alloys

!Replace this with a description

Interactive Guide App

⚠️ THE MOD VARIANT IS A WRAPPED DATAPACK, YOU STILL MUST DOWNLOAD AND ENABLE THE RESOURCEPACK THAT EVERY RELEASE HAS IN ITS SUPPLEMENTARY FILES SECTION

alloys adds ten fantasy metals to Minecraft 26.2 — from Tin to Astral — with full toolsets, armor, bows, material stats, lore, and passive traits. It is fully additive: vanilla recipes and ore drops are preserved.

Ships as a datapack (required for gameplay) and a companion resource pack (required — distinct textures for every ingot, fragment, tool, and armor piece). An optional Paper plugin adds a recipe chest GUI, written guidebook, and /alloys commands.

Forge deeper. Vanish never.

---

!Replace this with a description

Features

in testing, tools+armor+crossbows+bows should all be good to go, regular playtesting is ongoing on the Shirecraft survival server

• 10 alloys — Tin, Bronze, Silver, Steel, Cobalt, Nickel, Platinum, Mythril, Adamantine, Astral
• Additive only — no vanilla recipe overrides; alloy gear uses #alloys:ingots/<alloy> tags
• 4 mined fragment drops — bonus rolls while breaking vanilla ores (vanilla loot always drops first)
• Full gear per metal — pickaxe, shovel, axe, sword, hoe, bow, crossbow, helmet, chestplate, leggings, boots
• Passive traits — attribute bonuses, intrinsic enchants, and tick-based effects while held or worn
• Recipe book integration — advancement tabs and unlock backfill on join
• Written guidebook — delivered once per player (datapack or /alloys guidebook on Paper)
• Resource pack — separate zip with unique textures for all ten alloys (ingots, fragments, and full gear)
• Rituals integration — alloy tools support Rituals Soul Embodiment when both packs are installed

---

The ten alloys tier chart

#	Alloy	Band	≈ Stats	Source
1	Tin	Common	copper	Craft
2	Bronze	Common	copper	Craft
3	Silver	Uncommon	iron	Craft
4	Steel	Uncommon	iron	Craft
5	Cobalt	Uncommon	iron	Ore bonus or craft
6	Nickel	Rare	iron	Ore bonus or craft
7	Platinum	Rare	gold	Craft
8	Mythril	Epic	diamond	Ore bonus or craft
9	Adamantine	Legendary	diamond	Ore bonus or craft
10	Astral	Mythic	netherite	Craft (endgame)

Lore format: Tier: {Band} · Tier {N} · ≈{vanilla} — bands (Common→Mythic) are progression labels, not loot rarity.

Ore bonus drops (extra roll only — pool 1 is unchanged vanilla):

Fragment	Chance	Host ores
Cobalt Fragment	0.125%	Coal, copper, lapis (incl. deepslate)
Nickel Fragment	0.156%	Iron (incl. deepslate)
Mythril Fragment	0.0625%	Redstone, emerald (incl. deepslate)
Adamantine Fragment	0.031%	Diamond (incl. deepslate), ancient debris

Fragments are non-smeltable glowing collectibles. Nine matching fragments craft one ingot (#alloys:fragments/<alloy>). Each ore alloy also has a vanilla-material ingot recipe on its guide pages.

---

Installation

Datapack

1. Download alloys-datapack-*.zip
2. Copy into your world's datapacks/ folder and rename to Alloys.zip
3. Restart the world — not just /reload (functions must register)

Resource pack (required)

1. Download alloys-resourcepack-*.zip
2. Client: Options → Resource Packs → enable the zip (place above other packs that retexture tools or armor)
3. Server: copy into resourcepacks/ and set resource-pack= in server.properties (optional require-resource-pack=true).
   My personal favorite utilities for server resourcepack management: https://minepack.fr/ & https://www.craftmc.net/tools/resource-pack-merger

Gameplay works without the resource pack however, you will be missing textures.

Paper plugin (optional)

The plugin provides a chest GUI for in-game guidance and administration.

1. Place alloys-plugin-*.jar in plugins/
2. Restart the server — clients should still enable the resource pack for alloy textures
3. Verify the update, plugin behavior can vary from server-to-server. If anything is amiss, shut down the server and replace the datapack zip in the corresponding world datapack folder with the new one.

Requirements: Minecraft 26.2 · datapack format 107.1 · resource pack format 88.0 · Java 25 (Paper plugin)

---

Commands

Datapack:

• /function alloys:help — clickable help menu
• /function alloys:give/<alloy> — operator test kit (materials, ingot, full tools & armor)
• /function alloys:give/guidebook — written guidebook

Paper plugin:

• /alloys help — recipe browser (chest GUI)
• /alloys recipes — chat recipe viewer
• /alloys guidebook — written guidebook
• /alloys give <alloy> — operator kits
• /alloys reload — reload plugin config

Permissions: alloys.use (default: all players) · alloys.admin / alloys.give (default: op)

---

Rituals pairing

If Rituals is also installed, alloy tools can undergo Soul Embodiment awakening. Integration tags ship inside every Alloys zip — no extra download.

---

Design philosophy

Alloys adds content under alloys:* — it does not disable, replace, or suppress vanilla minecraft:* crafts. Ore changes append a second bonus loot pool; they never remove normal drops.

---

Author: strixun · Underwood Inc