Modules

Modules let you turn entire feature groups on or off without removing the plugin. Disabled modules skip command handlers, event listeners, and top-level command aliases (for example /money when economy is off).

Soft integrations such as MythicMobs are not separate modules. They activate when the plugin is present (see Integrations).

Each toggle in modules.yml lists which YAML file to edit (| config: …). See also Default modules.yml, Config Reference, and Configuration.

Lean profile

For a lower-RAM staff + travel install, set the heavy modules below to false in modules.yml, then /sa reload modules (or restart). There is only one modules file on disk.

modules:
  moderation: true
  freeze: true
  jail: true
  vanish: true
  staff-mode: true
  spectator: true
  spy: true
  chat: true
  broadcast: true
  announcements: false
  motd: true
  rules: true
  teleportation: true
  homes: true
  warps: true
  tpa: true
  spawn: true
  death-settings: true
  rtp: false
  waypoints: false
  kits: false
  economy: false
  spawner: false
  shop: false
  inventory: true
  inventory-snapshots: true
  items: true
  item-editor: false
  playervaults: false
  recipes: false
  afk: false
  friends: false
  nickname: false
  playtime-tracker: true
  double-doors: false
  death-coords: true
  seek-item: false
  player-utilities: false
  player-trade: false
  player-actions: false
  workbenches: false
  utility: true
  mail: false
  attributes: false
  reports: true
  tickets: true
  plugin-monitor: false
  diagnostics: true
  performance-diagnostics: false
  mining-audit: false
  gamerules: true
  clearlag: false
  backup: true
  world-manager: false
  world-state: false
  death-messages: true
  join-messages: true
  custom-commands: true
  fake-players: false

Managing Modules

Command	Description
/sa modules list	Show all modules and status
/sa modules toggle <module>	Flip a module on or off
/sa modules enable <module>	Enable one module
/sa modules disable <module>	Disable one module
/sa modules gui	Open the module manager GUI
/sa reload modules	Reload modules.yml

Changes from commands take effect immediately. File edits require /sa reload modules.

Module Reference

All keys live under modules: in modules.yml. Defaults below match the shipped jar.

Cross-cutting text: messages.yml. GUI panels: gui.yml. Soft integrations master toggles: config.yml.

Moderation and Enforcement

Module key	Default	Config file(s)	Description
moderation	true	moderation.yml	Kick, ban, mute, warn, notes
freeze	true	moderation.yml	Freeze players in place
jail	true	jails.yml, moderation.yml	Jail rooms and timed sentences

Staff Tools

Module key	Default	Config file(s)	Description
vanish	true	staff.yml	Hide staff from players
staff-mode	true	staff.yml	Staff mode with tool loadout
spectator	true	staff.yml	Spectate other players
spy	true	chat.yml	Command spy and social spy

Communication

Module key	Default	Config file(s)	Description
chat	true	chat.yml	Chat filter, slowmode, staff chat, private messages
broadcast	true	server.yml	Formatted broadcast messages
announcements	true	server.yml	Scheduled automatic announcements
motd	true	server.yml	Server list MOTD customization
rules	true	rules.yml (or customcommands.yml → custom-commands.rules)	/sa rules and rules GUI

Teleportation

Module key	Default	Config file(s)	Description
teleportation	true	teleport.yml	Staff teleports, warmups, cooldowns
homes	true	teleport.yml	Per-player homes
warps	true	teleport.yml	Server warp points
tpa	true	teleport.yml	Player teleport requests
spawn	true	teleport.yml; data: data/server/spawns.yml	Spawn management
death-settings	true	teleport.yml	Respawn flags (/sa deathsettings); related: death-coords
rtp	true	rtp.yml	Random teleportation
waypoints	true	waypoints.yml	Personal waypoint markers

Economy and Kits

Module key	Default	Config file(s)	Description
kits	true	kits.yml	Item kits with cooldowns
economy	true	economy.yml, daily.yml	Multi-currency + Vault (required for shop/pay/cheque/daily)
spawner	true	economy.yml; data: data/server/spawners.yml	Spawner editor, Mythic overrides, FX
shop	true	prices.yml	Buy/sell shop (requires economy: true)

Inventory and Items

Module key	Default	Config file(s)	Description
inventory	true	(none; commands and permissions only)	Invsee, endersee, lock, sort
inventory-snapshots	true	staff.yml → inventory-snapshot	Capture/restore inventories
items	true	player.yml → give; moderation.yml → item-blacklist	Give, take, blacklist
item-editor	true	(none; Paper GUI)	Item editor GUI
playervaults	true	playervaults.yml	Extra player storage vaults
recipes	true	recipes.yml	Custom recipes

Player QoL

Module key	Default	Config file(s)	Description
afk	true	player.yml	AFK detection and zones
friends	true	player.yml → friends; mcMMO toggle: config.yml → integrations.mcmmo.enabled	Friends list + XP share
nickname	true	player.yml	Nicknames
playtime-tracker	true	player.yml	Playtime tracking
double-doors	true	player.yml	Double-door sync
death-coords	true	player.yml	Death location reminders
seek-item	true	player.yml	Container item scan
player-utilities	true	player-utilities.yml	Filter, autopickup, autosell, privacy
player-trade	true	trade.yml	Player trades
player-actions	true	(none)	Sit, spin
workbenches	true	(none)	Virtual workbenches
utility	true	(none; commands and permissions)	God, fly, heal, /sa health (TPS/memory/entities), gamemode, speed, weather/time, spawnmob/killall, and related utility commands
mail	true	(none); data: data/social/mail/	Offline player mail inbox
attributes	true	(none)	Attribute editor

Support and Reporting

Module key	Default	Config file(s)	Description
reports	true	moderation.yml	Player reports
tickets	true	server.yml	Support tickets

Server Management

Module key	Default	Config file(s)	Description
plugin-monitor	true	server.yml	Plugin health monitor
diagnostics	true	server.yml	/sa uptime, /sa ping
performance-diagnostics	true	server.yml	Lag scanners (laghotspots, chunkactivity, mobdensity, redstonecheck, unloadchunks)
mining-audit	true	mining-audit.yml	Mining stats / xraycheck
gamerules	true	server.yml	Gamerule GUI
clearlag	true	clearlag.yml	Clear ground items
backup	true	server.yml	Data and world backups
world-manager	true	server.yml; data: worlds.yml	Create/load worlds
world-state	true	server.yml	Per-world fly/gamemode

Custom Content

Module key	Default	Config file(s)	Description
death-messages	true	deathmessages.yml	Custom death messages
join-messages	true	joinmessages.yml	Custom join/quit messages
custom-commands	true	customcommands.yml	Custom command definitions
fake-players	true	(none; Paper mannequins)	Fake player NPCs

Common module choices

Situation	Change
External shop plugin	Disable shop; keep economy enabled for balances and drops
Vanilla-only spawners	Disable spawner (SoapsAdmin stops managing spawners)
No mannequins / tab-list NPCs	Disable fake-players
Small server, less scanning	Disable performance-diagnostics

Toggle from file (modules.yml) or /sa modules gui.

Defaults: Default modules.yml · Intent: Want lean modules · Reload: Getting Started