Essentials Fabric

Essentials

一个轻量级的、服务端的 Fabric 工具包，适用于生存服务器和 SMP。Essentials 添加了大多数服务器所需的日常玩家命令和管理工具，且无需客户端模组。

仅服务端： 玩家可以使用未修改的原版客户端加入。服务器端需要 Fabric API。

功能

玩家体验优化

• 传送请求，支持 /tpa、/tpahere、接受、拒绝、取消，以及 /tpahere all
• 传送请求完成后可使用 /back
• 9x3 背包，支持每位玩家独立、全服共享或原版末影箱模式
• 使用 /disposal、/trash 或 /trashcan 打开一次性的 9x3 物品栏

服务器管理

• 修复手持物品，治疗或喂饱玩家，切换生存飞行
• 查看和编辑物品栏、末影箱以及每位玩家的背包
• 管理曾加入过的玩家，即使他们处于离线状态
• 当多位管理员查看同一个在线存储时，更改会保持同步

玩家管理

• 限时或永久封禁玩家，包括离线玩家
• 限时或永久封禁 IPv4 和 IPv6
• 在 /ban-ip 中使用在线玩家的名称，可同时封禁其账号和当前 IP
• 踢出玩家时必须提供理由
• 独立地赦免玩家账号和 IP 地址
• 使用 /history 或 /audit 查看分页的踢出和封禁历史，包括生效中的封禁

封禁时长支持诸如 30m、2h、7d 和 1d12h 等值。使用 permanent 或 perm 表示永久封禁。IPv6 地址在命令中必须加引号。

命令概览

区域	命令	默认权限
传送请求	/tpa、/tpahere、/tpaccept、/tpdeny、/tpcancel、/back	所有人
玩家存储	/backpack（/bp）、/disposal（/trash、/trashcan）	所有人
玩家实用工具	/repair [目标]、/heal [目标]、/feed [目标]、/flight [目标]	管理员
物品栏查看	/inventorysee（/isee）、/enderchestsee（/esee）、/backpacksee（/bpsee）	管理员
玩家管理	/ban、/pardon（/unban）、/kick、/history（/audit）	管理员
IP 管理	/ban-ip（/banip）、/pardon-ip（/unban-ip）	管理员

每个命令组都可以被禁用，或设置为仅管理员可用或所有人可用。

配置

配置文件生成于 config/essentials/essentials.yaml。更改在重启服务器后生效。

选项	默认值	用途
tag.text	Essentials	聊天前缀中显示的文本
tag.color	DARK_PURPLE	前缀文本颜色，使用 Minecraft 格式名称
tag.bracketColor	DARK_GRAY	前缀括号颜色
tag.bold	true	使前缀文本加粗
back.window_seconds	120	TPA 传送后 /back 保持可用的时长
backpack.mode	per_player	背包类型：per_player、serverwide 或 ender_chest
tpa.timeout_seconds	60	传送请求过期前的时间
tpa.cooldown_seconds	10	取消传送请求后的冷却时间
moderation.ban_message	包含在生成的配置中	用于玩家和 IP 封禁的断开连接消息
moderation.kick_message	包含在生成的配置中	用于踢出的断开连接消息
commands.<name>.enabled	true	启用或禁用某个命令组
commands.<name>.access	op 或 all	将命令组限制为管理员，或允许所有人使用

管理消息支持 Minecraft 的 & 格式代码，例如 &c 和 &l。

• ban_message：{player}、{reason}、{moderator}、{time}、{expires_at}
• kick_message：{player}、{reason}、{moderator}

可用的命令配置名称为 repair、heal、feed、flight、disposal、tpa、back、backpack、backpacksee、enderchestsee、inventorysee、ban、pardon、banip、pardonip、kick 和 history。

安装

1. 在服务器上安装 Fabric Loader 和 Fabric API。
2. 将 Essentials 的 JAR 文件放入服务器的 mods 文件夹。
3. 启动服务器，并根据需要调整 config/essentials/essentials.yaml。

需要 Java 25 或更新版本。无需客户端安装。