🛠️ Essential Commands

A lightweight, multiplatform (Fabric + NeoForge) essentials mod for Minecraft. Created as a dependency-free alternative to EssentialsX / FTBEssentials.

I built this because I couldn't find a lightweight alternative. This mod intends to add just the essential commands without extra fluff.

Supports LuckPerms for fine-grained permission control. Falls back to vanilla OP levels when LuckPerms is not installed.

---

Configuration

Generated at config/essential.commands.toml on first launch. Reload at runtime with /essentials reload.

# Essential Commands Configuration

[general]
# Optional server name used in chat prefixes (e.g. "SuperCraft" → "[SuperCraft Essentials]")
# Leave empty to use the default "[Essentials]" prefix
server_name = ""

[homes]
# Enable the /home, /sethome, /delhome commands
enabled = true
# Allow players to have multiple named homes
multiple_homes = false
# Maximum homes per player (only used when multiple_homes = true)
max_homes = 5
# Require OP (level 2) for home commands, ignoring LuckPerms nodes
op_only = false
# Seconds the player must stand still before being teleported (0 = instant)
warmup_seconds = 5
# Seconds before the player can use /home again (0 = no cooldown)
cooldown_seconds = 60

[back]
# Enable the /back command
enabled = true
# Require OP (level 2) for /back
op_only = true
warmup_seconds = 5
cooldown_seconds = 60

[tpa]
# Enable the /tpa, /tpaaccept, /tpadeny commands
enabled = true
# Seconds before a TPA request expires
timeout_seconds = 60
# Warmup after the request is accepted (0 = instant)
warmup_seconds = 5
# Seconds before the requester can send another TPA (0 = no cooldown)
cooldown_seconds = 30

[warps]
# Enable the /warp, /setwarp, /delwarp, /warps commands
enabled = true
# Require OP (level 2) to use /warp (set/delete always require OP)
op_only = false
warmup_seconds = 5
cooldown_seconds = 60

[spawn]
# Enable the /spawn command
enabled = true
# Require OP (level 2) to use /spawn
op_only = false
warmup_seconds = 5
cooldown_seconds = 60

[enderchest]
# Enable the /enderchest (/ec) command
enabled = true
# Require OP (level 2) to use /enderchest
op_only = true

[workbench]
# Enable the /workbench (/craft) command
enabled = true
# Require OP (level 2) to use /workbench
op_only = true

[other]
# Require OP (level 2) to use /near
near_op_only = true
# Require OP (level 2) to use /seen
seen_op_only = true

---

Commands

Use /essentials [page] in-game to see only the commands available to you.

Teleport

Command	Description	Permission node	Default
/home [name]	Teleport to your home	rift_essentials.command.home	all players
/sethome [name]	Set a home at your location	rift_essentials.command.home.set	all players
/delhome [name]	Delete a home	rift_essentials.command.home.delete	all players
/homes	List all your homes	rift_essentials.command.home.list	all players
/back	Return to your previous location or death spot	rift_essentials.command.back	OP
/spawn	Teleport to world spawn	rift_essentials.command.spawn	all players
/warp <name>	Teleport to a server warp	rift_essentials.command.warp	all players
/warps	List all server warps	rift_essentials.command.warp	all players
/setwarp <name>	Create a warp at your location	rift_essentials.command.warp.manage	OP
/delwarp <name>	Delete a warp	rift_essentials.command.warp.manage	OP
/tpa <player>	Request to teleport to a player	rift_essentials.command.tpa	all players
/tpaaccept <player>	Accept a teleport request	rift_essentials.command.tpa.respond	all players
/tpadeny <player>	Deny a teleport request	rift_essentials.command.tpa.respond	all players
/tppos <x> <y> <z>	Teleport to coordinates (supports ~)	rift_essentials.command.tppos	OP
/tphere <player>	Teleport a player to your location	rift_essentials.command.tphere	OP

Social

Command	Description	Permission node	Default
/msg <player> <msg>	Send a private message	rift_essentials.command.msg	all players
/tell <player> <msg>	Alias for /msg	rift_essentials.command.msg	all players
/r <message>	Reply to the last private message received	rift_essentials.command.msg	all players
/afk	Toggle AFK status	rift_essentials.command.afk	all players
/near [radius]	List players within N blocks (default 100)	rift_essentials.command.near	all players
/seen <player>	Show when a player was last online	rift_essentials.command.seen	all players
/nick <name|off>	Set or clear your display nickname	rift_essentials.command.nick	OP
/broadcast <msg>	Announce to all players	rift_essentials.command.broadcast	OP
/bc <msg>	Alias for /broadcast	rift_essentials.command.broadcast	OP

Utility

Command	Description	Permission node	Default
/heal [player]	Restore health and remove all effects	rift_essentials.command.heal / .heal.other	OP
/feed [player]	Restore hunger and saturation	rift_essentials.command.feed / .feed.other	OP
/fly [player]	Toggle flight ability	rift_essentials.command.fly / .fly.other	OP
/god [player]	Toggle invincibility	rift_essentials.command.god / .god.other	OP
/repair	Repair the item in your main hand	rift_essentials.command.repair	OP
/workbench	Open a crafting table anywhere	rift_essentials.command.workbench	all players
/craft	Alias for /workbench	rift_essentials.command.workbench	all players
/enderchest	Open your ender chest anywhere	rift_essentials.command.enderchest	all players
/ec	Alias for /enderchest	rift_essentials.command.enderchest	all players

Admin

Command	Description	Default
/essentials reload	Reload config without restarting	OP
/essentials [page]	Show commands available to you	all players

---

Warmup & Cooldowns

Teleport commands support configurable warmup timers and cooldowns. Set either to 0 to disable.

During warmup:

• A countdown message is displayed
• Moving to a different block cancels the teleport
• Taking damage cancels the teleport

Cooldowns begin only after a successful teleport.

---

Persistence

All player data is saved to <world>/data/rift_essentials.dat (standard Minecraft NBT SavedData). Saves automatically with the world. Includes:

• Homes and server warps
• Previous locations (/back)
• Nicknames
• Last-seen timestamps and username index (for offline /seen lookups)

---

Full Permission Node Reference

rift_essentials.command.home
rift_essentials.command.home.set
rift_essentials.command.home.delete
rift_essentials.command.home.list
rift_essentials.command.back
rift_essentials.command.spawn
rift_essentials.command.warp
rift_essentials.command.warp.manage
rift_essentials.command.tpa
rift_essentials.command.tpa.respond
rift_essentials.command.tppos
rift_essentials.command.tphere
rift_essentials.command.msg
rift_essentials.command.afk
rift_essentials.command.near
rift_essentials.command.seen
rift_essentials.command.nick
rift_essentials.command.broadcast
rift_essentials.command.heal
rift_essentials.command.heal.other
rift_essentials.command.feed
rift_essentials.command.feed.other
rift_essentials.command.fly
rift_essentials.command.fly.other
rift_essentials.command.god
rift_essentials.command.god.other
rift_essentials.command.repair
rift_essentials.command.workbench
rift_essentials.command.enderchest