Описание


## [Interactive Guide App](https://underwood-inc.github.io/s-alloys/)
> ### ⚠️ THE MOD VARIANT IS A WRAPPED DATAPACK, YOU STILL MUST DOWNLOAD AND ENABLE THE RESOURCEPACK THAT EVERY RELEASE HAS IN ITS SUPPLEMENTARY FILES SECTION
[](https://underwood-inc.github.io/s-alloys/)
**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.*
---

## Features
> in testing, tools+armor+crossbows+bows should all be good to go, regular playtesting is ongoing on the [Shirecraft survival server](https://modrinth.com/server/shirecraft)
- **10 alloys** — Tin, Bronze, Silver, Steel, Cobalt, Nickel, Platinum, Mythril, Adamantine, Astral
- **Additive only** — no vanilla recipe overrides; alloy gear uses `#alloys:ingots/` 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](https://modrinth.com/datapack/totem-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/`). 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/` — 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 ` — operator kits
- `/alloys reload` — reload plugin config
**Permissions:** `alloys.use` (default: all players) · `alloys.admin` / `alloys.give` (default: op)
---
## Rituals pairing
If **[Rituals](https://modrinth.com/datapack/totem-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](https://www.twitch.tv/strixun) · **Underwood Inc**