基本命令

🛠️ Essential Commands

一个轻量级、多平台（Fabric + NeoForge）的 Minecraft 基础指令模组。作为 EssentialsX / FTBEssentials 的无依赖替代品而创建。

我构建这个模组是因为找不到一个轻量级的替代品。这个模组旨在只添加必要的基础指令，不包含多余的功能。

支持 LuckPerms 进行细粒度权限控制。未安装 LuckPerms 时回退到原版 OP 等级。

---

配置

首次启动时生成于 config/essential.commands.toml。可在运行时使用 /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

---

指令

在游戏中使用 /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 <player> <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 [player]	恢复生命值并移除所有效果	rift_essentials.command.heal / .heal.other	OP
/feed [player]	恢复饥饿值和饱和度	rift_essentials.command.feed / .feed.other	OP
/fly [player]	切换飞行能力	rift_essentials.command.fly / .fly.other	OP
/god [player]	切换无敌状态	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 [page]	显示你可用的指令	所有玩家

---

传送等待与冷却

传送指令支持可配置的等待计时器和冷却时间。将任一设置为 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