一个功能完整、高度可配置的Minecraft修仙系统插件，为您的服务器带来沉浸式的修仙体验。
- 多样化修炼方式：传统打坐 + 盔甲架冥想 + 怪物猎杀
- 智能状态检测：精准识别玩家修炼状态，防止作弊
- 视觉反馈系统：粒子效果 + ActionBar提示 + 音效反馈
- 修仙系统：传统打坐 + 盔甲架冥想 + 怪物猎杀
- 武者系统：战斗训练 + 内力修炼 + 武技掌握
- 智能状态检测：精准识别玩家修炼状态，防止作弊
- 视觉反馈系统：粒子效果 + ActionBar提示 + 音效反馈
- 简体中文 (zh_cn) - 默认语言
- English (en_us) - 英文支持
- 自定义翻译 - 用户可修改语言文件
- 参数化消息 - 支持动态内容替换
- 五重境界：炼气 → 筑基 → 金丹 → 元婴 → 化神
- 细分段位：每个境界包含多个修炼段位
- 渐进式成长：平衡的修为需求曲线
- PlaceholderAPI集成 - 丰富的占位符支持
- 多语言系统 - 简体中文和英文双语支持
- 权限系统 - 完善的权限节点管理
- 配置热重载 - 在线修改配置无需重启
本项目支持GitHub Actions自动构建：
- 每次推送代码自动构建最新版本
- 发布标签时自动创建Release
- 构建产物可在Actions页面下载
# Windows
build-local.bat
# Linux/Mac
./build-local.sh
# 或直接使用Maven
mvn clean package由于ProtocolLib不在标准Maven仓库中, 需要手动安装:
- 从SpigotMC下载 ProtocolLib-5.4.0.jar
- 执行:
mvn install:install-file -Dfile=ProtocolLib-5.4.0.jar -DgroupId=com.comphenix.protocol -DartifactId=ProtocolLib -Dversion=5.4.0 -Dpackaging=jar - 在pom.xml中添加依赖
- 从Release下载：访问 Releases页面 下载最新版本
- 手动构建：克隆仓库后运行
mvn clean package - 将生成的
target/SimpleXiuzhen-*.jar文件放入服务器plugins目录 - 重启服务器或使用
/plugman reload SimpleXiuzhen - 插件将自动生成配置文件
统一命令系统：所有修炼相关功能都使用 /xz 或 /xiuzhen
# 基础命令（推荐使用短别名）
/xz # 查看个人信息和帮助
/xz gui # 打开图形界面
/xz stats # 查看详细状态（修仙 + 武者统一显示）
/xz zt # /xz stats 的短别名
# 修仙系统
/xz meditate # 开始/停止打坐修炼
/xz top # 查看排行榜
/xz info # 了解境界体系
# 武者系统
/xz train # 开始/停止战斗训练
/xz breakthrough # 尝试境界突破
# 功法系统
/xz kungfu list # 查看可用功法
/xz kungfu learn <ID> # 学习功法
/xz kungfu use <ID> # 使用功法
/xz kungfu info <ID> # 查看功法详情/xiuzhen meditate # 开始/停止打坐
- 保持静止获得基础修为
- 移动距离过大将中断修炼
# 生成冥想盔甲架
/summon armor_stand ~ ~ ~ {Invisible:1b,NoBasePlate:1b}- 骑乘盔甲架自动进入冥想状态
- 享受2倍修为增长加成
- 更加舒适自然的修炼体验
- 击杀怪物获得修为奖励
- 不同境界享受不同倍数加成
- 实战中提升修为两不误
| 境界 | 段位示例 | 修为要求 | 特殊能力 |
|---|---|---|---|
| 炼气期 | 一层 → 九层 | 0 → 1000 | 基础修炼 |
| 筑基期 | 初期 → 后期 | 1000+ | 属性提升 |
| 金丹期 | 一转 → 九转 | 5000+ | 战斗加成 |
| 元婴期 | 初婴 → 大婴 | 20000+ | 高级技能 |
| 化神期 | 入神 → 大成 | 100000+ | 神通广大 |
settings:
# 语言设置
language: "zh_cn" # 支持: zh_cn (简体中文), en_us (English)
cultivation:
# 修炼基础设置
base_gain_per_second: 0.05 # 每秒修为增长
move_distance_threshold: 0.5 # 打坐中断距离
# 盔甲架冥想配置
armor_stand_meditation:
enabled: true
multiplier: 2.0 # 修为倍数加成
detection_interval: 10 # 检测频率(ticks)
# 怪物击杀奖励设置
mob_kill:
enabled: true
difficulty_multiplier: 1.0
show_exp_message: true
realm_multipliers:
LianQi: 1.0 # 炼气期倍数
ZhuJi: 1.2 # 筑基期倍数
JinDan: 1.5 # 金丹期倍数
YuanYing: 2.0 # 元婴期倍数
HuaShen: 2.5 # 化神期倍数
# 数据存储配置
data:
storage_type: "YAML" # YAML 或 MYSQL
auto_save_interval_minutes: 5
mysql:
host: "localhost"
port: 3306
database: "simplexiuzhen"
username: "root"
password: "password"# 境界管理
/xiuzhenadmin setxiuzhenrealm <玩家> <境界> # 设置修仙境界
/xiuzhenadmin setwushurealm <玩家> <境界> # 设置武道境界
# 修为调整
/xiuzhenadmin addxiuzhenexp <玩家> <修为值> # 添加修仙修为
/xiuzhenadmin addwushuexp <玩家> <修为值> # 添加武道修为
/xiuzhenadmin addlingli <玩家> <数量> # 添加灵力
/xiuzhenadmin addneili <玩家> <数量> # 添加内力
# 查询命令
/xiuzhenadmin inspect <玩家> # 查看玩家详细信息
/xiuzhenadmin listkungfu <玩家> # 查看玩家功法列表
# 特殊操作
/xiuzhenadmin forcebreakthrough <玩家> <类型> # 强制突破
/xiuzhenadmin clearkungfu <玩家> # 清空功法
/xiuzhenadmin reset <玩家> # 重置数据
# 系统维护
/xiuzhenadmin reloadconfig # 重载配置
/xiuzhenadmin backup # 数据备份
# 命令别名
/xza
/xzadmin📋 完整命令手册：查看 管理员命令文档.md
- Minecraft: Paper 1.20.4 或更高版本
- Java: JDK 17 或更高版本
- 内存: 建议 2GB+ RAM
- 存储: 根据玩家数量决定
- ⚡ 异步数据操作 - 避免主线程阻塞
- 🔄 智能缓存机制 - 减少数据库查询压力
- 🛡️ 连接池管理 - 高效的数据库连接复用
- 📊 实时排行榜 - 高性能排序算法
- ✅ 原生Minecraft - 完全兼容
- ✅ 主流插件 - 与CMI、EssentialsX等兼容
- ✅ 模组环境 - 支持常见模组服务器
| 文档 | 用途 | 适用人群 |
|---|---|---|
| 使用文档.md | 完整使用指南 | 玩家、服主 |
| 开发文档.md | 开发者技术指南 | 开发者 |
| 项目说明.md | 快速入门 | 所有人 |
| AI任务记录.md | 项目开发历程 | 贡献者 |
Q: 插件无法加载 A: 检查Java版本(需17+)和Paper版本兼容性
Q: 数据保存失败 A: 确认配置文件格式正确，检查存储路径权限
Q: 命令无响应
A: 验证玩家权限节点 simplexiuzhen.use
Q: 修炼状态异常 A: 检查配置中的检测参数是否合理
[SimpleXiuzhen] 插件正在启用...
[SimpleXiuzhen] 数据库连接成功
[SimpleXiuzhen] 配置加载完成
[SimpleXiuzhen] 插件已启用！
我们欢迎任何形式的贡献！
- Fork 项目仓库
- 创建功能分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
- 遵循Java命名约定
- 使用中文注释
- 保持代码整洁一致
- 编写单元测试
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情
感谢所有为这个项目做出贡献的开发者和测试者！
让我们一起在Minecraft世界中体验修仙的乐趣！