Goetic Legacy

# Goetic Legacy - 诡厄遗物
版本 0.2.0-early-release
更新日志：

## [重大更新] 预制建筑系统（塑虚之杖/旧世的遗响）

**[塑虚之杖]**
- 新增「塑虚之杖」——虚实之界的枢转，可对预制建筑进行部署、回收、预览与创建
- 新增蓄力施法体系：右键蓄力执行当前模式动作，伴有紫色粒子与蓄力进度条 HUD
- 新增四种杖模式切换：预览 → 建造 → 回收 → 创建，通过 Z 键打开设置界面或 X 键圆环菜单切换
- 新增施法位置预设：角点 / 前面中间 / 中心，通过设置界面切换
- 新增魔法部署动画：方块逐层从地底升起，魔阵光环、星空球体、紫色烟雾等特效
- 新增魔法回收动画：方块自上而下缩小淡出，内爆球坍缩 + 黑洞扩散特效
- 新增蓝图创建功能：使用空白的遗响圈选世界中的区域（最大 32×32×32），命名后生成可部署蓝图
- 新增蓝图命名界面：创建时弹出命名界面，确认后开始方块移除动画
- 新增 X 键圆环菜单（EchoRadialMenu）：快捷切换杖模式、卸下/更换背包中的遗响
- 新增遗响 HUD：快捷栏上方显示当前装备的遗响图标
- 新增预览渲染器：通过半透明方块预览建筑放置位置与朝向
- 新增自定义法杖 3D 模型及着色器渲染
- 新增方块放置/回收动画渲染器

**[旧世的遗响（蓝图）]**
- 新增「旧世的遗响」物品，作为预制建筑蓝图的数据载体
- 支持三种状态：EMPTY（空白）/ READY（就绪）/ DEPLOYED（已部署）
- 支持从世界捕获的内嵌结构数据，收回后自动快照世界方块写入蓝图
- 支持预制建筑模板系统（.nbt 文件），含 GoeticMeta 元数据（稀有度、显示名、战利品权重）
- 稀有度系统：普通 / 精良 / 稀有 / 史诗，影响物品名颜色
- 战利品注入系统：预制建筑蓝图可从地牢战利品中获取

**[客户端消息系统增强]**
- 拓展 ClientMessageManager 为多槽位架构，支持 CENTER（屏幕中央）与 BOTTOM_LEFT（左下）两个独立消息槽
- 所有预制建筑系统消息从聊天框迁移至客户端动画消息：成功/完成类显示在屏幕中央（180tick），错误/警告类显示在左下方（80tick）
- 新增 PacketShowPrefabMessage 网络包，支持服务端→客户端动画消息推送

## [优化内容]
- 新增无瑕套装 DOT 机制 HUD 显示：左下角显示持续伤害池、释放速率、状态指示
- 新增无瑕套装 DOT 数据同步网络包，实时同步服务端 DOT 数据到客户端
- 优化无瑕套装持续伤害 DOT 逻辑与伤害池释放公式
- 优化无瑕套装伤害保护逻辑与计算
- 新增典籍被动效果开关处理器，支持动态开关典籍被动
- 新增无瑕套装、蜘蛛标本册、塑虚之杖的 Patchouli 百科条目
- 新增塑虚之杖、无瑕套装、旧世的遗响的仪式合成配方
- Complete the Chinese and English localization for the entire prefab building system
- 补全预制建筑系统的中英文本地化：GUI 菜单、Tooltip、聊天消息共 69 个翻译键
- 重写 VoidShapingStaff.msg/sendSystemMessage 为变参方法，支持参数传递

## [修复BUG]
- 修复 VoidShapingStaff 中 `template_not_found` 消息缺少模板名参数的 bug
- 修复各处翻译键与参数不匹配的问题
- 移除预制建筑系统的所有原始聊天框消息，统一走动画消息系统

---

# Goetic Legacy
Version 0.2.0-early-release
Changelog:

## [Major Update] Prefab Building System (Void Shaping Staff / Echo of the Old World)

**[Void Shaping Staff]**
- Added Void Shaping Staff — a pivot between the real and the imagined, capable of deploying, retracting, previewing, and creating prefabricated structures
- Added charged casting system: right-click and hold to charge the current action, with purple particles and a charge bar HUD overlay
- Added four staff mode cycling: Preview → Build → Reclaim → Create, switch via Z key settings screen or X key radial menu
- Added placement position presets: Corner / Front Middle / Center, switchable in settings screen
- Added animated deployment: blocks rise layer by layer from the ground with magic circle auras, star spheres, and purple smoke particles
- Added animated retraction: blocks shrink and fade from top to bottom with implosion sphere collapse and black hole effects
- Added blueprint creation: select an area in-world (max 32×32×32) with an empty Echo, name it, and generate a deployable blueprint
- Added blueprint naming screen: appears upon creation, confirms to start block removal animation
- Added X key radial menu (EchoRadialMenu): quickly switch staff mode, unequip or swap echoes from inventory
- Added Echo HUD: displays the currently equipped echo icon above the hotbar
- Added preview renderer: semi-transparent ghost block preview for placement position and rotation
- Added custom 3D staff model with shader-based rendering
- Added block place/retract animation renderers

**[Echo of the Old World (Blueprint)]**
- Added Echo of the Old World item as a data carrier for prefab blueprints
- Supports three states: EMPTY / READY / DEPLOYED
- Supports embedded structure data captured from the world; snapshots world blocks on retraction
- Supports prefab template system (.nbt files) with GoeticMeta metadata (rarity, display name, loot weight)
- Rarity system: Common / Uncommon / Rare / Epic, affects item name color
- Loot injection system: prefab blueprints obtainable from dungeon loot

**[Client Message System Enhancement]**
- Extended ClientMessageManager with multi-slot architecture, supporting CENTER (screen center) and BOTTOM_LEFT (bottom-left) independent message slots
- All prefab system messages migrated from chat to animated messages: success/completion messages appear at screen center (180 ticks), errors/warnings appear at bottom-left (80 ticks)
- Added PacketShowPrefabMessage network packet for server-to-client animated message delivery

## [Optimizations]
- Added Holy Armor DOT HUD overlay: displays DOT pool, release rate, and status indicator at bottom-left
- Added Holy Armor DOT data sync packet for real-time server-to-client DOT data synchronization
- Optimized Holy Armor damage-over-time logic and damage pool release formula
- Optimized Holy Armor protection calculation logic
- Added Guide Book passive toggle handler for dynamic passive book effect toggling
- Added Patchouli encyclopedia entries for Holy Armor, Spider Specimen Book, and Void Shaping Staff
- Added ritual crafting recipes for Void Shaping Staff, Holy Armor set, and Echo of the Old World
- Completed Chinese and English localization for the entire prefab building system: GUI menus, tooltips, and messages totaling 69 translation keys
- Refactored VoidShapingStaff.msg/sendSystemMessage with varargs for parameter support

## [Bug Fixes]
- Fixed `template_not_found` message missing template name parameter in VoidShapingStaff
- Fixed various mismatches between translation keys and their parameters
- Removed all raw chat messages in the prefab system, unified under the animated message system

---