Copy page

• Copy page
• View source

⚙️ 生成文件

使用 Beet 构建模块时，系统会自动生成多个文件以简化开发并提高一致性。本页概述其背后的运作机制。

---

📦 模块管理

模块与其依赖项会被打包：

• 若模块 A 依赖模块 B，两者均会被纳入构建流程。

系统会创建特殊加载器模块 bs.load 及 load (LanternLoad) 以实现：

• 解决版本冲突并管理模块间依赖关系。

• 确保加载函数按正确顺序调用，维持数据包行为可靠性。

构建过程中会自动更新 pack.mcmeta 文件以确保兼容性：

• pack_format 设为最新支持的 Minecraft 版本。

• supported_formats 指定兼容版本范围。

---

🗂️ 基于资源的插件

除模块管理外，Bookshelf 还会自动生成多种资源类型的数据。

📄 函数相关

Bookshelf 通过以下方式提升贡献者和用户体验：

• 自动将模块 import 文件夹中的函数添加至 __load__ 函数。

• 生成 __help__ 函数及其 help 标签，链接至模块文档。

🧪 测试相关

Bookshelf 使用 PackTest 运行模块自动化测试。为确保顺利且隔离的执行：

• 自动向测试函数注入 @environment bs.load:<module> 指令。

• 在 bs.load 命名空间内创建专用测试环境，隔离并仅加载被测模块。

🏷️ 标签相关

为确保正确加载和版本控制，Bookshelf 要求使用不可覆盖的标签：

• 将所有标签的 replace 键值设为 true。

---

🧩 模块专属插件

除共享插件外，每个模块可包含专属插件接入构建流程。部分模块拥有负责生成特定数据的插件，为构建过程提供更高灵活性。