EssentialsC/README.md

EssentialsC

一个轻量级的 Paper 服务器核心插件，灵感来自 CMI，但更加精简、易用且现代化。

✨ 功能特性

🎯 随身功能方块

随时随地打开各种功能性方块，无需放置实体方块：

• 工作台 (/workbench)
• 铁砧 (/anvil)
• 附魔台 (/enchantingtable)
• 制图台 (/cartographytable)
• 砂轮 (/grindstone)
• 织布机 (/loom)
• 锻造台 (/smithingtable)
• 切石机 (/stonecutter)

🔧 实用工具

• 末影箱 (/enderchest) - 随时访问末影箱
• 帽子 (/hat) - 将手中物品戴在头上
• 自杀 (/suicide) - 快速自杀
• 飞行 (/fly) - 切换飞行模式

💚 生存辅助

• 治疗 (/heal) - 恢复生命值和饱食度
• 隐身 (/vanish) - 管理员隐身模式

📊 管理功能

• 玩家查询 (/seen) - 查看玩家上线时间和信息
• 管理菜单 (/admin) - 可视化 GUI 管理面板
  • 时间/天气控制
  • 快捷状态恢复
  • 插件重载

🌍 多语言支持

• 完整的中文和英文配置
• 方块标题自动跟随客户端语言
• 可自定义所有消息文本

⚡ 权限控制

• 精细的权限管理系统
• 帮助菜单智能显示（只显示有权限的命令）
• 默认仅 OP 可用，可通过权限插件授权

📦 安装

要求

• Paper 1.21+ 服务器
• Java 21+

步骤

1. 下载最新版本的 essentialsc-*.jar
2. 将文件放入服务器的 plugins 文件夹
3. 重启服务器
4. 编辑 plugins/EssentialsC/config.yml 配置语言
5. （可选）使用权限插件为玩家授予相应权限

🎮 命令

基础命令

/essc help          # 显示帮助菜单（根据权限动态显示）

功能方块命令

/workbench          # 打开工作台
/anvil              # 打开铁砧
/enchantingtable    # 打开附魔台
/cartographytable   # 打开制图台
/grindstone         # 打开砂轮
/loom               # 打开织布机
/smithingtable      # 打开锻造台
/stonecutter        # 打开切石机
/enderchest         # 打开末影箱

其他命令

/hat                # 将手中物品戴在头上
/suicide            # 自杀
/fly                # 切换飞行模式
/heal               # 恢复生命值和饱食度
/vanish             # 切换隐身模式（管理员）
/seen <玩家>        # 查看玩家信息（管理员）
/admin              # 打开管理菜单（管理员）

命令别名

• /essentialsc = /essc

⚙️ 配置

config.yml

# 语言设置
# 可用语言: en_US, zh_CN
language: "zh_CN"

# 通用设置
settings:
  # 启用或禁用命令反馈消息
  enable-feedback: true
  
  # 所有插件消息的前缀
  message-prefix: "&6[EssentialsC] &r"

自定义语言

编辑 plugins/EssentialsC/lang/ 目录下的语言文件来自定义所有消息文本。

🔐 权限节点

所有命令默认需要 OP 权限。使用权限插件（如 LuckPerms）授予权限：

essentialsc.command.workbench         # 工作台
essentialsc.command.anvil             # 铁砧
essentialsc.command.enchantingtable   # 附魔台
essentialsc.command.cartographytable  # 制图台
essentialsc.command.grindstone        # 砂轮
essentialsc.command.loom              # 织布机
essentialsc.command.smithingtable     # 锻造台
essentialsc.command.stonecutter       # 切石机
essentialsc.command.enderchest        # 末影箱
essentialsc.command.hat               # 帽子
essentialsc.command.suicide           # 自杀
essentialsc.command.fly               # 飞行
essentialsc.command.heal              # 治疗
essentialsc.command.vanish            # 隐身
essentialsc.command.seen              # 玩家查询
essentialsc.command.admin             # 管理菜单
essentialsc.command.help              # 帮助（默认开放）
essentialsc.*                         # 所有权限

示例：使用 LuckPerms 授权

# 给单个玩家授权
/lp user <玩家名> permission set essentialsc.command.workbench true

# 给用户组授权
/lp group vip permission set essentialsc.command.workbench true

# 授权所有命令
/lp group admin permission set essentialsc.* true

🔨 构建

从源代码构建插件：

git clone https://github.com/Coldsmiles/EssentialsC.git
cd EssentialsC
mvn clean package

编译后的文件位于 target/essentialsc-*.jar

📝 开发计划

• 冷却时间系统
• 更多管理功能
• 数据统计
• API 支持

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

👨‍💻 作者

Coldsmiles_7

• GitHub: @Coldsmiles
• 网站: www.infstar.cn

⭐ 支持

如果觉得这个插件对你有帮助，请考虑在 GitHub 上给它一个 Star！