EssCore - 基础核心插件

EssCore 是一款功能全面的 Minecraft 服务器基础插件，它整合了聊天管理、玩家控制、传送系统和经济等日常管理所需的核心功能，并支持 Vault 和 PlaceholderAPI 等主流扩展。

💡重要须知

• 此插件在 1.14 服务器上，告示牌功能将无法使用。
• 插件基于 Java 8 开发，运行需要 Java 8 或更高版本。
• 请注意，该项目目前更新频率较低，未来重大更新的可能性较小。

🎮核心功能

EssCore 提供了丰富的管理工具，涵盖服务器运营的多个方面：

聊天与广播

• 广播全服消息。
• 清理全局或个人聊天记录。
• 在聊天和告示牌中使用颜色代码。
• 自定义聊天格式（支持 PlaceholderAPI）。
• 自定义或隐藏默认的加入/退出消息。

玩家管理

• 查看其他玩家的背包。
• 通过指令打开工作台或末影箱。
• 给予或切换飞行模式。
• 冻结玩家。
• 治疗玩家或恢复饱食度。
• 禁言与解禁玩家。
• 修改玩家显示名称（昵称）。
• 使玩家隐身（Vanish）。

传送与家园

• 设置全局出生点 /spawn。
• 创建传送点（Warp）。
• 设置个人家园（Home）。

游戏模式与经济

• 提供游戏模式切换的快捷指令。
• 完整的虚拟经济系统（需 Vault 支持）。

集成支持

• 完美兼容 Vault 经济系统。
• 支持 clip 的 PlaceholderAPI，用于自定义消息格式。

🔧指令与权限

使用格式：/<指令> : [所需权限]

• esscore.*：拥有所有权限。

经济相关

• /balance : esscore.balance
• /balance <玩家> : esscore.balance.target
• /money : esscore.money
• /pay <玩家> <金额> : esscore.pay

聊天相关

• /broadcast : esscore.broadcast
• /clearchat : esscore.clearchat + esscore.clearchat.global
• /clearchat <玩家> : escore.clearchat.target
• esscore.chat.color：允许在聊天中使用颜色代码。
• esscore.clearchat.ignore：使玩家免疫聊天清理。

玩家工具

• /crafting (或 /workbench, /craftingtable) : esscore.workbench
• /echest [玩家] (或 /enderchest) : esscore.enderchest
• /fly : esscore.fly
• /feed : esscore.feed
• /heal : esscore.heal
• /openinv <玩家> : esscore.openinv

游戏模式

• /gm : esscore.gamemode
• 各模式独立权限：

- 生存模式：`esscore.gamemode.survival`

- 创造模式：`esscore.gamemode.creative`

- 冒险模式：`esscore.gamemode.adventure`

- 旁观模式：`esscore.gamemode.spectator`

• /gm <...> <玩家> : esscore.gamemode.target

家园系统

• /home [名称] : esscore.home
• /homes : esscore.homes
• /sethome <名称> : esscore.sethome
• /delhome <名称> : esscore.delhome

控制与惩罚

• /freeze : esscore.freeze

- `esscore.freeze.bypass`：免疫被冻结。

- `esscore.freeze.force`：可强制冻结（无视 bypass）。

• /mute : esscore.mute

- `esscore.mute.bypass`：免疫被禁言。

- `esscore.mute.force`：可强制禁言（无视 bypass）。

传送与出生点

• /spawn : esscore.spawn
• /setspawn : esscore.setspawn
• /warp : esscore.warp
• /warps : esscore.warps

- 传送到具体 warp 需要权限：`esscore.warps.<warp名称>`

• esscore.warps.*：使用所有 warp。

其他功能

• /nickname : esscore.nickname
• /vanish : esscore.vanish
• esscore.silent：静默加入/退出服务器。

✨配置文件详解

配置文件为 YAML 格式，请勿使用 Tab 缩进，仅使用空格。

全局设置

• nickname-prefix：昵称前缀（例如 ~）。
• max-nick-length：昵称最大长度（含前缀）。
• ignore-nick-colorcodes：计算昵称长度时是否忽略颜色代码。
• allowed-signs：可启用的功能告示牌列表（需取消注释并配置对应权限 esscore.signs.<名称>.create/use）。
• limit-homes：基于权限设置家园数量上限（例如 esscore.sethome.member 对应 3 个家园）。

聊天设置

• allow-color-codes：是否允许所有玩家在聊天中使用颜色代码。
• broadcast-prefix：广播消息的前缀（支持颜色代码）。
• custom-messages：自定义加入/退出消息（使用 %name% 代表玩家名）。
• hide-messages：是否隐藏加入/退出消息。
• chat-format：自定义聊天格式（需包含 {DISPLAYNAME} 和 {MESSAGE}，支持 PlaceholderAPI）。

经济设置 (Vault)

• currency-format：货币显示格式（单数、复数、符号）。
• starting-balance：新玩家初始余额。
• allow-negative-balance：是否允许负余额。
• maximum-negative-balance：最大负余额限制。

杂项设置

• spawn-teleport：设置何种情况下将玩家传送至出生点（首次加入、每次加入、重生时）。
• debug-signs：是否对无权限玩家显示“权限缺失”调试信息。

❓故障排除与支持

• 加载插件出错时，请检查 YAML 配置文件：

- 确保没有使用 Tab，只使用空格缩进。

- 缩进层级必须正确。

- 文本中的英文单引号需转写为两个单引号（如 `don''t`）。

- 包含特殊符号的文本需用引号包裹。

• 如发现漏洞或问题，建议通过私信或 EssCore 的 GitHub 仓库提交报告。
• 请勿修改插件代码并声称是自己的作品。
• 欢迎留下评论和建议，但遇到问题请先联系开发者，而非直接给予差评。

⭐开发计划与状态

（截至 2018年5月12日）

以下为已规划但可能未实现或已废弃的功能

• 上帝模式（已废弃，未来版本可能回归）
• 礼包系统（已废弃）
• 全服禁言
• 临时封禁
• 每日消息 (MOTD)
• 员工指令/模式
• 自定义消息与多语言
• 易于使用的 API

项目状态说明：此插件目前维护活跃度较低，重大更新的可能性很小，但已发布的功能基本稳定可用。