minecraft-mod-mcp-helper

Minecraft Mod MCP Helper

Minecraft 整合包开发助手，覆盖 FTB Quests 任务书生成、KubeJS 物品/武器/盔甲/配方生成、SNBT/KubeJS 验证四大核心工作流。

---

When To Use

在以下情况时主动执行本 skill：

• 用户需要生成 FTB Quests 任务书章节（generate_quest_chapter）
• 用户需要生成单个任务（generate_quest_task）
• 用户需要生成武器/盔甲的 KubeJS 注册代码（generate_kubejs_weapon / generate_kubejs_armor_set）
• 用户需要生成合成/熔炼/移除配方（generate_kubejs_shaped_recipe / generate_kubejs_smelting / generate_kubejs_remove_recipe）
• 用户需要验证 SNBT 语法正确性（validate_snbt）
• 用户需要检查 KubeJS 脚本中的常见问题（check_kubejs_errors）
• 用户需要生成纹理路径指南（generate_item_texture_path）

---

Inputs

输入	说明	来源
title	章节/任务标题	用户指定
group_id	章节分组 ID（16位十六进制）	自动生成或用户提供
icon	图标物品 ID（如 minecraft:writable_book）	用户提供
quest_count	任务数量（1-20）	用户提供
filename	文件名（如 00_prologue）	用户提供
item_name	物品注册名（如 warrior_sword）	用户提供
item_type	类型：item / weapon / armor_helm 等	用户提供
snbt_content	SNBT 文件内容	用户粘贴或文件读取
script_content	KubeJS 脚本内容	用户粘贴或文件读取

---

Workflow

Phase 1 — FTB Quests 任务书生成

步骤 1：生成章节 ID 和分组

调用 generate_hex_id 生成 16 位随机十六进制 ID：

{}

返回 { "id": "A1B2C3D4E5F6G7H8" }。

调用 generate_chapter_group_snbt 生成章节分组配置：

{
  "groups": [
    { "id": "MAIN000000000001", "title": "§l&6主线任务" },
    { "id": "SIDE000000000001", "title": "§l&a支线任务" }
  ]
}

步骤 2：生成章节内容

调用 generate_quest_chapter 生成完整章节：

{
  "title": "初入世间",
  "group_id": "723AE4EA49A6043A",
  "icon": "minecraft:writable_book",
  "order_index": 0,
  "filename": "00_prologue",
  "quest_count": 3
}

返回结构：

{
  "chapter_id": "A1B2C3D4E5F6G7H8",
  "filename": "00_prologue.snbt",
  "content": "{ ... SNBT 内容 ... }",
  "quest_count": 3,
  "quest_ids": ["id1", "id2", "id3"]
}

步骤 3：生成单个任务（可选）

调用 generate_quest_task 生成单独任务定义：

{
  "title": "收集钻石",
  "description": "获得 5 个钻石",
  "icon": "minecraft:diamond",
  "task_type": "item",
  "target_item": "minecraft:diamond",
  "target_count": 5,
  "x": 0,
  "y": 0
}