UltimateChristmas / Module system
Module system
Every feature is an independent module with its own config file and its own lifecycle. You decide what runs — live, in game, without a restart — and the plugin remembers your choice.
Managing modules
/christmas module list what exists and what is running /christmas module disable <id> stop one feature now, and keep it off /christmas module enable <id> start it again /christmas module restart <id> fresh listeners and tasks /christmas module reload <id> re-read only that module's config /christmas reload re-read every config (nothing restarts)
Permission: ultimatechristmas.admin.modules (/christmas reload needs .admin.reload).
Disabling a module removes its commands, listeners and tasks on the spot. The choice is recorded in config.yml under modules.disabled, so it stays off after a restart. You can also edit that list by hand before first start.
reload vs restart
reload re-reads the module's config file and applies what can be applied live. A few settings create tasks at startup and need a restart instead — each config file says so at the top when it applies. Known cases:
snow.tick-period—/christmas module restart snowcountdown.boss-bar.enabled—/christmas module restart countdown
Module ids and config files
Each module reads plugins/UltimateChristmas/modules/<id>.yml:
| Id | Config file | Documentation |
|---|---|---|
economy | modules/economy.yml | Shard economy |
shop | modules/shop.yml | Shard shop |
advent | modules/advent.yml | Advent calendar |
santa | modules/santa.yml | Santa NPC |
bosses | modules/bosses.yml | Bosses & models |
presents | modules/presents.yml | Hidden presents |
quests | modules/quests.yml | Quests |
pass | modules/pass.yml | Festive pass |
cosmetics | modules/cosmetics.yml | Cosmetics |
tree | modules/tree.yml | Community tree |
secretsanta | modules/secretsanta.yml | Secret Santa |
snowball | modules/snowball.yml | Snowballs |
feasts | modules/feasts.yml | Feasts |
music | modules/music.yml | Music & carols |
snow | modules/snow.yml | Snow |
ambience | modules/ambience.yml | Ambience |
countdown | modules/countdown.yml | Countdown |
leaderboard | modules/leaderboards.yml | Leaderboards |
admin | modules/admin.yml | Below |
platform | config.yml | Installation |
The admin module
# modules/admin.yml apply-disabled-on-start: true # re-apply modules.disabled once the server is up expose-architecture: true # allow /christmas architecture exports
/christmas architecture [markdown|json|mermaid|graphviz] exports the live module dependency graph to a file — handy for seeing how the pieces connect.