The Legend Of The Ten Rings: Shang Chi's Legacy

Ten Rings: Ancient Power brings Shang-Chi-inspired combat to Minecraft Java Edition 1.20.1 on Forge. Become the wielder of ten engraved magical rings, launch ricocheting attacks, form energy whips, control enemies with telekinetic force, and combine powerful movement abilities with devastating ground strikes.

Each ring moves independently, with five resting on each forearm. Glowing engravings, customizable energy colors, magical trails, metallic impacts, and cinematic sound effects accompany your abilities.

To obtain the rings in Survival, find a Rift Sigil in an unopened Ancient City chest, Bastion treasure chest, or End City treasure chest. Eligible chests have a 12% chance by default, adjustable by the server.

Use the sigil while standing on solid ground with plenty of open space in front of you. A dimensional rift opens, and ten rings emerge individually, orbit around you, and attach to your arms from elbow to hand. A final burst of energy completes the bond.

Your initial energy color is chosen before the ceremony begins, so the rift, magical energy, and initial rune glow match. You can customize those colors afterward. Bonding is once per player by default, and the old Wither/Dragon acquisition method is no longer used.

Once bonded, keep the Ten Rings artifact anywhere in your player inventory. You do not need to hold it to use combat mode or your special abilities. Losing or transferring the artifact removes access until you recover it.

The mod has two main modes:

• Normal Mode: Your mouse controls work normally for mining, attacking, placing blocks, eating, and using items. Special ability keys remain available while you carry your valid artifact.
• Combat Mode: Press R to switch your mouse controls to ring combat. Your arms and rings become your weapons, and held-item models disappear. The actual items remain in their slots—your sword stays in your inventory, and a held Totem of Undying can still save you. Press R again to restore normal controls and held-item rendering.

These are the default controls:

Slam starts unbound on a fresh installation. Assign it through Options → Controls → Ten Rings, or use the Rebind button in the controls guide. R is now reserved for Combat Mode. 

Outside Combat Mode, Grab requires holding the artifact in either hand. Inside Combat Mode, carrying it in your inventory is sufficient. Grab uses Shift + right-click

A short right-click tap fires a complete five-ring volley, launching rapidly from hand to elbow. Successful volleys alternate arms when possible. You need a full arm of available rings to launch one.

Holding right-click instead commits to Whip Mode. The default tap/hold threshold is 0.25 seconds, and a single gesture never activates both attacks. Releasing Shift during Grab ends the grab without turning the same held click into whips.

Returning rings dock in the opposite order—elbow to hand—and can pass through solid terrain to reach you. Their intended return damage remains active, while offensive projectiles still collide with terrain.

Movement abilities let you close distances or attack from above. Charged Dash provides 5–50 blocks of powered movement by default, with natural momentum potentially carrying you farther afterward. Aim upward for Sky Dash, then activate your assigned Slam key while airborne to drive downward into a powerful ground shockwave. The aerial Slam strikes on actual ground contact and protects against fall damage during its intended sequence.

Carrying your valid rings also grants 4 armor points by default, equivalent to two armor icons. This is real armor protection that stacks with worn armor and remains active while rings are deployed. The separate magical Shield blocks ordinary damage while active; exceptional sources such as the void can still bypass it.

Press K to customize the mod. The settings interface includes searchable categories, numerical fields, sliders, Apply/Cancel controls, and category resets. You can:

• Choose Gold, Blue, Red, Purple, Green, Cyan, Pink, White, Orange, Teal, or Black energy.
• Set rune glow independently or use MATCH_ENERGY.
• Drag the pixel-art ability HUD to your preferred position.
• Adjust available visual, audio, camera-shake, and cinematic settings.
• View effective gameplay settings, including ranges, damage, cooldowns, armor, and movement tuning.

Energy customization changes magical effects and appropriate HUD accents. The physical rings retain their metallic appearance. Gameplay settings require the appropriate server permissions.

The Controls & Demonstrations screen teaches the current controls with animated previews using the actual ring models and engravings. Select an ability, rotate its preview, pause or replay it, reduce motion, or open the rebinding menu. These demonstrations are isolated from gameplay and do not consume items or trigger real attacks.

If you lose your bonded artifact, Rift Recall can recover it through another dimensional sequence with the keybind V, subject to the server’s recovery rules and cooldown. It preserves your saved energy color and does not create an additional usable copy. The recall binding is separate from Dash and stays hidden from the combat HUD.

You can also pass the rings to another player through a cinematic trust transfer. Carry your bonded artifact and use:

/tenrings trust PlayerName

The recipient must be eligible, online in your dimension, and have inventory space. This permanently transfers ownership: the recipient gains the rings and recovery rights, and you give them up.

The available commands are:

Use @s in the bond status/reset commands to target yourself. Resetting preserves inventory contents but makes the retained artifact dormant until rebonding. /tenrings give starts the actual ceremony and refuses duplicate grants to an existing owner.

The mod requires Minecraft Java 1.20.1, Forge 47.4.x, and Java 17. No additional mods are required. For multiplayer, install the same Ten Rings version on both the server and every client.

this mod was made with the help of AI due to my lack of experience