?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
Tuanzi'sMod

Tuanzi'sMod

A module for Tuanzi's server, which requires the client to install it.

63
0
63
0

Compatibility

Minecraft: Java Edition

26.1.x

Platforms

Supported environments

Client and server

Tags

Creators

Details

Licensed MIT
Published last month

团子的模组 (Tuanzi's Mod)

Minecraft Version Fabric Loader Mod Version

团子的模组 是一个基于 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.