Modules

Modules let you turn entire feature groups on or off without removing the plugin. Disabled modules skip command handlers and event listeners.

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

Feature settings live in matching YAML files (staff.yml, teleport.yml, server.yml, player.yml, chat.yml, …). See Configuration.

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.

Moderation and Enforcement

Module key	Default	Description
moderation	true	Kick, ban, mute, warn, notes
freeze	true	Freeze players in place
jail	true	Jail rooms and timed sentences

Staff Tools

Module key	Default	Description
vanish	true	Hide staff from players
staff-mode	true	Staff mode with tool loadout
spectator	true	Spectate other players
spy	true	Command spy and social spy

Communication

Module key	Default	Description
chat	true	Chat filter, slowmode, staff chat, private messages
broadcast	true	Formatted broadcast messages
announcements	true	Scheduled automatic announcements
motd	true	Server list MOTD customization
rules	true	/sa rules and rules GUI

Teleportation

Module key	Default	Description
teleportation	true	Staff teleports, warmups, cooldowns
homes	true	Per-player homes
warps	true	Server warp points
tpa	true	Player teleport requests
spawn	true	Spawn management
death-settings	true	Death and respawn behavior
rtp	true	Random teleportation
waypoints	true	Personal waypoint markers

Economy and Kits

Module key	Default	Description
kits	true	Item kits with cooldowns
economy	true	Multi-currency economy
spawner	true	Spawner editor, Mythic overrides, FX (off = pure vanilla)
shop	true	Global shop from prices.yml

Inventory and Items

Module key	Default	Description
inventory	true	Invsee, endersee, lock, sort
inventory-snapshots	true	Auto-capture and restore inventories
items	true	Give, take, clear, item blacklist
item-editor	true	Advanced item editing
playervaults	true	Extra player storage vaults + vault autopickup
recipes	true	Custom recipe crafter

Player QoL

Module key	Default	Description
afk	true	AFK detection, toggle, AFK zones
friends	true	Friend system with PvP protection
nickname	true	Nickname system
playtime-tracker	true	Playtime tracking and leaderboard
double-doors	true	Double-door sync
weather-vote	true	Weather voting
death-coords	true	Death location reminders
seek-item	true	Scan containers for items
player-utilities	true	Item filter, autopickup, privacy toggles
player-trade	true	Secure player trading
player-actions	true	Sit, spin, and cosmetic actions
workbenches	true	Virtual crafting stations
utility	true	God, fly, heal, gamemode, speed
attributes	true	Player attribute management

Support and Reporting

Module key	Default	Description
reports	true	Player report system
tickets	true	Support ticket system

Server Management

Module key	Default	Description
plugin-monitor	true	Plugin error and performance monitor
diagnostics	true	Server health (/sa health)
performance-diagnostics	true	Lag hotspot scans
mining-audit	true	Mining stats and /sa xraycheck
gamerules	true	Gamerule editor GUI
clearlag	true	Scheduled ground item clearing
backup	true	Data and world backups
world-manager	true	Create and manage worlds
world-state	true	Save fly/gamemode across worlds

Custom Content

Module key	Default	Description
death-messages	true	Custom death messages
join-messages	true	Join, quit, first-join messages
custom-commands	true	YAML-defined command aliases
fake-players	true	Fake player NPC entities

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.