Diamond Ascended Core

# Diamond Ascended Core

The progression engine behind the **Diamond Ascended** modpack. It turns a playthrough into a journey through seven **Ages**, where exploring, farming and beating bosses unlock better gear.

## The Ages

Every player starts in the **Wood Age** and moves up through Stone, Iron, Diamond, Nether, End and Ascended.

- **Gear locks:** tools, weapons and armor from a later Age can't be used. Locked tools won't mine or attack, and locked armor comes straight off. Tooltips show which Age an item needs.
- **Dimension locks:** the Nether opens at the Diamond Age, the End at the Nether Age, and other dimensions when their Age arrives. Each can be changed in the config.
- **Real tasks:** Ages are earned by visiting biomes, discovering structures (vanilla and modded), travelling, harvesting crops, breeding animals, fishing, trading, mining, levelling up, playing and defeating bosses. Progress counts from the moment a world starts.
- **Age rewards:** reaching each Age gives items and plays a title and sound.
- **Ages screen:** press **J** for a live checklist with progress counts, or type `/ages`.

## Quests

- A built-in quest book. Press **H** to open it.
- 41 quests, one chapter per Age, covering exploring, farming, building, fighting and bosses.
- Quests track themselves. When one is done, press **Claim** for its items and XP.
- Quests for mods you don't have are hidden.

## Monsters and bosses

- **Monster scaling:** monsters copy the Age of the nearest player when they spawn, from weaker than normal in the Wood Age up to +160% health in the last Age. This works on monsters from any mod.
- **Dimension bonus:** the Nether, End and Otherside add extra strength on top.
- **Ascended elites:** from the Diamond Age, some monsters spawn faster and tougher, and drop double XP.
- **Tougher bosses:** every boss has double health and +50% damage, plus +50% health for each extra player nearby.

## Netherite as treasure

- Ancient debris no longer generates.
- Netherite comes only from rare chest loot (any mod's chests) and boss drops.
- Diamond gear can't be upgraded to netherite. If Apotheosis is installed, its netherite affix drops are swapped for diamond.

## Also included

- The **Ascension** milestone path in the advancements screen, with rewards.
- A full in-game **guidebook**. Players get it on first join, and it can be crafted from a book and a stick.
- Item and entity tags (`requires_age_1` to `requires_age_6`, `bosses`, `never_scale`) so pack makers can put any mod's gear in an Age.

## Configuration

`config/diamond_ascended-common.toml` controls gear and dimension locks, monster and boss strength, elite chance, dimension bonuses and XP rewards. It's also editable from the Mods menu.

## For pack makers

- Operators can set a player's Age with `/ages set <players> <age>`.
- Gear from other mods can be assigned to an Age with item tags in a datapack.

Made for the Diamond Ascended modpack, but it works in any NeoForge 1.21.1 pack with Patchouli.

## Credits

The Apotheosis data overrides are adapted from Apotheosis by Stormraven Studios (MIT License). The guidebook is built with Patchouli by Vazkii.