本頁面說明小喵喵RPG模組JSON結構、必填與可選欄位,以及生物/方塊生成規則。

遊戲基礎規則

必填欄位(type)

{
    "info": {
        "author": "Example",
        "modname": "example",
        "modversion": "1.0"
    },
    "data": {
        "animal": {},
        "block": {},
        "item": {}
    },
    "rule":{
        "animal": {},
        "block": {}
    },
    "type": [],
    "events": {}
}
欄位 型態 說明
info.author str 作者名稱
info.modname str 模組名稱
info.modversion str 模組版本
data.animal dict 生物資料
data.block dict 方塊資料
data.item dict 物品資料
rule.animal dict 生物生成規則
rule.block dict 方塊生成規則
type list 類型註冊列表(預設類型:default、food)
events dict 事件註冊列表(預設事件請查看事件說明與註冊)

生物物品註冊

data.animal - 額外生物

"<生物名稱>": {
    "hp": 10,
    "drops": ["<掉落物>"],
    "display-emoji": "<emoji>"
}

data.block - 額外方塊

"<方塊名稱>": {
    "drops": ["<掉落物>"],
    "display-emoji": "<emoji>",
    "events": ["<event>"]
}
        

data.item - 額外物品

"<物品名稱>": {
    "type": ["<type>"],
        "gen": {
            "health": <回復血量>,
            "cooked": <是否烹煮>,
        },
        "trade": {
            "sold": <賣出價格>,
            "buy": <買入價格>
      }
}
欄位 型態 說明
<生物名稱>.hp int 生物血量
<生物名稱>.drops list 掉落物
<生物名稱>.display-emoji str 顯示的表情符號
<方塊名稱>.drops list 掉落物
<方塊名稱>.display-emoji str 顯示的表情符號
<方塊名稱>.events list 觸發事件(可不填)
<物品名稱>.type list 物品屬性(food為食物)
<物品名稱>.gen dict 物品食物屬性(非食物不填)
<物品名稱>.gen.health int 食物回復血量
<物品名稱>.gen.cooked bool 食物是否烹煮(不烹煮或已烹煮為True)
<物品名稱>.trade dict 物品交易
<物品名稱>.trade.sold int 物品售出價格
<物品名稱>.trade.buy int 物品買入價格

生物方塊生成規則

rule.animal

"<生物名稱>": {
    "chunk": {
        "max": <區塊最多生成數量>
    },
    "type": ["<type>"]
}

rule.block

"<方塊名稱>": {
    "chunk": {
        "max": <區塊最多生成數量>
    },
    "type": ["<type>"]
}
欄位 型態 說明
<生物名稱>.chunk dict 區塊生成規則
<生物名稱>.chunk.max int 區塊最多生成數量
<生物名稱>.type list 生物屬性
<方塊名稱>.chunk dict 區塊生成規則
<方塊名稱>.chunk.max int 區塊最多生成數量
<方塊名稱>.type list 方塊屬性

事件說明與註冊

events

"events": {
    "<事件名稱>": {
        "core": "<核心事件>"
    }
}
欄位 型態 說明
<事件名稱>.core str 引用核心事件:de-health或in-health
預設事件 str 不須註冊即可使用的預設事件:explode、hurt、recover
core str de-health、in-health請則一輸入 <事件名稱>.core 使用

驗證規則

完整範例

{
    "info": {
        "author": "command_cat",
        "modname": "Example",
        "modversion": "1.1"
    },
    "data": {
        "animal": {
          "cat": {
              "hp": 10,
              "drops": ["bone"],
              "display-emoji": "🐱"
          },
          "dog": {
              "hp": 12,
              "drops": ["bone"],
              "display-emoji": "🐶"
          },
          "fox": {
              "hp": 8,
              "drops": ["apple"],
              "display-emoji": "🦊"
          }
        },
      "block": {
        "tnt": {
          "drops": ["tnt"],
          "display-emoji": "💣",
          "events": ["explode"]
        },
        "blackhole": {
          "drops": [],
          "display-emoji": "⚫",
          "events": ["fall"]
        },
        "soil": {
          "drops": [],
          "display-emoji": "🟫",
          "events": []
        }
      },
      "item": {
        "bone": {
          "type": [],
          "gen": {},
          "trade": {
            "sold": 0,
            "buy": 0
          }
        },
        "apple": {
          "type": ["food"],
          "gen": {
            "health": 3,
            "cooked": true
          },
          "trade": {
            "sold": 2,
            "buy": 3
          }
        },
        "steak": {
          "type": ["food"],
          "gen": {
            "health": 5,
            "cooked": true
          },
          "trade": {
            "sold": 10,
            "buy": 5
          }
        },
        "tnt": {
          "type": ["danger"],
          "gen": {},
          "trade": {
            "sold": 40,
            "buy": 45
          }
        }
      }
    },
    "rule": {
      "animal": {
        "cat": {
          "chunk": {
            "max": 2
          },
          "type": ["normal"]
        },
        "dog": {
          "chunk": {
            "max": 2
          },
          "type": ["normal"]
        },
        "fox": {
          "chunk": {
            "max": 1
          },
          "type": ["default"]
        }
      },
      "block": {
        "tnt": {
          "chunk": {
            "max": 2
          },
          "type": ["danger"]
        },
        "blackhole": {
          "chunk": {
            "max": 2
          },
          "type": ["danger"]
        },
        "soil": {
          "chunk": {
            "max": 1
          },
          "type": ["default"]
        }
      }
    },
    "type": ["normal", "danger"],
    "events": {
      "fall": {
        "core": "de-health"
      }
    }
  }

開始創建你的RPG模組吧!

立即使用範例