DonutSMP Core

DonutSMP Core puts a whole DonutSMP-style server into one jar: auction house, orders, shop, sell, crates, spawners, homes, teams, RTP, TPA, shards, scoreboard and more. Each part is a module you switch on or off in config.yml, and all of them save to one storage backend, so a network can share everything through MySQL or Redis.

Several modules are the same systems sold as separate BlazeZ plugins. Their sections below link to those plugins' pages for the full details.

Permissions#

Commands a player uses without a permission are marked None in Commands. Everything below is OP-only by default, so grant the player nodes you want your members to have.

Commands#

A module's commands only exist while that module is on.

Configuration#

Modules#

Every module is on by default. Set one to false and restart to turn it off.

modules:
  auction: true
  billford: true
  bounty: true
  clearlag: true
  crates: true
  enderchest: true
  help: true
  hider: true
  homes: true
  leaderboard: true
  litecrystal: true
  media: true
  message: true
  order: true
  rtp: true
  rules: true
  scoreboard: true
  sell: true
  shards: true
  shop: true
  spawn: true
  spawner: true
  teams: true
  tools: true
  tpa: true
  warp: true

Storage#

storage:
  type: h2
  thread-pool-size: 4
  mysql:
    host: localhost
    port: 3306
    database: donut
    username: root
    password: ''
  redis:
    host: localhost
    port: 6379
    password: ''

The three network types need the DonutBridge cross-server addon installed next to DonutSMP Core on every server. It keeps balances, homes and player profiles in sync, and /donutbridge <status|nodes|reload> (permission donutbridge.admin) shows the link between servers.

Install#

1. Put the DonutSMP Core jar in plugins/. Your server must run Java 25 or newer.
2. Install Vault and an economy plugin if you use the auction, bounty, order, sell or shop modules, and WorldGuard for RTP zones and shard AFK regions.
3. Start the server once. It creates plugins/DonutCore/ with config.yml, license.yml and a folder per module.
4. Paste your license key into license-key in license.yml. Your key is under My Licenses on the BlazeZ portal; licenses linked to your Discord account show up there automatically. If yours is missing, open a License Key ticket in the BlazeZ Discord.
5. Turn off the modules you don't want, pick a storage type and restart.
6. Grant your players the permissions from Permissions.

DonutSMP Core loads before Essentials, so its /home, /spawn, /warp, /msg and other commands win over Essentials' versions.

Auction#

/ah opens a paged auction house. Players list the item in their hand with /ah sell <price>, and prices take shorthand like 10k or 1.5m. /ah <search> filters listings, and adding stack or shulker at the end shows only full stacks or shulker boxes. Players with fast buy on skip the confirm step when buying. Staff can /ah inspect a player's listings, force-sell for them, or lock the auction house.

Billford#

Billford is a trader who offers one trade at a time. Players open /billford, bring the required items and get the reward. The trade switches to the next one in trades every change-trade-internal seconds (default 3600).

trades:
  1:
    requirements:
      1:
        material: SAND
        amount: 64
    reward:
      material: GLASS
      amount: 32

Bounty#

Players put money on another player's head with /bounty add <player> <amount>. Whoever kills that player gets the money. /bounty lists every open bounty, and staff can add, remove or reset bounties and view the history with /bountyadmin.

ClearLag#

Every interval-seconds (default 900, 15 minutes), ClearLag removes dropped items, animals and monsters, as set under clear. It warns players at each number of seconds in warnings. Tamed, named and leashed mobs are kept, and bosses like the Ender Dragon and Wither are never removed. automatic: false stops the timer, and /clearlag clear runs a sweep by hand.

Ender Chest#

/ec opens an ender chest of rows rows (default 6) that saves through the core storage, so on a network it follows players between servers. Lowering rows later hides the extra rows without deleting their items.

Help, Media and Rules#

/help, /media and /rules open simple menus you design in each module's config.yml. Each icon under inventory.icons has a material, name, lore and slot. A /help icon can also run a command as the player or send messages in chat when clicked.

Scoreboard#

A sidebar in the classic DonutSMP layout. Players hide it with /scoreboard. These placeholders work without PlaceholderAPI:

With PlaceholderAPI installed, any other placeholder works too. update-interval sets the refresh in ticks, and title.frames can list several titles to animate.

Shards#

Shards are a second currency. Players earn them every Shard-Delay seconds while standing in a WorldGuard region from AFK-Regions, and Shard-Kill shards per kill. /afk takes them to the AFK area you set with /shard setafk. They spend shards in /shard shop and compare in /shard leaderboard.

Extra earnings come from Gen-Nodes and Kill-Nodes. The defaults give shard.gennodes.extra_two +2 per generation and shard.killnodes.extra_ten +10 per kill, and you can add your own node names. Kill-Nodes.prevent_abuse stops rewards for killing the same player again.

Spawn#

/setspawn <id> saves a spawn area where you stand, and /spawn opens a menu of every area. The lowest id is the main spawn used for teleport-on-first-join, teleport-on-every-join and respawn-at-spawn. warmup-seconds and cooldown-seconds apply to teleports from the menu.

Teams#

/team create <name> starts a team, and the leader invites players with /team invite. The team menu shows every member, and the leader sets what each one may do: edit or visit the team home, kick, invite, switch team PvP and use team chat. /team pvp sets whether teammates can hurt each other.

Warp#

/setwarp <name> saves a warp where you stand, and players use /warp <name>. warmup-seconds and cooldown-seconds apply, and moving during the warm-up cancels the warp.