Orebound Katana

Quickstart

1. Craft a Forger at a crafting table using oak planks and an anvil:

1. Place the Forger and interact with it.
2. Choose up to four materials in the four pattern slots. You may leave slots empty or repeat the same material.
3. Keep the required materials in your inventory, then confirm the forgery. Each selected slot consumes one item.
4. Equip the resulting katana and attack normally.
5. Try a Netherite-Forged Katana and use it to activate its defensive ability.

In Creative mode, you can also obtain the Forger with:

/give @s com_orebound_katana_upkxxw7f:forger

Overview

Orebound Katana turns mining materials into customizable katanas. The Forger combines one to four materials into a single weapon:

• The katana’s color and name come from the most frequently used material.
• Its attack damage is calculated from the average value of all selected materials.
• Different combinations produce different damage values, even when they create the same color variant.
• Repeated materials count once for every slot in which they are selected.

What It Adds

The Forger

The Forger is a placeable block used to create katanas. Interact with it to open four pattern slots, each containing the same list of materials and an Empty option.

Forged Katanas

The mod includes nine color-coded katana variants:

All katanas are one-handed equipment items, do not stack, and lose durability through normal use.

How To Use

Forging a Katana

1. Interact with a placed Forger.
2. Select a material for each of the four slots, or leave slots empty.
3. Select at least one material.
4. Confirm the pattern.
5. The selected materials are removed from your inventory and the katana is placed into your inventory.

The Forger checks your inventory before consuming anything. If you do not have enough of a selected material, it tells you how many are required and does not complete the forgery.

Available materials are:

• Coal
• Copper Ingot
• Redstone
• Lapis Lazuli
• Iron Ingot
• Gold Ingot
• Emerald
• Diamond
• Netherite Ingot

Fighting With Katanas

Equip a katana in your hand and attack entities with normal melee controls. The finished weapon’s pattern damage determines how hard it strikes.

For quick testing in Creative mode, the Netherite variant can be spawned with:

/give @s com_orebound_katana_upkxxw7f:forged_katana_netherite

Replace forged_katana_netherite with another material suffix such as forged_katana_diamond, forged_katana_iron, or forged_katana_coal to obtain another variant.

Crafting And Obtaining

The Forger is crafted with eight oak planks and one anvil:

Katanas are produced by using the Forger. They are not made with the normal crafting table recipe system.

The Forger can also be obtained in Creative mode or with:

/give @s com_orebound_katana_upkxxw7f:forger

Abilities And Mechanics

Pattern Damage

Each material has a forging value:

The katana’s damage is calculated as:

floor(total forging value ÷ number of selected slots)

The minimum result is 1 damage.

Examples:

• Four Coal: floor(4 ÷ 4) = 1 damage
• One Diamond: 6 damage
• Three Diamond and one Netherite Ingot: floor(32 ÷ 4) = 8 damage
• Two Emerald and two Gold Ingots: floor(24 ÷ 4) = 6 damage

Color and Dominant Material

The output variant is determined by the material used most often.

If two or more materials are tied for most-used, the material with the higher forging value determines the katana’s color and name. For example, a pattern with two Diamond and two Netherite Ingots produces a Netherite-Forged Katana, because Netherite Ingot has the higher value.

The dominant material only controls the output variant. The complete pattern still controls the final damage, so a mixed-material katana can deal a different amount of damage from the base value listed for its color.

Netherite Defensive Ability

Using a Netherite-Forged Katana activates a powerful defensive effect for 30 seconds:

• Incoming damage is heavily resisted.
• Your health is continually restored to its maximum.
• The ability has a 30-second active period and cannot be activated again while already active.
• Activation produces a totem-like sound and no visible particles.

Only the Netherite-Forged Katana variant has this ability. A pattern containing Netherite Ingot does not receive it unless Netherite is the dominant material and produces the Netherite variant.

Progression And Strategy

• Start with Coal, Copper, Redstone, or Lapis Lazuli to make inexpensive low-damage weapons.
• Use Iron and Gold for middle-tier combinations, keeping in mind that Gold has strong damage value but lower durability.
• Save Diamonds, Emeralds, and Netherite Ingots for high-damage patterns.
• Repeat a material when you want it to control the katana’s color and name.
• Mix high-value materials to increase damage without necessarily making one material dominant.
• Use four slots for a predictable average, or use fewer slots when you want a single material to determine the result.
• For maximum durability and the defensive ability, make sure Netherite Ingot is the dominant material in the pattern.