Minecraft Bookshelf 库概览:功能与命令
关于 Minecraft Java Edition 核心库 Bookshelf 的详细技术概览,介绍其高级工具、命令与依赖项。
关于 Minecraft Java Edition 核心库 Bookshelf 的详细技术概览,介绍其高级工具、命令与依赖项。
依赖项:
加载器:Forge / NeoForge / Fabric / Quilt
Minecraft 版本:1.7.10 - 26.2
Bookshelf 模组是开发者 Darkhax 制作的核心库(mod-core),用于简化开发并优化其他模组的运行。它本身不会向游戏中添加新的装饰性书架或其他方块。相反,该库提供了共享的代码框架、内容注册功能以及跨平台事件。使用共享代码可以减少兼容模组中的错误,并降低游戏运行时的系统负载。
面向开发者的核心功能
Bookshelf 库包含一套工具,可简化针对不同加载器的模组开发:
跨平台事件(Events):让开发者只需编写一次代码,即可在 Forge、NeoForge、Fabric 或 Quilt 上运行,无需为每个加载器重写事件处理程序。
扩展编解码器(Codecs):简化游戏内复杂数据对象的序列化与反序列化。
简化注册:减少注册新方块、物品、声音和实体所需的代码量。库提供了单一的注册方法,可自动适配所选运行环境,而无需为每个加载器编写单独的初始化方法(例如 Forge 的 RegistryEvents 或 Fabric 的 Registry)。
数学计算:提供现成的公式,用于计算玩家经验值、处理颜色以及操作字体。
面向数据包作者与玩家的工具
尽管 Bookshelf 主要是作为核心库开发的,但它也为服务器管理员和数据包作者提供了一些实用功能:
调试命令
/bookshelf hand:显示你手持物品的详细信息。该命令会直接在聊天框中输出物品的技术名称、耐久等级、标签以及 NBT 数据。它还会自动将生成的物品 JSON 代码复制到剪贴板,方便数据包作者无需手动输入冗长的代码,即可立即将其粘贴到合成配方或战利品表中。/bookshelf font:允许你设置和更改游戏中文本元素的字体。你可以为书本、告示牌或用户界面应用不同的显示样式,帮助在服务器或冒险地图中营造独特的氛围。
扩展配方功能
该库允许在数据包中使用独特的合成条件。例如,你可以创建消耗工具耐久度而不是完全摧毁物品的配方(例如使用锤子来粉碎材料)。
请始终下载与所选加载器(Forge、Fabric 等)相匹配的 Bookshelf 文件。安装错误的版本会导致游戏启动时发生严重错误。
安装
一次典型安装大约 5 分钟。流程相同,只是 Loader 和对应构建不同。
- 1Install a mod loader (Forge, Fabric or NeoForge) that matches your Minecraft version.
- 2Download the mod file (.jar) built for that same version.
- 3Place the .jar into your .minecraft/mods folder.
- 4Launch Minecraft with the modded profile and check the mod loads in-game.











