Skip to content

Modules Guide

Quick reference for configuring each module. All modules toggle in config.yml under Modules.<name>.enabled.

Economy stack

Module Config folder Key files
economy economy/ config.yml — currency, starting balance
worth worth/ config.yml, prices.yml, gui/sell.yml — sell prices, sell GUI mode
shop shop/ config.yml, category YAMLs
auction auction/ config.yml, gui/ — listing limits, fees
order order/ config.yml, gui/ — buy orders, notifications
bounty bounty/ config.yml — min/max bounty amounts
shards shards/ config.yml — passive earn, boosters, regions

Economy setup →

PvP

Module Highlights
combat Combat tags, actionbar countdown, glowing, crystal/TNT/pet linking
duels 1v1 requests, ranked queue, FAWE arena clones, Elo, spectate

Social & teleport

Module Highlights
team Max members, PVP toggle, promote, team home
home Home slots (3 default, 5 with donutplus), TP delay
tpa Daily limit, auto-accept, confirm menus
warp gui.enabled: false for chat list fallback
rtp Regions, cooldowns, priority queue permission
rtpzone Timed group RTP events
fly Combat disable (shares combat module tags when enabled)

Gameplay

Module Highlights
crates Per-crate YAML in crates/crates/, key-all cooldown
billford Trade definitions, NPC locations
spawner Mob types, drop rates, GUI, chunk-indexed sync
tools Sell axe and custom tools
doublejump Worlds, cooldown, WorldGuard regions
phantom Server-wide phantom toggle
portals Custom portal destinations
settings Player toggles including duel requests / post-duel songs

Staff & moderation

Module Highlights
punishments GUI off by default, IP bans, offend IDs, LiteBans-style commands
report Cooldown, GUI for staff, mod actions (TP/kick/ban)
core commandspy, scaninv, maintenance, voice moderation

Punishment commands →

Stats & display

Module Highlights
stats Tracks kills, deaths, blocks, playtime, money
leaderboard GUI boards for all stat types
holograms FancyHolograms top-10 at spawn

Requires PlaceholderAPI for hologram placeholders.

Public API

Module Highlights
publicapi HTTP port, rate limits, webhooks, maintenance

Public HTTP API →

Message customization

Every module uses hex colors in messages:

no-permission: "#FF5555You don't have permission."
success: "#AAAAAADone! &#00F986%player%"

Placeholders: %player%, %amount%, %donutsmpcore:module:key%, PlaceholderAPI when enabled.

GUI customization

Modules with GUIs store layouts in <module>/gui/*.yml. Items support:

  • Material names (XSeries cross-version)
  • Custom model data
  • Placeholder lore
  • Click actions

Reload after edits: module-specific reload or /donutsmpcore reload.