团子的模组 (Tuanzi's Mod)

团子的模组 是一个基于 Fabric Loader 开发的高级功能与玩法拓展模组，专为 Minecraft 26.1 (Tiny Takeover) 版本量身定制。本模组集成了炫酷的彩虹海绵染色系统、颠覆性的无 AI 灵笼贸易站、多款战术护符与专属武器、数十种极富创意的奇特附魔，以及针对炼金与铁砧体验的深度重构。

---

🌟 核心特色 (Core Features)

🌈 1. 彩虹海绵染色系统 (Rainbow Sponge System)

彩虹海绵（原名颜色海绵，堆叠上限已调整为 1）是玩家的“名称编程卡”。通过在铁砧中进行“编程”与“应用”，玩家可以将前所未有的炫酷样式渲染到任何物品的名字上！

• 解除限制：彻底打破了原版铁砧重命名的 50 字符长度限制。
• 铁砧编程：在铁砧中通过给彩虹海绵重命名来输入指令代码。
• 无缝合并：将已命名的海绵与目标物品合并，即可将缤纷的格式与渐变实时渲染至物品名称上。

📄 指令语法说明：

效果类型	示例代码	功能说明
十六进制颜色	#FF5555	应用精确的 16 进制颜色（如亮红色）。
原版经典样式	&l, &o, &n	支持加粗、倾斜、下划线等传统样式（使用 & 代替 §）。
多段分割系统	&c,&b,&l	使用逗号分隔不同样式，按字符顺序循环应用到物品名中。
智能随机渐变	&q3#FF0000	基于起始色，为接下来的 N 个字生成平滑随机渐变。
线性双色渐变	&q5#FF0000-#0000FF	在起始色与结束色之间生成丝滑的线性过渡渐变。
重置属性	&r	清除目标物品上所有自定义的颜色与样式属性。

[!NOTE] 经验费用规则：

• 十六进制颜色：命名海绵 8 级 / 合并物品 32 级
• 原版样式（每项）：命名 +4 级 / 合并 +16 级
• 分割符（每逗号）：命名 +2 级 / 合并 +8 级
• 渐变字符（每个字）：命名 8 级 / 合并 32 级
• 重置样式：命名 1 级 / 合并 16 级

---

💼 2. 灵笼与无 AI 贸易站 (Villager Caging & AI-less Trading)

为了彻底解决村民运输难以及实体寻路导致的 TPS/FPS 暴跌问题，本模组引入了高效的“灵笼”工业系统。

• 缚灵笼 (Villager Cage)：
  • 一键捕捉：右键点击村民即可将其封印入笼（播放灵魂沙音效与末影粒子），完美保留村民的职业、等级、交易项目、改名及交易次数。
  • 捕捉限制：若铁傀儡正处于 16 格主动守护范围内，捕捉村民会瞬间激怒周围所有铁傀儡！
  • 安全释放：通过“潜行 + 右键”固体方块表面释放村民。若空间不足（需 2 格高度）或悬空，则会拒绝释放并发出警告。
• 灵笼贸易站 (Soul Merchant Station)：
  • 免 AI 极速交易：将装有村民的缚灵笼右键放入贸易站中，即可直接右键贸易站打开与原村民完全一致的交易 GUI（完全兼容声望折扣、村庄英雄折扣以及改名）。
  • 零寻路工作站刷新：在方块相邻的 6 面贴上该村民对应且未被占用的有效工作站（如讲台、酿造台），在每日黎明或床睡觉醒来时即可自动解除交易锁定！
  • 无损取出：手持空缚灵笼“潜行 + 右键”贸易站，可无损回收村民。
  • 偏转朝向微调：内存有村民时，手持非空缚灵笼“潜行 + 右键”方块可以让站内缩小版 3D 村民顺时针旋转 90°，自由锁定面向。
  • 极致安全：方块具备极高爆炸抗性，免疫 TNT、苦力怕等一切爆炸破坏。

---

🛡 3. 专属武器与功能装备 (Special Gear & Tactical Equipment)

• 尤里的复仇 (Yuri's Revenge)：
  • 只拥有 5 点耐久度的神级镐子。
  • 只能挖掘基岩，无法破坏任何其他种类的方块。
• 回响破障者 (Echo Breaker)：
  • 声波吸收：主手持握时，自动减免 30% 监守者 (Warden) 的音波爆破伤害。
  • 完美格挡：副手为空时，右键提供持效 0.5 秒 的防御状态。在此状态下免受 100% 音波伤害。
  • 声波折射：格挡成功的瞬间，将声波完美反弹回发射源，使其立刻受到 15 点真实伤害 并受到强烈击退！
  • 格挡代价与修复：成功格挡额外扣除 3 点耐久。使用坚守者的心脏 (Warden Heart) 可以在铁砧中修复它。
• 试炼假人 (Trial Dummy)：
  • 真实防御模拟：假人处于无敌状态（免受环境伤害，创造模式可一击破坏）。支持右键穿戴防具盔甲与主副手武器，计算时完整继承护甲、抗性与附魔等真实属性！
  • 无损极限测试：攻击假人完全不扣除武器耐久，射击假人的箭矢会在击中后原样安全回收。
  • 伤害跳字与 HUD：受击时头顶产生橙色浮空 3D 伤害数字，同时 Actionbar 实时更新“⚔ 累计伤害 | DPS”，4 秒停止攻击后重置。
  • 详尽报告：空手（非潜行）右键假人可在聊天栏输出包含总伤害、最大伤害、平均 DPS 等的超详尽历史数据报告。
• 稻草人 (Scarecrow) 与假目标 (Decoy Totem)：
  • 稻草人：摆脱了原版盔甲架的违和设计，下部拥有极具田园风的 3D 橡木栅栏立柱。受到攻击时具有来回晃动的丝滑倾摆动画与木质敲击音效。夜间自动切换为发光的南瓜灯并提供亮度为 7 的光源，白天复原。支持蹲下无损收回。
  • 假目标：右键使用可召唤一个持续 15 秒 的玩家幻影。幻影会完全复制玩家的皮肤、护甲和主副手物品，以自身为中心周期性强力吸引 10 格内所有敌怪的仇恨。受击时幻影会智能逃跑。在消失时伴随白烟 Poof 粒子和陶罐碎裂声，并使周围怪物进入 10 秒速度 II 暴走状态。
• 坐在楼梯上 (Stair Seating)：
  • 家具互动：玩家在空手状态下右键正向放置的楼梯方块（half=bottom）可直接坐下。
  • 智能落点与防卡：下车（Shift 键）时玩家将被安全放置于楼梯顶部。拥有防卡头窒息与重叠坐下校验，退出或因环境变动卸载时自动清理隐藏椅子实体，避免世界残留垃圾。

---

🔮 4. 强力战术护符 (Tactical Charms)

• 狂暴护符 (Berserk Charm)：
  • 置于副手栏生效。当玩家生命值低于 30% 时自动激活，消耗 1 个护符并提供 15 秒的 力量 II + 速度 II 爆发。
  • 拥有 15 秒内置冷却时间（显示白色遮罩），彻底避免了瞬间被吃光多个护符的问题。
• 战狼护符 (Wolf Command)：
  • 置于副手栏生效。使已驯服的狼生命上限额外 +4。
  • 撕裂利爪：被驯服的狼攻击目标时，有 15% 概率附加“撕裂”Debuff，使目标在发生位移时每 0.5s 受到 0.5 * 等级 点魔法伤害，静止不受伤害。撕裂可叠加至 IV 级。
  • 致死保护与狂怒：狼在遭受致命伤害时，消耗护符 1 点耐久，并为狼回满血同时赋予 5 秒无敌与狂怒战意（疯咬攻速翻倍，移速提升 III，伤害提升 I）。
  • 力竭倒地与腐肉复活：狂怒结束后狼会力竭倒地（HP 1f 强制坐下、无敌免伤、禁止拴绳）。通过喂食 10 个腐肉 即可重燃战意满血复活！

---

🏹 5. 秘藏与奇特附魔 (Treasure & Unique Enchantments)

本模组新增了大量好玩、平衡且极具战术价值的自定义附魔：

附魔名称	适用装备	最高等级	效果与规则
灵魂绑定 (Soulbound)	绝大多数装备	I	死亡时物品不掉落，直接保留在背包中。无法通过附魔台获得。对监守者造成超过 50% 伤害有 10% 概率掉落此书。
阅历 (Experience)	主手武器	IV	击杀生物所获得的经验每级额外增加 25%（向上取整）。对击杀玩家无效。
熔炼 (Smelting)	镐、斧、锹	I	挖掘可烧炼方块时直接掉落烧炼后产物。与时运 (Fortune) 完美兼容，与精准采集互斥。每次挖掘额外消耗 1 耐久。
连锁采掘 (Chain Mining)	工具	IV	仅限创造模式。按住快捷键 ~ 挖掘方块时，瞬间连锁采集同类方块。每级连锁 16 个，最高 64 个。每块消耗 0.25 饱食度。
血怒 (Blood Rage)	剑、斧	I	击杀生物后获得 7 秒血怒 Buff。期间伤害增加 40%，但易伤 30%。若 7s 走完未续杯，状态结束时会受到 2 点真实伤害反噬。与火焰附加冲突。
狂战士 (Berserker)	胸甲	II	每损失 10% 最大生命值，近战伤害提升 5%(I) / 8%(II)。代价是胸甲的基础护甲值减少 35%(I) / 30%(II)。血量低于 30% 时屏幕边缘会平滑浮现暗红血丝特效。与所有保护类附魔互斥。
处决 (Execute)	剑、斧	III	目标血量低于 (5 + 等级 * 10)% 时触发斩杀。伤害乘数提升 等级 * 25%，但每次触发时玩家自身也会立刻受到 等级 * 0.5 心 的真实反噬伤害！与锋利、亡灵、节肢互斥。
连锁苦痛 (Chain Pain)	斧	I	宝藏附魔。斧击杀目标时，将其溢出伤害的 50% 依次连锁传导给周围 5 格内的最多 5 个敌对目标。该间接伤害不会二次触发效果（无套娃）。与精准采集冲突。
追踪箭 (Seeking Arrow)	弩	I	宝藏附魔。弩装填时瞄准的目标会在客户端发出高亮光晕（仅自己可见）。箭矢射出 0.5s 后向原目标进行最大 30° 弹道智能偏转修正。与多重射击冲突。

[!IMPORTANT] 伤害计算规范：模组内所有的物理加成、易伤及血怒伤害结算，均基于高可维护性的 me.tuanzi.util.DamageCalculator 类进行，采用加法累加（Additive）的综合增伤计算模型。

---

🧪 6. 奇妙炼金与食品 (Alchemy & Food)

• 飞行药水 (Flight Potion)：
  • 变体：包含普通版（3分钟）、延长版（8分钟）、喷溅药水、滞留药水及药水箭。
  • 核心功能：赋予生存模式下如同创造模式般自由飞行的能力。
  • 安全防摔机制：飞行效果即将结束的 15秒 与 10秒 时会通过 Actionbar 警告并播放音效；最后5秒 会开启每秒急促高频音效倒计时！
• 不死药水 (Undying Potion)：
  • 赋予“不死”状态效果。为了防止敌怪意外受保护，该效果仅对玩家和驯服后的生物生效！
• 肾上腺素药水 (Adrenaline Potion)：
  • 饮用效果：每级提供 +15% 攻速与 +7.5% 移速的爆发。
  • 透支副作用：饮用时会产生等长的“肾上腺素透支”Debuff（无法被牛奶清除）。当 Buff 耗尽或被强行移走时，若身上仍有透支，则会获得每级叠加 30 秒的虚弱 I + 挖掘疲劳 I。在透支未结束时连续饮用会导致透支等级叠加（最高 IV）并导致副作用时间线性翻倍。
• 地狱炖菜 (Nether Stew)：
  • 绯红菌 + 诡异菌 + 烈焰粉 + 岩浆膏 + 碗合成。
  • 突破常规炖菜限制，堆叠上限达 64 个，吃完返还空碗。
  • 食用获得持续 1 分 30 秒的混合效果：
    • 地狱之火：免受火焰/岩浆伤害；近战 60% 概率点燃目标 2s；近战攻击着火目标伤害 +1。
    • 烈焰饥渴：饱食与饱和度消耗速度翻倍。
    • 惧水：在水中时每 1 秒受到 2 点无视护甲/抗性的真实伤害！

---

🛠 开发与构建指南 (Development Setup)

环境要求

• Minecraft 版本: 26.1 (Tiny Takeover)
• Java 版本: Java 25 (推荐使用 JBR 25 以支持增强的热重载 Hotswap)
• 模组加载器: Fabric Loader 0.18.4
• 构建工具: Gradle 9.4.1

构建命令

• 运行客户端：

  ./gradlew runClient
  

• 运行数据生成器 (DataGen)：

  ./gradlew runDatagen
  

• 编译构建模组：

  ./gradlew build
  

[!TIP] 热重载配置提示：

• 为了支持在不重启游戏的情况下修改 Mixin，请在 IDE 运行配置的 VM 参数中手动添加：-Dmixin.hotSwap=true
• 若使用 JetBrains Runtime (JBR)，可额外添加 -XX:+AllowEnhancedClassRedefinition 以开启增强类重定义。

---

Tuanzi's Mod (README English)

Tuanzi's Mod is an advanced feature-rich Minecraft mod built on Fabric Loader specifically optimized for Minecraft 26.1 (Tiny Takeover). It features an innovative Rainbow Sponge naming system, AI-less Soul Merchant Stations, powerful tactical equipment, creative custom enchantments, unique status effects, and performance-first mechanical tweaks.

---

🌟 Key Features

🌈 1. Rainbow Sponge System

The Rainbow Sponge (originally Color Sponge, stack limit is 1) is your custom name formatting card. Program it and apply it to any item in an anvil!

• Limit Break: Removes the vanilla 50-character limit for renaming.
• Anvil Coding: Rename a Rainbow Sponge in an anvil to input formatting code patterns.
• Format Merging: Combine the programmed sponge with a target item to paint the item name in real-time.

📄 Code Syntax Reference:

Style Type	Example Code	Description
Hex Color	#FF5555	Applies a precise hex color (e.g. Bright Red).
Vanilla Formatting	&l, &o, &n	Standard Bold, Italic, Underline format codes (use & instead of §).
Multi-segment Split	&c,&b,&l	Commas divide formatting. Styles are applied in rotation char-by-char.
Random Gradient	&q3#FF0000	Smooth random gradient for N chars starting from the base color.
Linear Gradient	&q5#FF0000-#0000FF	Smooth linear transition from the start color to the end color.
Style Reset	&r	Completely resets and strips all custom color/formatting.

---

💼 2. Villager Caging & AI-less Trading

Struggle with moving villagers? FPS dragging due to villager entity pathfinding? This industrial "Soul Cage" pipeline fixes it all.

• Villager Cage:
  • Capture: Right-click a villager to capture it. It stores all NBT attributes (level, profession, trade items, custom name) into the item.
  • Aggro Penalty: Capturing a villager inside an active Iron Golem patrol area (16 blocks) will instantly aggro all nearby Golems.
  • Release: Crouch + Right-click a solid block surface. Refuses release and warns the player if space (2 block high) is insufficient.
• Soul Merchant Station:
  • AI-less Efficient Trading: Right-click the station with a caged villager to register them. Right-click the block to trade without spawning any entity, saving massive server ticks!
  • Zero-pathfinding Workstation Update: Placing their respective vacant workstation block next to any of the 6 sides of the trade station will automatically restock and unlock trades at dawn or after sleeping.
  • 無损 Extraction: Crouch + Right-click the station with an empty cage to securely take the villager back.
  • Facing Adjust: Crouch + Right-click (holding non-empty cage) to rotate the mini 3D villager model 90° clockwise.
  • Explosion Protection: Extremely high blast resistance. Fully immune to TNT or Creeper damage.

---

🛡 3. Special Weapons & Tactical Gear

• Yuri's Revenge:
  • A mythical pickaxe with only 5 durability.
  • Can only break Bedrock, and cannot break any other block.
• Echo Breaker:
  • Sonic Dampener: While held in main hand, reduces Warden's sonic boom damage by 30%.
  • Perfect Parry: Right-click with empty offhand to parry for 0.5s, blocking 100% of Warden's sonic boom damage.
  • Refraction: A successful parry reflects the sonic blast back to the Warden, dealing 15 points of True Damage and strong knockback!
  • Parry Cost: Succeeding parry costs 3 extra durability. Repairable with Warden Heart in an anvil.
• Trial Dummy:
  • Realistic Defense Simulation: Invulnerable entity (except in Creative mode). Supports equipping standard armor and weapons. Calculates damage mitigation using fully accurate armor defense, toughness, and protection enchantments.
  • No-loss Testing: Attacks against the dummy cost 0 weapon durability. Projectiles (arrows) are automatically recovered intact upon impact.
  • Floating Damage Digits & HUD: Orange floating 3D numbers bounce upon damage. ActionBar shows cumulative damage and DPS, resetting after 4s idle.
  • Full Analysis Reports: Right-click empty-handed (non-crouching) to print comprehensive damage logs (total damage, max hit, avg DPS, duration) in the chat window.
• Scarecrow & Decoy Totem:
  • Scarecrow: Features a beautiful 3D oak fence post bottom base. Bounces back-and-forth dynamically upon impact with distinct wooden hit sounds. Automatically lights up into a Jack-o'-Lantern at night (light level 7), reverting during daytime. Safe crouch-retrieval.
  • Decoy Totem: Right-click to spawn a decoy replica of the player for 15 seconds (including skin, armor, held items, health, and defense stats). Attracts all mob aggro within 10 blocks. Flees when hit. Explodes into a flashy Poof cloud upon death/expiration, and enrages nearby monsters with Speed II for 10s.
• Stair Seating:
  • Interactive Furniture: Right-click any right-side-up stair block (half=bottom) with empty hands to sit down.
  • Safe Dismount: Shifts player to the top of the stair on dismount. Includes collision checks to prevent suffocation or overlapping seating. Auto-destroys invisible seat entities cleanly.

---