Essentials

A lightweight, server-side Fabric toolkit for survival servers and SMPs. Essentials adds the everyday player commands and moderation tools most servers need without requiring a client-side mod.

Server-side only: players can join with an unmodified vanilla client. Fabric API is required on the server.

Features

Player quality of life

• Teleport requests with /tpa, /tpahere, accept, deny, cancel, and /tpahere all
• /back after a completed teleport request
• Persistent /spawn and /setspawn with safe arrival checks, warm-up, cooldown, and optional first-join/respawn routing
• Named /sethome, /home, /delhome, and /homes saved by player UUID, with limits, warm-up, cooldown, and safe arrival
• 9x3 backpacks with per-player, shared-server, or vanilla ender chest modes
• A disposable 9x3 inventory with /disposal, /trash, or /trashcan

Server administration

• Repair held items, heal or feed players, and toggle survival flight
• Inspect and edit inventories, ender chests, and per-player backpacks
• Manage previously joined players even while they are offline
• Changes stay synchronized when multiple admins inspect the same live storage
• Hide staff with /vanish, including entities, the tab list, commands, announcements, mobs, and collision
• Check server-reported latency with /ping [player], including configurable color thresholds
• Monitor rolling server TPS with /tps across 5-second through 15-minute windows

Moderation

• Timed or permanent player bans, including offline players
• Timed or permanent IPv4 and IPv6 bans
• Ban an online player's account and current IP together by using their name with /ban-ip
• Kick players with a required reason
• Pardon player accounts and IP addresses independently
• View paginated kick and ban history with /history or /audit, including active bans

Ban durations support values such as 30m, 2h, 7d, and 1d12h. Use permanent or perm for a permanent ban. IPv6 addresses must be quoted in commands.

Command overview

Every command group can be disabled or made available to either operators or all players. With a compatible Fabric permission provider such as LuckPerms, stable essentials.<command> nodes provide granular access; aliases share the primary command node. See the README for the complete permission-node table. Without a provider, commands.<name>.access remains the only access check and behavior is unchanged.

Configuration

The configuration is generated at config/essentials/essentials.yaml. Changes take effect after restarting the server.

Moderation messages support Minecraft ampersand formatting codes such as &c and &l.

• ban_message: {player}, {reason}, {moderator}, {time}, {expires_at}
• kick_message: {player}, {reason}, {moderator}

Available command configuration names include repair, heal, feed, flight, disposal, tpa, back, spawn, setspawn, home, sethome, delhome, homes, backpack, backpacksee, enderchestsee, inventorysee, ban, pardon, banip, pardonip, kick, history, ping, and tps.

Installation

1. Install Fabric Loader and Fabric API on the server.
2. Place the Essentials JAR in the server's mods folder.
3. Start the server and adjust config/essentials/essentials.yaml as needed.

Requires Java 25 or newer. No client installation is required.