YARAM

# YARAM

**YARAM transforme Minecraft en jeu d'aventure et de rôle.** Rencontre des aventuriers, enchaîne leurs quêtes, ouvre des donjons à thèmes, affronte leurs boss, survis aux événements célestes, explore une cité steampunk suspendue dans les nuages… et découvre une faune nouvelle dans les trois dimensions.

📖 **Wiki complet (français) : https://yaram.miraheze.org** — chaque objet, chaque recette, chaque créature et ses biomes d'apparition.

> ⚠️ **Version bêta (0.9.0).** Le mod est jouable du début à la fin, mais il peut rester des bugs : merci de les signaler !

---

## 🧭 Aventuriers et quêtes
- Des **aventuriers** dans les villages et dans des **campements** en pleine nature (tente, feu de camp, bancs…).
- Chacun propose une **série de quêtes** selon sa spécialité (chasseur, forgeron, alchimiste, explorateur) ; la dernière étape donne un **parchemin de donjon**.
- Plus de **180 quêtes** (séries d'aventuriers et quêtes annexes), une **carte au trésor** qui mène à l'aventurier le plus proche, et la possibilité d'abandonner un aventurier trop lointain.

## ⚔️ Progression du personnage
- **Niveaux**, points de compétence et quatre attributs : **Force, Agilité, Endurance, Magie** (avec une barre de **mana**).
- Un **livre de l'aventurier** (touche K) : personnage, compétences, quêtes et un guide qui s'enrichit au fil de l'aventure, sans divulgâcher.
- Équipement à **rareté et affixes** tirés au hasard (commun, rare, épique, légendaire).

## 🏰 Donjons à thèmes
- **Six thèmes** selon l'endroit où tu lis le parchemin : château, temple du désert, caverne, crypte gelée… et, dans le Nether et l'End, **forteresse infernale** et **observatoire du Vide**.
- **Quatre rangs**, des gardes, des mini-boss, un boss final, des coffres et des **trophées** au rang IV.
- Les quatre trophées de l'Overworld forgent la **Statue du héros**, qui ouvre la porte de la Cité Céleste.

## 🌩️ Événements célestes
- **Tempête des Anciens, Pluie d'étoiles, Aurore arcanique, Lune de sang**, et désormais **l'Éruption** (Nether) et **l'Éclipse noire** (End).
- Un objectif commun, un matériau rare, des récompenses légendaires… et un **cor céleste** pour les invoquer.

## ☁️ La Cité Céleste
- Une **dimension steampunk** : un archipel d'îles flottantes, des rues, des usines, des dirigeables.
- Des **machines** à combattre (automates, drones, contremaîtres) et le redoutable **Titan d'Airain** en trois phases.
- **Délivre les villageois prisonniers**, rejoins la **Résistance** et libère la cité quartier par quartier.
- Reprogramme un automate en **compagnon**, pilote ton propre **dirigeable**, vole avec le **harnais d'aéronaute**.

## 🦔 Faune des trois dimensions
- **Overworld** : hérisson, cerf, capybara, escargot géant, lucioles.
- **Nether** : salamandre de cendre, scarabée doré, mouton de cendre, méduse de braise, et des **marchands piglins**.
- **End** : raie du Vide, méduse astrale, et le **shulkling**, un petit compagnon qui porte tes affaires.
- Leurs ressources se récoltent **sans les tuer** et servent à des dizaines d'objets utiles : canne à pêche barbelée, flèches, pièges, sac de couchage, boussoles, planeur, cape de cendre, bottes de marche-lave…

## 🎵 Une bande-son originale
**21 morceaux** composés pour le mod (plaines, nuit, feu de camp, chaque donjon, chaque événement, Nether, End, combat contre le Titan) qui alternent avec la musique de Minecraft.

## 🥚 Et quelques secrets…
Quelques clins d'œil sont cachés dans le mod. À toi de les trouver !

---

## 📦 Installation
- **Minecraft 26.2** avec **NeoForge 26.2.0.80** ou plus récent.
- À installer sur le **client et le serveur** (multijoueur pris en charge).
- **Optionnel** : [Curios API](https://modrinth.com/mod/curios) (amulette, harnais, talisman, cape et anneau dans des emplacements dédiés) et [JourneyMap](https://modrinth.com/mod/journeymap) (points de repère des aventuriers).
- Langues : **français** et **anglais**.

---
---

# 🇬🇧 English

**YARAM turns Minecraft into an adventure RPG.** Meet adventurers and follow their quest chains, open themed dungeons and defeat their bosses, survive sky events, explore a steampunk city above the clouds, and discover new wildlife in all three dimensions.

📖 **Full wiki (in French): https://yaram.miraheze.org**

> ⚠️ **Beta (0.9.0).** Playable from start to finish, but bugs may remain — please report them!

- **Adventurers & quests**: adventurers in villages and wilderness camps, 180+ quests, treasure maps, dungeon scrolls.
- **Character progression**: levels, skill points, Strength / Agility / Endurance / Magic, mana, randomly rolled gear rarities and affixes, an in-game adventurer's book (K).
- **Themed dungeons**: six themes (castle, desert temple, cavern, frozen crypt, infernal fortress, void observatory), four ranks, bosses and trophies.
- **Sky events**: Storm of the Ancients, Starfall, Arcane Aurora, Blood Moon, Eruption (Nether), Black Eclipse (End).
- **The Sky City**: a steampunk dimension with machines to fight, the three-phase Brass Titan, prisoners to free, a Resistance to join, companion automatons and pilotable airships.
- **Wildlife in three dimensions**, harvested without killing, and dozens of useful crafts.
- **An original soundtrack** of 21 pieces.
- **Requirements**: Minecraft 26.2, NeoForge 26.2.0.80+, client and server. Optional: Curios API, JourneyMap.