How to enable or disable a module
A. At startup via config.yml
This is the only supported way to toggle a module.
-
In the repo — edit
src/main/resources/config.yml:modules:spawn:enabled: true # set to false to disable -
On the running server — the deployed file is at
plugins/Kreiscraft/config.yml. Edit it there for a live server, then restart. -
Restart the server. Module enable/disable only takes effect on startup.
Default behaviour: if the
enabledkey is absent from a module’s config block, the module is disabled. You must explicitly setenabled: true.
Shipped defaults: the bundled
config.ymlenables most modules, buteffects,firework,glow,plugin-hiderandpositionsship withenabled: false. Setenabled: trueto activate any of them.plugin-hiderandpositionsare intentionally disabled by default because they are server-specific policy choices.
B. During development — runtime reload
/kreiscraft reload does not enable or disable modules.
It calls config.reload() and then module.onConfigReload(moduleConfig) on every
already-enabled module. This refreshes config values (timeouts, thresholds, etc.) without
restarting the server.
There is no runtime toggle command. A module that was not enabled at startup cannot be enabled mid-session, and a running module cannot be stopped without a full restart.
Quick reference
| Goal | How |
|---|---|
| Enable a module | Add enabled: true under modules.<id> in config.yml, restart |
| Disable a module | Set enabled: false (or remove the block), restart |
| Reload config values for running modules | /kreiscraft reload |
| Toggle a module without restart | Not supported |