🛠️ 我的世界插件：CS-CoreLib | 轻量级 Bukkit 插件开发核心库

📜 核心定位与历史背景

🌟 核心特性

1. 基础工具集
   • 反射 API：简化对 Minecraft 内部类的访问（如NMS、CraftBukkit）
   • 配置解析：支持 YAML/JSON 文件的自动加载与验证
   • 本地化系统：内置多语言文本管理模块（Locale）
2. 插件开发辅助
   • 事件监听：提供@EventHandler注解简化事件注册
   • 命令框架：支持子命令嵌套与权限检测（CommandAPI）
   • 任务调度：封装 Bukkit 的BukkitRunnable实现异步操作
3. 兼容性设计
   • 版本适配：兼容 Minecraft 1.8~1.16.5，支持 Spigot/Paper 服务器
   • 依赖管理：通过pom.xml配置 Maven 依赖，支持shade打包

🚧 使用说明与迁移建议

🔧 安装方式

1. 手动安装
   • 下载旧版本 JAR 文件：MC-Plugins.net 存档
   • 将CS-CoreLib.jar放入服务器plugins目录，重启加载
2. 开发依赖
   • 在 Maven 项目中添加仓库与依赖：
     xml

     <repositories>  
       <repository>  
         <id>jitpack.io</id>  
         <url>https://jitpack.io</url>  
       </repository>  
     </repositories>  
     <dependencies>  
       <dependency>  
         <groupId>com.github.TheBusyBiscuit</groupId>  
         <artifactId>CS-CoreLib2</artifactId>  
         <version>0.3.0</version>  
       </dependency>  
     </dependencies>  
     
   • 注意：CS-CoreLib2 为轻量化版本，需通过shade插件整合到最终 JAR 中

⚠️ 替代方案推荐

1. Dough 库优势
   • 支持 Minecraft 1.17+，兼容 Folia 异步架构
   • 模块化设计，可按需引入inventory、command等子模块
   • 提供更完善的 API 文档与社区支持
2. 迁移步骤
   • 修改 Maven 依赖为：
     xml

     <dependency>  
       <groupId>com.github.TheBusyBiscuit</groupId>  
       <artifactId>Dough</artifactId>  
       <version>1.0.0</version>  
     </dependency>  
     
   • 替换旧 API 调用（如ItemStackBuilder改为ItemUtils）
   • 参考Dough 迁移指南调整代码逻辑

📚 典型应用场景

1. 物品合成配方管理

// 使用CS-CoreLib的ItemStackBuilder创建自定义物品  
ItemStack customSword = new ItemStackBuilder(Material.DIAMOND_SWORD)  
  .name("§c神之剑")  
  .lore("§7攻击力+10")  
  .attribute(Attribute.GENERIC_ATTACK_DAMAGE, 10)  
  .build();  

// 注册合成配方  
ShapedRecipe recipe = new ShapedRecipe(customSword)  
  .shape("XXX", " X ", " X ")  
  .setIngredient('X', Material.DIAMOND);  
Bukkit.addRecipe(recipe);  

2. 玩家数据持久化

// 使用CS-CoreLib的PlayerData类存储数据  
PlayerData playerData = new PlayerData(player.getUniqueId());  
playerData.set("kills", playerData.getInt("kills") + 1);  
playerData.save();  

// 读取数据  
int totalKills = playerData.getInt("kills");  

3. 自定义 GUI 界面

// 创建带分页的GUI  
PagedGUI gui = new PagedGUI(6, "商店界面", player);  
gui.addItem(0, new ItemStackBuilder(Material.EMERALD).name("购买").build());  
gui.addNextPageButton(49);  
gui.open();  

❗ 注意事项

1. 版本兼容性
   • CS-CoreLib 仅支持 Minecraft 1.16.5 及以下版本，高版本服务器需使用 Dough 库
   • 部分扩展插件（如 Slimefun 4）已移除对 CS-CoreLib 的依赖
2. 性能影响
   • 旧版本存在内存泄漏问题，建议在生产环境中禁用未使用的模块
   • 多插件依赖时可能引发NoClassDefFoundError，需通过shade排除冲突类
3. 社区支持
   • 官方 Discord 已关闭，可通过Slimefun 社区获取间接帮助
   • GitHub 仓库已归档，仅保留历史版本下载

📖 延伸资源

• 旧版文档：TheBusyBiscuit Wiki（部分内容已失效）
• Dough 库官网：Dough GitHub
• 替代方案对比：Spigot 插件开发基础库推荐