---

📚 Quick Links

🌐 Wiki
Titanium Add-on Wiki

💬 Support Discord
Titans Club

✨ Showcase & Tutorial
Titanium Add-on Showcase and Tutorial

📢 Exclusive Development Updates
NOVA Discord

🎥 Official YouTube Channel
Titans Club YouTube

---

---

✦ Content Overview

---

🪨 Mining & Smelting

Begin your Titanium journey by exploring the Overworld and discovering a new high-tier resource.

• 🌍 Titanium Ore generates naturally throughout the Overworld.
• ⛏️ Deepslate Titanium Ore generates at lower depths.
• 🔥 Mine Titanium Ore and Deepslate Titanium Ore with a Netherite, Titanium, or Titanium+ Pickaxe to obtain Raw Titanium.
• 🔩 Process Raw Titanium and related materials into Unrefined Titanium Scrap, then smelt it in a Blast Furnace into Refined Titanium Ingots.
• 💎 Titanium Shards are rare Epic boss drops featuring an enchanted glint and a stack size of 16.
• 🚫 Titanium Ore and Deepslate Titanium Ore no longer have direct crafting recipes.

This creates a meaningful post-Netherite progression path instead of allowing high-tier materials to be obtained instantly.

---

🔧 Titanium Workbench

The Titanium Workbench is the heart of Titanium progression.

It is a dedicated crafting station — a custom crafting table with its own tag — that emits light and produces a weak redstone signal.

Use the Workbench to craft and process advanced Titanium components and equipment while keeping Titanium progression separate from ordinary vanilla crafting.

Titanium is designed to feel like a genuine progression system — not a collection of instantly obtainable overpowered items.

---

⚔️ Titanium Equipment

Forge an entire Titanium arsenal built for endgame survival:

• ⚔️ Titanium Sword — 10 damage
• 🪓 Titanium Axe — 12 damage
• ⛏️ Titanium Pickaxe — 7 damage
• 🥄 Titanium Shovel — 7 damage
• 🌾 Titanium Hoe — 6 damage
• 🏹 Titanium Bow
• 🎯 Titanium Crossbow
• 🔨 Titanium Mace — 12 damage, Epic, Titanium+ tier, special fall-based smash attack
• 🛡️ Titanium Shield
• 🏹 Titanium Arrow — fully custom projectile entity with its own model, animations and behavior
• ⛑️ Titanium Helmet
• 🦺 Titanium Chestplate
• 👖 Titanium Leggings
• 👢 Titanium Boots

🔩 Progression Materials

• 🔩 Refined Titanium Stick
• ✨ Titanium Coating
• 💠 Titanium Core
• 🔷 Titanium Shard
• 📜 Titanium Upgrade
• 🔥 Ultimate Titanium — premium repair material

---

✨ Titanium+ Equipment

Take Titanium equipment to the next level with the Titanium Plus tier.

Titanium+ equipment provides enhanced capabilities, higher damage, substantially increased durability, and persistent script-driven Advancement effects while equipped.

⚔️ Upgradeable Equipment

• ⚔️ Sword+ — 12 damage
• 🪓 Axe+ — 14 damage
• ⛏️ Pickaxe+ — 8 damage
• 🥄 Shovel+ — 8 damage
• 🌾 Hoe+ — 7 damage
• ⛑️ Helmet+
• 🦺 Chestplate+
• 👖 Leggings+
• 👢 Boots+

Bow, Crossbow and Mace are part of the Titanium+ tier.

Titanium+ equipment also interacts with the add-on's intelligent script-controlled Payback and Advancement systems.

---

🧠 Payback & Advancement — Intelligent Combat

Titanium equipment isn't simply stronger gear.

Its behavior is controlled by a dynamic script-based system that reacts to equipment usage, incoming damage and the player's current equipment state.

✨ Advancement System

While the matching Titanium+ item is equipped and its Advancement is not suppressed by Payback, the player receives a continuously refreshed effect.

Weapons — Mainhand

• ⚔️ Sword+ → Strength I
• ⛏️ Pickaxe+ → Haste II
• 🪓 Axe+ → Speed I
• 🥄 Shovel+ → Saturation I
• 🌾 Hoe+ → Night Vision I

Armor

• ⛑️ Helmet+ → Night Vision I
• 🦺 Chestplate+ → Resistance I
• 👖 Leggings+ → Speed I
• 👢 Boots+ → Jump Boost I

Effects last 40 ticks (2 seconds) and are re-applied every 10 ticks while the matching item remains equipped.

⚡ Payback System

When applicable damage or equipment misuse triggers Payback, the system applies reactive status effects and temporarily suppresses the matching Advancement.

• ⚖️ LOW / HIGH tiered effects — enchanted gear uses the stronger HIGH table; high incoming damage can also force HIGH.
• ⏱️ 1-second per-player cooldown prevents effect spam.
• 🧩 Each armor piece and weapon type has its own assigned effects.
• 🔄 Advancement effects are suppressed for the exact duration of the Payback effect and automatically restored afterward.

🛡️ Armor Payback

• ⛑️ Helmet → Poison / Fatal Poison
• 🦺 Chestplate → Blindness
• 👖 Leggings → Nausea
• 👢 Boots → Slowness

⚔️ Weapon Payback

• ⚔️ Sword / Axe → Weakness
• ⛏️ Pickaxe / Shovel → Slowness
• 🌾 Hoe → Hunger
• 🔨 Mace → Weakness + Slowness
• 🛡️ Shield while actively blocking → Slowness II + Weakness II

🔨 Mace & Shield Behavior

• 🔨 Holding the Titanium Mace continuously applies Slowness I.
• 🛡️ Actively blocking with the Titanium Shield while sneaking on the ground applies Slowness II and enables shield-hit Payback.

The entire system is controlled through the stable Script API rather than legacy static tick-based buffs.

---

👑 The Titan Boss

Meet The Titan — the centerpiece of Titanium's endgame.

The Titan is a fully custom boss featuring multiple combat states, specialized attacks, advanced targeting behavior, custom properties (attack_type, rage_mode, melee_range) and a dedicated boss bar.

⚔️ Titan Combat

Battle an enemy featuring:

• ⚔️ Advanced melee combat
• 🏹 Ranged combat
• ☢️ Atomic Attack
• 💢 Rage Mode
• 🎯 Smart target tracking
• 🧠 Multiple combat states
• ⚡ Nearby-area attacks
• 🔨 Rage Slam
• 🔨 Rage Hammer
• 🎬 Custom animations
• 🔊 Custom sounds
• 🤖 Advanced AI behavior

The Titan dynamically switches between combat states including melee, ranged, projectile, nearby, rage slam and rage hammer behavior.

---

🏛️ Titans Lab

The Titan no longer randomly spawns throughout the Overworld.

The boss encounter takes place inside the Titans Lab — a dedicated underground structure generated using Minecraft Bedrock's Jigsaw Structure System, with a structure set using random_spread placement.

This transforms The Titan from an ordinary randomly spawning mob into a dedicated boss encounter.

---

🏆 Boss Rewards

Defeat The Titan to obtain exclusive endgame resources.

💎 Titanium Shard

A rare Epic crafting material used for advanced Titanium progression.

• ✨ Enchanted glint
• 📦 Stack size of 16
• 🔧 Used in advanced crafting and progression

❤️ Titan's Heart

A valuable boss resource used for advanced progression and crafting.

Holding the Titan's Heart activates a special pulsing effect system.

🏆 Titan's Trophy

A decorative trophy commemorating your victory over The Titan.

The trophy features custom geometry and textures and can be displayed as a permanent reminder of the boss encounter.

---

🧱 Titanium Building Blocks

Expand your builds with Titanium-themed construction and decoration.

Available blocks include:

• 🔷 Titanium Block
• 🧱 Titanium Bricks
• 📐 Titanium Slab
• 🪜 Titanium Stairs
• 🧱 Titanium Wall
• 🚪 Titanium Trapdoor
• 💡 Titanium Lamp — emits light
• 🏆 Titan's Trophy
• 🔧 Titanium Workbench

Titanium Ore and its related blocks follow a high-tier Minecraft mining progression designed around survival gameplay.

---

🛡️ Titanium Shield

The Titanium Shield features a custom damage-mitigation system.

Players must actively sneak while blocking to use the shield's defensive mechanics.

Damage Type	Damage Blocked	Damage Taken
⚔️ Melee	75%	25%
🏹 Projectile	60%	40%
💥 Explosion	40%	60%

Explosions now correctly interact with the shield instead of bypassing its mitigation system.

Shield durability is consumed according to the damage it mitigates.

Durability: 900

Repair the shield using Titanium resources and Ultimate Titanium.

---

⚔️ Titanium Combat Power

Titanium equipment is designed to provide a clear progression beyond Netherite.

🔷 Base Titanium

• ⚔️ Sword — 10 damage
• 🪓 Axe — 12 damage
• ⛏️ Pickaxe — 7 damage
• 🥄 Shovel — 7 damage
• 🌾 Hoe — 6 damage

💜 Titanium+

• ⚔️ Sword+ — 12 damage
• 🪓 Axe+ — 14 damage
• ⛏️ Pickaxe+ — 8 damage
• 🥄 Shovel+ — 8 damage
• 🌾 Hoe+ — 7 damage
• 🔨 Mace — 12 damage

---

🔧 Durability & Equipment Management

Titanium equipment is powerful, but durability still matters.

Equipment	Durability
🔧 Base Titanium tools / weapons	2200
✨ Titanium+ tools / weapons	2650
🔨 Titanium Mace	700
🛡️ Base Titanium armor	800
💜 Titanium+ armor	1200
🛡️ Titanium Shield	900

⚠️ Titanium+ Degradation

• 🛡️ Titanium+ armor wears 1.5× faster per hit taken.
• ⚔️ Titanium+ weapons used for the wrong action lose durability 2× faster.
• ⛏️ Custom Titanium mining tools correctly consume durability when breaking blocks.

Repair costs have also been rebalanced, with Ultimate Titanium serving as the premium high-efficiency repair material.

---

🍎 Titan Fruit

A powerful endgame food item that can always be eaten.

Nutrition & Saturation

• 🍎 Nutrition: 10
• ⚡ Saturation Modifier: 10.0

When consumed, Titan Fruit grants powerful temporary buffs:

• ❤️ Regeneration IV
• ⚔️ Strength III
• 💨 Speed II
• 🔥 Fire Resistance
• 🛡️ Absorption IV
• 🛡️ Resistance II

But great power comes with significant drawbacks:

• 🤢 Nausea
• 👁️ Blindness
• 🍖 Hunger
• ⚔️ Weakness
• 🐌 Slowness
• ⛏️ Mining Fatigue

Titan Fruit is designed as a high-impact risk-and-reward endgame food.

---

🏹 Titanium Arrow

A fully custom projectile featuring its own:

• 🎯 Projectile entity
• 🎬 Animations
• 🧩 Custom model
• ⚙️ Custom behavior

The Titanium Arrow is designed as part of the add-on's custom ranged-combat system rather than simply being a renamed vanilla projectile.

---

🔥 Ultimate Titanium

Ultimate Titanium is a rare premium Titanium material used for advanced equipment maintenance.

It currently serves as a high-value repair material, providing a higher repair percentage than normal Refined Titanium Ingots.

Additional uses are planned for future progression.

---

✨ Designed for Survival

Titanium Add-on follows one philosophy:

Expand Minecraft — don't replace it.

The add-on is built around:

• ✅ Vanilla-friendly progression
• ✅ Post-Netherite progression
• ✅ Survival-focused mechanics
• ✅ Dedicated crafting systems
• ✅ Custom equipment
• ✅ Custom boss encounters
• ✅ Intelligent combat systems
• ✅ Custom animations
• ✅ Custom models & textures
• ✅ Multiplayer-oriented mechanics
• ✅ Achievement-friendly design
• ✅ Ongoing development

---

🆕 v6.4.0 — Stable Edition

The current Stable Edition focuses on making Titanium more reliable, balanced and survival-friendly.

⚙️ Stability & Compatibility

• 🟢 Updated @minecraft/server from 2.8.0 → 2.9.0
• 🧹 Removed the obsolete entities/player.json
• 🚫 Removed unnecessary experimental entity/block flags
• 🧩 Removed beta-suffixed Script API dependencies
• 🏆 product_type set to addon for an achievement-friendly configuration
• 📦 Minimum engine version: 1.21.131

🛡️ Combat

• ⚔️ Shield melee mitigation: 75%
• 🏹 Shield projectile mitigation: 60%
• 💥 Shield explosion mitigation: 40%
• 🐲 The Titan's combat AI and attack priorities reworked
• ☢️ Atomic Attack redesigned
• 💢 Rage Mode threshold adjusted
• 🧹 Broken Titan healing animation removed

🗡️ Equipment

• 🔧 Major durability overhaul
• ⚔️ Weapon and tool damage rebalanced
• ✨ Bow, Crossbow and Mace moved into the Titanium Plus tier
• 🛠️ Titanium Sword block-breaking behavior fixed
• ⚠️ New Titanium+ degradation mechanics — 1.5× armor / 2× wrong-tool
• 🍎 Titan Fruit massively upgraded

⛏️ Progression

• 🚫 Titanium Ore recipes removed
• 🚫 Deepslate Titanium Ore recipes removed
• 💎 Titanium Shard added to Titan loot
• 🔷 Titanium Upgrade recipes rebalanced
• 🔄 Upgrade duplication recipe changed to shapeless
• 🔊 Ore sounds switched to vanilla deepslate

---

🎮 Multiplayer & Compatibility

Titanium Add-on is designed for both:

• 🧍 Singleplayer Survival
• 👥 Multiplayer Survival

The Stable Edition uses:

• @minecraft/server 2.9.0
• @minecraft/server-ui 2.1.0
• Stable Script API dependencies
• No experimental entity requirements
• No experimental block requirements

The goal is to provide a reliable Titanium experience across both singleplayer and multiplayer survival worlds.

---

🏆 Achievement-Friendly

The Stable Edition is specifically designed around an achievement-friendly configuration.

It uses:

• ✅ product_type: addon
• ✅ Stable Script API dependencies
• ✅ No experimental entity flags
• ✅ No experimental block flags
• ✅ No beta-suffixed Script API dependencies

Build your Titanium world with an achievement-friendly add-on configuration focused on legitimate survival progression.

---

---

🚀 Future Updates

The Titanium universe is still expanding.

Future updates may introduce:

• 👑 More bosses
• 🏛️ New structures
• ⚔️ Additional weapons
• 🛡️ New equipment
• 🧱 More decorative blocks
• 📖 Expanded lore
• 🌍 New gameplay mechanics
• 💎 New Titanium materials
• ⚡ New endgame systems

---

❤️ Credits

Special thanks to:

🤖 Claude

For development assistance, debugging, validation and code reviews.

💬 ChatGPT

For scripting support, debugging, optimization, documentation and technical assistance throughout development.

⚒️ Mr. Myro

Mr. Myro on CurseForge

For helping design the combat mechanics and gameplay of The Titan boss.

---