?️ 基础命令
一个轻量级、跨平台(Fabric + NeoForge)的 Minecraft 基础功能模组。作为 EssentialsX / FTBEssentials 的无依赖替代方案而开发。
我创建这个模组是因为找不到轻量级的替代品。该模组旨在仅添加必要的命令,不包含多余的功能。
支持 LuckPerms 以实现细粒度的权限控制。如果未安装 LuckPerms,则回退到原版 OP 等级。
配置
首次启动时生成于 config/essential.commands.toml。可通过 /essentials reload 在运行时重载配置。
# Essential Commands Configuration
[general]
# 可选的服务器名称,用于聊天前缀(例如 "SuperCraft" → "[SuperCraft Essentials]")
# 留空则使用默认前缀 "[Essentials]"
server_name = ""
[homes]
# 启用 /home, /sethome, /delhome 命令
enabled = true
# 允许玩家拥有多个命名家园
multiple_homes = false
# 每位玩家的最大家园数量(仅在 multiple_homes = true 时生效)
max_homes = 5
# 强制要求 OP(2 级)才能使用家园相关命令,忽略 LuckPerms 节点
op_only = false
# 玩家必须静止站立多少秒后才能传送(0 = 瞬间传送)
warmup_seconds = 5
# 玩家再次使用 /home 之前需要等待的秒数(0 = 无冷却时间)
cooldown_seconds = 60
[back]
# 启用 /back 命令
enabled = true
# 强制要求 OP(2 级)才能使用 /back
op_only = true
warmup_seconds = 5
cooldown_seconds = 60
[tpa]
# 启用 /tpa, /tpaaccept, /tpadeny 命令
enabled = true
# TPA 请求过期的秒数
timeout_seconds = 60
# 请求被接受后的预热时间(0 = 瞬间传送)
warmup_seconds = 5
# 请求者发送另一个 TPA 请求前需要等待的秒数(0 = 无冷却时间)
cooldown_seconds = 30
[warps]
# 启用 /warp, /setwarp, /delwarp, /warps 命令
enabled = true
# 强制要求 OP(2 级)才能使用 /warp(设置和删除始终需要 OP)
op_only = false
warmup_seconds = 5
cooldown_seconds = 60
[spawn]
# 启用 /spawn 命令
enabled = true
# 强制要求 OP(2 级)才能使用 /spawn
op_only = false
warmup_seconds = 5
cooldown_seconds = 60
[enderchest]
# 启用 /enderchest (/ec) 命令
enabled = true
# 强制要求 OP(2 级)才能使用 /enderchest
op_only = true
[workbench]
# 启用 /workbench (/craft) 命令
enabled = true
# 强制要求 OP(2 级)才能使用 /workbench
op_only = true
[other]
# 强制要求 OP(2 级)才能使用 /near
near_op_only = true
# 强制要求 OP(2 级)才能使用 /seen
seen_op_only = true
命令
在游戏中使用 /essentials [page] 查看你可用的命令列表。
传送
| 命令 |
描述 |
权限节点 |
默认权限 |
/home [name] |
传送到你的家园 |
rift_essentials.command.home |
所有玩家 |
/sethome [name] |
在当前地点设置家园 |
rift_essentials.command.home.set |
所有玩家 |
/delhome [name] |
删除一个家园 |
rift_essentials.command.home.delete |
所有玩家 |
/homes |
列出所有你的家园 |
rift_essentials.command.home.list |
所有玩家 |
/back |
返回上一个位置或死亡地点 |
rift_essentials.command.back |
OP |
/spawn |
传送到世界出生点 |
rift_essentials.command.spawn |
所有玩家 |
/warp <name> |
传送到服务器传送点 |
rift_essentials.command.warp |
所有玩家 |
/warps |
列出所有服务器传送点 |
rift_essentials.command.warp |
所有玩家 |
/setwarp <name> |
在当前地点创建一个传送点 |
rift_essentials.command.warp.manage |
OP |
/delwarp <name> |
删除一个传送点 |
rift_essentials.command.warp.manage |
OP |
/tpa <player> |
请求传送到某位玩家 |
rift_essentials.command.tpa |
所有玩家 |
/tpaaccept <player> |
接受传送请求 |
rift_essentials.command.tpa.respond |
所有玩家 |
/tpadeny <player> |
拒绝传送请求 |
rift_essentials.command.tpa.respond |
所有玩家 |
/tppos <x> <y> <z> |
传送到坐标(支持 ~) |
rift_essentials.command.tppos |
OP |
/tphere <player> |
将某位玩家传送到你的位置 |
rift_essentials.command.tphere |
OP |
社交
| 命令 |
描述 |
权限节点 |
默认状态 |
/msg <玩家> <消息> |
发送私聊消息 |
rift_essentials.command.msg |
所有玩家 |
| /tell <player> <msg> | /msg 的别名 | rift_essentials.command.msg | 所有玩家 |
| /r <message> | 回复最后收到的私人消息 | rift_essentials.command.msg | 所有玩家 |
| /afk | 切换 AFK 状态 | rift_essentials.command.afk | 所有玩家 |
| /near [radius] | 列出 N 格内的玩家(默认 100) | rift_essentials.command.near | 所有玩家 |
| /seen <player> | 显示某玩家上次在线的时间 | rift_essentials.command.seen | 所有玩家 |
| /nick <name\|off> | 设置或清除你的显示昵称 | rift_essentials.command.nick | OP |
| /broadcast <msg> | 向所有玩家广播消息 | rift_essentials.command.broadcast | OP |
| /bc <msg> | /broadcast 的别名 | rift_essentials.command.broadcast | OP |
工具
| 命令 |
描述 |
权限节点 |
默认值 |
/heal [玩家] |
恢复生命值并移除所有状态效果 |
rift_essentials.command.heal / .heal.other |
OP |
/feed [玩家] |
恢复饥饿值和饱和度 |
rift_essentials.command.feed / .feed.other |
OP |
/fly [玩家] |
切换飞行能力 |
rift_essentials.command.fly / .fly.other |
OP |
/god [玩家] |
切换无敌模式 |
rift_essentials.command.god / .god.other |
OP |
/repair |
修复主手物品 |
rift_essentials.command.repair |
OP |
/workbench |
在任何位置打开工作台 |
rift_essentials.command.workbench |
所有玩家 |
/craft |
/workbench 的别名 |
rift_essentials.command.workbench |
所有玩家 |
/enderchest |
在任何位置打开末影箱 |
rift_essentials.command.enderchest |
所有玩家 |
/ec |
/enderchest 的别名 |
rift_essentials.command.enderchest |
所有玩家 |
管理员
| 命令 |
描述 |
默认值 |
/essentials reload |
重新加载配置而不重启服务器 |
OP |
/essentials [页码] |
显示你可用的命令列表 |
所有玩家 |
预热与冷却时间
传送命令支持可配置的预热计时器和冷却时间。将任意一项设置为 0 即可禁用。
在预热期间:
- 会显示倒计时消息
- 移动到不同的方块取消传送
- 受到伤害取消传送
冷却时间仅在传送成功后开始计算。
数据持久化
所有玩家数据均保存至 <world>/data/rift_essentials.dat(标准 Minecraft NBT SavedData)。随世界自动保存。包括:
- 家园和服务器传送点
- 上次位置(
/back)
- 昵称
- 最后上线时间与用户名索引(用于离线状态的
/seen 查询)
完整权限节点参考
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
?️ 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧