PiaoYang Encyclopedia (怪物圖鑑)

PiaoYang Encyclopedia is a highly customizable Bestiary/Encyclopedia mod designed specifically for Minecraft RPG map makers. By utilizing a flexible NBT tag system and a comprehensive command API, map creators can easily integrate custom mobs, bosses, and unique world regions into an interactive collection system for players.

這是一款專為 Minecraft RPG 地圖創作者設計的「怪物圖鑑」模組。透過靈活的 NBT 標籤系統與完善的指令 API，地圖作者可以輕鬆地將自訂怪物、Boss 與特定世界區域整合進圖鑑系統中，為玩家提供豐富的收集要素與連動機制。

🌟 核心功能 (Core Features)

自訂怪物識別 (Custom Mob Recognition) Supports registering vanilla entities as unique custom mobs via NBT tags (encyclopedia:<id>). Perfectly compatible with command-summoned mobs or custom spawners. 支援透過 NBT 標籤將原版生物註冊為獨立的圖鑑項目，完美相容於原版指令或生成器生成的客製化怪物。
動態資訊解鎖 (Dynamic Information Unlocking) Players unlock 3D models, health, attack, armor, and spawn locations upon their first kill. Subsequent kills track kill counts and newly discovered dropped items. 玩家首次擊殺怪物後，將解鎖其 3D 模型、血量、攻擊力、防禦力及生成地點。後續擊殺可持續記錄擊殺次數與實際發現的掉落物。
世界分類與防劇透機制 (World Categories & Anti-Spoiler) Creators can assign mobs to specific world regions. Undiscovered entities are displayed as ???. Supports command-based "forced hiding" to prevent spoilers for hidden bosses or future updates. 作者可將怪物分配至不同的世界區域。未解鎖的實體將以 ??? 顯示，並支援透過指令「強制隱藏」特定怪物，防止劇情或隱藏 Boss 提前曝光。
地圖指令連動 (Command Block Integration) Built-in progression testing commands (/encyclopedia test). Seamlessly integrates with command blocks and /execute to trigger quests, achievements, or rewards when a player unlocks a specific mob or reaches a certain collection threshold. 內建進度檢測指令，完美支援命令方塊與 /execute。當玩家解鎖特定怪物或圖鑑數量達到指定門檻時，可輕鬆觸發地圖任務或給予實質獎勵。
自訂文本 (Resource Pack Support) Fully supports modifying mob display names and detailed lore descriptions via Resource Packs (zh_tw.json / en_us.json). 支援透過資源包 (Resource Pack) 自訂怪物的顯示名稱與長篇背景描述。

🛠️ 給地圖作者的快速指南 (For Map Makers)

To register a custom mob, simply add the specific tags when summoning the entity: 在地圖中召喚自訂怪物時，加入專屬標籤即可讓系統自動識別並記錄：
程式碼片段
<button class="mdc-icon-button mat-mdc-icon-button mat-mdc-button-base mat-badge mat-unthemed mat-badge-overlap mat-badge-above mat-badge-after mat-badge-small mat-badge-hidden ng-star-inserted" aria-label="下載程式碼"></button><button class="mdc-icon-button mat-mdc-icon-button mat-mdc-button-base mat-badge mat-unthemed mat-badge-overlap mat-badge-above mat-badge-after mat-badge-small mat-badge-hidden ng-star-inserted" aria-label="複製代碼"></button>
```
/summon zombie ~ ~ ~ {Tags:["encyclopedia:abyss_guard", "encyclopedia_loc:The Abyss", "encyclopedia_is_boss:1b"]}
```
- encyclopedia:<ID> : The unique identifier for the custom mob. (自訂怪物的唯一 ID)
- encyclopedia_loc:<Location> : The spawn location/world category. (生成地點與世界分類)
- encyclopedia_is_boss:1b : Marks the entity as a Boss (Red name & Boss filter). (標記為 Boss，啟用紅色名稱與專屬過濾器)
📜 常用指令 (Commands)

Requires OP Permission Level 2 or higher. (需要 OP 權限)
- /encyclopedia global add/remove <World> <MobID>: Manage the global undiscovered preview list. (管理全域未解鎖預覽清單)
- /encyclopedia hide/show entity <MobID>: Force hide or show specific mobs from the book. (強制隱藏或顯示特定怪物)
- /encyclopedia test count <Player> <Amount>: Test if a player has reached a specific unlock count (For command blocks). (檢測玩家圖鑑解鎖數量，供命令方塊使用)
- /encyclopedia test entity <Player> <MobID>: Test if a player has unlocked a specific mob. (檢測玩家是否已解鎖特定怪物)
- /encyclopedia unlock/remove/clear <Player> <MobID>: Manage personal progression. (管理玩家個人解鎖進度)

PiaoYang Encyclopedia (怪物圖鑑)

🌟 核心功能 (Core Features)

🛠️ 給地圖作者的快速指南 (For Map Makers)

📜 常用指令 (Commands)

Piaoyang_Encyclopedia