插件概述
什么是 Codex？
Codex 是一款专为 Minecraft RPG 服务器设计的发现与图鉴插件。它通过多样化的触发机制，让玩家在游戏过程中自然地收集和解锁各种发现条目，从而增强游戏的沉浸感和探索乐趣。
核心理念
- 自然发现：玩家通过正常游戏行为（击杀怪物、获取物品、探索区域）来解锁发现
- 丰富奖励：每次发现都有相应的奖励，包括经验、物品、标题、音效等
- 深度集成：与主流插件无缝整合，扩展发现的可能性
- 可视化收集：美观的GUI界面展示收集进度和详细信息
主要功能特性
🔍 发现系统
- 支持多种触发器：物品获取、指令执行、生物击杀、区域进入等
- 智能物品识别：支持原版物品、自定义模型、NBT数据等
- 灵活的触发条件：可组合多种判定条件
📚 自动图鉴
- 附魔图鉴：自动记录所有发现的附魔
- 钓鱼图鉴：与CustomFishing集成，记录鱼类数据
- 作物图鉴：与CustomCrops集成，追踪农作物信息
- 世界历史：收集RPG世界的背景故事
🔗 第三方集成
- 物品插件：ItemsAdder, MMOItems, Craft-Engine
- 附魔插件：Aiyatsbus, EcoEnchants
- 其他插件：WorldGuard, MythicMobs, EliteMobs, Residence
🛠️ 数据存储
- YAML文件：简单易用，适合小型服务器
- H2数据库：高性能嵌入式数据库，无需额外配置
- MySQL数据库：支持跨服数据同步
系统要求
服务器要求
- Minecraft版本：1.13+ (推荐1.20+)
- 服务器核心：Paper, Spigot (推荐Paper)
- Java版本：Java 8+
- 内存要求：最少512MB可用内存
依赖插件
- 必需：无（插件可独立运行）
- 可选：
- PlaceholderAPI（变量支持）
- WorldGuard（区域触发）
- ItemsAdder（自定义物品）
- MMOItems（自定义物品）
- Aiyatsbus（自定义附魔）
- CustomFishing（钓鱼图鉴）
- CustomCrops（作物图鉴）
性能特点
- 轻量级：优化的代码设计，最小化性能影响
- 异步处理：数据库操作和文件IO均异步执行
- 智能缓存：减少重复计算和数据库查询
- 内存管理：自动清理不在线玩家的数据
兼容性
Minecraft版本兼容性
| Minecraft版本 | 支持状态 | 备注 |
|---|---|---|
| 1.21.x | ✅ 完全支持 | 推荐版本 |
| 1.20.x | ✅ 完全支持 | 稳定支持 |
| 1.19.x | ✅ 完全支持 | 稳定支持 |
| 1.18.x | ✅ 完全支持 | 稳定支持 |
| 1.17.x | ✅ 完全支持 | 稳定支持 |
| 1.16.x | ✅ 部分支持 | 部分新特性不可用 |
| 1.15.x | ✅ 部分支持 | 部分新特性不可用 |
| 1.14.x | ✅ 基础支持 | 仅基础功能 |
| 1.13.x | ✅ 基础支持 | 仅基础功能 |
| 1.12.x 及以下 | ❌ 不支持 | - |
服务器核心兼容性
| 服务器核心 | 支持状态 | 性能 | 推荐程度 |
|---|---|---|---|
| Paper | ✅ 完全支持 | 优秀 | 🌟🌟🌟🌟🌟 |
| Spigot | ✅ 完全支持 | 良好 | 🌟🌟🌟🌟 |
| Bukkit | ✅ 基础支持 | 一般 | 🌟🌟🌟 |
| 其他分支 | 🔶 可能支持 | 未知 | 🌟🌟 |
下一步
准备好开始使用 Codex 了吗？请继续阅读：