Modules
Each module is independently toggleable from config.yml. Disable
what you don't use. Disabled modules cost zero CPU.
Overview
NexoraSMP ships 14 modules. Toggle each via:
modules:
<module-name>:
enabled: true # or false
combat
PvP and combat mechanics. Combat tag, PvP toggle, golden heads, damage indicators, totem warmup.
Default permissions: nexora.pvp.toggle (everyone), nexora.combat.bypass (op).
Commands: /pvp [player]
kits
Cooldown / one-time / permission-gated kits. Define kits in modules/kits.yml.
starter:
cooldown: "24h"
one-time: false
items:
- type: IRON_SWORD
- type: BREAD
amount: 16
custom-items
Custom items with abilities, lore, custom-model-data, and cooldowns.
Defined in modules/custom-items.yml.
Commands: /nitem give <player> <item-id>
recipes
Custom shaped / shapeless crafting recipes + an in-game recipe book GUI.
Commands: /recipebook (alias /rbook)
bosses
Custom mob bosses with multi-phase attacks, configurable loot tables,
per-phase abilities. Defined in modules/bosses.yml.
Commands: /nboss list, /nboss spawn <id>
rituals
Multi-block, multi-item rituals (e.g. arrange diamonds in a circle around a beacon, drop a totem in the center, get an effect). Server-side custom gameplay without resource packs.
events
Scheduled in-game events: drop parties, double-XP nights, pvp-only nights,
mini-games. Defined in modules/events.yml.
item-sets
Wear-set bonuses. Wear all 4 pieces of a configured armour set, get an ongoing potion effect or stat boost. Per-set permissions supported.
anti-exploit
Defensive bundle. Each sub-feature can be toggled independently:
- anti-crash: blocks oversized books, sign exploits, NBT bombs
- anti-xray: packet-level chunk obfuscation (no client mod required)
- anti-spam: rate-limits chat and command spam
- anti-click: flags inhuman click rates
- anti-health-inspector: strips entity-health packets sent to non-staff
Anti-X-ray works best when paired with a moderate view-distance and
simulation-distance in server.properties. Defaults
are tuned for view-distance: 8.
bans
Server-wide blacklist for items, blocks, recipes, and potions. Defined in
modules/bans.yml. Items are silently removed; recipes and
potions show a configurable message.
punishments
Warn / mute / kick / ban with full history. Stored in the SQLite database; manageable from the dashboard or in-game commands.
Commands: /warn, /mute, /unmute, /kick, /nban, /nunban, /history
tickets
Player-submitted tickets and reports. Staff queue with claim / close / comment. Optional notification permission so on-duty staff get pinged in chat.
Commands: /ticket create, /tickets, /report, /reports
staff
Vanish, freeze, invsee, enderchest, teleport-to / teleport-here, notes, staff chat.
Commands: /vanish, /freeze, /invsee, /ec, /tphere, /tpto, /note, /notes, /staffchat
qol (quality of life)
Homes, warps, TPA, AFK, spawn, /back. The basics, polished.
dashboard
The web control panel. See Web dashboard for the full tour.
Disabling a module
modules:
rituals:
enabled: false
Then run /nexora reload. The module is unloaded, its listeners are
unregistered, and any tasks it scheduled are cancelled. Re-enabling at
runtime requires a restart.