OP-Essentials

Essentials-style server utilities for NeoForge: vanish, permission groups, homes, warps, teleports, moderation, chat formatting, kits and more. Server-side only — players connect with a completely vanilla client.

Everything in here exists because our own server needed it. The mod runs in production on a public All The Mods 10 server, which is where most of the bug fixes in the changelog come from.

Project status: beta. v0.1 is pretty stable — it's the build running in production — but a lot of the internals are still being reworked, so expect things to change between releases. OP-Essentials is based on NeoEssentials by ZeroG Network, the project it was forked from, and has grown from there.

See COMMANDS.md for the full command reference.

• Removes you from the tab list, entity tracking and minimaps — no footsteps, no sounds, no radar dot
• Staff can always see other vanished staff (priority-based, no toggles needed)
• Optional fake leave/join messages on vanish/unvanish
• Teleports while vanished are silent: no chat broadcast, no sound, no particles
• Handles the login race, so players who join while you are vanished still cannot see you

• Built-in permission engine: groups with inheritance, prefixes/suffixes, per-user overrides
• Dynamic nodes, e.g. neoessentials.home.5 grants 5 homes (highest node wins)
• Live reload: edit permissions.json, run /permissions reload, done
• FTB Ranks adapter for modpack integrations

• Homes with per-group limits, warps, /spawn, /back, /rtp, /top, /jump
• TPA requests with accept/deny, plus silent admin teleports (/tpo, /tphere, /tpall, /tpoffline)
• Teleport sounds and particles for players; staff move silently

• Ban, tempban with durations, IP bans, kick, kickall — all with reasons
• Mute/unmute, mute list
• Freeze single players or the whole server (/freezeall)
• Jails: /setjail, /jail <player> [duration], /jailinfo, /jaillist
• /invsee and /enderchest inventory GUIs (view or edit)
• /whois, /seen, /near, /realname, /sudo

• Group prefixes, colored/hex/rich-text chat behind permissions, badges, channels
• Private messages, replies, ignore, social spy, helpop
• AFK detection with tab indicator; broadcasts and auto-kick are optional and fully configurable
• Tablist header/footer with placeholders (TPS, ping, balance, world), static or animated

• Kits with cooldowns and a first-join starter kit, created in-game
• Virtual workbenches: /craft, /anvil, /grindstone, /smithing, /stonecutter
• /hat, /repair, /heal, /feed, /ext, /speed, /ptime, /pweather, /nick
• Mail with offline delivery and send-to-all, MOTD, rules, item customisation
• Economy commands, with bridging to external economy mods where present

• Split JSON configs under config/neoessentials/, one file per system
• neoe reload reloads every system live
• Player data persists per-change, so a hard kill cannot lose homes or settings

Put the jar in the server's mods/ folder. There is no client component. Configs generate under config/neoessentials/ on first start.

The project is currently maintained by surgical patching rather than a full gradle build — see BUILDING.md. The patches/ directory contains the per-version change history.

OP-Essentials started as a fork of NeoEssentials by ZeroG Network and has since diverged heavily (see CHANGELOG.md). Internal ids still use the neoessentials namespace; the full rename is planned for an upcoming release.

MIT, same as upstream. See LICENSE — the original NeoEssentials copyright (ZeroG Network) is preserved alongside the OP-Essentials changes.