EssentialsBMC Summary

EssentialsBMC is a server-side Fabric mod (1.21.1) that delivers essentials-style utilities with permission checks and JSON-backed storage. The Fabric Permissions API is bundled in the jar, so no extra mods are required.

• Storage & Config: Data lives under config/essentials_bmc/ (homes.json, warps.json, spawn.json, joined.json, announcer.json, config.json). Files are created with defaults on first run.
• Teleports: /spawn & /setspawn, /back (last death), /rtp with border buffer and solid-ground checks, warps (/warp, /setwarp, /delwarp), homes with tiered limits (/home, /sethome, /delhome), and TPA flow (/tpa, /tpaccept, /tpdeny with 60s expiry).
• Player tools: Private messages (/msg, /r), trash GUI (/trash), hat swap, clear inventory, night vision (/luz), nicknames, item repair (single/all), and inventory inspection (/invsee 9x6 view).
• Admin & buffs: Flight toggle, god mode, heal/feed, speed scaling, and hunger/night-vision helpers. Damage is blocked for players with god enabled.
• World utilities: First-join auto-teleport to spawn with a welcome note, auto-announcer cycling chat/actionbar/title/bossbar messages (bossbar hides after 10s), random teleport chooses safe ground, and passive main/offhand repair for players with the essentialsbmc.passive.autorepair permission (interval from config.json, default 5 minutes).
• Permissions: Every command registers permission nodes (see PermissionNodes in code). Home limits honor essentialsbmc.home.limit.admin/vip/member with a default of 1 home when no tier is granted.

Use the JSON files to pre-seed homes/warps/spawn or adjust announcer messages/intervals and the passive repair interval. Everything runs server-side with no client assets or mixins.

Server Validation

✅ Server validation passed - The mod was tested on a real Minecraft server and loaded successfully.