The Twelve Talismans

This mod inspired by *Jackie Chan Adventures* adds twelve zodiac talismans with distinct magical abilities to Minecraft.
IMG_202607141064_149x149.png

IMG_202607141064_149x149.png

Description

The Twelve Talismans Mod Complete Documentation

1. Basic Information

<colgroup><col width="200"><col width="200"></colgroup>
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.
<colgroup><col width="200"><col width="200"></colgroup>
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 完整版模组文档（含最新修复日志）

一、基础信息

<colgroup><col width="200"><col width="200"></colgroup>
属性
内容
模组名称
十二符咒 (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个空符咒即可成功提取对应符咒。创造模式物品栏中，所有符咒按照十二生肖顺序整齐排列。
<colgroup><col width="200"><col width="200"></colgroup>
符咒
对应目标生物
鼠符咒
蠹虫（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. 生存获取：合成空符咒，对准对应生物右键即可提取符咒，单次提取消耗1个空符咒
  2. 基础激活：手持任意符咒，右键点击即可直接释放对应专属能力
  3. 特殊按键：鸡符咒按住Shift实现缓慢下降；猴符咒按住TAB+鼠标滚轮切换变形形态

六、核心技术特性

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

七、版本修复日志（1.0.0）

7.1 渲染问题修复

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

7.2 功能逻辑修复

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

八、重要注意事项

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

The The Twelve Talismans Team

profile avatar
NillFall
Owner
  • 2
    Projects
  • 19
    Downloads

无名氏

More from NillFall

  • MonsterHunter project image

    MonsterHunter

    ByNillFall

    Monster Hunter Point Race is an intense PvP competition mod! Players are randomly assigned various mobs as hunting targets. Earn points by slaying your designated mobs, and the first player to hit the target score wins!

    • 7
    • July 11, 2026
    View
    Install
  • MonsterHunter project image

    MonsterHunter

    ByNillFall

    Monster Hunter Point Race is an intense PvP competition mod! Players are randomly assigned various mobs as hunting targets. Earn points by slaying your designated mobs, and the first player to hit the target score wins!

    • 7
    • July 11, 2026
    View
    Install