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

这个插件是一个面向 SMP 的轻量级 Essentials 风格整合插件，覆盖实体、玩家、Tablist、计分板、隐身与占位符等常用功能。

🎮基本信息

• 支持版本：26.2
• Java：25
• 依赖：
• Vault
• PlaceholderAPI

✨安装

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

⭐功能简介

• 为什么我把这个插件命名为 Essentials？
• 实体设置：非常小巧，但对 SMP 很高效
• 玩家功能：例如家园与经济
• Tablist：支持 LuckPerms 权重
• Scoreboard
• Vanish：允许对玩家隐身
• Placeholders

❓API

• Documentation

❓Placeholders

占位符代码（YAML）

• offlineName: %essentials_name%
• nickname or offlineName: %essentials_display_name%
• balance: %essentials_account%
• bank-name: %essentials_bank_name%
• bank-name: %essentials_bank_account%
• pvp: %essentials_pvp%
• homes-max: %essentials_homes_max%
• homes-size: %essentials_homes_size%
• homes-left: %essentials_homes_left%
• vanished: %essentials_vanished%
• online-players-minus-vanished: %essentials_online_players%
• health: %essentials_health%
• walk-speed: %essentials_walk_speed%
• fly-speed: %essentials_fly_speed%
• is-flying: %essentials_is_flying%
• is-invulnerable: %essentials_is_invulnerable%
• has-passenger: %essentials_has_passenger%
• is-inside-vehicle: %essentials_is_inside_vehicle%
• is-sleeping: %essentials_is_sleeping%
• is-whitelisted: %essentials_is_whitelisted%
• is-collidable: %essentials_is_collidable%
• is-sprinting: %essentials_is_sprinting%
• is-sneaking: %essentials_is_sneaking%
• locale: %essentials_locale%
• ping: %essentials_ping%
• world-name: %essentials_world_name%
• world-seed: %essentials_world_seed%
• world-environment: %essentials_world_environment%

💡Commands

说明

• 所有命令的 usage 均为 /help
• 所有命令的无权限提示均为：You do not have the permissions to execute the command

命令列表

• /announcement：公告服务器
• 权限：essentials.command.announcement
• /anvil：通过命令打开铁砧
• 权限：essentials.command.anvil
• /back：返回到最近一次位置或死亡地点
• 权限：essentials.command.back
• /balance：查询余额/排行榜
• 权限：essentials.command.balance
• 别名：bal
• /ban：封禁目标
• 权限：essentials.command.ban
• /bank：查询银行/排行榜，或提取/存入
• 权限：essentials.command.bank
• /cartography：通过命令打开制图台
• 权限：essentials.command.cartography
• /color：查看颜色代码
• 权限：essentials.command.color
• /delhome：删除家园
• 权限：essentials.command.delhome
• /delwarp：删除传送点
• 权限：essentials.command.delwarp
• /eco：修改玩家经济
• 权限：essentials.command.eco
• /enchant：为手持物品附魔
• 权限：essentials.command.enchant
• /enchanting：通过命令打开附魔台
• 权限：essentials.command.enchanting
• /enderchest：通过命令打开末影箱
• 权限：essentials.command.enderchest
• /entity：实体设置
• 权限：essentials.command.entity
• /essentials：Essentials 主命令
• 权限：essentials.command.essentials
• 别名：ess
• /feed：通过命令恢复饥饿值
• 权限：essentials.command.feed
• /fly：切换飞行
• 权限：essentials.command.fly
• /flyspeed：修改飞行速度
• 权限：essentials.command.flyspeed
• /freeze：冻结玩家
• 权限：essentials.command.freeze
• /gamemode：修改游戏模式
• 权限：essentials.command.gamemode
• /give：给予物品
• 权限：essentials.command.give
• /gma：切换为冒险模式
• 权限：essentials.command.gamemode.adventure
• /gmc：切换为创造模式
• 权限：essentials.command.gamemode.creative
• /gms：切换为生存模式
• 权限：essentials.command.gamemode.survival
• /gmsp：切换为旁观模式
• 权限：essentials.command.gamemode.spectator
• /grindstone：通过命令打开砂轮
• 权限：essentials.command.grindstone
• /hat：通过命令更换头饰
• 权限：essentials.command.hat
• /heal：通过命令恢复生命值
• 权限：essentials.command.heal
• /help：查看配置中的帮助列表
• 权限：essentials.command.help
• /home：传送回家
• 权限：essentials.command.home
• /homes：查看家园
• 权限：essentials.command.homes
• /information：查看玩家信息
• 权限：essentials.command.information
• /inventory：查看玩家背包
• 权限：essentials.command.inventory
• /jail：切换监禁
• 权限：essentials.command.jail
• /kit：礼包命令
• 权限：essentials.command.kit
• /loom：通过命令打开织布机
• 权限：essentials.command.loom
• /motd：查看 MOTD
• 权限：essentials.command.motd
• /mute：禁言玩家
• 权限：essentials.command.mute
• /nickname：修改昵称
• 权限：essentials.command.nickname
• /pay：向他人付款
• 权限：essentials.command.pay
• /portal：创建传送门
• 权限：essentials.command.portal
• /pvp：切换 PvP
• 权限：essentials.command.pvp
• /repair：修复手持物品
• 权限：essentials.command.repair
• /respond：回复私聊
• 权限：essentials.command.respond
• 别名：r
• /rtp：随机传送
• 权限：essentials.command.rtp
• /rules：查看规则
• 权限：essentials.command.rules
• /sell：出售物品
• 权限：essentials.command.sell
• /sethome：设置家园
• 权限：essentials.command.sethome
• /setjail：设置监禁点
• 权限：essentials.command.setjail
• /setspawn：设置出生点
• 权限：essentials.command.setspawn
• /setwarp：设置传送点
• 权限：essentials.command.setwarp
• /setworth：设置手持物品价值
• 权限：essentials.command.setworth
• /skull：头颅命令
• 权限：essentials.command.skull
• /smithing：通过命令打开锻造台
• 权限：essentials.command.smithing
• /spawn：传送到出生点
• 权限：essentials.command.spawn
• /stonecutter：通过命令打开切石机
• 权限：essentials.command.stonecutter
• /store：通过命令打开 stonecutter
• 权限：essentials.command.store
• /tpaccept：tpaccept
• 权限：essentials.command.tpaccept
• /tpa：tpa
• 权限：essentials.command.tpa
• /tpahere：tpahere
• 权限：essentials.command.tpahere
• /tpcancel：tpcancel
• 权限：essentials.command.tpcancel
• /tp：tp
• 权限：essentials.command.tp
• /tpdeny：tpdeny
• 权限：essentials.command.tpdeny
• /tphere：tphere
• 权限：essentials.command.tphere
• /unban：解除封禁
• 权限：essentials.command.unban
• /vanish：隐身
• 权限：essentials.command.vanish
• /walkspeed：行走速度
• 权限：essentials.command.walkspeed
• /warp：传送点
• 权限：essentials.command.warp
• /whisper：私聊
• 权限：essentials.command.whisper
• /workbench：工作台
• 权限：essentials.command.workbench
• /world：世界设置
• 权限：essentials.command.world
• /worth：价值
• 权限：essentials.command.worth

💡Permissions

说明

• 以下权限节点的默认值均为 op

命令权限

• essentials.command.announcement：公告服务器
• essentials.command.anvil：通过命令打开铁砧
• essentials.command.anvil.other：为目标打开铁砧
• essentials.command.anvil.exempt：免受他人打开铁砧影响
• essentials.command.back：返回到最近一次位置或死亡地点
• essentials.command.back.death：返回到死亡地点
• essentials.command.back.world.world：返回到最近一次位置
• essentials.command.back.world.world_nether：返回到最近一次位置
• essentials.command.back.world.world_the_end：返回到最近一次位置
• essentials.command.back.other：将目标返回到最近一次位置或死亡地点
• essentials.command.back.exempt：免受返回到最近一次位置或死亡地点影响
• essentials.command.balance：查询余额/排行榜
• essentials.command.balance.top：查询余额/排行榜
• essentials.command.ban：封禁目标
• essentials.command.ban.exempt：免受封禁
• essentials.command.bank：查询银行/排行榜，或提取/存入
• essentials.command.bank.top：查询银行/排行榜，或提取/存入
• essentials.command.bank.withdraw：查询银行/排行榜，或提取/存入
• essentials.command.bank.deposit：查询银行/排行榜，或提取/存入
• essentials.command.cartography：通过命令打开制图台
• essentials.command.cartography.other：为目标打开制图台
• essentials.command.cartography.exempt：免受打开制图台影响
• essentials.command.color：查看颜色代码
• essentials.command.color.other：查看颜色代码
• essentials.command.color.exempt：查看颜色代码
• essentials.command.delhome：删除家园
• essentials.command.delwarp：删除传送点
• essentials.command.eco：修改玩家经济
• essentials.command.enchant：为手持物品附魔
• essentials.command.enchanting：通过命令打开附魔台
• essentials.command.enchanting.other：为目标打开附魔台
• essentials.command.enchanting.exempt：免受打开附魔台影响
• essentials.command.enderchest：通过命令打开末影箱
• essentials.command.enderchest.other：通过命令打开玩家的末影箱
• essentials.command.enderchest.exempt：拒绝打开末影箱
• essentials.command.entity：实体设置
• essentials.command.essentials：Essentials 主命令
• essentials.command.feed：通过命令恢复饥饿值
• essentials.command.feed.other：通过命令恢复目标的饥饿值
• essentials.command.feed.exempt：免受 feed 影响
• essentials.command.fly：切换飞行
• essentials.command.fly.other：切换目标的飞行
• essentials.command.fly.exempt：免受飞行切换影响
• essentials.command.flyspeed：修改飞行速度
• essentials.command.flyspeed.other：修改目标的飞行速度
• essentials.command.flyspeed.exempt：免受飞行速度修改影响
• essentials.command.freeze：冻结玩家
• essentials.command.freeze.exempt：免受冻结影响
• essentials.command.gamemode：gamemode 命令
• essentials.command.gamemode.adventure：切换为冒险模式
• essentials.command.gamemode.creative：切换为创造模式
• essentials.command.gamemode.survival：切换为生存模式
• essentials.command.gamemode.spectator：切换为旁观模式
• essentials.command.gamemode.other：修改目标的游戏模式
• essentials.command.gamemode.exempt：免受他人修改游戏模式影响
• essentials.command.gamemode.notify：通知游戏模式变更
• essentials.command.give：给予物品
• essentials.command.grindstone：通过命令打开砂轮
• essentials.command.grindstone.other：为目标通过命令打开砂轮
• essentials.command.grindstone.exempt：免受砂轮影响
• essentials.command.hat：通过命令更换头饰
• essentials.command.hat.other：通过命令更换目标的头饰
• essentials.command.hat.exempt：免受更换头饰影响
• essentials.command.heal：通过命令恢复生命值
• essentials.command.heal.other：通过命令恢复目标的生命值
• essentials.command.heal.exempt：免受治疗影响
• essentials.command.help：根据配置查看帮助列表
• essentials.command.help.other：根据配置查看帮助列表
• essentials.command.help.exempt：根据配置查看帮助列表
• essentials.command.home：传送回家
• essentials.command.homes：查看家园
• essentials.command.homes.delete：删除目标的家园
• essentials.command.homes.teleport：传送到目标的家园
• essentials.command.information：查看玩家信息
• essentials.command.inventory：查看玩家背包
• essentials.command.inventory.exempt：免受查看玩家背包影响
• essentials.command.jail：切换监禁
• essentials.command.jail.exempt：免受监禁影响
• essentials.command.kit：礼包命令
• essentials.command.kit.starter：礼包命令
• essentials.command.kit.other：礼包命令
• essentials.command.kit.exempt：礼包命令
• essentials.command.loom：通过命令打开织布机
• essentials.command.loom.other：通过命令打开织布机
• essentials.command.loom.exempt：通过命令打开织布机
• essentials.command.motd：查看 MOTD
• essentials.command.motd.other：查看 MOTD
• essentials.command.motd.exempt：查看 MOTD
• essentials.command.mute：禁言玩家
• essentials.command.mute.exempt：禁言玩家
• essentials.command.nickname：修改昵称
• essentials.command.nickname.other：修改昵称
• essentials.command.nickname.exempt：修改昵称
• essentials.command.pay：向他人付款
• essentials.command.portal：创建传送门
• essentials.command.pvp：切换 PvP
• essentials.command.pvp.other：切换 PvP
• essentials.command.pvp.exempt：切换 PvP
• essentials.command.repair：修复手持物品
• essentials.command.repair.force：修复手持物品
• essentials.command.respond：回复私聊
• essentials.command.rtp：随机传送
• essentials.command.rtp.force：随机传送
• essentials.command.rules：查看规则
• essentials.command.rules.other：查看规则
• essentials.command.rules.exempt：查看规则
• essentials.command.sell：出售物品
• essentials.command.sethome：设置家园
• essentials.command.sethome.multiple.default：设置家园
• essentials.command.setjail：设置监禁点
• essentials.command.setspawn：设置出生点
• essentials.command.setwarp：设置传送点
• essentials.command.setworth：设置手持物品价值
• essentials.command.skull：头颅命令
• essentials.command.smithing：通过命令打开锻造台
• essentials.command.smithing.other：为目标通过命令打开锻造台
• essentials.command.smithing.exempt：免受锻造台影响
• essentials.command.spawn：传送到出生点
• essentials.command.spawn.other：为目标传送到出生点
• essentials.command.spawn.exempt：免受传送到出生点影响
• essentials.command.stonecutter：通过命令打开切石机
• essentials.command.stonecutter.other：为目标通过命令打开切石机
• essentials.command.stonecutter.exempt：免受切石机影响
• essentials.command.store：通过命令打开 stonecutter
• essentials.command.store.other：通过命令打开 stonecutter
• essentials.command.store.exempt：通过命令打开 stonecutter
• essentials.command.tpaccept：tpaccept
• essentials.command.tpa：tpa
• essentials.command.tpahere：tpahere
• essentials.command.tpcancel：tpcancel
• essentials.command.tp：tp
• essentials.command.tp.exempt：tp
• essentials.command.tpdeny：tpdeny
• essentials.command.tphere：tphere
• essentials.command.tphere.exempt：tphere
• essentials.command.unban：解除封禁
• essentials.command.vanish：隐身
• essentials.command.walkspeed：行走速度
• essentials.command.warp：传送点
• essentials.command.warp.warpName：传送点
• essentials.command.warp.other：传送点
• essentials.command.warp.exempt：传送点
• essentials.command.whisper：私聊
• essentials.command.workbench：工作台
• essentials.command.workbench.other：工作台
• essentials.command.workbench.exempt：工作台
• essentials.command.world：世界设置
• essentials.command.worth：价值

事件权限

• essentials.event.chat.color：聊天颜色
• essentials.event.block_break.notify：通知破坏方块
• essentials.event.block_place.notify：通知放置方块
• essentials.event.bucket_empty.notify：通知倒出桶
• essentials.event.command.exempt：允许使用已禁用的命令
• essentials.event.death.keep_inventory：死亡后保留物品栏
• essentials.event.death.keep_exp：死亡后保留经验
• essentials.event.join.message：发送加入消息
• essentials.event.join.notify：通知加入事件
• essentials.event.level_change：允许在等级变化时使用粒子和声音
• essentials.event.login.full_sever：允许在满员服务器中加入
• essentials.event.quit.message：发送退出消息
• essentials.event.quit.notify：通知退出事件
• essentials.event.death.location：重生后发送死亡地点
• essentials.event.anvil.color：允许在铁砧中使用颜色代码
• essentials.event.anvil.unsafe：允许在铁砧中不安全地使用附魔
• essentials.event.anvil.safe：允许在铁砧中安全地使用附魔
• essentials.event.sign.color：在告示牌上使用颜色代码

🔧备注

• Permissions 与 Commands 的结构都来自原始 YAML 文档
• 原文中的 permission-message 均为：You do not have the permissions to execute the command
• 原文中的 usage 均为：/help

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 等权限插件，为不同玩家组别分配相应的权限节点。