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
Tip

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.