╔══════════════════════════════════════════════════════════╗
║       CustomHorde — 35 隻自訂敵人 + 動態配樂系統          ║
║       Minecraft Java 版 1.21.4（pack_format 61）          ║
╚══════════════════════════════════════════════════════════╝

■ 免責聲明 / DISCLAIMER
  本資料包為非官方的第三方社群作品，並非 Minecraft 官方產品，
  未經 Mojang Studios 或 Microsoft 認可，亦與其無任何隸屬關係。
  NOT AN OFFICIAL MINECRAFT PRODUCT.
  NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.

  「Minecraft」為 Mojang Studios 之註冊商標，本文件僅作相容性說明之用。
  本資料包僅包含自行撰寫的 .mcfunction 指令檔，
  不含任何 Mojang 之程式碼、貼圖、模型或音訊檔案。
  配樂功能為「引用」使用者自身遊戲內既有的音效事件 ID，未散布任何音檔。
  本包免費散布，不得販售。

■ 這是什麼
  一個「資料包（Datapack）」，把圖中 35 隻怪物做進原版 Minecraft，
  並內建動態戰鬥配樂系統。不需 Mod / Forge / Fabric。
  外觀為原版怪物的改造版（名稱、體型、裝備、顏色、光環特效），
  玩法（血量、攻擊、掉落、Boss 血條、召喚小兵、配樂）全為客製。

  ★ 配樂需搭配另一個「CustomHorde-Music 資源包」一起啟用（見下方）。


■ 安裝（資料包）
  1) 存檔資料夾內找到 datapacks：
     Mac：~/Library/Application Support/minecraft/saves/<存檔>/datapacks/
     Win：%appdata%\.minecraft\saves\<存檔>\datapacks\
  2) 把 CustomHorde 資料夾（或 CustomHorde.zip）放進去。
  3) 遊戲內輸入 /reload，看到「已載入」訊息即成功。
  ※ 需開啟「作弊 / Cheats」才能用召喚指令。


■ 安裝（配樂資源包）※ 有這個才會有音樂
  1) 把 CustomHorde-Music.zip 放進：
     Mac：~/Library/Application Support/minecraft/resourcepacks/
     Win：%appdata%\.minecraft\resourcepacks\
  2) 遊戲 → 選項 → 資源包 → 啟用「CustomHorde 配樂」。
  預設會用原版精彩曲目（龍戰鬥樂 / pigstep / 詭異唱片）當 Boss 音樂，
  免下載、立即可用。想換自己的原創音樂見資源包內 README。


■ 召喚怪物
  /function customhorde:menu          → 可點擊召喚選單（推薦）
  /function customhorde:summon/<ID>   → 直接召喚，例：
      /function customhorde:summon/infernal_behemoth
  /kill @e[tag=customhorde]           → 清除全部自訂怪物
  /function customhorde:uninstall     → 完全移除系統


■ 配樂系統（動態）
  • Boss 出現：號角警示 + 專屬戰鬥主題（自動循環）+ 標題「BOSS 現身」
  • Boss 陣亡：停止戰鬥樂 + 勝利號角 + 標題「討伐成功」
  • 每隻 Boss 不同主題：
      蒼藍飛龍 → 天空龍主題   煉獄巨獸 → 地獄主題   緋紅蛛母 → 詭異主題
  • 測試選單：/function customhorde:music/menu
  • 停止音樂：/function customhorde:music/stop


■ 35 隻怪物一覽（★ = Boss，附血條）
  哥布林步兵 goblin_grunt        霜網巨蛛 frostweave_spider（冰霜光環）
  腐化食人魔 corrupted_ogre       寂靜白影 silent_shade（弓兵）
  虛空死神 void_reaper（凋零光環） 象牙劍齒獸 ivory_sabercat
  餘燼蜈蚣 ember_centipede        溺屍掠奪者 drowned_raider
  地獄小惡魔 nether_imp（飛行）    薔薇魔 rosebound_fiend（劇毒光環）
  沼澤幽魅 bog_phantom（爆破）     血教徒 blood_cultist（弩兵）
  血肉巨兵 flesh_colossus         劇毒刺客 venom_assassin（劇毒光環）
  熾焰哨兵 ember_sentinel（火球）  寒霜幽靈 chill_specter（飛行冰霜）
  枯朽木乃伊 withered_husk         雪原泰坦 snow_titan（超大型）
  沼澤薩滿 swamp_shaman           黃金決鬥者 golden_duelist
  虛空行者 void_walker（瞬移）     甲殼蟲 carapace_beetle
  蛇髮女妖 gorgon（石化光環）      蒼藍飛龍 azure_wyrm ★（飛行火球 200血）
  冥收割者 grim_harvester（凋零）  塵埃哥布靈 dust_gremlin
  鎏金狗頭人 gilded_kobold         煉獄巨獸 infernal_behemoth ★（召喚岩漿怪 180血）
  珊瑚精靈 reef_sprite            冰霜女巫 frost_witch（冰霜光環）
  暮光喚魔師 twilight_evoker       尖刺爬獸 spiked_crawler
  緋紅蛛母 crimson_broodmother ★（召喚洞穴蜘蛛 150血）
  暗影忍者 shadow_ninja（高速）    孢子少女 spore_maiden（劇毒光環）


■ 限制說明（誠實告知）
  - 資料包無法新增全新 3D 模型/貼圖，外觀為原版怪物改造，非 100% 還原圖片。
  - 配樂無法內建音檔；預設用遊戲既有曲目，換原創音樂需自備 .ogg（見資源包 README）。
  - 目前鎖定 1.21.4；1.21.5+ 改了部分格式，需其他版本請告知再調整。


製作：Claude Code
