메뉴
Guides API-Split multi-module architecture decisions for NeoPasterDream (NeoForge 1.21.1). Invoke when deciding where to place new code (PasterDreamAPI vs PasterDream), creating Builder/Facade/Result/Config classes, or designing new registration systems.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
PasterDream模组药水效果注册专用API，提供Facade+Builder模式一键注册自定义MobEffect。在需要创建新状态效果、配置效果属性/着色器/粒子/回调/药水酿造时调用。
PasterDream模组实体注册专用API，提供Facade+Builder模式一键注册自定义实体。在需要创建新实体、配置实体属性/AI/碰撞箱/追踪范围/生物技能、动画系统或注册渲染器时调用。
PasterDream NeoForge 1.21.1 模组开发指南。提供项目结构、注册系统、实体系统、物品系统等的开发规范，以及常见崩溃问题的解决方案。Invoke when developing or modifying PasterDream mod features, creating new items/blocks/entities, fixing crashes, or when needing to understand the mod's architecture.
PasterDream 物品移植 API —— 用于将原 FixPasterDream 模组（MCreator 生成）中的物品系统化移植到 NeoForge 1.21.1。提供 Builder 模式、批量注册、迁移追踪、配方生成、战利品表生成、方块数据生成、创造标签页生成、语言文件生成及超级快速导入器等一站式工具链。Invoke when needing to port items from the old FixPasterDream mod, register new items in PDItems.java, batch-create items with consistent patterns, generate recipes/loot tables/block tags, or create creative tab registration code.
Minecraft NeoForge 1.21.1 方块掉落问题诊断与修复指南。Invoke when user encounters block drop issues, missing loot drops, or needs to implement custom block drops. Covers getDrops() override, BlockItem registration, and loot table JSON troubleshooting.
PasterDream模组维度注册专用API，提供Facade+Builder模式一键注册自定义维度。在需要创建新维度、配置维度类型/生物群系/背景音乐或生成维度JSON时调用。
| name | api-split-multi-module |
| description | Guides API-Split multi-module architecture decisions for NeoPasterDream (NeoForge 1.21.1). Invoke when deciding where to place new code (PasterDreamAPI vs PasterDream), creating Builder/Facade/Result/Config classes, or designing new registration systems. |
| 场景 | 说明 | 示例 |
|---|---|---|
| 新增 API 类 | 创建新的 Builder/Facade/Result/Config 类 | BlockAPI, EntityBuilder, ParticleResult 等 |
| 新增注册体系 | 设计新的注册流程或数据生成器 | DimensionAPI, RuinAPI 等注册 Facade |
| 跨模块调用 | API 类被多个业务模块引用 | EntityResult 被 PDEntities.java 和业务代码同时使用 |
| 独立发布需求 | 需要被其他模组或项目作为库依赖 | 附属模组需要依赖核心 API |
| 包路径变更 | 移动或重命名 API 相关包 | 将 worldgen/decor/ 中的 API 类移至 API 模块 |
| 场景 | 原因 |
|---|---|
| 纯业务逻辑（具体的方块/物品/实体类） | 属于主模块职责，不需要独立发布 |
| 客户端专属代码（渲染器、粒子效果、GUI） | 强依赖 Minecraft 客户端，不适合独立发布 |
| 临时调试工具（调试命令、测试用 Wand 物品） | 一次性代码，不值得模块化 |
| 原版 Minecraft 扩展类（继承原版 Block/Item 的自定义类） | 属于业务实现层 |
[新代码要放在哪?]
│
├─ 属于 API 接口/Builder/Facade/Result/Config？
│ ├─ ✅ → PasterDreamAPI 模块
│ └─ ❌ → 继续判断
│
├─ 会被多个业务模块引用？
│ ├─ ✅ → PasterDreamAPI 模块
│ └─ ❌ → 继续判断
│
├─ 是注册体系的一部分（DeferredRegister/DataGen）？
│ ├─ ✅ → PasterDreamAPI 模块
│ └─ ❌ → 继续判断
│
├─ 需要被其他模组作为库依赖？
│ ├─ ✅ → PasterDreamAPI 模块
│ └─ ❌ → PasterDream 模块（主模块）
口诀: API 接口、Builder、Result、注册门面 → 放 API 模块；具体的方块、物品、实体、渲染 → 放主模块。
| 模块 | 包路径 | 应包含的内容 | 不应包含的内容 |
|---|---|---|---|
| PasterDreamAPI | PasterDreamAPI/src/main/java/com/pasterdream/pasterdreammod/api/ | BlockAPI, EntityAPI, ParticleAPI, DimensionAPI, RuinAPI, MobEffectAPI, ItemMigrationAPI, 以及所有 Builder/Result/Config/Gen 类 | 具体的 Block/Item/Entity 子类，客户端渲染代码 |
| PasterDream | PasterDream/src/main/java/com/pasterdream/pasterdreammod/ | 所有方块、物品、实体、流体、容器、渲染器、注册管理器（PDBlocks, PDItems 等）、DataGen 提供者 | 纯 API 接口/门面类（应通过依赖使用 PasterDreamAPI） |
| 旧目录（已归档） | src/main/java/com/pasterdream/pasterdreammod/ | 仅保留 package-info.java 标记为 @Deprecated | 不应在此目录添加新代码 |
如果 API-Split 架构不适用，按以下优先级选择替代方案：
api/、impl/ 分包，为日后拆分预留空间BlockAPI 的设计）ITEMS.register()），直接在注册类中内联即可，不需要额外抽象PasterDreamAPI/src/main/java/com/pasterdream/pasterdreammod/api/ 下的对应子包PasterDreamMod.java 构造器中 .register(modEventBus)PasterDream/src/main/resources/assets/pasterdream/lang/zh_cn.json.\gradlew compileJava（会自动编译两个模块）所有 API 应遵循统一的设计模式（Facade + Builder）：
| API | Facade 入口 | Builder 类 | 注册方法 |
|---|---|---|---|
| 方块 | BlockAPI | SimpleBlockBuilder | .register() |
| 实体 | EntityAPI | EntityBuilder | .buildAndRegister() |
| 粒子 | ParticleAPI | ParticleAPI.ParticleBuilder | .build() |
| 维度 | DimensionAPI | DimensionAPI.DimensionBuilder | .register() |
| 装饰物 | DecorationBuilder | （自身即是Builder） | .register() |
新 API 请遵循此模式，确保调用方式一致。