Configuration

BusyHub keeps every setting in one file: plugins/BusyHub/config.yml. This page maps each top-level section to what it controls and where it's covered in depth — treat it as an index, not the full reference.

config.yml sections

Section Controls Details
active-hub Reserved for multi-hub support. v1 only ever uses default. —
debug Verbose logging. —
messages prefix shown in front of every /busyhub command reply (legacy & codes or MiniMessage). —
chat Global chat on/off switch, and which commands get blocked when chat is off. Chat & Command Lockdown
command-lockdown Always-on blocklist for commands that leak server info, independent of the chat toggle. Chat & Command Lockdown
spawn Hub spawn location, /spawn permission requirement, respawn override, join teleport. Spawn
protection Invincibility, no-hunger, and the full block-place/break/drop/pickup/weather/mob-spawn/fire/leaf-decay/interact/death-message toggle set. World Protection
disabled-worlds Worlds exempt from everything in protection and from antivoid. World Protection
double-jump Enable/disable, boost velocity, cooldown. Double Jump
visibility The global admin-only mutual-hide switch (/busyhub visibility) — not the per-player item. Player Visibility Toggle
compass The server-select compass item: material, name, lore, join slot, which menu it opens. Server-Select Compass
player-visibility-item The per-player "hide other players from my view" toggle item. Player Visibility Toggle
launch-pads Default velocity/height used when /busyhub pad create omits them. Launch Pads
antivoid Whether falling into the void returns a player to spawn. World Protection

Other files

  • menus/*.yml — one file per GUI. main.yml ships as the default compass menu. See Menus & Actions.
  • data.yml — portals and launch pads registered via /busyhub portal/pad commands. Hand-editing is safe but requires /busyhub reload to pick up.
  • plugin.yml — permission definitions. See Commands & Permissions.

Applying changes

/busyhub reload re-reads config.yml, every file under menus/, and data.yml. No restart needed for anything in this wiki.