Skip to content

voxelrift/essentials

Repository files navigation

🛠️ 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

About

This project aims to add essential commands to any Neoforge / Fabric server, in a lightweight, dependency-free manner.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages