The Twelve Talismans Mod Complete Documentation

1. Basic Information

Attribute	Value
Mod Name	The Twelve Talismans
Mod ID	the_twelve_talismans
Version	1.0.0
Author	NillFall
Minecraft Version	1.21.1
Loader	NeoForge 26.2.0.8-beta
License	All Rights Reserved

2. Mod Description

A Minecraft mod inspired by the classic animation Jackie Chan Adventures. It adds twelve zodiac talismans with unique magical powers. Collecting all twelve talismans grants supreme ultimate power in-game.

3. Talisman Acquisition Rules

Mechanic: Hold an Empty Talisman and right-click the corresponding mob to extract a unique talisman. One Empty Talisman will be consumed per extraction. Talismans are sorted in zodiac order in the creative inventory.

Talisman	Corresponding Mobs
Rat Talisman	Silverfish
Ox Talisman	Cow, Mooshroom
Tiger Talisman	Ocelot
Rabbit Talisman	Rabbit
Dragon Talisman	Ender Dragon
Snake Talisman	Spider, Cave Spider
Horse Talisman	Horse, Skeleton Horse, Zombie Horse, Llama, Donkey, Mule
Sheep Talisman	Sheep
Monkey Talisman	Villager, Wandering Trader
Rooster Talisman	Chicken
Dog Talisman	Wolf
Pig Talisman	Pig, Hoglin

4. Detailed Talisman Abilities

Rat Talisman 🐀

Ability: Fires a small beam that stops upon hitting blocks or entities.

Effect: Remotely activates redstone mechanisms and triggers devices.

Ox Talisman 🐂

Ability: Super strength enhancement.

Effect: Greatly increases attack damage and maximum health.

Tiger Talisman 🐅

Ability: Balances yin and yang, splits good and evil.

Effect: Summons an evil doppelgänger of yourself to fight alongside you.

Doppelgänger Traits:

Independent AI: Auto-follows, auto-attacks hostile mobs, and counterattacks
Synchronizes and updates player equipment in real time
Draws hostile aggro and takes damage instead of the player
Player receives half-health backlash damage if the doppelgänger dies

Operation: Right-click to summon; right-click again or approach the doppelgänger to merge.

Rabbit Talisman 🐇

Ability: Extreme agility and speed.

Effect: Massively boosts movement speed. Enables high-speed flight when combined with the Rooster Talisman.

Dragon Talisman 🐲

Ability: Dragon Blast.

Effect: Fires a forward fire column that creates an explosion on impact.

Snake Talisman 🐍

Ability: Complete invisibility.

Effect: Grants full invisibility and clears all hostile mob aggro toward the player.

Horse Talisman 🐴

Ability: Purification and healing.

Effect: Removes all negative status effects and fully restores health.

Sheep Talisman 🐑

Ability: Astral projection (soul separation).

Effect: Detaches your soul from your body for free remote exploration.

Trait: Reunite with your body at any time; you will be alerted if your physical body takes damage.

Monkey Talisman 🐒

Ability: Shapeshifting (72 transformations).

Operation: Hold TAB + scroll mouse wheel to switch forms; right-click again to revert to human form.

24 Transformable Forms & Skills:

Chicken: Slow falling
Cow: High health & high attack damage
Pig: High health
Horse: Extreme movement speed
Wolf: High attack damage
Cat: Night vision & high mobility
Parrot: Slow falling
Bat: Night vision & flight
Bee: Flight & stinging attack
Cod: Underwater breathing & enhanced water movement
Dolphin: Underwater breathing & high swim speed
Turtle: Underwater breathing & high defense
Tadpole: Underwater breathing
Frog: Super jump & aquatic mobility
Squid: Underwater breathing & ink blinding
Axolotl: Underwater breathing & self-regeneration
Polar Bear: High health
Donkey/Mule: Portable inventory storage
Llama: Spit ranged attack
Rabbit: Super jumping ability
Fox: Night vision
Panda: High health
Pufferfish: Inflates to gain defense when attacked
Sniffer: Detects and locates ancient relics

Rooster Talisman 🐓

Ability: Levitation and flight.

Operation: Enables floating and lifting. Hold Shift to descend. Combine with Rabbit Talisman for hovering and ultra-fast flight.

Dog Talisman 🐕

Ability: Guardian blessing.

Effect: Grants continuous health regeneration and general damage resistance.

Pig Talisman 🐷

Ability: Eye laser beam.

Effect: Shoots yellow laser beams from the eyes. Does not break blocks but burns all living entities in its path.

5. General Controls

Basic Activation: Right-click with the talisman in hand to activate its power.
Special Keybinds: Hold Shift to descend while using Rooster Talisman; Hold TAB + mouse wheel for Monkey Talisman shape shifting.
Survival Acquisition: Craft Empty Talismans and extract powers from corresponding mobs.

6. Technical Features

Custom entities: Tiger Talisman doppelgänger, Sheep Talisman player body
Custom rendering: Dopplegängers inherit the player’s skin and model
Advanced AI system for companion combat and navigation
Full client-server network synchronization for multiplayer compatibility
Powered by NeoForge event bus system
24 unique animal transformation forms with independent attributes and skills

7. Important Notes

Loader Requirement: NeoForge 26.2.0 or higher is mandatory.
Multiplayer: The mod must be installed on both client and server.
Tiger Talisman Risk: Doppelgänger death causes half-health backlash damage; use with caution.
Balance Mechanic: Flight abilities are properly restricted in survival mode to maintain game balance.

十二符咒 The Twelve Talismans 完整版模组文档（含最新修复日志）

一、基础信息

属性	内容
模组名称	十二符咒 (The Twelve Talismans)
模组ID	the_twelve_talismans
版本	1.0.0
作者	NillFall
MC版本	1.21.1
加载器	NeoForge 26.2.0.8-beta
授权协议	All Rights Reserved

二、模组简介

改编自动画《成龙历险记》的十二生肖符咒模组，为游戏加入十二款对应十二生肖的神奇符咒，每枚符咒拥有独一无二的专属能力，集齐全部十二符咒即可解锁强大的至尊之力，完美还原动画经典设定。

三、符咒获取规则

生存模式获取方式：手持空符咒，右键点击对应生肖生物，消耗1个空符咒即可成功提取对应符咒。创造模式物品栏中，所有符咒按照十二生肖顺序整齐排列。

符咒	对应目标生物
鼠符咒	蠹虫（Silverfish）
牛符咒	牛、哞菇（Cow / Mooshroom）
虎符咒	豹猫（Ocelot）
兔符咒	兔子（Rabbit）
龙符咒	末影龙（Ender Dragon）
蛇符咒	蜘蛛、洞穴蜘蛛（Spider / Cave Spider）
马符咒	马、骷髅马、僵尸马、羊驼、驴、骡子（Horse / Skeleton Horse / Zombie Horse / Llama / Donkey / Mule）
羊符咒	羊（Sheep）
猴符咒	村民、流浪商人（Villager / Wandering Trader）
鸡符咒	鸡（Chicken）
狗符咒	狼（Wolf）
猪符咒	猪、疣猪兽（Pig / Hoglin）

四、十二符咒功能详解

鼠符咒 🐀

核心能力：发射小型光束，光束触碰方块或生物后停止
实战效果：可远程激活红石机关、触发各类游戏装置

牛符咒 🐂

核心能力：极致力量增幅
实战效果：大幅提升玩家攻击力与最大生命值，强化近战能力

虎符咒 🐅

核心能力：平衡阴阳、分裂善恶，召唤阴暗分身协同作战
分身特性：拥有独立AI，可自动跟随玩家、攻击敌对生物、受到反击；实时同步复制并更新玩家穿戴装备；主动吸引怪物仇恨，替玩家承受伤害；分身阵亡后，玩家会受到半血反噬伤害
操作方式：右键召唤分身；再次右键或靠近分身即可完成融合

兔符咒 🐇

核心能力：极致高速移动
实战效果：大幅提升人物移动速度，搭配鸡符咒可实现高速飞行

龙符咒 🐲

核心能力：龙爆破攻击
实战效果：向前方喷射强力火柱，命中目标后触发范围爆炸，造成高额伤害

蛇符咒 🐍

核心能力：隐匿身形、无声潜行
实战效果：赋予玩家完全隐身效果，清除所有敌对生物的仇恨值，实现无伤潜行

马符咒 🐴

核心能力：净化驱邪、完全治愈
实战效果：瞬间清除玩家所有负面状态效果，全额恢复生命值

羊符咒 🐑

核心能力：灵魂出窍、离体探索
实战效果：玩家灵魂脱离肉体自由移动，可远程探索未知区域
专属特性：可随时召回灵魂回归本体；肉体受到伤害时会及时弹窗提示玩家

猴符咒 🐒

核心能力：七十二变，自由变形
操作方式：激活符咒后，按住TAB键+鼠标滚轮切换动物形态，再次右键即可恢复人形
24种可变形态及效果：鸡-缓降｜牛-高攻高血量｜猪-高血量｜马-高速移动狼-高攻击｜猫-夜视、灵活机动｜鹦鹉-缓降｜蝙蝠-夜视飞行蜜蜂-飞行、近战蜇伤｜鳕鱼-水下呼吸、水速加成｜海豚-水下高速游泳海龟-水下呼吸、高额防御｜蝌蚪-水下呼吸｜青蛙-高跳跃、水中机动鱿鱼-水下呼吸、喷墨干扰｜美西螈-水下呼吸、持续再生北极熊-高血量｜驴/骡子-自带背包栏｜羊驼-口水远程攻击兔子-超高跳跃｜狐狸-夜视｜熊猫-高血量｜河豚-受击膨胀增防嗅探兽-自动搜寻地下古物

鸡符咒 🐓

核心能力：浮空升空、自由飞行
操作方式：激活后升空漂浮，按住Shift键缓慢下降；搭配兔符咒可实现空中悬停、极速飞行

狗符咒 🐕

核心能力：生命守护、全域防护
实战效果：为玩家提供持续生命恢复效果，同时提升全类型伤害抗性

猪符咒 🐷

核心能力：双目激光灼烧
实战效果：双眼射出黄色激光，不会破坏任何方块，可灼烧路径上所有生物

五、通用使用操作

生存获取：合成空符咒，对准对应生物右键即可提取符咒，单次提取消耗1个空符咒
基础激活：手持任意符咒，右键点击即可直接释放对应专属能力
特殊按键：鸡符咒按住Shift实现缓慢下降；猴符咒按住TAB+鼠标滚轮切换变形形态

六、核心技术特性

自定义实体系统：新增虎符咒战斗分身、羊符咒离体躯体专属实体
高清渲染系统：虎符咒分身完整复用玩家原生皮肤与模型，贴合玩家形象
智能AI逻辑：分身具备自主跟随、自动索敌、协同作战、受击反击能力
全域网络同步：客户端与服务端数据双向同步，多人联机无异常、无卡顿
基于NeoForge原生事件总线驱动，模组运行稳定、兼容性强
24套独立动物变形体系，每套形态拥有专属属性与独有技能

七、版本修复日志（1.0.0）

7.1 渲染问题修复

修复虎符咒分身渲染异常问题，解决分身跟随本体渲染、分身完全不可见的BUG
修复羊符咒离体躯体朝向错误问题，修复躯体倾斜45度、面部朝上的异常姿态
修复光照参数错误，解决模型暗化、模型透明消失、显示异常的问题
优化分身渲染逻辑，完美适配玩家模型与自定义皮肤渲染
替换分身原生僵尸音效，更新为玩家原生声音，提升沉浸感

7.2 功能逻辑修复

修复猴符咒变形后角色属性、专属能力无变化的失效问题
修复鸡符咒缓降效果与原版游戏重力机制不一致的问题，完全对齐原版手感
修复生存模式关闭飞行后，飞行能力、移速buff残留的问题
新增服务器端ID验证，修复多人模式下部分动物形态无法选中变形的BUG
修复无限时长MobEffect效果，无法触发applyEffectTick持续判定的逻辑漏洞
修正受伤事件监听错误，将失效的 LivingHurtEvent 替换为标准后置事件 LivingDamageEvent.Post

八、重要注意事项

模组最低加载器要求：NeoForge 26.2.0及以上版本，低版本无法正常运行
多人联机要求：客户端与服务端必须同步安装本模组，否则无法正常联机游玩
虎符咒使用风险：分身阵亡会对玩家造成反噬伤害，实战使用需谨慎
游戏平衡适配：所有飞行类能力在生存模式均有合理限制，杜绝破坏游戏平衡的情况