Essentials
一款轻量级的服务端 Fabric 工具包,专为生存服务器和 SMP 设计。Essentials 提供了大多数服务器所需的日常玩家命令和管理工具,且无需客户端模组支持。
仅限服务端: 玩家可以使用未经修改的原版客户端加入游戏。服务端需要安装 Fabric API。
功能特性
玩家便利性
- 使用
/tpa、/tpahere 进行传送请求,支持接受、拒绝、取消以及 /tpahere all
- 完成传送请求后使用
/back 返回
- 持久化的
/spawn 和 /setspawn,包含安全抵达检查、预热时间、冷却时间及可选的首次加入/重生路由
- 基于玩家 UUID 保存的命名
/sethome、/home、/delhome 和 /homes,支持限制、预热时间、冷却时间及安全抵达功能
- 9x3 容量的背包,支持按玩家独立、全服共享或原版末影箱模式
- 一次性使用的 9x3 容量容器,通过
/disposal、/trash 或 /trashcan 访问
服务器管理
- 修复手持物品、治疗或喂食玩家,并切换生存飞行模式
- 查看和编辑库存、末影箱及每个玩家的背包
- 即使玩家离线也能管理其之前的存档数据
- 当多名管理员同时查看同一实时存储时,更改保持同步
- 使用
/vanish 隐藏工作人员,包括实体、标签页列表、命令、公告、怪物及碰撞检测
- 使用
/ping [player] 检查服务器报告的延迟,支持可配置的颜色阈值
- 使用
/tps 监控滚动服务器 TPS,涵盖 5 秒至 15 分钟的窗口期
Moderation(管理)
- 对玩家实施定时或永久封禁,包括离线玩家
- 对 IPv4 和 IPv6 地址实施定时或永久封禁
- 使用
/ban-ip 结合玩家名称,同时封禁在线玩家的账号及其当前 IP
- 踢出玩家时必须提供理由
- 独立解除玩家账号和 IP 地址的封禁
- 使用
/history 或 /audit 查看分页的踢出和封禁历史,包括活跃封禁
封禁时长支持如 30m、2h、7d 和 1d12h 等值。使用 permanent 或 perm 表示永久封禁。IPv6 地址在命令中必须加引号。
命令概览
| 类别 |
命令 |
默认权限 |
| 传送请求 |
/tpa, /tpahere, /tpaccept, /tpdeny, /tpcancel, /back |
所有人 |
| 服务器出生点 |
/spawn |
所有人 |
| 服务器出生点管理 |
/setspawn |
操作员 (OP) |
| 玩家家园 |
/home [name], /sethome [name], /delhome <name>, /homes |
所有人 |
| 玩家储物 |
/backpack (/bp), /disposal (/trash, /trashcan) |
所有人 |
| 玩家实用工具 |
/repair [target], /heal [target], /feed [target], /flight [target] |
操作员 (OP) |
| 服务器状态 |
/ping [player], /tps |
所有人 |
| 库存检查 |
/inventorysee (/isee), /enderchestsee (/esee), /backpacksee (/bpsee) |
操作员 (OP) |
| 玩家管理 |
/ban, /pardon (/unban), /kick, /history (/audit), /vanish |
操作员 (OP) |
| IP 管理 |
/ban-ip (/banip), /pardon-ip (/unban-ip) |
操作员 (OP) |
每个命令组都可以被禁用,或设置为仅操作员可用或对所有玩家开放。配合兼容的 Fabric 权限提供者(如 LuckPerms),稳定的 essentials.<command> 节点可提供细粒度的访问控制;别名共享主命令节点。请参阅 README 获取完整的权限节点表。如果没有权限提供者,commands.<name>.access 将是唯一的访问检查项,行为保持不变。
配置
配置文件生成于 config/essentials/essentials.yaml。修改后需重启服务器生效。
| 选项 |
默认值 |
用途 |
tag.text |
Essentials |
聊天前缀中显示的文本 |
tag.color |
DARK_PURPLE |
使用前缀文本颜色,使用 Minecraft 格式化名称 |
tag.bracketColor |
DARK_GRAY |
前缀括号的颜色 |
tag.bold |
true |
使前缀文本加粗 |
back.window_seconds |
120 |
/back 在 TPA 传送后保持可用的时长 |
backpack.mode |
per_player |
背包类型:per_player(每位玩家独立)、serverwide(全服共享)或 ender_chest(末影箱) |
tpa.timeout_seconds |
60 |
传送请求过期的时间 |
tpa.cooldown_seconds |
10 |
取消传送请求后的冷却时间 |
spawn.first_join |
true |
将首次加入的玩家传送到配置的 Essentials 出生点 |
spawn.respawn |
true |
当没有有效的床、锚或其他个人重生点时,死亡后使用 Essentials 出生点重生 |
spawn.warmup_seconds |
3 |
/spawn 传送前的延迟 |
spawn.cooldown_seconds |
30 |
再次使用 /spawn 前的延迟 |
spawn.cancel_on_movement |
true |
玩家移动时取消待处理的出生点传送 |
spawn.cancel_on_damage |
true |
玩家受到伤害时取消待处理的出生点传送 |
homes.default_limit |
1 |
无数字限制权限时允许设置的家数量 |
homes.maximum_limit |
5 |
计入权重的最高数字家数量限制权限 |
homes.allow_cross_dimension |
true |
允许 /home 跨维度传送 |
homes.warmup_seconds |
3 |
/home 传送前的延迟 |
homes.cooldown_seconds |
30 |
再次使用 /home 前的延迟 |
homes.cancel_on_movement |
true |
玩家移动时取消待处理的家传送 |
homes.cancel_on_damage |
true |
玩家受到伤害时取消待处理的家传送 |
tps.healthy.minimum_tps |
18.0 |
健康 TPS 着色的下限 |
tps.degraded.minimum_tps |
15.0 |
降级 TPS 着色的下限 |
vanish.persist_state |
true |
在重新连接和重启期间保持基于 UUID 的隐身状态 |
vanish.chat_behavior |
block |
阻止公共聊天或将其路由至仅限工作人员可见 |
moderation.ban_message |
包含在生成的配置中 |
用于玩家封禁和 IP 封禁的断开连接消息 |
moderation.kick_message |
包含在生成的配置中 |
用于踢出玩家的断开连接消息 |
updates.enabled |
true |
启动后运行一次异步兼容版本检查 |
updates.channel |
stable_only |
仅接受稳定版本或包含预发布版本 |
updates.console_notifications |
true |
将可用更新记录到服务器控制台 |
updates.player_notifications |
true |
每个会话通知一次已授权的在线玩家 |
updates.request_timeout_seconds |
5 |
网络超时,限制在 2-30 秒之间 |
updates.startup_delay_seconds |
10 |
启动后延迟,限制在 0-300 秒之间 |
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、spawn、setspawn、home、sethome、delhome、homes、backpack、backpacksee、enderchestsee、inventorysee、ban、pardon、banip、pardonip、kick、history、ping 和 tps。
安装
- 在服务器上安装 Fabric Loader 和 Fabric API。
- 将 Essentials JAR 文件放入服务器的
mods 文件夹。
- 启动服务器并根据需要调整
config/essentials/essentials.yaml。
需要 Java 25 或更高版本。无需客户端安装。
Essentials
A lightweight, server-side Fabric toolkit for survival servers and SMPs. Essentials adds the everyday player commands and moderation tools most servers need without requiring a client-side mod.
Server-side only: players can join with an unmodified vanilla client. Fabric API is required on the server.
Features
Player quality of life
- Teleport requests with
/tpa, /tpahere, accept, deny, cancel, and /tpahere all
/back after a completed teleport request
- Persistent
/spawn and /setspawn with safe arrival checks, warm-up, cooldown, and optional first-join/respawn routing
- Named
/sethome, /home, /delhome, and /homes saved by player UUID, with limits, warm-up, cooldown, and safe arrival
- 9x3 backpacks with per-player, shared-server, or vanilla ender chest modes
- A disposable 9x3 inventory with
/disposal, /trash, or /trashcan
Server administration
- Repair held items, heal or feed players, and toggle survival flight
- Inspect and edit inventories, ender chests, and per-player backpacks
- Manage previously joined players even while they are offline
- Changes stay synchronized when multiple admins inspect the same live storage
- Hide staff with
/vanish, including entities, the tab list, commands, announcements, mobs, and collision
- Check server-reported latency with
/ping [player], including configurable color thresholds
- Monitor rolling server TPS with
/tps across 5-second through 15-minute windows
Moderation
- Timed or permanent player bans, including offline players
- Timed or permanent IPv4 and IPv6 bans
- Ban an online player's account and current IP together by using their name with
/ban-ip
- Kick players with a required reason
- Pardon player accounts and IP addresses independently
- View paginated kick and ban history with
/history or /audit, including active bans
Ban durations support values such as 30m, 2h, 7d, and 1d12h. Use permanent or perm for a permanent ban. IPv6 addresses must be quoted in commands.
Command overview
| Area |
Commands |
Default access |
| Teleport requests |
/tpa, /tpahere, /tpaccept, /tpdeny, /tpcancel, /back |
Everyone |
| Server spawn |
/spawn |
Everyone |
| Server spawn administration |
/setspawn |
Operators |
| Player homes |
/home [name], /sethome [name], /delhome <name>, /homes |
Everyone |
| Player storage |
/backpack (/bp), /disposal (/trash, /trashcan) |
Everyone |
| Player utilities |
/repair [target], /heal [target], /feed [target], /flight [target] |
Operators |
| Server status |
/ping [player], /tps |
Everyone |
| Inventory inspection |
/inventorysee (/isee), /enderchestsee (/esee), /backpacksee (/bpsee) |
Operators |
| Player moderation |
/ban, /pardon (/unban), /kick, /history (/audit), /vanish |
Operators |
| IP moderation |
/ban-ip (/banip), /pardon-ip (/unban-ip) |
Operators |
Every command group can be disabled or made available to either operators or all players. With a compatible
Fabric permission provider such as LuckPerms, stable essentials.<command> nodes provide granular access;
aliases share the primary command node. See the README for the complete permission-node table. Without a
provider, commands.<name>.access remains the only access check and behavior is unchanged.
Configuration
The configuration is generated at config/essentials/essentials.yaml. Changes take effect after restarting the server.
| Option |
Default |
Purpose |
tag.text |
Essentials |
Text shown in the chat prefix |
tag.color |
DARK_PURPLE |
Prefix text color using a Minecraft formatting name |
tag.bracketColor |
DARK_GRAY |
Prefix bracket color |
tag.bold |
true |
Makes the prefix text bold |
back.window_seconds |
120 |
How long /back remains available after a TPA teleport |
backpack.mode |
per_player |
Backpack type: per_player, serverwide, or ender_chest |
tpa.timeout_seconds |
60 |
Time before a teleport request expires |
tpa.cooldown_seconds |
10 |
Cooldown after cancelling a teleport request |
spawn.first_join |
true |
Sends first-time players to a configured Essentials spawn |
spawn.respawn |
true |
Uses Essentials spawn after death when no valid bed, anchor, or other personal point exists |
spawn.warmup_seconds |
3 |
Delay before /spawn teleports |
spawn.cooldown_seconds |
30 |
Delay before /spawn can be used again |
spawn.cancel_on_movement |
true |
Cancels a pending spawn teleport when the player moves |
spawn.cancel_on_damage |
true |
Cancels a pending spawn teleport when the player takes damage |
homes.default_limit |
1 |
Homes allowed without a numeric limit permission |
homes.maximum_limit |
5 |
Highest numeric home-limit permission that counts |
homes.allow_cross_dimension |
true |
Allows /home to teleport across dimensions |
homes.warmup_seconds |
3 |
Delay before /home teleports |
homes.cooldown_seconds |
30 |
Delay before /home can be used again |
homes.cancel_on_movement |
true |
Cancels a pending home teleport when the player moves |
homes.cancel_on_damage |
true |
Cancels a pending home teleport when the player takes damage |
tps.healthy.minimum_tps |
18.0 |
Lower bound for healthy TPS coloring |
tps.degraded.minimum_tps |
15.0 |
Lower bound for degraded TPS coloring |
vanish.persist_state |
true |
Keeps UUID-based vanish state across reconnects and restarts |
vanish.chat_behavior |
block |
Blocks public chat or routes it to staff-only visibility |
moderation.ban_message |
Included in generated config |
Disconnect message used for player and IP bans |
moderation.kick_message |
Included in generated config |
Disconnect message used for kicks |
updates.enabled |
true |
Runs one asynchronous compatible-release check after startup |
updates.channel |
stable_only |
Accepts stable releases only or includes prereleases |
updates.console_notifications |
true |
Logs an available update to the server console |
updates.player_notifications |
true |
Notifies authorized online players once per session |
updates.request_timeout_seconds |
5 |
Network timeout, clamped to 2-30 seconds |
updates.startup_delay_seconds |
10 |
Post-start delay, clamped to 0-300 seconds |
commands.<name>.enabled |
true |
Enables or disables a command group |
commands.<name>.access |
op or all |
Restricts the command group to operators or allows everyone |
Moderation messages support Minecraft ampersand formatting codes such as &c and &l.
ban_message: {player}, {reason}, {moderator}, {time}, {expires_at}
kick_message: {player}, {reason}, {moderator}
Available command configuration names include repair, heal, feed, flight, disposal, tpa, back, spawn, setspawn, home, sethome, delhome, homes,
backpack, backpacksee, enderchestsee, inventorysee, ban, pardon, banip, pardonip,
kick, history, ping, and tps.
Installation
- Install Fabric Loader and Fabric API on the server.
- Place the Essentials JAR in the server's
mods folder.
- Start the server and adjust
config/essentials/essentials.yaml as needed.
Requires Java 25 or newer. No client installation is required.
评论 0
登录后参与评分
还没有评论,来抢沙发吧