DonutScoreboard

DonutScoreboard

This plugin creates a scoreboard easy adjustment and configuration exactly like the famous server "DonutSMP" that owned but "DrDonutt"

32 749 downloads
18 followers

Full Documentation

DonutScoreboard

Paper Purpur Spigot Bukkit Modrinth


Discord
Please contact me on Discord if you have any suggestions or edits.


What

  • DonutScoreboard makes a Scoreboard exactly like the famous Server "DonutSMP"

Features

  • Same Design: The scoreboard matches the original DonutSMP layout exactly — same icons, same colors, same gradient title.
  • Full Customization: Every single line is editable in config.yml. Change text, colors, hex codes, or swap any value with a placeholder.
  • Zero Flicker: Lines only update when the content actually changes. Players never see a flash or refresh stutter.
  • Keyall Countdown: A server-wide 60 minute countdown that resets automatically. Operators can set it to any time live with a command.
  • Player Toggle: Players can show or hide their own scoreboard at any time with /sb enable or /sb disable. The preference saves across restarts.
  • World Control: Disable the scoreboard in specific worlds from config or with a command. Players moving between worlds have it handled automatically.
  • PlaceholderAPI Support: Any %placeholder% from PlaceholderAPI works inside scoreboard lines when PAPI is installed.

Commands

Commands

Command Permission Description
/donutscoreboard Everyone Shows plugin info and available commands
/donutscoreboard reload donutscoreboard.admin Reloads the configuration file
/donutscoreboard reset donutscoreboard.admin Resets config to defaults and rebuilds all scoreboards
/donutscoreboard interval <seconds> donutscoreboard.admin Sets the scoreboard refresh rate (1-60 seconds)
/donutscoreboard title edit [text] donutscoreboard.admin Changes the scoreboard title
/donutscoreboard title reset donutscoreboard.admin Resets the title to default
/donutscoreboard line add [text] donutscoreboard.admin Adds a new line to the scoreboard
/donutscoreboard line edit <number> [text] donutscoreboard.admin Edits a specific line
/donutscoreboard line delete <number> donutscoreboard.admin Removes a line from the scoreboard
/donutscoreboard line empty <number> donutscoreboard.admin Clears a line (makes it blank)
/donutscoreboard line reset [number] donutscoreboard.admin Resets a line (or all lines) to default
/donutscoreboard line swap <n> with <n> donutscoreboard.admin Swaps two lines
/donutscoreboard keyall time set <time> donutscoreboard.admin Sets the keyall countdown (example: 30m, 1h, 2d)
/donutscoreboard keyall time reset donutscoreboard.admin Resets keyall countdown to max duration
/donutscoreboard keyall duration <time> donutscoreboard.admin Sets the max keyall duration (example: 2h, 3d)
/donutscoreboard keyall trigger donutscoreboard.admin Fires the keyall event immediately
/donutscoreboard world list donutscoreboard.admin Lists all worlds and their status
/donutscoreboard world disable <world> donutscoreboard.admin Disables the scoreboard in a world
/donutscoreboard world enable <world> donutscoreboard.admin Enables the scoreboard in a world
/donutscoreboard auto-world list donutscoreboard.admin Lists auto-disable patterns
/donutscoreboard auto-world add <pattern> donutscoreboard.admin Adds an auto-disable pattern (supports * wildcard)
/donutscoreboard auto-world remove <pattern> donutscoreboard.admin Removes an auto-disable pattern
/donutscoreboard animation preview <name> donutscoreboard.admin Previews the current frame of an animation
/donutscoreboard animation interval <name> <ticks> donutscoreboard.admin Changes an animation's frame interval
/donutscoreboard animation delete <name> donutscoreboard.admin Deletes an animation
/donutscoreboard style <new|old> donutscoreboard.admin Switches between preset scoreboard layouts
/donutscoreboard toggle-placeholder set-true <format> donutscoreboard.admin Sets format for %donutscoreboard_toggle_status% when ON
/donutscoreboard toggle-placeholder set-false <format> donutscoreboard.admin Sets format for %donutscoreboard_toggle_status% when OFF
/donutscoreboard scoreboard-numbers <enable|disable> donutscoreboard.admin Toggles the side numbers on the scoreboard (Paper 1.20.5+)
/donutscoreboard export create donutscoreboard.admin Creates a full config backup zip
/donutscoreboard export list donutscoreboard.admin Lists all available backup exports
/donutscoreboard import <filename> donutscoreboard.admin Imports a config backup zip
/donutscoreboard toggle <player> donutscoreboard.admin Toggles another player's scoreboard visibility
/sb donutscoreboard.toggle Toggles your scoreboard on or off
/sb enable donutscoreboard.toggle Shows your scoreboard
/sb disable donutscoreboard.toggle Hides your scoreboard

Permissions

Permission Default Description
donutscoreboard.admin OP Full access to all admin commands (grants every child permission below)
donutscoreboard.view Everyone Required to see the scoreboard at all
donutscoreboard.toggle Everyone Access to the /sb toggle command
donutscoreboard.toggle.others OP Access to /dsb toggle <player> to toggle other players
donutscoreboard.reload OP /dsb reload
donutscoreboard.reset OP /dsb reset
donutscoreboard.interval OP /dsb interval
donutscoreboard.title OP /dsb title
donutscoreboard.line OP /dsb line
donutscoreboard.keyall OP /dsb keyall
donutscoreboard.world OP /dsb world
donutscoreboard.auto-world OP /dsb auto-world
donutscoreboard.animation OP /dsb animation
donutscoreboard.style OP /dsb style
donutscoreboard.toggle-placeholder OP /dsb toggle-placeholder
donutscoreboard.scoreboard-numbers OP /dsb scoreboard-numbers
donutscoreboard.export OP /dsb export
donutscoreboard.import OP /dsb import

Configuration

  • A folder named DonutScoreboard is created in your plugins folder automatically. Inside you will find a clean config.yml file.
Config.yml
# DonutScoreboard config
# Colors: &f &7 &a &c &l &#RRGGBB and MiniMessage tags
# Tokens: %kills% %deaths% %ping% %playtime% %keyall% %donutscoreboard_player%
# Condition: line-condition: "%kills% > 0" or "permission:node" or "world:name"

enabled: true

# Refresh rate in seconds
update-interval: 1

# Ticks before scoreboard shows on join
join-delay: 2

# Keyall countdown length in seconds
keyall-duration: 3600

# Worlds that never show scoreboard
disabled-worlds: []

# Pattern-based world disabling, supports wildcards like world_*
auto-disable-worlds: []

toggle:
  command: "sb"
  command-enabled: false
  permission: "donutscoreboard.toggle"
  default-on: true
  args:
    enable:  "enable"
    disable: "disable"

  enable:
    chat-enabled:      true
    chat-message:      "&aYou have enabled scoreboard."
    actionbar-enabled: true
    actionbar-message: "&aYou have enabled scoreboard."
    title-enabled:     false
    title-message:     "&aScoreboard"
    subtitle-message:  "&7has been enabled"
    title-fade-in:     10
    title-stay:        40
    title-fade-out:    10
    sound-enabled:     true
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"

  disable:
    chat-enabled:      true
    chat-message:      "&cYou have disabled scoreboard."
    actionbar-enabled: true
    actionbar-message: "&cYou have disabled scoreboard."
    title-enabled:     false
    title-message:     "&cScoreboard"
    subtitle-message:  "&7has been disabled"
    title-fade-in:     10
    title-stay:        40
    title-fade-out:    10
    sound-enabled:     true
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"

toggle-placeholder:
  format-on:  "&a&lON"
  format-off: "&c&lOFF"

scoreboard:

  # Show or hide score numbers
  numbers-visible: false

  title: "&#007DFC&lD&#0088FC&lo&#0092FC&ln&#009DFC&lu&#00A8FC&lt&#00B3FC&l S&#00BDFC&lM&#00C8FC&lP"

  lines:
    spacer-top: " "
    money: "&f&#00FF00&l$ &fMoney &#00FF000"
    shards: "&f&#A503FC★ &fShards &#A503FC0"
    kills: "&f&#FF0000\uD83D\uDDE1 &fKills &#FF00000"
    deaths: "&f&#FC7703\u2620 &fDeaths &#FC77030"
    keyall: "&f&#00A6FF\u231B &fKeyall &#00A6FF%keyall%"
    playtime: "&f&#FFE600\u231A &fPlaytime &#FFE6000h 0s"
    team: "&#00A6FF\uD83E\uDE93 &#FFFFFFTeam &#00A6FFN/A"
    spacer-mid: " "
    footer: "&f&7NA East &7(&#00A6FF%ping%ms&7)"

# Runs commands when keyall countdown hits zero
keyall-execute:
  enabled: false
  commands:
    - "crates key give @a example"
    - "broadcast &6&lKeyall keys have been distributed!"
  notify:
    actionbar-enabled: false
    actionbar-message: "&#00A6FF&lKeyall &7keys have been given to everyone!"
    title-enabled: false
    title-message:    "&#00A6FF&lKEYALL"
    subtitle-message: "&7Keys have been distributed!"
    title-fade-in:  10
    title-stay:     60
    title-fade-out: 10
    sound-enabled: false
    sound: "ENTITY_PLAYER_LEVELUP"

Installation

  • Download the latest version of DonutScoreboard.
  • Drop the .jar file into your server's plugins folder.
  • Restart your server.
  • Done! No additional setup required.

Modrinth Gallery

Example


© All Rights Reversed. Created by SirSnaryo.