Classes and Magie

Classes and Magie

Un système RPG complet et entièrement configurable pour serveurs Paper 26.x : classes, sous-classes, compétences et mana, races, traits, métiers, forge et gemmes.

Chaque joueur crée un vrai personnage : il choisit une classe, une race, reçoit des traits au hasard, apprend un métier, puis progresse en niveaux, en sous-classe et en spécialisation.

Tout est configurable. Les classes, races, métiers et objets décrits ci-dessous sont un contenu d'exemple prêt à jouer. Modifiez-les, supprimez-les ou créez les vôtres dans des fichiers YAML commentés, sans écrire une ligne de code.

---

⚔️ Classes et compétences

Contenu fourni par défaut :

• 5 classes : Guerrier, Mage, Archer, Assassin, Clerc, chacune avec ses statistiques, ses défauts et ses compétences.
• 10 sous-classes débloquées par des conditions : niveau, éliminations, sorts lancés, dégâts infligés, soins prodigués…
• 36 compétences : charge, boule de feu, pluie de météores, nova de givre, pas de l'ombre, parade, racines, jugement…
• Barre de compétences : la touche F remplace la barre d'objets par les icônes des compétences, les touches 1 à 8 les lancent. Recharge et mana visibles sur chaque icône, icônes personnalisables par resource pack.
• Mana avec régénération par classe, réduite en combat.

🧬 Création du personnage

• 6 races (Humain, Elfe, Nain, Orc, Tieffelin, Félys) avec bonus, défauts, effets permanents et malus si la race ne convient pas à la classe.
• Traits aléatoires positifs, négatifs ou mixtes, avec relances limitées.
• Traits uniques : un seul joueur sur tout le serveur peut porter chacun d'eux.

📈 Progression

• Niveaux et XP par monstre (barème configurable, MythicMobs compris).
• Arbre de compétences par classe, avec des branches réservées aux sous-classes.
• Attributs : Force, Dextérité, Intelligence, Vitalité, Sagesse, Agilité, Endurance.

⚒️ Métiers et artisanat

• 9 métiers, un seul par joueur : Mineur, Forgeron, Joaillier, Bûcheron, Fermier, Alchimiste, Enchanteur, Pêcheur, Dresseur.
• Actions et recettes débloquées par niveau de métier (équipement en diamant, débris antiques, table de forgeron…).
• Spécialisations au niveau 20 : Prospecteur, Foreur, Armurier, Fabricant d'armes, Facteur d'arcs, Lapidaire, Orfèvre.
• Forge : les armes et armures fabriquées par un forgeron reçoivent une rareté (Commun → Légendaire), des stats aléatoires positives ou négatives et des emplacements de gemmes.
• Objets uniques : Excalibur, Égide… chacun ne peut être forgé qu'une seule fois sur le serveur.
• Gemmes trouvées brutes en minant, taillées par un joaillier (rareté et pureté selon son niveau), puis incrustées dans l'équipement.

👥 Groupes, chat et HUD

• Groupes dont les règles sont fixées à la création : XP partagée ou égale, dégâts alliés ou non. Les soins ne touchent que les alliés.
• Chat de groupe (/gc), classe et niveau affichés dans le chat.
• Dégâts flottants (normaux, critiques, compétences, soins) et PV de la cible en bossbar ou au-dessus de la tête.
• Panneau latéral avec les PV et le mana des membres du groupe.

🛠️ Créez votre propre univers

Tout se règle dans des fichiers YAML commentés, avec des exemples :

Fichier	Ce que vous pouvez créer ou modifier
classes.yml	Classes, sous-classes, stats, défauts, conditions de déblocage, compétences
races.yml · traits.yml	Races, malus selon la classe, traits et traits uniques
jobs.yml	Métiers, spécialisations, actions réservées, recettes par niveau, XP
forge.yml · gems.yml	Raretés, stats aléatoires, objets uniques, gemmes, taille
skilltree.yml · attributes.yml	Arbres de compétences, attributs
kits.yml · items.yml	Kits de départ, restrictions d'objets (objets custom compris)
hud.yml · messages.yml	Affichages, et tous les textes (traduisibles dans n'importe quelle langue)

Bon à savoir

• Les compétences s'appuient sur une trentaine de mécaniques fournies (projectile, zone, soin, charge, téléportation, invisibilité…) entièrement réglables : dégâts, portée, durée, mana, recharge, icône. Pour une mécanique totalement nouvelle, utilisez une compétence MythicMobs (type MYTHIC, sans code) ou l'API Java.
• Les types de défauts, de conditions et d'actions de métier sont prédéfinis, mais se combinent librement.
• Une classe et une sous-classe par joueur, un seul métier, jusqu'à 8 compétences dans la barre.
• Les commandes sont en français, avec des alias anglais (/class, /job, /party, /skill).

🔌 Compatibilité

• Paper 26.1.x et 26.2 (et Purpur), Java 25.
• MythicMobs (optionnel) : noms et niveaux des mobs, XP par mob, compétences MythicMobs utilisables comme compétences de classe.
• PlaceholderAPI (optionnel) : placeholders %cykclasses_*%.
• Objets custom dans les kits et les restrictions : CraftEngine, ExecutableItems, MythicCrucible, ItemsAdder, Oraxen, Nexo, MMOItems.
• Stockage YAML, JSON ou SQLite.
• API Java et événements pour les autres plugins.

📖 Documentation

Documentation complète en français, avec exemples et limites : wiki.

Code source sous licence GPL-3.0 : GitHub · Bugs et suggestions : Issues.

---

🇬🇧 English

A complete RPG system for Paper 26.x servers. Players pick a class (5 classes, 10 unlockable subclasses, 36 skills cast from a dedicated hotbar with mana and cooldowns), a race (with class penalties), random traits (including server-unique ones), and a job (9 jobs with level-gated recipes and specializations). Blacksmiths forge gear with random rarity and stats, including one-of-a-kind unique items; jewelers cut raw gems with rarity and purity before they are socketed. Also includes parties with custom rules, party chat, floating damage numbers and target health display, a skill tree and attributes.

Fully configurable: everything listed above is ready-to-play default content. Create your own classes, subclasses, races, traits, jobs, forge rarities, gems, kits and item rules in commented YAML files, without writing code. Skills are built from ~36 tunable mechanics (projectiles, AoE, heals, dashes, teleports…); brand-new mechanics can be added through MythicMobs skills or the Java API.

Compatible with MythicMobs, PlaceholderAPI and custom items from CraftEngine, ExecutableItems, MythicCrucible, ItemsAdder, Oraxen, Nexo, MMOItems. The default texts and documentation are in French; every message can be translated in messages.yml. Commands are in French with English aliases (/class, /job, /party, /skill).