团子的模组 (Tuanzi's Mod) - 完整内容与机制总览

团子的模组 是基于 Fabric Loader 开发的高级综合玩法拓展模组，专为 Minecraft 26.2 量身定制。模组囊括了炫酷的彩虹海绵染色系统、颠覆性的无 AI 灵笼贸易站、高精度蓝图自动化构筑、全真玩家模拟器、专属动态磨损武器库、归一化深度战斗附魔体系、抽卡定轨保底系统，以及针对原版铁砧、附魔、炼金与机制的深度优化。

---

目录

1. 新增方块与核心系统
   • 灵笼贸易站
   • 蓝图构筑系统 (蓝图大炮 / 蓝图桌 / 结构蓝图)
   • 玩家模拟器
   • 彩色建材与油漆桶系统
2. 专属武器与防具装备
   • 神级工具：尤里的复仇
   • 防御反击：回响破障者
   • 极速绝影：蜂刺余响
   • 城墙壁垒：钢御壁垒
   • 虚空切割：裂虚之痕
   • 深暗爆破：幽匿裂片
   • 海洋节拍：潮汐切割者
   • 机械传导：脉冲谐振剑
   • 轻盈防具：潮汐织靴
3. 功能道具与辅助装备
   • 彩虹海绵
   • 缚灵笼
   • 旅者手札与道标符石
   • 工匠护符
   • 不朽圣符
   • 狂暴护符
   • 战狼护符
   • 塑世之笔与虚空墨锭
   • 彩色变化头颅
   • 手里剑
   • 试炼假人
   • 稻草人与假目标
   • 地狱炖菜
   • 核心构件
4. 抽卡与卡池定轨系统
5. 自定义附魔体系 (15种)
6. 自定义状态效果 (16种)
7. 药水与炼金配方
8. 实体列表 (5种)
9. 原版机制修改与高级特性
10. 获取途径与生存合成指南 (21种配方)

---

🏗 1. 新增方块与核心系统

1. 灵笼贸易站 (Soul Merchant Station)

• 免 AI 极速交易：将封装了村民的【缚灵笼】右键导入贸易站后，右键贸易站直接打开原生村民交易 GUI（完全兼容声望折扣、村庄英雄折扣以及改名）。彻底脱离实体寻路与 AI 计算，大幅优化服务器 TPS 与客户端 FPS。
• 自主计时无寻路补货：方块实体内部拥有独立的 RestockTimer（8000 ticks，即游戏内 8 小时）。在其相邻 6 面（东、西、南、北、上、下）贴有对应村民的有效且未被占用工作站时，无需村民走动接触，到时即可自动解除锁定补货。支持保存 NBT，不受睡觉或 /time set 指令时序跳变影响。
• 安全取出与朝向锁定：手持空缚灵笼潜行右键贸易站可无损回收村民；手持非空物品潜行右键贸易站可使内部微缩 3D 村民顺时针旋转 90°，锁定面向。
• 绝对防爆：方块具备极高爆炸抗性，免疫 TNT、苦力怕等一切爆炸破坏。

2. 蓝图构筑系统 (Blueprint Construction System)

• 蓝图大炮 (Blueprint Cannon)：
  • 生存模式自动化建筑机械，工作效率为 5 ticks/方块。
  • 智能物料检索：自动扫描周围 5 格内的箱子、木桶、潜影盒，具备多层递归穿透（支持深达 3 层嵌套潜影盒）与自动扣料功能。
  • 工作燃料：消耗【压缩建造浆料】作为能源（创造模式免燃料）。
  • 控制与设置：GUI 设有 ▶（开始）、⏸（暂停）、⏹（终止）控制，宽幅实时彩色进度条（缺料/缺燃料时高亮红字警告），支持“错误方块移除（掉落/销毁）”与“精准 NBT 匹配”。
  • 材料清单生成：在槽位放入“书与笔”点击“清单”，系统服务端检索周围物料，生成带 ✔（足量绿色）与 ✗（缺失红色）排版的格式化成书。
  • 实体打印支持：支持打印区域内的盔甲架、物品展示框、生物等实体（消耗对应刷怪蛋/实体物品）。
• 蓝图桌 (Blueprint Table)：
  • 高科技投影文件交互台。
  • 导出：放入结构蓝图点击导出，在 blueprints 目录下生成标准 .litematic 投影文件。
  • 导入：检索 blueprints 目录下的外部 .litematic 或 .schem 投影文件，消耗空白蓝图生成结构蓝图。
  • 3D 真实透视预览：左侧附着滚动列表，点击预览无缝切换为带真实透视投影的 3D 微缩立体建筑模型（高保真方块材质渲染，极小尺寸自动像素抽稀，性能极佳）。
• 空白蓝图 (Blank Blueprint) 与结构蓝图 (Structure Blueprint)：
  • 手持空白蓝图右键点击对角线两端，点击聊天栏中的 [确认构筑] 链接，即可录制长方体区域内的所有方块、状态、方块实体 NBT 及非玩家实体（体积上限 262,144 格），消耗空白蓝图生成结构蓝图。
  • 手持结构蓝图右键地面可放置半透明 BlockDisplay 虚影。
  • 专属快捷键：R 旋转虚影、F 水平镜像、Ctrl + 方向键/PgUp/PgDn 平移与高度调整、V 隐藏/显示虚影、G 呼出虚影控制悬浮操作面板。

3. 玩家模拟器 (Player Simulator)

• 全真行为模拟：模拟真实玩家行为的高级红石方块。内置 3x3 模拟快捷栏（支持漏斗顶/侧面输入，底面抽出）。
• 脉冲轮询触发：接收到红石上升沿脉冲时，按行优先顺序（(0,0) → (0,1) → ... → (2,2)）轮流执行一个非空格子动作。
• 右键使用优先：优先对朝向面方块或实体执行 useOn（放置方块、剪羊毛、施加骨粉、倒装水等），若无效尝试空气使用 use（瞬间进食、饮用药水、拉弓射箭等）。
• 左键攻击与挖掘：
  • 左键攻击蓄力机制：前方有实体时进入攻击蓄力挂起状态，在红石信号保持期间累积蓄力刻（chargeTicks），断开瞬间打出满蓄力致命攻击！
  • 真实挖掘机制：前方为硬方块时挂起并花费实际游戏 tick 进行破坏，显示方块破坏进度裂痕。完全继承原版工具耐久度损耗逻辑、耐久附魔折减与时运/精准采集掉落物计算。
• 拥有者绑定系统：
  • 放置时记录拥有者 UUID 与名字；模拟器攻击产生的伤害、击杀经验与怪物仇恨全部重定向给在线拥有者。
  • 防盗保护：非拥有者尝试放置带有所有权标签的模拟器将被拦截并警告。
  • 一键净化：在工作台单卡无序合成自身即可清除所有权标签。

4. 彩色建材与油漆桶系统 (Color Blocks & Paint Bucket)

• 彩色方块 / 彩色半砖 / 彩色楼梯：纯净无边框的自定义现代装饰建材。
  • 方块染色：在工作台与装有颜色的油漆桶无序合成，每次消耗 1 点油漆桶耐久。
  • 双半砖独立染色：允许将两种不同颜色的半砖叠加放置为双半砖，上下两层各自保留并渲染染上的颜色，挖掘时拆分掉落原本各自颜色的半砖。
  • 合成颜色继承：使用带颜色的彩色方块合成楼梯（产出4个）或半砖（产出6个）时，自动继承所有输入原料的平均 RGB 颜色。
  • 地图精准显示：彩色方块、楼梯和单半砖在地图上直接呈现其对应染色颜色；双半砖智能呈现顶部半砖颜色。
• 油漆桶 (Paint Bucket)：耐久 256 次。
  • 右键打开专属 300x150 宽屏 RGB 调色盘界面。
  • 支持 R/G/B 三色滑块（0-255）精准调节、十六进制 Hex 文本输入框双向无缝联动、16 种原版染料色彩快捷预设按钮以及大色块实时预览。

---

⚔ 2. 专属武器与防具装备

装备名称	基础面板	攻击速度	耐久度	核心专属机制
尤里的复仇	-	-	5	唯一可破坏基岩的工具。模拟硬度 50 极速破坏基岩并掉落，无法挖掘其他方块。
回响破障者	8.0	1.2	1550	主手减免 15% 音波伤害；副手为空右键进行 0.75 秒完美格挡（免疫 100% 音波），反弹造成 18 点真实伤害 与强烈击退。坚守者的心脏修复。
蜂刺余响	6.5	2.1	2031	触及距离 -0.25 格，无横扫。命中叠加“蜂毒”（每层增伤 3%），满 5 层引爆造成 15% 最终伤害的真实伤害。带 5 阶段磨损。坚守者的心脏修复。
钢御壁垒	6.7	1.6	2031	命中叠加 1 层“钢盾”（每层 +2 护甲，最高 5 层破 20 上限），持续 5s 后以每 5s 衰减 1 层的速度平缓消退。下界合金锭修复。
裂虚之痕	4.12	2.0	2031	虚无切割：攻击护甲值为 0 的目标时，造成的最终伤害提升至 175%。末影之眼修复。
幽匿裂片	9.0	1.25	2031	命中附加 2.5s“共鸣”；命中已有共鸣目标消耗共鸣并造成 2.0 点真实音波魔法伤害。静默残片不碎裂。坚守者的心脏修复。
潮汐切割者	6.3	1.66	2031	潮汐节拍：冷却充能 80%~100%（或满后 0.2s 内）合拍攻击叠充能（最高 5 层，每层增伤 2%）；低于 80% 失拍攻击减伤 15% 并掉充能；>=2 层附带“潮汐侵蚀”DOT；5 层合拍触发潮涌爆发（3 点魔法真实伤害，7s CD）。海洋之心修复。
脉冲谐振剑	5.0	2.5	2031	攻击蓄力 >= 80% 命中叠加电容脉冲，满 3 层下一次攻击释放脉冲电击（额外造成 3.0 点雷电伤害）。铜锭/红石块修复。
潮汐织靴	3护甲/2韧性	-	429	凌波微步：在水面如陆地般行走/疾跑/跳跃；潜水切换：按住 Shift 沉入水中潜水，回水面恢复行走；高空落水完全免受摔落伤害。幻翼膜/海晶晶体修复。

[!NOTE] 永久磨损体系 (Wear System)： 蜂刺余响、钢御壁垒、裂虚之痕、幽匿裂片、潮汐切割者、脉冲谐振剑 诞生时均随机生成磨损度（0.0001 ~ 1.0），永久固定。划分为五个独立外观阶段，采用双图层平滑插值渲染，击中音效随磨损度加深发生低沉音调偏移。按住 Shift 键查看详细背景故事与磨损详情。

---

🎒 3. 功能道具与辅助装备

1. 彩虹海绵 (✨ Sponge)

• 名称编程卡：堆叠上限 1。突破原版铁砧 50 字符长度限制。
• 在铁砧中为彩虹海绵重命名输入指令代码，再将其与目标物品合并，将样式永久渲染到物品名称上。
• 语法速查：
  • 十六进制颜色：#FF5555（亮红）
  • 经典样式代码：&l（加粗）、&o（倾斜）、&n（下划线）
  • 多段循环分割：&c,&b,&l（逗号分隔，按字轮流应用）
  • 平滑随机渐变：&q3#FF0000（从起始色为接下来的 3 个字平滑渐变）
  • 线性双色渐变：&q5#FF0000-#0000FF（在两色之间平滑渐变 5 个字）
  • 属性重置：&r（彻底清除物品所有自定义颜色与样式）

2. 缚灵笼 (Villager Cage)

• 村民封印装置：一次性使用（耐久 1）。右键村民封印入笼，完整保存职业、等级、交易项目、改名及交易次数。
• 守护惩罚：若在铁傀儡 16 格守护范围内捕捉村民，会瞬间激怒周围所有铁傀儡。
• 安全释放：潜行 + 右键固体方块释放（需 2 格高度空间）。支持跨维度运输。

3. 旅者手札与道标符石 (Traveler's Notebook & Signpost Rune)

• 旅者手札：右键打开水晶书传送界面；潜行+右键打开内部存储界面（Slot 0 仅限存放传送纸充能，上限 64 点；Slot 1-26 存放已绑定的道标符石）。
  • 传送消耗：同维度 1 能量，跨维度 2 能量。
  • 传送伴随 3 秒静止引导，受到伤害或移动立刻打断。冷却：同维度 3 秒，跨维度 5 秒。
  • 物品实体遇火或爆炸损毁时，内部所有符石与传送纸全部原地爆出。
• 道标符石：右键绑定当前坐标与维度；可在铁砧中改名，作为手札中的目的地标题。
• 传送纸：手札的唯一充能原料，每张转化 1 点能量。

4. 便携神器：工匠护符 (Craftsman Charm)

• 右键直接打开 3x3 便携工作台界面。
• 材料缓存：护符内部自带 9 个独立缓存格，关闭界面时原料保留在护符内不掉落。
• JEI 完美联动：支持在 JEI 配方界面点击“+”一键将背包材料填入便携合成网格。
• 防刷安全：护符无法放入自身缓存格；在 GUI 内拖拽该手持护符会自动强制关闭界面。

5. 保命神器：不朽圣符 (Immortal Talisman)

• 放在背包物品栏中即可生效。
• 当玩家死亡时，自动消耗 1 个圣符，保留玩家所有物品、装备与经验值，杜绝死亡掉落！

6. 狂暴护符 (Berserk Charm)

• 置于副手生效。当生命值低于 30% 时自动消耗 1 个护符，提供 15 秒 力量 II + 速度 II。
• 拥有 15 秒内置冷却时间（白遮罩），防止连续消耗。

7. 战狼护符 (Wolf Command)

• 置于副手生效（耐久 3，不可修复，移出副手触发 5 秒冷却惩罚）。
• 驯服的狼生命上限 +4；狼攻击 15% 概率附加“撕裂”Debuff（位移受魔法伤害）。
• 致死保护：狼遭受致命伤害时消耗 1 耐久，免死回满血并获得 5 秒无敌与激怒（攻速翻倍、移速提升、伤害提升）。
• 力竭与复活：激怒后狼力竭倒地（1 点生命、无敌免伤、强制坐下、禁止拴绳），喂食 10 个腐肉即可满血复活！

8. 塑世之笔与虚空墨锭 (World Sculptor's Pen & Void Ink Ingot)

• 塑世之笔：耐久 8192，不可附魔。
  • 批量填充：右键起点，在 64 格直线距离、2048 格体积内右键终点，长方体区域瞬间填充。
  • 取色与选定：Shift + 右键点击方块设为填充类型（右下角渲染小图标，完美提取彩色方块 RGB）。
  • 智能消耗：直接从主背包及潜影盒中扣除方块（支持同色方块精准扣除）。
  • 防刷撤销：填充后 60 秒内面对空气 Shift + 右键撤销，仅还原未改动的方块并退回方块与笔耐久，完整备份与还原方块实体 NBT。
  • 安全保护：禁止破坏或填充基岩等硬度 -1 的不可破坏方块。
• 虚空墨锭：专供塑世之笔在铁砧中定额修复 1000 点耐久。若与其他装备放入铁砧，输出槽显示红石粉“墨不相容”红字警告且无法拾取。

9. 彩色变化头颅 (Chromatic Skull)

• 堆叠上限 16。手持右键呼出输入面板，输入任意正版 Minecraft 玩家名称（3~16 字符），点击确认消耗 1 个头颅，即刻获取该玩家正版皮肤头颅。

10. 极速暗器：手里剑 (Shuriken)

• 伤害 2，飞行速度为箭的 1.5 倍且无重力下坠。
• 单发右键 0.2 秒 CD；Shift + 右键消耗 3 枚向前扇形齐射 3 枚（0.6 秒 CD）。
• 命中 20% 概率附加“手里剑嵌入”（每枚使目标移速 -10%，上限 3 枚 -30% 移速；再次命中刷新 8s；8s 未刷新脱落为掉落物；玩家受伤 15% 概率抖落，挥拳 10% 概率抖落）。

11. 试炼假人 (Trial Dummy)

• 专业伤害测试实体（耐久 32，不可放入物品展示框）。
• 手持右键地面放置（10 格内每人限 1 个）；假人实体无敌。
• 支持右键穿戴盔甲防具与武器，100% 继承真实护甲防御、韧性与保护附魔减免。
• 攻击不消耗武器耐久，射击箭矢原样安全回收。
• 受击产生橙色 3D 浮空跳字，ActionBar 实时显示“累计伤害 | DPS”（4s 无攻击自动归档）。
• 空手右键输出详尽历史测试报告（累计输出、有效命中次数、单次最高伤害、平均 DPS、测试时长）。
• 空手潜行右键消耗 1 耐久收回假人并无损掉落防具。

12. 稻草人 (Scarecrow) 与假目标 (Decoy Totem)

• 稻草人：田园风橡木立柱与草帽稻草人。受击产生平滑回弹摆动动画与木质音效；夜间自动变为发光南瓜灯（提供 7 级光源），白天复原。
• 假目标：右键召唤持续 15 秒的玩家幻影（复刻皮肤、装备、血量与护甲）。吸引 10 格内敌怪仇恨，受击大跳逃跑，死亡/消失爆出白烟并使周围怪物狂暴（速度 II 持续 10 秒）。

13. 地狱炖菜 (Nether Stew)

• 突破常规炖菜限制，堆叠上限达 64 个，食用恢复 7 饱食度与 8 饱和度，返还空碗。
• 赋予持续 1 分 30 秒的双刃剑效果：
  • 地狱之火：完全免疫火焰与岩浆伤害；近战 60% 概率点燃目标 2 秒；攻击着火目标近战伤害 +1。
  • 烈焰饥渴：饱食度与饱和度消耗速度翻倍。
  • 惧水：在水中时每 1 秒受到 2 点无视护甲/抗性的真实伤害。

14. 核心构件 (Cores & Slurry)

• 压缩建造浆料 (Compressed Build Slurry)：堆叠上限 64。蓝图大炮的高能建造燃料（1 份可支持构筑或破坏 64 个方块）。
• 逻辑核心 (Logic Core)：6 红石 + 1 铁锭合成，用于玩家模拟器。
• 玩家控制核心 (Player Control Core)：2 红石 + 1 红石块 + 1 玩家头颅合成，用于玩家模拟器。

15. 坚守者的心脏 (Warden Heart)

• 深暗领主核心战利品：击杀监守者时拥有 25%（每级抢夺附魔额外 +10%）概率掉落的核心战利品素材。
• 核心装备合成：作为合成【回响破障者】的核心原料（3 回响碎片 + 1 坚守者的心脏 + 1 木棍）。
• 铁砧特异性修复：可在铁砧中作为专用修补素材，修复【回响破障者】、【幽匿裂片】与【蜂刺余响】的耐久度。

---

🎰 4. 抽卡与卡池定轨系统 (Gacha System)

• 双卡池架构：
  • 常驻卡池（normal）：消耗【星旅卡牌包】（单抽）或【星旅卡牌箱】（十连抽）。
  • 樱花季限定卡池（sakura_moon）：消耗【樱花祭卡牌包】（单抽）或【樱花祭卡牌箱】（十连抽）。
• 视觉粒子与掉落物保护：
  • 抽卡时以玩家为中心发射专属烟花火箭（传说金黄星形、史诗紫爆裂、稀有蓝大球等品质变色）。
  • 烟花空中引爆后生成发光的专属掉落物，带有 30 秒专属防抢锁定，超时后自动解锁允许全员拾取。
• 卡池预览与定轨系统 (Fate Anchor)：
  • 手持卡包潜行右键可打开卡池物品与概率预览 GUI。
  • 点击任意品质物品可进行“定轨”，定轨目标四角显示红色指示箭头。
  • 常驻池传说/史诗品质命定值上限为 2（即“最多歪两次，第三次必出”），限定池与低品质命定值上限均为 1。
  • 写穿透与原子级持久化存盘，服务器关闭自动落盘，防断电防崩溃。
• 抽卡历史 GUI：输入 /cardpool history 打开 9x6 纯服务端只读历史记录界面，倒序呈现个人抽卡存根，格子背景根据稀有度彩色高亮。
• 管理指令：/cardpool info（查看卡池列表）、/cardpool stats（查看抽卡统计）、/cardpool reload（重载卡池配置）、/cardpool reset（重置保底数据）、/cardpool edit（GUI 可视化编辑卡池）。

---

📖 5. 自定义附魔体系 (Enchantments)

模组共新增 15 种富有战术深度的高级附魔：

附魔名称	英文 ID	适用装备	最大等级	获取方式	核心效果与互斥规则
灵魂绑定	soulbound	绝大多数装备	I	监守者掉落	死亡时物品不掉落，直接保留在背包中。无法通过附魔台获得。
阅历	experience	主手武器	IV	附魔台/宝箱	击杀生物所获经验每级额外增加 25%（向上取整）。对击杀玩家无效。
熔炼	smelting	镐、斧、锹	I	遗迹宝箱/村民	挖掘可烧炼方块直接掉落烧炼成品。与时运兼容，与精准采集互斥。每次挖掘额外扣 1 耐久。
连锁采掘	chain_mining	工具	IV	创造模式	按住快捷键破坏相连同类方块（16/32/48/64个）。每块消耗 0.25 饱食度并正常扣耐久。
血怒	blood_rage	剑、斧	I	附魔台/宝箱	击杀生物获 7 秒血怒：伤害 +40%，但易伤 30%。7 秒未续杯反噬 2 点真实伤害。与火焰附加互斥。
狂战士	berserker	胸甲	II	附魔台/宝箱	每损失 10% 最大生命值，近战伤害提升 5%(I) / 8%(II)（低于 5% 达上限）。代价为胸甲基础护甲值减少 35%(I) / 30%(II)。与所有保护类附魔互斥。
处决	execute	剑、斧	III	附魔台/宝箱	目标生命低于 (5 + 等级 * 10)% 触发斩杀，伤害乘数提升 等级 * 25%。反噬自身 等级 * 1.0 点真实伤害。与锋利/亡灵/节肢互斥。
连锁苦痛	chain_pain	斧	I	宝藏附魔	击杀目标时，将其 50% 溢出伤害依次传导给周围 5 格内最多 5 个敌对目标。无二次套娃。与精准采集互斥。
追踪箭	seeking_arrow	弩	I	宝藏附魔	装填瞄准时目标高亮（仅自己可见）。射出 0.5 秒后向原目标进行最大 30° 弹道智能偏转修正（含预判）。与多重射击互斥。
蜂鸣节律 ★	buzzing_rhythm	剑	IV	附魔台/宝箱/村民	连续攻击带蜂毒目标每次叠 1 层节律（最高 1+等级 层，持续 3 秒），每层伤害 +3%。每级增加 0.0625 格触及距离。与横扫之刃/火焰附加/击退及归一化体系互斥。
共振脉冲 ★	resonance_pulse	剑	III	附魔台/宝箱/村民	命中 10% * 等级 概率附加共鸣；攻击已有共鸣目标消耗共鸣，对目标及周围 2 格敌人造成 0.2 + 0.4 * 等级 音波魔法伤害。归一化互斥。
深渊律动 ★	abyssal_rhythm	剑	IV	专属抽取/创造	命中必定触发额外魔法伤害：基础伤害 (0.1~0.3) + 潮汐共鸣加成 (0.05 * 等级 * 潮汐充能层数)。不进入附魔台与战利品池。归一化互斥。
虚无共鸣 ★	void_resonance	近战武器	V	附魔台/宝箱/村民	攻击护甲为 0 的目标时，基础攻击力增加 (0.8 * 等级) * (攻速 / 基础攻击力) 点。归一化互斥。
坚盾之赐 ★	steel_shield_gift	近战武器/工具	IV	附魔台/宝箱/村民	主手提供 +0.5 * 等级 护甲。当持有者护甲超过 20 点时，每 1 点溢出护甲使伤害额外增加 (0.0625 * 等级) * 溢出点数。归一化互斥。
过载协议 ★	overload_protocol	近战武器/工具	V	附魔台/宝箱/村民	蓄力 >= 80% 攻击有 5% + 5% * 等级 概率叠加脉冲（脉冲剑固定 100%）。满 3 层释放脉冲电击造成额外电击伤害。归一化互斥。

★ 归一化附魔体系 (exclusive_normalization)： 共振脉冲、深渊律动、蜂鸣节律、虚无共鸣、坚盾之赐、过载协议 共 6 种附魔均属于归一化标签体系（tuanzis_mod:exclusive_normalization），一件装备上只能共存其中一种，杜绝无限制叠伤数值失衡！

---

🔮 6. 自定义状态效果 (Status Effects)

模组共新增 16 种状态效果：

效果名称	注册 ID	分类	核心效果描述
飞行	flight	正面	赋予生存模式自由飞行能力。到期前 15s/10s 警告，最后 5s 急促倒计时音效。
不死	undying	正面	免死回血保护（仅对玩家及驯服生物生效，防止意外保护敌人）。
血怒	blood_rage	中性	近战伤害 +40%，受到伤害 +30%，7 秒未续杯反噬 2 点真实伤害。
肾上腺素	adrenaline	正面	每级提供 +15% 攻击速度与 +7.5% 移动速度。
肾上腺素透支	adrenaline_overdraw	负面	牛奶无法消除。药效结束每级附加 30 秒虚弱 I + 挖掘疲劳 I；连续饮用等级累加惩罚翻倍。
撕裂	tearing	负面	战狼护符附加。目标发生位移时每 0.5s 受到 0.5 * 等级 魔法伤害，静止不受伤害。最高 IV 级。
手里剑嵌入	shuriken_stuck	负面	每枚嵌入使移动速度 -10%（上限 3 枚 -30%）。8 秒未刷新脱落；受伤或挥击有概率抖落。
地狱之火	hell_fire	正面	免疫火焰与岩浆伤害；近战 60% 概率点燃目标 2 秒；攻击着火目标近战伤害 +1。
烈焰饥渴	blazing_hunger	负面	饱食度与饱和度消耗速度翻倍。
惧水	hydrophobia	负面	在水中时每 1 秒受到 2 点无视护甲/抗性的真实伤害。
蜂毒	bee_poison	负面	每层使目标受到的下一次伤害提升 3%，最高 5 层。叠满 5 层引爆造成 15% 最终伤害的真实伤害。
蜂毒冷却	bee_poison_cooldown	负面	蜂毒引爆后持续 8 秒，期间免疫蜂毒叠加。
节律	buzzing_rhythm	正面	连续攻击带蜂毒目标获得，每层攻击伤害提升 3%，上限 1+等级 层。
共鸣	resonance	负面	持续 2.5 秒，被幽匿裂片或共振脉冲再次攻击时消耗并触发真实音波伤害。
潮汐侵蚀	tide_erosion	负面	潮汐切割者充能 >= 2 层时命中施加，每秒受到 1 点魔法伤害。
钢盾	steel_shield	正面	钢御壁垒命中获得，每层 +2 护甲（上限 5 层可突破 20 护甲），5 秒后平缓逐层衰减。

---

🧪 7. 药水与炼金配方 (Potions & Brewing)

• 不死药水 (Undying Potion)：
  • 普通版（3分钟）：平凡药水 (Mundane) + 不死图腾 酿造。
  • 延长版（8分钟）：不死药水 + 红石粉 酿造。
• 肾上腺素药水 (Adrenaline Potion)：
  • 普通版（45秒）：虚弱药水 + 金胡萝卜 酿造。
  • 增强版 II（30秒）：肾上腺素药水 + 萤石粉 酿造。
  • 延长版（1分30秒）：肾上腺素药水 + 红石粉 酿造。
• 飞行药水 (Flight Potion)：
  • 包含普通版（3分钟）与延长版（8分钟）。（可由创造模式物品栏直接获取，包含喷溅型、滞留型与药箭变体）。

---

👥 8. 实体列表 (Entities)

1. 假目标幻影 (Decoy) (decoy)：
   • 复刻玩家皮肤、装备与属性，周期性强力吸引 10 格内敌怪仇恨，受击大跳逃跑，消散时爆出烟花并使怪物狂暴。
2. 稻草人 (Scarecrow) (scarecrow)：
   • 经典 3D 农田稻草人，受击丝滑倾摆回弹动画与木质音效，夜间自动变身为发光南瓜灯。
3. 试炼假人 (Trial Dummy) (trial_dummy)：
   • 专业伤害与 DPS 测试假人，支持穿戴装备模拟防御，攻击不耗耐久，箭矢自动回收，伤害跳字与历史测试报告。
4. 隐形座椅 (Seat) (seat)：
   • 玩家空手右键正向楼梯时生成的隐形坐垫实体，Shift 下车安全回落至楼梯顶端并自动销毁实体。
5. 手里剑 (Shuriken) (shuriken)：
   • 极速直线无重力下坠弹射物，支持单发与潜行三发齐射，命中触发嵌入判定。

---

⚙ 9. 原版机制修改与高级特性

1. 铁砧限制彻底破除：
   • 移除了 40 级“过于昂贵 (Too Expensive!)”限制，支持消耗更高经验进行无上限合并与修复。
   • 移除了 50 字符的物品名称验证长度截断，完美支持超长自定义渐变名称。
2. 附魔兼容性增强：
   • 【无限 (Infinity)】与【经验修补 (Mending)】解除互斥，现在可以同时附在同一把弓上！
3. 监守者 (Warden) 收益与机制重构：
   • 击杀经验由 5 点大幅提升至 275 点。
   • 单体玩家造成超过 50% 最大生命值伤害时，监守者身体高亮发光，击杀时有 10%（每级抢夺 +2.5%）概率掉落**《灵魂绑定》附魔书**。
   • 击杀时有 25%（每级抢夺 +10%）概率掉落坚守者的心脏。
4. 闪电苦力怕掉落玩家正版头颅：
   • 当玩家被闪电苦力怕（Charged Creeper）炸死后，100% 掉落带有该玩家正版 UUID 与皮肤的玩家头颅。
5. 基岩可破坏与掉落：
   • 手持“尤里的复仇”可以挖掘并掉落基岩方块（其余方块无法破坏）。
6. 展示框防卡保护：
   • 禁止将试炼假人放入物品展示框中，杜绝刷实体或 NBT 丢失 Bug。
7. 规范化伤害计算模型 (DamageCalculator)：
   • 所有物理伤害加成、易伤、抗性、附魔增幅均通过统一的加法累加模型计算，并在后台输出统一规范的 ModLog.debug 日志，确保数值稳定与可追溯性。
8. Modrinth 自动更新检测器：
   • 客户端启动时异步向 Modrinth 检测新版本。主界面采用高质感平滑弹窗，内置高性能极简 Markdown 解析器与多行裁剪滚动条。
   • 支持安全无删自动升级（旧包自动重命名为 .jar.bak）。
9. 全生态 JEI 与 DataGen 集成：
   • 所有物品、方块、附魔、药水均配有详尽的中英文双语 JEI 信息页，且所有语言、配方、标签、模型均通过 Fabric DataGen 自动生成，规范严谨。

---

🔨 10. 获取途径与生存合成指南

1. 生存模式工作台合成配方 (全21种)

产出物品/方块	类型	产出数量	合成配方与所需原料	解锁条件
回响破障者	有序	1	顶部 3 个回响碎片 + 中间 1 个坚守者的心脏 + 底部 1 根木棍	获得回响碎片 / 坚守者的心脏
稻草人	无序	1	1 个干草块 + 1 根木棍 + 1 个雕刻南瓜	获得干草块
假目标	有序	1	顶中幽匿脉络；中排幻翼膜 + 稻草人 + 幻翼膜；底排萤石 + 红石 + 萤石	获得稻草人
试炼假人	有序	1	顶排 3 个干草块；中排木棍 + 稻草人 + 木棍；底排干草块 + 标靶 + 干草块	获得干草块 / 稻草人
缚灵笼	有序	1	外围 7 个铁锭环绕，顶中绿宝石块，中心灵魂沙	获得灵魂沙 / 绿宝石块
灵笼贸易站	有序	1	四角 4 个下界石英，上下 2 个幽匿块，左右 2 个红石比较器，中心 1 个缚灵笼	获得缚灵笼
逻辑核心	有序	1	上下各 3 个红石粉（共6个），中心 1 个铁锭	获得红石粉
玩家控制核心	有序	1	上下各 1 个红石粉，左侧 1 个红石块，中心 1 个玩家头颅	获得玩家头颅
玩家模拟器	有序	1	四角 4 个红石粉，上下 2 个侦测器，左中 1 个玩家控制核心，中心 1 个发射器，右中 1 个逻辑核心	获得玩家控制核心 / 逻辑核心
玩家模拟器 (净化)	无序	1	任意放入 1 个已绑定所有权的玩家模拟器（单卡无序返还无所有权净版）	获得玩家模拟器
狂暴护符	无序	1	1 个铁锭 + 2 个烈焰粉 + 1 个红石粉	获得铁锭 / 烈焰粉
工匠护符	无序	1	1 个工作台 + 2 个黑曜石 + 1 个紫水晶碎片 + 1 个下界石英	获得工作台
战狼护符	无序	1	1 个骨块 + 2 个铁锭 + 1 个幽匿脉络	获得骨块 / 铁锭 / 幽匿脉络
手里剑	有序	4	上下左右 4 个铁粒，中心 1 个下界石英	获得下界石英
地狱炖菜	无序	1	1 个碗 + 1 个绯红菌 + 1 个诡异菌 + 1 个烈焰粉 + 1 个岩浆膏	获得碗 / 绯红菌 / 诡异菌
潮汐织靴	有序	1	顶中 1 双钻石靴；中排下界合金碎片 + 海洋之心 + 下界合金碎片；底排左右各 1 个海晶晶体	获得钻石靴 / 海洋之心
彩色方块	有序	6	顶排与底排共 6 个任意颜色混凝土粉末，中排粘土球 + 水桶 + 粘土球（返还空桶）	获得粘土球
油漆桶	有序	1	2 红色染料 + 2 绿色染料 + 2 黑色染料 + 2 蓝色染料 + 1 水桶（环绕排列）	获得水桶
彩色建材染色	特殊无序	1	任意 1 个彩色方块/半砖/楼梯 + 装有颜色的油漆桶（消耗油漆桶 1 耐久）	任意放入工作台
彩色楼梯	有序	4	6 个彩色方块楼梯状摆放（自动继承并计算原料平均 RGB 颜色）	获得彩色方块
彩色半砖	有序	6	底排 3 个彩色方块横向摆放（自动继承并计算原料平均 RGB 颜色）	获得彩色方块

---

2. 卡池专属武器 (6把专属磨损武器)

以下武器拥有 5 阶段独占磨损外观与专属音效，无法通过生存工作台直接合成，主要通过抽卡系统获取：

• 蜂刺余响 (bee_sting_echo)：常驻池 / 樱花限定池抽取。
• 钢御壁垒 (steel_barrier)：常驻池 / 樱花限定池抽取。
• 裂虚之痕 (rift_scar)：常驻池 / 樱花限定池抽取。
• 幽匿裂片 (scully_shard)：常驻池 / 樱花限定池抽取。
• 潮汐切割者 (tide_cleaver)：常驻池 / 樱花限定池抽取。
• 脉冲谐振剑 (pulse_resonance_sword)：常驻池 / 樱花限定池抽取。

---

3. Boss 战利品与特殊机制掉落

• 坚守者的心脏 (warden_heart)：击杀监守者时 25%（每级抢夺 +10%）概率掉落。
• 《灵魂绑定》附魔书 (soulbound)：单人对监守者造成超过 50% 伤害击杀时 10%（每级抢夺 +2.5%）概率掉落。
• 玩家正版皮肤头颅 (player_head)：玩家被闪电苦力怕（Charged Creeper）炸死时 100% 掉落。

---

4. 宝藏探索与村民交易专属附魔

• 熔炼 (smelting)：生成于废弃矿井、远古之城、要塞、沙漠神殿等遗迹宝箱；可从制箭师、武器匠等村民处交易获得。附魔台无法产出。
• 连锁苦痛 (chain_pain)：宝藏附魔，生成于遗迹宝箱与图书管理员交易。附魔台无法产出。
• 追踪箭 (seeking_arrow)：宝藏附魔，生成于要塞宝箱与制箭师交易。附魔台无法产出。

---

5. 创造模式专属与待未来版本拓展物品

以下物品完整实现并深度集成于创造模式物品栏与 JEI 中，暂未配置生存工作台合成配方：

• 蓝图构筑设备：蓝图大炮、蓝图桌、空白蓝图、结构蓝图、压缩建造浆料。
• 高阶造物工具：塑世之笔、虚空墨锭。
• 特殊神级道具：彩虹海绵、尤里的复仇、不朽圣符、彩色变化头颅。
• 时空传送道具：旅者手札、道标符石、传送纸。
• 抽卡流通资产：星旅卡牌包/箱、樱花祭卡牌包/箱。
• 专属附魔与药水：【连锁采掘】附魔书、飞行药水（普通版/延长版/喷溅/滞留/药箭）。

---

Tuanzi's Mod - Complete Content & Mechanics Overview

Tuanzi's Mod is an advanced comprehensive gameplay expansion mod developed on Fabric Loader, tailor-made for Minecraft 26.2. The mod includes a cool ✨ sponge dyeing system, a revolutionary AI-free Soul Merchant Station, high-precision blueprint automated construction, a full player simulator, an exclusive dynamic wear weapon arsenal, a normalized deep combat enchantment system, a gacha fate anchor pity system, and deep optimizations for vanilla anvils, enchanting, alchemy, and mechanics.

---

Table of Contents

1. New Blocks & Core Systems
   • Soul Merchant Station
   • Blueprint Construction System (Blueprint Cannon / Blueprint Table / Structure Blueprint)
   • Player Simulator
   • Color Blocks & Paint Bucket
2. Exclusive Weapons & Armor Equipment
   • God-Tier Tool: Yuri's Revenge
   • Defensive Counter: Echo Breaker
   • Ultra-Fast Afterimage: Bee Sting Echo
   • City Wall Bulwark: Steel Barrier
   • Void Cleave: Rift Scar
   • Deep Dark Detonation: Sculk Shard
   • Ocean Rhythm: Tide Cleaver
   • Mechanical Conduction: Pulse Resonance Sword
   • Lightweight Armor: Tidal Weave Boots
3. Functional Items & Auxiliary Equipment
   • ✨ Sponge
   • Villager Cage
   • Traveler's Notebook & Signpost Rune
   • Craftsman Charm
   • Immortal Talisman
   • Berserk Charm
   • Wolf Command
   • World Sculptor's Pen & Void Ink Ingot
   • Chromatic Skull
   • Shuriken
   • Trial Dummy
   • Scarecrow & Decoy Totem
   • Nether Stew
   • Cores & Slurry
4. Gacha & Banner Fate Anchor System
5. Custom Enchantment System (15 Types)
6. Custom Status Effects (16 Types)
7. Potions & Brewing Recipes
8. Entity List (5 Types)
9. Vanilla Mechanic Changes & Advanced Features
10. Acquisition Routes & Survival Crafting Guide (21 Recipes)

---

🏗 1. New Blocks & Core Systems

1. Soul Merchant Station

• AI-Free Ultra-Fast Trading: After right-clicking to import a [Villager Cage] containing a villager into the trade station, right-click the trade station to directly open the native villager trading GUI (fully compatible with reputation discounts, Hero of the Village discounts, and renaming). Completely free from entity pathfinding and AI calculations, greatly optimizing server TPS and client FPS.
• Autonomous Timed Restocking Without Pathfinding: The block entity has an independent RestockTimer (8000 ticks, i.e. 8 in-game hours). When a valid and unoccupied workstation corresponding to the villager is attached to any of its adjacent 6 faces (east, west, south, north, up, down), it can automatically unlock and restock when the time is up without the villager needing to walk over and touch it. Supports NBT saving and is unaffected by sleeping or /time set command timing jumps.
• Safe Removal & Facing Lock: Sneak-right-click the trade station with an empty Villager Cage to recover the villager losslessly; sneak-right-click the trade station with a non-empty item to make the miniature 3D villager inside rotate 90° clockwise to lock its facing.
• Absolute Explosion Protection: The block has extremely high explosion resistance and is immune to all explosion destruction such as TNT and creepers.

2. Blueprint Construction System

• Blueprint Cannon:
  • Survival mode automated building machine, work efficiency 5 ticks/block.
  • Smart material retrieval: automatically scans chests, barrels, shulker boxes within 5 blocks, with multi-layer recursive penetration (supports up to 3 layers of nested shulker boxes) and automatic material deduction.
  • Fuel: consumes [Compressed Build Slurry] as energy (no fuel in creative mode).
  • Control & settings: GUI has ▶ (Start), ⏸ (Pause), ⏹ (Stop) controls, wide real-time colored progress bar (highlights red warning when materials/fuel are missing), supports "remove wrong blocks (drop/destroy)" and "precise NBT matching".
  • Material list generation: put "Book and Quill" in the slot and click "List"; the system server-side scans surrounding materials and generates a formatted written book with ✔ (enough, green) and ✗ (missing, red) layout.
  • Entity printing support: supports printing armor stands, item frames, mobs, etc. within the area (consumes corresponding spawn eggs/entity items).
• Blueprint Table:
  • High-tech projection file interaction table.
  • Export: put in a Structure Blueprint and click Export to generate a standard .litematic projection file in the blueprints directory.
  • Import: retrieve external .litematic or .schem projection files from the blueprints directory, consume a Blank Blueprint to generate a Structure Blueprint.
  • 3D real perspective preview: left-side attached scrolling list; click preview to seamlessly switch to a 3D miniature stereoscopic building model with real perspective projection (high-fidelity block material rendering, automatic pixel thinning at extremely small sizes, excellent performance).
• Blank Blueprint & Structure Blueprint:
  • Hold a Blank Blueprint and right-click the two diagonal corners, then click the [Confirm Construction] link in chat to record all blocks, states, block entity NBT, and non-player entities within the cuboid area (volume limit 262,144 blocks), consuming the Blank Blueprint to generate a Structure Blueprint.
  • Hold a Structure Blueprint and right-click the ground to place a semi-transparent BlockDisplay ghost.
  • Dedicated hotkeys: R rotate ghost, F horizontal mirror, Ctrl + arrow keys/PgUp/PgDn translate and height adjust, V hide/show ghost, G open the ghost control floating panel.

3. Player Simulator

• Full Behavior Simulation: An advanced redstone block that simulates real player behavior. Built-in 3x3 simulated hotbar (supports hopper input from top/sides, extraction from bottom).
• Pulse Polling Trigger: When receiving a redstone rising-edge pulse, executes one non-empty slot action in row-major order ((0,0) → (0,1) → ... → (2,2)) in turn.
• Right-Click Use Priority: Prioritizes executing useOn on the block or entity on the facing side (placing blocks, shearing sheep, applying bone meal, filling/emptying water, etc.); if invalid, attempts air use (instant eating, drinking potions, drawing bow and shooting arrows, etc.).
• Left-Click Attack & Mining:
  • Left-click attack charge mechanism: when there is an entity in front, enters attack charge pending state, accumulates charge ticks (chargeTicks) while redstone signal remains, and releases a full-charge lethal attack the moment it disconnects!
  • Real mining mechanism: when there is a hard block in front, suspends and spends actual game ticks to break it, displaying block breaking progress cracks. Fully inherits vanilla tool durability loss logic, durability enchantment reduction, and Fortune/Silk Touch drop calculations.
• Owner Binding System:
  • Records owner UUID and name when placed; damage, kill experience, and mob aggro generated by the simulator are all redirected to the online owner.
  • Anti-theft protection: non-owners attempting to place a simulator with an ownership tag will be intercepted and warned.
  • One-Click Purification: shapelessly craft the simulator by itself in a crafting table to clear the ownership tag.

4. Color Blocks & Paint Bucket

• Color Block / Color Slab / Color Stairs: Pure borderless custom modern decorative building materials.
  • Block dyeing: shapelessly craft in a crafting table with a paint bucket containing color, consuming 1 point of paint bucket durability each time.
  • Independent double-slab dyeing: allows two different colored slabs to be stacked into a double slab, with the upper and lower layers each retaining and rendering their dyed colors; when mined, drops the original separately colored slabs.
  • Crafting color inheritance: when using colored Color Blocks to craft stairs (outputs 4) or slabs (outputs 6), automatically inherits the average RGB color of all input materials.
  • Accurate map display: Color Blocks, stairs, and single slabs directly display their corresponding dyed color on maps; double slabs intelligently display the top slab color.
• Paint Bucket: durability 256 uses.
  • Right-click to open the exclusive 300x150 widescreen RGB palette GUI.
  • Supports R/G/B three-color sliders (0-255) for precise adjustment, hexadecimal Hex text input box with bidirectional seamless linkage, 16 vanilla dye color quick preset buttons, and large color swatch real-time preview.

---

⚔ 2. Exclusive Weapons & Armor Equipment

Equipment Name	Base Panel	Attack Speed	Durability	Core Exclusive Mechanic
Yuri's Revenge	-	-	5	The only tool that can break bedrock. Simulates hardness 50 to quickly break bedrock and drop it; cannot mine other blocks.
Echo Breaker	8.0	1.2	1550	Main hand reduces 15% sonic damage; empty offhand right-click performs 0.75s perfect block (immune to 100% sonic), reflects 18 true damage and strong knockback. Repaired with Warden Heart.
Bee Sting Echo	6.5	2.1	2031	Reach distance -0.25 blocks, no sweeping. Hits stack "Bee Poison" (each stack +3% damage), at 5 stacks detonates dealing 15% final damage as true damage. Has 5-stage wear. Repaired with Warden Heart.
Steel Barrier	6.7	1.6	2031	Hits stack 1 "Steel Shield" (each stack +2 armor, up to 5 stacks breaking the 20 cap), lasts 5s then decays 1 stack every 5s smoothly. Repaired with Netherite Ingot.
Rift Scar	4.12	2.0	2031	Void Cleave: when attacking a target with 0 armor, final damage dealt is increased to 175%. Repaired with Eye of Ender.
Sculk Shard	9.0	1.25	2031	Hits apply 2.5s "Resonance"; hitting a target already affected by Resonance consumes Resonance and deals 2.0 true sonic magic damage. Silent shard does not shatter. Repaired with Warden Heart.
Tide Cleaver	6.3	1.66	2031	Tidal Rhythm: cooldown charge 80%~100% (or within 0.2s after full) rhythm attacks stack charge (max 5, each +2% damage); off-beat attacks below 80% reduce damage by 15% and lose charge; >=2 stacks apply "Tide Erosion" DOT; 5-stack on-beat triggers Tidal Surge burst (3 magic true damage, 7s CD). Repaired with Heart of the Sea.
Pulse Resonance Sword	5.0	2.5	2031	Attack charge >= 80% hits stack capacitor pulse, at 3 stacks the next attack releases pulse shock (additional 3.0 lightning damage). Repaired with Copper Ingot/Redstone Block.
Tidal Weave Boots	3 Armor / 2 Toughness	-	429	Wave-Walking: walk/sprint/jump on water as on land; Dive toggle: hold Shift to sink into water, return to surface to resume walking; falling into water from high altitude completely prevents fall damage. Repaired with Phantom Membrane/Prismarine Crystals.

[!NOTE] Permanent Wear System: Bee Sting Echo, Steel Barrier, Rift Scar, Sculk Shard, Tide Cleaver, Pulse Resonance Sword all randomly generate wear (0.0001 ~ 1.0) at birth, permanently fixed. Divided into five independent appearance stages, using dual-layer smooth interpolation rendering; hit sound pitch shifts lower as wear deepens. Hold Shift to view detailed background story and wear details.

---

🎒 3. Functional Items & Auxiliary Equipment

1. ✨ Sponge

• Name Programming Card: stack limit 1. Breaks vanilla anvil 50-character length limit.
• In an anvil, rename ✨ Sponge and input command codes, then merge it with the target item to permanently render the style onto the item name.
• Syntax Quick Reference:
  • Hexadecimal color: #FF5555 (bright red)
  • Classic style codes: &l (bold), &o (italic), &n (underline)
  • Multi-segment cyclic split: &c,&b,&l (comma-separated, applied to characters in turn)
  • Smooth random gradient: &q3#FF0000 (smooth gradient from starting color for the next 3 characters)
  • Linear two-color gradient: &q5#FF0000-#0000FF (smooth gradient between two colors for 5 characters)
  • Attribute reset: &r (completely clears all custom colors and styles from the item)

2. Villager Cage

• Villager Sealing Device: single-use (durability 1). Right-click a villager to seal into cage, fully preserving profession, level, trades, renaming, and trade counts.
• Guardian Punishment: if capturing a villager within 16 blocks of an iron golem's guard range, all nearby iron golems are instantly enraged.
• Safe Release: sneak + right-click solid block to release (requires 2 blocks of height space). Supports cross-dimensional transport.

3. Traveler's Notebook & Signpost Rune

• Traveler's Notebook: right-click to open crystal book teleport GUI; sneak+right-click to open internal storage GUI (Slot 0 only for teleport paper charging, max 64 points; Slot 1-26 for bound Signpost Runes).
  • Teleport cost: same dimension 1 energy, cross-dimension 2 energy.
  • Teleport accompanied by 3-second stationary channel; interrupted immediately by damage or movement. Cooldown: same dimension 3 seconds, cross-dimension 5 seconds.
  • When the item entity is destroyed by fire or explosion, all runes and teleport paper inside burst out at the original location.
• Signpost Rune: right-click to bind current coordinates and dimension; can be renamed in an anvil as destination title in the notebook.
• Teleport Paper: the only charging material for the notebook, each converts to 1 energy.

4. Portable Artifact: Craftsman Charm

• Right-click directly opens 3x3 portable crafting table GUI.
• Material Cache: charm has 9 independent cache slots; when GUI closes, materials remain in charm and do not drop.
• JEI Perfect Integration: supports clicking "+" in JEI recipe GUI to fill backpack materials into portable crafting grid in one click.
• Anti-dupe Safety: charm cannot be placed into its own cache slots; dragging the held charm in GUI automatically force-closes the GUI.

5. Life-Saving Artifact: Immortal Talisman

• Effective when placed in backpack inventory.
• When player dies, automatically consumes 1 talisman, preserves all player items, equipment, and experience, preventing death drops!

6. Berserk Charm

• Effective when placed in offhand. When health is below 30%, automatically consumes 1 charm, grants 15 seconds Strength II + Speed II.
• Has 15-second internal cooldown (white overlay) to prevent continuous consumption.

7. Wolf Command

• Effective in offhand (durability 3, unrepairable, removing from offhand triggers 5-second cooldown penalty).
• Tamed wolf max health +4; wolf attacks have 15% chance to apply "Tearing" debuff (movement causes magic damage).
• Death Protection: when wolf takes fatal damage, consumes 1 durability, avoids death and heals to full, gains 5 seconds invincibility and enrage (double attack speed, increased movement speed, increased damage).
• Exhaustion & Revival: after enrage the wolf collapses exhausted (1 health, invincible damage immunity, forced sit, lead prohibited), feed 10 rotten flesh to revive with full health!

8. World Sculptor's Pen & Void Ink Ingot

• World Sculptor's Pen: durability 8192, unenchantable.
  • Batch fill: right-click start point, right-click end point within 64 blocks straight-line distance, 2048 blocks volume, cuboid area instantly filled.
  • Color picking & selection: Shift + right-click block to set fill type (small icon rendered in lower right, perfectly extracts color block RGB).
  • Smart consumption: directly deduct blocks from main inventory and shulker boxes (supports precise deduction of same-color blocks).
  • Anti-dupe undo: within 60 seconds after filling, Shift + right-click facing air to undo, only restores unmodified blocks and returns blocks and pen durability, complete backup and restoration of block entity NBT.
  • Safety protection: prohibits breaking or filling bedrock and other unbreakable blocks with hardness -1.
• Void Ink Ingot: exclusively used to repair World Sculptor's Pen by a fixed 1000 durability in an anvil. If placed with other equipment in an anvil, output slot displays redstone dust "Ink Incompatible" red warning and cannot be taken.

9. Chromatic Skull

• Stack limit 16. Hold and right-click to open input panel, input any genuine Minecraft player name (3~16 characters), click confirm to consume 1 skull, immediately obtain that player's genuine skin skull.

10. Ultra-Fast Hidden Weapon: Shuriken

• Damage 2, flight speed 1.5x arrow and no gravity drop.
• Single right-click 0.2s CD; Shift + right-click consumes 3 shurikens to fire 3 in a forward fan (0.6s CD).
• On hit 20% chance to apply "Shuriken Stuck" (each shuriken reduces target movement speed by -10%, max 3 shurikens -30% movement speed; re-hit refreshes 8s; if not refreshed after 8s, falls off as drop; player injury 15% chance to shake off, punch 10% chance to shake off).

11. Trial Dummy

• Professional damage test entity (durability 32, cannot be placed in item frame).
• Hold and right-click ground to place (one per person within 10 blocks); dummy entity is invincible.
• Supports right-click to equip armor and weapons, 100% inherits real armor defense, toughness, and protection enchantment reduction.
• Attacks do not consume weapon durability; shot arrows are safely recovered as-is.
• On hit produces orange 3D floating damage numbers, ActionBar displays in real time "Total Damage | DPS" (auto-archives after 4s without attack).
• Empty-hand right-click outputs detailed historical test report (total output, effective hit count, single highest damage, average DPS, test duration).
• Empty-hand sneak-right-click consumes 1 durability to retrieve dummy and drops armor losslessly.

12. Scarecrow & Decoy Totem

• Scarecrow: pastoral oak post and straw hat scarecrow. On hit produces smooth rebound swing animation and wooden sound; at night automatically turns into glowing jack o'lantern (provides light level 7), returns to normal during day.
• Decoy Totem: right-click summons a 15-second player phantom (replicates skin, equipment, health, and armor). Attracts mob aggro within 10 blocks, on hit jumps away, on death/disappearance bursts white smoke and enrages nearby monsters (Speed II for 10 seconds).

13. Nether Stew

• Breaks conventional stew limit, stack limit up to 64, eating restores 7 hunger and 8 saturation, returns empty bowl.
• Grants a 1 minute 30 second double-edged effect:
  • Hell Fire: complete immunity to fire and lava damage; melee 60% chance to ignite target for 2 seconds; attacks against burning targets deal +1 melee damage.
  • Blazing Hunger: hunger and saturation consumption speed doubled.
  • Hydrophobia: while in water takes 2 true damage per second ignoring armor/resistance.

14. Cores & Slurry

• Compressed Build Slurry: stack limit 64. High-energy construction fuel for Blueprint Cannon (1 portion supports constructing or destroying 64 blocks).
• Logic Core: 6 redstone + 1 iron ingot, used for Player Simulator.
• Player Control Core: 2 redstone + 1 redstone block + 1 player head, used for Player Simulator.

15. Warden Heart

• Deep Dark Lord Core Loot: killing a Warden has 25% (each level of Looting +10%) chance to drop core loot material.
• Core Equipment Crafting: as core material for crafting [Echo Breaker] (3 Echo Shards + 1 Warden Heart + 1 Stick).
• Anvil Specific Repair: can be used in an anvil as dedicated repair material to repair [Echo Breaker], [Sculk Shard], and [Bee Sting Echo] durability.

---

🎰 4. Gacha & Banner Fate Anchor System

• Dual Banner Architecture:
  • Standard banner (normal): consumes [Star Journey Card Pack] (single pull) or [Star Journey Card Box] (ten pull).
  • Sakura Season Limited Banner (sakura_moon): consumes [Sakura Festival Card Pack] (single pull) or [Sakura Festival Card Box] (ten pull).
• Visual Particles & Drop Protection:
  • During gacha, launches exclusive fireworks rockets centered on player (legendary gold star, epic purple burst, rare blue large ball, etc., color changes by quality).
  • After fireworks explode in air, generates glowing exclusive drops with 30-second exclusive anti-steal lock; after timeout automatically unlocks and allows all players to pick up.
• Banner Preview & Fate Anchor:
  • Hold card pack and sneak-right-click to open banner item and probability preview GUI.
  • Click any quality item to "Fate Anchor"; red indicator arrows appear at the four corners of the anchored target.
  • Standard banner legendary/epic quality fate value cap is 2 (i.e. "can lose at most twice, third is guaranteed"), limited banner and low-quality fate value cap is 1.
  • Write-through and atomic-level persistent saving, server shutdown automatically writes to disk, resistant to power outage and crashes.
• Gacha History GUI: input /cardpool history to open 9x6 pure server-side read-only history record GUI, displaying personal gacha receipts in reverse order, cell backgrounds colored highlighted by rarity.
• Admin Commands: /cardpool info (view banner list), /cardpool stats (view gacha stats), /cardpool reload (reload banner config), /cardpool reset (reset pity data), /cardpool edit (GUI visual banner editing).

---

📖 5. Custom Enchantment System (Enchantments)

The mod adds a total of 15 advanced enchantments with deep tactical depth:

Enchantment Name	English ID	Applicable Equipment	Max Level	Acquisition	Core Effects & Mutual Exclusions
Soulbound	soulbound	Most equipment	I	Warden drop	Items do not drop on death, directly kept in inventory. Cannot be obtained via enchanting table.
Experience	experience	Main-hand weapon	IV	Enchanting table/Loot chest	EXP from killing mobs increased by 25% per level (rounded up). Does not work on player kills.
Smelting	smelting	Pickaxe, axe, shovel	I	Ruins chests/Villagers	Mining smeltable blocks directly drops smelted product. Compatible with Fortune, mutually exclusive with Silk Touch. Each mining consumes 1 extra durability.
Chain Mining	chain_mining	Tools	IV	Creative mode	Hold hotkey to break connected same-type blocks (16/32/48/64). Each block consumes 0.25 hunger and normally consumes durability.
Blood Rage	blood_rage	Sword, axe	I	Enchanting table/Loot chest	Killing mobs grants 7s Blood Rage: damage +40%, but vulnerability +30%. If not refreshed within 7s, backlash 2 true damage. Mutually exclusive with Fire Aspect.
Berserker	berserker	Chestplate	II	Enchanting table/Loot chest	For every 10% max health lost, melee damage increases by 5% (I) / 8% (II) (cap reached below 5%). Cost is chestplate base armor reduced by 35% (I) / 30% (II). Mutually exclusive with all protection enchantments.
Execute	execute	Sword, axe	III	Enchanting table/Loot chest	Target health below (5 + level * 10)% triggers execution, damage multiplier increased by level * 25%. Backlash self level * 1.0 true damage. Mutually exclusive with Sharpness/Smite/Bane of Arthropods.
Chain Pain	chain_pain	Axe	I	Treasure enchantment	On killing target, 50% of overflow damage is transmitted to up to 5 hostile targets within 5 blocks. No secondary chaining. Mutually exclusive with Silk Touch.
Seeking Arrow	seeking_arrow	Crossbow	I	Treasure enchantment	When loaded and aiming target is highlighted (visible only to self). 0.5s after firing, performs up to 30° ballistic intelligent deflection correction toward original target (including prediction). Mutually exclusive with Multishot.
Buzzing Rhythm ★	buzzing_rhythm	Sword	IV	Enchanting table/Loot chest/Villagers	Consecutive attacks on targets with Bee Poison stack 1 Rhythm each time (max 1+level stacks, lasts 3 seconds), each stack +3% damage. Each level increases reach by 0.0625 blocks. Mutually exclusive with Sweeping Edge/Fire Aspect/Knockback and Normalization System.
Resonance Pulse ★	resonance_pulse	Sword	III	Enchanting table/Loot chest/Villagers	On hit 10% * level chance to apply Resonance; attacking a target already affected by Resonance consumes Resonance, dealing 0.2 + 0.4 * level sonic magic damage to target and enemies within 2 blocks. Normalization exclusive.
Abyssal Rhythm ★	abyssal_rhythm	Sword	IV	Exclusive draw/Creative	On hit always triggers extra magic damage: base damage (0.1~0.3) + Tidal Resonance bonus (0.05 * level * Tide Charge stacks). Does not enter enchanting table or loot pool. Normalization exclusive.
Void Resonance ★	void_resonance	Melee weapon	V	Enchanting table/Loot chest/Villagers	When attacking a target with 0 armor, base attack power increases by (0.8 * level) * (attack speed / base attack power) points. Normalization exclusive.
Steel Shield Gift ★	steel_shield_gift	Melee weapon/tool	IV	Enchanting table/Loot chest/Villagers	Main hand provides +0.5 * level armor. When holder's armor exceeds 20 points, every 1 point of overflow armor increases damage by (0.0625 * level) * overflow points. Normalization exclusive.
Overload Protocol ★	overload_protocol	Melee weapon/tool	V	Enchanting table/Loot chest/Villagers	Charge >= 80% attack has 5% + 5% * level chance to stack pulse (Pulse Sword fixed 100%). At 3 stacks releases pulse shock dealing extra lightning damage. Normalization exclusive.

★ Normalized Enchantment System (exclusive_normalization): Resonance Pulse, Abyssal Rhythm, Buzzing Rhythm, Void Resonance, Steel Shield Gift, Overload Protocol — 6 enchantments all belong to the normalization tag system (tuanzis_mod:exclusive_normalization). Only one of them can coexist on a piece of equipment, preventing unlimited damage stacking and numerical imbalance!

---

🔮 6. Custom Status Effects (Status Effects)

The mod adds a total of 16 status effects:

Effect Name	Registry ID	Category	Core Effect Description
Flight	flight	Positive	Grants survival mode free flight. Warns at 15s/10s before expiration, rapid countdown sound in last 5s.
Undying	undying	Positive	Death immunity and healing protection (only effective for players and tamed creatures, prevents accidental protection of enemies).
Blood Rage	blood_rage	Neutral	Melee damage +40%, damage taken +30%, if not refreshed within 7s backlash 2 true damage.
Adrenaline	adrenaline	Positive	Each level grants +15% attack speed and +7.5% movement speed.
Adrenaline Overdraw	adrenaline_overdraw	Negative	Cannot be removed by milk. After effect ends, each level applies 30 seconds Weakness I + Mining Fatigue I; consecutive drinking doubles cumulative penalty.
Tearing	tearing	Negative	Applied by Wolf Command. When target moves, takes 0.5 * level magic damage every 0.5s, no damage while stationary. Max level IV.
Shuriken Stuck	shuriken_stuck	Negative	Each embedded shuriken reduces movement speed by -10% (max 3 -30%). Falls off if not refreshed after 8s; injury or swing has chance to shake off.
Hell Fire	hell_fire	Positive	Immune to fire and lava damage; melee 60% chance to ignite target for 2s; attacks against burning targets deal +1 melee damage.
Blazing Hunger	blazing_hunger	Negative	Hunger and saturation consumption speed doubled.
Hydrophobia	hydrophobia	Negative	While in water takes 2 true damage per second ignoring armor/resistance.
Bee Poison	bee_poison	Negative	Each stack increases next damage taken by target by 3%, max 5 stacks. At 5 stacks detonates dealing 15% final damage as true damage.
Bee Poison Cooldown	bee_poison_cooldown	Negative	Lasts 8 seconds after Bee Poison detonation, during which immune to Bee Poison stacking.
Buzzing Rhythm	buzzing_rhythm	Positive	Obtained by consecutive attacks on targets with Bee Poison, each stack increases attack damage by 3%, max 1+level stacks.
Resonance	resonance	Negative	Lasts 2.5 seconds; when hit again by Sculk Shard or Resonance Pulse, consumed and triggers true sonic damage.
Tide Erosion	tide_erosion	Negative	Applied on hit when Tide Cleaver charge >= 2 stacks, takes 1 magic damage per second.
Steel Shield	steel_shield	Positive	Obtained on hit by Steel Barrier, each stack +2 armor (max 5 stacks can exceed 20 armor), after 5 seconds smoothly decays stack by stack.

---

🧪 7. Potions & Brewing Recipes

• Undying Potion:
  • Normal (3 min): Mundane Potion + Totem of Undying brewing.
  • Extended (8 min): Undying Potion + Redstone Dust brewing.
• Adrenaline Potion:
  • Normal (45 sec): Potion of Weakness + Golden Carrot brewing.
  • Enhanced II (30 sec): Adrenaline Potion + Glowstone Dust brewing.
  • Extended (1 min 30 sec): Adrenaline Potion + Redstone Dust brewing.
• Flight Potion:
  • Includes normal (3 min) and extended (8 min). (Can be obtained directly from creative inventory, including splash, lingering, and tipped arrow variants.)

---

👥 8. Entity List (Entities)

1. Decoy (decoy):
   • Replicates player skin, equipment, attributes, periodically strongly attracts mob aggro within 10 blocks, on hit jumps away, on dissipation bursts fireworks and enrages monsters.
2. Scarecrow (scarecrow):
   • Classic 3D farm scarecrow, smooth tilt rebound animation and wooden sound on hit, automatically transforms into glowing jack o'lantern at night.
3. Trial Dummy (trial_dummy):
   • Professional damage and DPS test dummy, supports wearing equipment to simulate defense, attacks do not consume durability, arrows auto-recover, damage numbers and historical test report.
4. Seat (seat):
   • Invisible seat entity generated when player empty-hand right-clicks a forward-facing stairs; Shift to dismount safely falls back to top of stairs and entity auto-destroys.
5. Shuriken (shuriken):
   • Ultra-fast straight-line no-gravity projectile, supports single shot and sneak triple fan volley, on hit triggers embed check.

---

⚙ 9. Vanilla Mechanic Changes & Advanced Features

1. Anvil Restrictions Completely Removed:
   • Removed the 40-level "Too Expensive!" limit, supports unlimited merging and repair by consuming higher experience.
   • Removed the 50-character item name validation length truncation, perfectly supports ultra-long custom gradient names.
2. Enchantment Compatibility Enhanced:
   • [Infinity] and [Mending] mutual exclusion removed, now can be enchanted on the same bow at the same time!
3. Warden Loot & Mechanic Rework:
   • Kill experience greatly increased from 5 to 275.
   • When a single player deals more than 50% max health damage, Warden body glows highlighted, and on kill has 10% (each Looting level +2.5%) chance to drop Soulbound enchanted book.
   • On kill has 25% (each Looting level +10%) chance to drop Warden Heart.
4. Lightning Creeper Drops Player Genuine Head:
   • When a player is killed by a Charged Creeper explosion, 100% drops a player head with that player's genuine UUID and skin.
5. Bedrock Breakable & Drops:
   • Holding "Yuri's Revenge" can mine and drop bedrock blocks (cannot break other blocks).
6. Item Frame Anti-Exploit Protection:
   • Prohibits placing Trial Dummy into item frames, eliminating entity duplication or NBT loss bugs.
7. Normalized Damage Calculation Model (DamageCalculator):
   • All physical damage bonuses, vulnerability, resistance, and enchantment increases are calculated through a unified additive accumulation model, and output unified standardized ModLog.debug logs in the background, ensuring numerical stability and traceability.
8. Modrinth Auto Update Checker:
   • Client asynchronously checks Modrinth for new versions on startup. Main menu uses high-quality smooth popup, built-in high-performance minimalist Markdown parser and multi-line clipped scrollbar.
   • Supports safe no-delete auto-upgrade (old package automatically renamed to .jar.bak).
9. Full Ecosystem JEI & DataGen Integration:
   • All items, blocks, enchantments, potions have detailed Chinese-English bilingual JEI info pages, and all languages, recipes, tags, models are automatically generated via Fabric DataGen, standardized and rigorous.

---

🔨 10. Acquisition Routes & Survival Crafting Guide

1. Survival Mode Crafting Table Recipes (All 21)

Output Item/Block	Type	Output Qty	Crafting Recipe & Required Materials	Unlock Condition
Echo Breaker	Shaped	1	Top 3 Echo Shards + middle 1 Warden Heart + bottom 1 Stick	Obtain Echo Shard / Warden Heart
Scarecrow	Shapeless	1	1 Hay Bale + 1 Stick + 1 Carved Pumpkin	Obtain Hay Bale
Decoy Totem	Shaped	1	Top middle Sculk Vein; middle row Phantom Membrane + Scarecrow + Phantom Membrane; bottom row Glowstone + Redstone + Glowstone	Obtain Scarecrow
Trial Dummy	Shaped	1	Top row 3 Hay Bales; middle row Stick + Scarecrow + Stick; bottom row Hay Bale + Target + Hay Bale	Obtain Hay Bale / Scarecrow
Villager Cage	Shaped	1	Outer 7 Iron Ingots surrounding, top middle Block of Emerald, center Soul Sand	Obtain Soul Sand / Block of Emerald
Soul Merchant Station	Shaped	1	Four corners 4 Nether Quartz, top and bottom 2 Sculk Blocks, left and right 2 Redstone Comparators, center 1 Villager Cage	Obtain Villager Cage
Logic Core	Shaped	1	Top and bottom each 3 Redstone Dust (6 total), center 1 Iron Ingot	Obtain Redstone Dust
Player Control Core	Shaped	1	Top and bottom each 1 Redstone Dust, left 1 Block of Redstone, center 1 Player Head	Obtain Player Head
Player Simulator	Shaped	1	Four corners 4 Redstone Dust, top and bottom 2 Observers, left middle 1 Player Control Core, center 1 Dispenser, right middle 1 Logic Core	Obtain Player Control Core / Logic Core
Player Simulator (Purified)	Shapeless	1	Any 1 ownership-bound Player Simulator (single-card shapeless returns purified no-ownership version)	Obtain Player Simulator
Berserk Charm	Shapeless	1	1 Iron Ingot + 2 Blaze Powder + 1 Redstone Dust	Obtain Iron Ingot / Blaze Powder
Craftsman Charm	Shapeless	1	1 Crafting Table + 2 Obsidian + 1 Amethyst Shard + 1 Nether Quartz	Obtain Crafting Table
Wolf Command	Shapeless	1	1 Bone Block + 2 Iron Ingots + 1 Sculk Vein	Obtain Bone Block / Iron Ingot / Sculk Vein
Shuriken	Shaped	4	Top/bottom/left/right 4 Iron Nuggets, center 1 Nether Quartz	Obtain Nether Quartz
Nether Stew	Shapeless	1	1 Bowl + 1 Crimson Fungus + 1 Warped Fungus + 1 Blaze Powder + 1 Magma Cream	Obtain Bowl / Crimson Fungus / Warped Fungus
Tidal Weave Boots	Shaped	1	Top middle 1 pair Diamond Boots; middle row Netherite Scrap + Heart of the Sea + Netherite Scrap; bottom left/right each 1 Prismarine Crystals	Obtain Diamond Boots / Heart of the Sea
Color Block	Shaped	6	Top and bottom rows total 6 any color concrete powder, middle row Clay Ball + Water Bucket + Clay Ball (returns empty bucket)	Obtain Clay Ball
Paint Bucket	Shaped	1	2 Red Dye + 2 Green Dye + 2 Black Dye + 2 Blue Dye + 1 Water Bucket (arranged in a ring)	Obtain Water Bucket
Color Building Block Dyeing	Special Shapeless	1	Any 1 Color Block/Slab/Stairs + colored Paint Bucket (consumes 1 Paint Bucket durability)	Any placed in crafting table
Color Stairs	Shaped	4	6 Color Blocks arranged in stairs shape (automatically inherits and calculates average RGB color of materials)	Obtain Color Block
Color Slab	Shaped	6	Bottom row 3 Color Blocks placed horizontally (automatically inherits and calculates average RGB color of materials)	Obtain Color Block

---

2. Banner-Exclusive Weapons (6 Exclusive Wear Weapons)

The following weapons have 5-stage exclusive wear appearances and exclusive sound effects, cannot be directly crafted at a survival crafting table, mainly obtained through the gacha system:

• Bee Sting Echo (bee_sting_echo): Standard banner / Sakura limited banner.
• Steel Barrier (steel_barrier): Standard banner / Sakura limited banner.
• Rift Scar (rift_scar): Standard banner / Sakura limited banner.
• Sculk Shard (scully_shard): Standard banner / Sakura limited banner.
• Tide Cleaver (tide_cleaver): Standard banner / Sakura limited banner.
• Pulse Resonance Sword (pulse_resonance_sword): Standard banner / Sakura limited banner.

---

3. Boss Loot & Special Mechanic Drops

• Warden Heart (warden_heart): 25% (each Looting level +10%) chance to drop when killing a Warden.
• Soulbound Enchanted Book (soulbound): 10% (each Looting level +2.5%) chance to drop when a single player deals more than 50% damage and kills the Warden.
• Player Genuine Skin Head (player_head): 100% drop when player is killed by a Charged Creeper explosion.

---

4. Treasure Exploration & Villager Trade Exclusive Enchantments

• Smelting (smelting): generated in abandoned mineshafts, Ancient Cities, strongholds, desert temples and other ruin chests; obtainable by trading with fletchers, weaponsmiths, etc. Cannot be produced by enchanting table.
• Chain Pain (chain_pain): treasure enchantment, generated in ruin chests and librarian trades. Cannot be produced by enchanting table.
• Seeking Arrow (seeking_arrow): treasure enchantment, generated in stronghold chests and fletcher trades. Cannot be produced by enchanting table.

---

5. Creative Mode Exclusive & Future Version Expansion Items

The following items are fully implemented and deeply integrated into creative inventory and JEI, but do not yet have survival crafting table recipes:

• Blueprint Construction Equipment: Blueprint Cannon, Blueprint Table, Blank Blueprint, Structure Blueprint, Compressed Build Slurry.
• High-Tier Creation Tools: World Sculptor's Pen, Void Ink Ingot.
• Special God-Tier Items: ✨ Sponge, Yuri's Revenge, Immortal Talisman, Chromatic Skull.
• Space-Time Teleport Items: Traveler's Notebook, Signpost Rune, Teleport Paper.
• Gacha Circulation Assets: Star Journey Card Pack/Box, Sakura Festival Card Pack/Box.
• Exclusive Enchantments & Potions: [Chain Mining] enchanted book, Flight Potion (normal/extended/splash/lingering/tipped arrow).