Essentials - 基础功能插件（经济/家园等）

Essentials 是一款轻量但功能全面的 Minecraft 服务器管理插件，专为 1.26.1.2 版本设计，整合了实体管理、玩家系统、Tab 列表、计分板、隐身等功能，并支持占位符与权限节点，适合各类生存服务器使用。

💡基本信息

• 支持版本：26.1.2
• Java 版本：25
• 前置依赖：
• Vault
• PlaceholderAPI

✨安装步骤

• 下载最新版插件文件
• 将文件上传至服务端的 plugins 文件夹
• 重启服务器

🎮API 文档

• 官方文档：[Documentation]（请替换为实际链接）
• 提供开发者接口用于扩展功能

🔧为什么叫 Essentials？

• 插件虽小，但足够高效，涵盖生存服务器所需核心功能：
• 实体设置
• 玩家系统（家、经济等）
• Tab 列表（支持 LuckPerms 权重排序）
• 计分板
• 隐身功能（对玩家不可见）

⭐占位符

所有占位符以 %essentials_...% 格式调用，支持 PlaceholderAPI。

玩家信息

• %essentials_name% – 玩家离线名或昵称
• %essentials_display_name% – 显示名称（nickname 或原名）
• %essentials_locale% – 语言环境
• %essentials_ping% – 延迟
• %essentials_health% – 生命值
• %essentials_walk_speed% – 行走速度
• %essentials_fly_speed% – 飞行速度
• %essentials_is_flying% – 是否飞行
• %essentials_is_invulnerable% – 是否无敌
• %essentials_is_sprinting% – 是否疾跑
• %essentials_is_sneaking% – 是否潜行
• %essentials_is_sleeping% – 是否睡觉
• %essentials_is_whitelisted% – 是否在白名单中
• %essentials_is_collidable% – 是否可碰撞
• %essentials_has_passenger% – 是否载有乘客
• %essentials_is_inside_vehicle% – 是否在载具中

经济

• %essentials_account% – 玩家余额
• %essentials_bank_name% – 银行名称
• %essentials_bank_account% – 银行存款

玩家设置

• %essentials_pvp% – PVP 开关状态
• %essentials_vanished% – 是否隐身
• %essentials_homes_max% – 最大家数
• %essentials_homes_size% – 已有家数
• %essentials_homes_left% – 剩余家数

服务器

• %essentials_online_players% – 在线玩家数（排除隐身玩家）
• %essentials_world_name% – 当前世界名称
• %essentials_world_seed% – 世界种子
• %essentials_world_environment% – 世界环境（主世界/下界/末地）

⭐指令列表

所有指令均带有详细的描述、权限节点及用法提示。以下为主要指令分类概览：

玩家系统

• /home – 传送至家
• /sethome – 设置家
• /delhome – 删除家
• /homes – 查看所有家
• /nickname – 设置昵称

经济系统

• /balance（别名：/bal）– 查看余额/排行
• /bank – 银行存取及排行
• /pay – 转账给其他玩家
• /eco – 管理员修改玩家经济
• /sell – 出售物品
• /worth – 查询物品价值
• /setworth – 设置手持物品价值

传送系统

• /spawn – 返回出生点
• /setspawn – 设置出生点
• /warp – 传送至 warp 点
• /setwarp – 设置 warp
• /delwarp – 删除 warp
• /tpa / /tpahere / /tpaccept / /tpdeny / /tpcancel – 传送请求
• /tp / /tphere – 强制传送
• /rtp – 随机传送

玩家管理

• /vanish – 隐身开关
• /fly – 飞行开关
• /flyspeed – 设置飞行速度
• /walkspeed – 设置行走速度
• /feed – 补饱食度
• /heal – 补生命值
• /hat – 将手持物品戴在头上
• /repair – 修复手持物品
• /enchant – 附魔手持物品
• /skull – 获取头颅
• /inventory – 查看其他玩家背包
• /information – 查看玩家信息
• /freeze – 冻结玩家
• /mute – 禁言
• /jail / /setjail – 监禁系统
• /ban / /unban – 封禁/解封

世界与实体

• /entity – 实体设置
• /world – 世界设置
• /portal – 创建传送门

界面工具

• /anvil – 打开铁砧界面
• /cartography – 打开制图台
• /enchanting – 打开附魔台
• /enderchest – 打开末影箱
• /grindstone – 打开砂轮
• /loom – 打开织布机
• /smithing – 打开锻造台
• /stonecutter – 打开切石机
• /workbench – 打开工作台

其他

• /announcement – 服务器公告
• /color – 查看颜色代码
• /help – 帮助菜单（可自定义）
• /motd – 查看 MOTD
• /rules – 查看规则
• /store – 商店链接
• /essentials（别名：/ess）– 主命令
• /give – 给予物品
• /gamemode / /gma / /gmc / /gms / /gmsp – 游戏模式切换
• /kit – 领取礼包
• /back – 返回上次位置或死亡点
• /respond（别名：/r）– 回复私聊
• /whisper – 私聊
• /color – 颜色代码参考

⭐权限节点

所有指令均对应独立的权限节点，格式为 essentials.command.<命令名>。此外还有事件权限、特殊功能权限等。以下为权限结构示例：

基础权限模式

• essentials.command.<command> – 允许使用某指令
• essentials.command.<command>.other – 允许对他人执行
• essentials.command.<command>.exempt – 免除该指令的影响
• essentials.command.<command>.top – 允许查看排行
• essentials.command.<command>.force – 允许强制操作

事件权限

• essentials.event.chat.color – 彩色聊天
• essentials.event.block_break.notify – 破坏方块通知
• essentials.event.block_place.notify – 放置方块通知
• essentials.event.death.keep_inventory – 死亡保留物品
• essentials.event.death.keep_exp – 死亡保留经验
• essentials.event.login.full_server – 服务器满员时允许进入
• essentials.event.command.exempt – 允许使用被禁用的指令
• essentials.event.join.notify – 加入通知
• essentials.event.quit.notify – 退出通知
• essentials.event.anvil.color – 铁砧使用颜色代码
• essentials.event.anvil.unsafe – 铁砧允许非正常附魔
• essentials.event.anvil.safe – 铁砧安全附魔
• essentials.event.sign.color – 告示牌颜色代码
• essentials.event.level_change – 等级变化音效粒子

默认权限组

• 大部分管理员指令默认权限为 op

所有权限节点均可在 permissions 配置段中完整查看，并支持通过权限插件（如 LuckPerms）精细分配。

EssentialsX 是一个功能全面的 Minecraft 服务器插件，它整合了众多基础且实用的功能，旨在简化服务器管理并提升玩家体验。它涵盖了从经济系统、家园传送、工具包到聊天管理和实体控制等各个方面。

💡核心功能

经济与银行系统

• 内置经济系统，支持自定义货币符号（如 €）和格式。
• 玩家银行功能，支持创建、存款、取款和成员管理。
• 银行间可以发送邀请、设置成员等级。

玩家传送与家园

• 设置多个个人家园 (/sethome, /home) 和公共传送点 (/setwarp, /warp)。
• 玩家间传送请求 (/tpa, /tpahere) 系统，带有接受/拒绝机制。
• 随机传送 (/rtp) 功能，可设置冷却时间。
• 所有传送均可配置延迟和取消条件（移动或受伤）。

工具包系统

• 可创建多种工具包（如 starter, food），并设置价格、冷却时间和内含物品。
• 工具包物品支持自定义名称、描述和附魔。

聊天与社交

• 可配置的聊天格式，支持按玩家组别（默认、VIP、管理、隐身、OP）显示不同前缀。
• 私聊 (/whisper, /respond) 和公告 (/announcement) 功能。
• 内置脏话过滤列表。
• 玩家加入/退出消息和音效可自定义。

游戏内工具

• 物品修复 (/repair)。
• 经验与等级管理 (/exp, /lvl)。
• 玩家治疗 (/heal) 和饱食度恢复 (/feed)。
• 飞行模式 (/fly) 和速度调整 (/flyspeed, /walkspeed)。
• 获取玩家头颅 (/skull)。
• 打开各类工作台（铁砧、制图台等）的快捷命令。

管理与惩罚

• 玩家封禁 (/ban) 与解封 (/unban)。
• 禁言 (/mute) 与冻结 (/freeze) 玩家。
• 监狱系统 (/jail, /setjail)。
• 隐身模式 (/vanish)，隐身玩家可潜行拾取物品。
• 查看其他玩家信息 (/information)。

世界与游戏规则

• 设置时间 (/time) 和天气 (/weather)。
• 切换游戏模式 (/gamemode) 和 PVP 状态 (/pvp)。
• 防止耕地、海龟蛋、嗅探兽蛋被踩踏。
• 禁用火焰蔓延、活塞、红石等物理效果（可配置）。
• 控制实体生成和行为（通过 ALLAY.yml 等实体配置文件）。

其他实用功能

• 双段跳功能，可配置粒子与音效。
• 计分板 (scoreboard.yml) 和自定义标签列表 (tablist.yml)。
• 登录提示、每日消息 (MOTD)、规则和商店链接广播。
• 刷怪笼可被精准采集，并显示自定义名称和描述。
• 物品出售 (/sell) 和价值 (/worth) 系统。

🎮配置文件概述

插件通过多个 YAML 文件进行高度自定义。

config.yml

主配置文件，控制插件绝大部分功能开关和参数，例如：

• 经济、银行、家园的基础设置。
• 聊天格式、过滤词。
• 各类命令的冷却时间。
• 双段跳、粒子效果、音效的详细参数。
• 实体清理、投射物移除计时器。
• 登录、退出、死亡等事件的处理方式。

message.yml

全插件所有消息的文本自定义文件，允许服务器管理员完全修改命令反馈、错误提示、事件通知等内容，支持颜色代码和占位符。

kits.yml

定义工具包内容，包括物品类型、数量、名称、描述、附魔和价格。

ALLAY.yml (实体配置文件示例)

用于精细控制特定实体（如悦灵）的生成属性和行为。可以设置：

• 生成几率、生命值、攻击伤害、移动速度、体型等属性的范围。
• 穿戴的装备、手持物品及其掉落几率。
• 实体是否敌对、区块生成上限、是否禁用特定交互或伤害等。

scoreboard.yml 与 tablist.yml

分别用于配置计分板和玩家列表（Tablist）的显示内容、更新频率和世界特定规则。

skulls.yml

存储自定义玩家头颅的 Base64 材质值，用于 /skull 命令。

🔧安装与依赖

前置需求

• 必需插件: Vault。用于与经济、权限、聊天插件挂钩。
• 推荐插件: 一个与 Vault 兼容的权限插件（如 LuckPerms）和经济插件（如 EssentialsX Economy 或其他）。

安装步骤

• 确保服务器已安装 Vault 及相应的经济、权限插件。
• 将 EssentialsX 的 jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 根据生成的配置文件，按需编辑 config.yml, message.yml 等文件。
• 使用 /essentials reload 重载配置（部分核心设置可能需要重启生效）。

✨权限与命令

插件拥有庞大的命令和权限系统。大多数命令都有对应的权限节点，格式通常为 essentials.command.<命令名>（例如 essentials.command.fly）或 essentials.command.<命令名>.others（用于操作他人）。

关键权限示例

• essentials.help - 查看插件帮助。
• essentials.gamemode - 切换游戏模式。
• essentials.home.multiple.<组名> - 设置多个家园（如 essentials.home.multiple.vip）。
• essentials.vanish - 使用隐身模式。
• essentials.ban - 封禁玩家。

建议结合 LuckPerms 等权限插件，为不同玩家组别分配相应的权限节点。