FactionWar — Wiki communautaire#

Documentation complète du serveur Minecraft FactionWar (Paper 1.21.11, hébergé par PingHeberg), reconstituée intégralement à partir des 5 canaux Discord de la catégorie Minecraft FactionWar et des pièces jointes qui y ont été publiées.

Périmètre couvert : #wiki-factionwar, #factionwar-annonces, #factionwar-histoire, #factionwar-dev, #factionwar-modspack — lus intégralement, du premier au dernier message.

🚀 Par où commencer#

📚 Sommaire de la documentation#

Le projet#

L'univers#

Le gameplay#

La technique#

Les visuels#

• Index des 112 visuels — bannières, interfaces du mod, PNJ en jeu, builds de la Capitale, pack de textures. Les 97 images de #factionwar-dev y sont datées à la minute et recoupent la chronologie de dev.

📁 Structure du dossier#

mc-factionwar/
├── documentation.html        ← TOUT le wiki en une page, à double-cliquer
├── README.md                 ← vous êtes ici
├── docs/                     15 fiches thématiques
├── assets/                  112 images, classées par canal Discord
│   ├── INDEX.md              index commenté des visuels
│   ├── wiki-factionwar/      \
│   ├── factionwar-annonces/   |
│   ├── factionwar-histoire/   |  les ORIGINAUX, pleine résolution (119 Mo)
│   ├── factionwar-dev/        |
│   ├── factionwar-modspack/  /
│   ├── _moyennes/            versions 1400 px pour l'affichage (15 Mo)
│   └── _vignettes/           versions 480 px pour la galerie (3 Mo)
└── sources/                  matière première brute
    ├── brief-recrutement.md  brief fourni par le porteur du projet
    ├── image-urls.txt        URL CDN d'origine de chaque image
    ├── discord/              transcriptions des 5 canaux
    └── attachments/          pièces jointes publiées sur le Discord

Lire la documentation#

Double-cliquez sur documentation.html. Tout y est : les 15 fiches, l'index des visuels, le brief, et une galerie des 112 images. Le fichier fonctionne hors ligne, sans serveur et sans connexion — il doit simplement rester à côté du dossier assets/ pour afficher les images.

Il embarque une barre de navigation, une recherche instantanée (Ctrl+F), une visionneuse d'images et une mise en page imprimable. Les dossiers _moyennes/ et _vignettes/ sont des versions allégées générées automatiquement : la page les affiche pour rester fluide, et donne accès à l'original en pleine résolution d'un clic. Ils sont reconstructibles et peuvent être supprimés si vous ne gardez que les fiches Markdown.

🔎 Traçabilité#

Toute la documentation est sourcée. Chaque fiche se termine par une section « Sources » qui renvoie aux fichiers de sources/, et rien n'a été inventé : quand une information manque, c'est écrit explicitement (« non précisé dans les sources »).

Matière première#

Convention de fiabilité#

Convention de citation#

Les passages entre guillemets « … » sont repris des messages Discord, mais leur orthographe est normalisée : fautes de frappe corrigées, accords rétablis, tutoiement parfois transposé à la troisième personne. Le sens et les chiffres ne sont jamais modifiés. Exemple : la source écrit « Le lien et Tres priver réserver au membre Genesis il ce reconnaitrons », la documentation cite « Le lien est très privé, réservé aux membres Genesis — ils se reconnaîtront ».

Le texte brut, tel que publié, est toujours dans sources/ — c'est lui qui fait foi en cas de doute. Deux exceptions où la graphie d'origine est conservée volontairement, parce qu'elle a une conséquence pratique : le chemin %appdata%\Raoming\minecraft\mods du guide d'installation (coquille à corriger dans l'annonce) et la citation « Info Vocal » de la fiche 12, explicitement marquée (orthographe d'origine).

✅ Audit de complétude#

La couverture des sources a été auditée en trois passes successives, chacune plus stricte que la précédente, parce que les deux premières se sont révélées insuffisantes. Voici exactement ce qui est garanti, et comment on le sait.

Le recensement officiel : 152 messages à l'audit, 159 aujourd'hui#

La recherche Discord filtrée par salon donne le nombre exact de messages de chaque canal. C'est le dénominateur incontestable. Les canaux étant vivants, la colonne de droite donne le recomptage du 31/08/2026 :

148 messages sur 152 ont été récupérés avec leur texte intégral. Les 4 restants sont des publications sans aucun texte (image ou vidéo seule) : il n'y a rien à en extraire.

Les 7 messages apparus depuis sont tous du 31/08 et portent tous sur le donjon et son boss ; ils sont intégrés (voir « Contenu ajouté après l'audit » plus bas). Aucun autre contenu n'est apparu ailleurs : les trois canaux histoire, wiki et modspack sont recomptés identiques.

La méthode qui fait foi#

Les premières captures se faisaient en faisant défiler le canal et en sélectionnant le texte à l'écran. Cette méthode perd des messages en silence — c'est la cause de tous les trous trouvés.

La méthode retenue au final est différente : on filtre la recherche Discord sur un salon, et on copie le panneau de résultats en entier, page par page. Chaque message y figure complet, horodaté et attribué, sans troncature liée à l'écran. Le résultat consolidé est dans sources/discord/EXPORT-REFERENCE-tous-canaux.txt — c'est désormais la source qui fait autorité, les captures par défilement sont conservées en second.

Ce que les audits ont trouvé, et corrigé#

Passe 1 — recensement par mots-clés (nouveau, guide) : 27 annonces énumérées, 7 messages manquants ou tronqués découverts et récupérés.

Passe 2 — export exhaustif par la recherche : confrontation des 148 messages récupérés aux sources existantes. Sur les 69 messages porteurs de texte substantiel, 66 étaient déjà couverts et 3 manquaient (dont 2 étaient un doublon du même message). Parmi les messages courts, un seul avait une valeur documentaire réelle. Tous ont été intégrés.

Les 7 messages de la passe 1 :

Et les 3 de la passe 2 :

Passe 3 — recalage de la chronologie sur l'export. La chronologie avait été bâtie sur les captures par défilement, qui ne portaient pas toujours l'horodatage. Confrontée à l'export de référence, elle a livré une dernière série de corrections :

• une erreur de date réelle : l'ouverture de la Zone Bois était datée du 15/08 15:07, elle est du 16/08 08:44 (le guide associé suit à 08:56) ;
• 14 entrées datées « ⚠️ à confirmer » ont reçu leur horodatage exact (cross-play 14/08 00:50, métiers 12:09, impôt 23:12, /f history 15/08 01:08, boutique 01:38, zone AFK 14:45, mod client 16/08 23:25, V.0.9 17/08 12:54, refonte métiers 18/08 06:22, MAJ menus 20/08 14:41, 46 quêtes 24/08 23:53, infrastructure 25/08 20:39, roadmap 29/08 15:04, coulisses 30/08 03:11) ;
• 9 messages présents dans les sources mais absents du tableau chronologique y ont été ajoutés, dont le pack de textures maison (18/08) et le logo + titre du serveur (25/08) — deux éléments qui changent le brief du graphiste : il reprend un existant au lieu de partir de zéro ;
• l'appel à bâtisseurs était daté du 30/08, il est du 25/08 11:35.

Résultat après correction : sur les 152 messages du recensement officiel, 148 sont récupérés intégralement et leur contenu substantiel est intégré à la documentation. Les 4 non récupérés n'ont aucun texte. Il ne reste qu'un seul « ⚠️ à confirmer » dans la chronologie.

Passe 4 — vérification systématique du contenu des fiches (31/08/2026). Les trois premières passes vérifiaient la couverture des sources. Celle-ci vérifie ce que les fiches en disent, par des contrôles mécaniques dont le dénominateur est vérifiable :

Les 3 défauts trouvés et corrigés :

1. Une date fausse. Les fiches 01 et 02 attribuaient au 27/08/2026 le message sur l'infrastructure multi-serveurs (« On ne construit pas juste un serveur… », proxy central, Terravel comme monde final). Aucun message n'a été publié le 27/08 — il est du 25/08/2026 20:39. La passe 3 avait déjà recalé cette date dans la chronologie, mais les deux autres fiches avaient gardé l'ancienne.
2. Une contradiction entre fiches sur le bonus de métier. La fiche 04 reprenait la formulation du guide Zone Bois (« votre rendement en bois augmente jusqu'à +30 % »), alors que la fiche 07 documente le mécanisme réel : une chance de doubler le drop, +1 point par niveau. Même borne chiffrée, nature de l'effet différente. La fiche 04 porte désormais la précision.
3. 44 chemins absolus Windows (C:\Users\kevin\Desktop\mc\…) dans les sections « Sources » de 5 fiches — ce dossier étant fait pour être partagé, ces références auraient été inutilisables chez un bâtisseur ou un développeur. Converties en chemins relatifs, comme dans les 10 autres fiches.

Ce qui n'est volontairement pas exhaustif

• Les vidéos publiées dans #factionwar-dev n'ont pas été téléchargées (images uniquement).
• Les binaires du pack de mods (.exe, .jar) ne sont pas dans le dossier : la doc conserve les liens de téléchargement officiels, ce qui est plus sûr et plus durable.

Les images, elles, sont exhaustives — sur les 5 canaux

Contrairement à une première version de ce dossier qui n'en gardait qu'une sélection, toutes les images des cinq canaux ont été récupérées : 112 fichiers (119 Mo), zéro doublon binaire, zéro fichier tronqué. Le dénominateur vient de Discord lui-même, canal par canal (dans: <canal> + contient: image) :

Le nombre de fichiers dépasse celui des messages car certains messages portent jusqu'à 4 pièces jointes. Chaque copie a été validée par une empreinte distincte du presse-papier, pour écarter le mode d'échec silencieux d'un presse-papier périmé — un piège qui s'est déclenché trois fois au total, à chaque fois détecté et rejoué. Le détail est dans l'index des visuels.

🆕 La seule image nouvelle trouvée lors de cette passe est 04-boss-le-veilleur-muet.png, publiée le 31/08/2026 à 01:52 — soit après la rédaction des 14 premières fiches. Elle a déclenché la rédaction de la fiche 15, Donjons instanciés et boss, qui couvre désormais ce contenu.

Contenu ajouté après l'audit des 152 messages#

Le canal #factionwar-dev est passé de 129 à 135 messages et #factionwar-annonces de 3 à 4 annonces pendant la constitution de ce dossier. Le contenu apparu depuis a été intégré :

⚠️ Contradictions connues dans les sources#

Ces points sont contredits d'un message à l'autre du Discord et n'ont pas pu être tranchés. Ils demandent un arbitrage du porteur du projet — ils sont signalés en place dans chaque fiche.

Dossier constitué le 30 août 2026 à partir du serveur Discord PingHeberg°, catégorie « Minecraft FactionWar ».

FactionWar — Vue d'ensemble du projet#

FactionWar est un serveur Minecraft PvP-Factions développé de zéro par PingHeberg, construit autour d'un univers narratif propre (Terravel, les Cinq Royaumes) et d'une progression par paliers, avec un plugin Paper maison et un mod client Fabric développé en interne.

1. Ce qu'est FactionWar#

FactionWar est présenté par son auteur comme un projet, pas juste un serveur :

« On ne construit pas juste un serveur. On construit une plateforme. »

« On ne fait pas les choses à moitié. FactionWar est un projet, pas juste un serveur. » — #factionwar-dev, 25/08/2026 20:39

Le pitch d'origine, publié à l'annonce du projet :

« Je vous présente FactionWar, mon nouveau projet : un serveur Minecraft PvP-Factions avec une identité forte et un vrai univers derrière. » — Appo, #factionwar-annonces, 13/08/2026

Le wiki officiel le résume côté joueur :

« Bienvenue sur FactionWar, le serveur d'event PingHeberg où des factions s'affrontent pour la domination, la richesse et le territoire. »

Le concept a évolué en cours de route#

« Le concept lui-même a évolué : ce n'est plus deux zones opposées, c'est devenu 5 royaumes progressifs avec une vraie mythologie derrière (Terravel, l'Innommé, les Cinq Royaumes) » — Hynata, #factionwar-annonces, roadmap mise à jour du 29/08/2026

2. Positionnement : pas un serveur factions classique#

Trois partis pris distinguent FactionWar d'un serveur factions générique.

1. Tout est codé maison. C'est l'engagement le plus répété du projet, de l'annonce initiale jusqu'à la roadmap mise à jour.

« Un système 100% custom, codé de zéro. Toujours pas un plugin tout fait. »

« On voit souvent des serveurs Minecraft qui tournent avec un ou deux plugins téléchargés tout faits. Chez nous, c'est différent : je développe tout le système de jeu sur mesure, à la main, depuis plusieurs semaines. » — #factionwar-annonces, 30/08/2026

2. La progression se mérite. Chaque palier demande un niveau de métier et/ou un stock de ressources ; rien n'est offert.

« Chaque transition demande d'avoir vraiment progressé — niveaux de métiers, stocks de ressources, parfois les deux combinés. Rien n'est offert, tout se mérite. »

Le Nether, l'End et les Élytres sont volontairement désactivés sur les serveurs de progression, et réservés comme récompense finale :

« Ce n'est pas une limitation, c'est une promesse : l'expérience Minecraft complète, avec Nether, End et Élytres, vous attend ailleurs, comme véritable récompense finale de tout votre parcours. »

3. Une couche RPG narrative greffée sur du PvP-Factions. PNJ avec de vraies fenêtres de dialogue (jamais l'écran de troc vanilla), quêtes à rendre en personne, réputation individuelle par PNJ, chapitres narratifs — voir 03-personnages.md.

4. Une économie qui interdit de thésauriser. Une faction Riche passive perd 10 % de chaque gain dans une cagnotte redistribuée aux Pauvres, et un Core détruit coûte 30 % du trésor.

« La richesse ne se garde pas sur FactionWar. Elle se défend, elle s'investit, et surtout — elle se mérite chaque jour. »

3. Stack technique en une page#

Base serveur#

Plugins serveur maison#

Les données transitent entre serveur et client par des canaux réseau dédiés : MenuDataChannel, ShopPurchaseChannel, ZoneTravelChannel, FactionManagementChannel, TrashItemChannel.

🆕 Depuis le 31/08/2026, s'ajoute un système de donjons instanciés (copie de monde, chargement, nettoyage) et un moteur de boss scripté à phases, décrits comme fonctionnels et testés. Ces briques ne portent pas encore de nom de classe dans les sources — l'inventaire ci-dessus est antérieur. Voir 15-donjons-et-boss.md.

Mod client Fabric maison#

Le FactionWar Client (factionwarclient) est un mod client développé en interne, obligatoire pour rejoindre le serveur (annoncé comme tel dans #factionwar-dev).

• Une sidebar unique partagée (Sidebar.java) entre trois écrans : Inventaire (Inv), Recettes (Rct), Faction (F), plus un onglet Quêtes (Que)
• Écran Inventaire custom : grille repositionnée, barre de recherche filtrante, aperçu 3D du personnage, panneau Loadout, poubelle intégrée
• Menu Faction en 7 sections : Faction, Shop, Raids, Cagnotte, Core, Zones, Métiers
• Écran Recettes : reconstruction quasi-complète du livre de recettes vanilla (pagination, aperçu fantôme, surbrillance des ingrédients, craft automatique réel)
• Touches dédiées : G (menu général, en test à côté de /newinv), J (parler à Osric à distance), V (réglages du vocal)

Le menu Faction « n'invente aucune donnée, il ne fait qu'afficher et permettre d'agir sur ce que ces plugins gèrent déjà côté serveur depuis le début. »

Mods clients tiers (optionnels)#

Le vocal de proximité (Simple Voice Chat) tourne sur Fabric 1.21.11 avec la Fabric API. Il est totalement optionnel et indisponible en Bedrock (limitation technique).

4. Crossplay Java / Bedrock#

Le serveur est jouable sur toutes les plateformes : Java Edition, Bedrock (Switch, Xbox, PlayStation, mobile, Windows 10/11).

Adresses de connexion — ⚠️ à confirmer : les sources se contredisent.

• Wiki officiel (16/08/2026) : 51.195.4.126:25577 pour toutes les plateformes (Java / Bedrock / mobile / consoles).
• Annonce crossplay #factionwar-dev : adresse 51.195.4.126, port 19132 pour les joueurs Bedrock, « adresse habituelle » pour les Java.

⚠️ À confirmer également : le mod client FactionWar est annoncé comme obligatoire, mais il n'existe qu'en Fabric (Java). Les sources n'expliquent pas comment les joueurs Bedrock accèdent aux menus custom.

5. Équipe et rôles#

« Un grand merci aussi à MissMlx, qui met la main à la pâte sur la construction du monde, et à Poucy, qui teste sans relâche tout le contenu narratif pour traquer le moindre bug avant que vous ne tombiez dessus. » — #factionwar-annonces, 30/08/2026

⚠️ À confirmer : la répartition exacte entre les comptes « Appo » et « ! Hynata » n'est pas explicitée dans les captures — les deux publient du contenu de développement à la première personne (« je développe tout le système de jeu sur mesure »).

Statut bénévole et recrutement#

Le projet est bénévole et recrute : bâtisseurs, développeurs Java (Bukkit / Paper / Fabric) et graphiste (contexte projet vérifié).

⚠️ À confirmer : aucune des captures Discord fournies ne contient le message de recrutement lui-même. Les conditions, le format de candidature et le salon concerné ne sont donc pas documentés ici.

6. La roadmap en 5 phases#

Roadmap annoncée le 13/08/2026, réévaluée honnêtement le 29/08/2026.

Phase 1 — Fondations & système maison ✅#

Annoncé : infrastructure serveur (zones, base de données, plugin de transfert entre mondes), génération des deux mondes, systèmes de base (spawn, sécurité, anti-mobs en zone safe).

Réellement livré :

• Infrastructure multiserveur complète (Lobby + Terravel + 5 zones), synchronisation totale du joueur entre serveurs (inventaire, vie, XP — « tout suit sans perte »)
• Téléportation intelligente, respawn multi-monde, sauvegardes silencieuses
• Refonte du concept : de deux zones opposées vers 5 royaumes progressifs avec mythologie

Phase 2 — Gameplay Factions 🟡#

Annoncé : claims, économie interne, mécaniques PvP.

Déjà construit :

• Claims de territoire, Core avec PV et invulnérabilité, anti-friendly-fire
• Économie complète avec statut Riche/Pauvre dynamique et impôt automatique redistribué chaque jour
• Au-delà du prévu : 6 PNJ avec dialogues et réputation individuelle, un arc narratif complet de 10 quêtes menant à une voûte cachée, 5 métiers actifs simultanément, menu client entièrement custom (mod Fabric)

Reste à faire avant la suite :

• Écriture des quêtes pour les zones et PNJ restants (au-delà du Chapitre 1, déjà terminé)
• Build et aménagement du monde, zone par zone

Phase 3 — Alpha fermée ⏳#

« Pas encore. On préfère avoir un contenu plus complet et un monde plus abouti avant d'ouvrir à un premier groupe de testeurs, plutôt que de vous faire découvrir un chantier à moitié fini. »

⚠️ Tension à noter dans les sources : dès l'annonce crossplay (mi-août, #factionwar-dev), un appel à bêta-testeurs par MP était lancé (« envoyez-moi un MP, je vous donnerai accès en priorité ») et plusieurs fonctionnalités sont marquées « en test ». Il existe donc un accès de test informel, distinct de la Phase 3 officielle qui n'a pas démarré.

Phase 4 — Bêta publique ⏳#

Ouverture élargie, événements de lancement, système de rangs/boutique cosmétique uniquement — toujours pas de pay-to-win.

Phase 5 — Lancement officiel ⏳#

Sortie complète, mises à jour de contenu régulières, « toujours sur notre propre moteur de jeu maison ».

7. Chiffres et faits clés#

⚠️ Contradictions relevées entre sources (à trancher par l'équipe) :

• Métiers : le wiki du 16/08 décrit un métier à la fois avec un cooldown de 7 jours pour en changer ; les communications de fin août décrivent les 5 métiers progressant simultanément, « sans cooldown, sans exclusivité ». La version tardive semble faire foi.
• Zone Diamant : annoncée « Diamant + Ancien Débris / Netherite » dans le wiki et le document technique, puis « diamant + lapis exclusifs » dans le patch du 24/08 — ce dernier collant au lore de Glacime (« sommets de diamant et de lapis »).
• Adresse Bedrock : voir § 4.

8. Où trouver quoi#

Le dossier docs/ compte 15 fiches, numérotées de 01 à 15 sans trou.

Sources#

• #factionwar-annonces (Discord PingHeberg) — annonce initiale du projet (Appo, 13/08/2026), roadmap mise à jour (Hynata, 29/08/2026), coulisses techniques (Hynata, 30/08/2026)
• #factionwar-dev (Discord PingHeberg) — documentation du menu /f, annonce crossplay, FactionWar Client, patchs zones/paliers, infrastructure multi-serveurs, système de réputation
• #wiki-factionwar (Discord PingHeberg) — wiki officiel du 16/08/2026 (Wiki_FactionWar (3).md) et document de référence « Wiki complet du système de menus et de progression »
• #factionwar-histoire (Discord PingHeberg) — Les Chroniques de Terravel et présentations de personnages
• #factionwar-modspack (Discord PingHeberg) — installation Fabric / Fabric API / Simple Voice Chat
• Contexte projet vérifié hors Discord : plateforme Paper, statut bénévole et recrutement en cours
• sources/discord/factionwar-annonces-COMPLET.txt — annonce du 31/08/2026 01:52 : système de donjons instanciés et premier boss Le Veilleur Muet (voir 15-donjons-et-boss.md pour le détail et le sourçage complet).

Le lore de Terravel#

Restitution fidèle et structurée des Chroniques de Terravel telles que publiées sur le Discord FactionWar : le monde d'avant la Rupture, l'Innommé, la Guerre du Silence, la Rupture, les Cinq Royaumes, et le lien entre ce récit et la progression par paliers du serveur.

📜 « L'histoire complète, avec ses annexes et ses quêtes liées à chaque royaume, est désormais consultable directement en jeu — onglet Quêtes → Principale → Histoire. »

1. Avant la Rupture#

« Il fut un temps où le monde n'avait ni frontière ni palier. On l'appelait Terravel, une terre unique où la prospérité semblait sans limite et où la richesse appartenait à quiconque savait la saisir. Ses cités prospéraient sans crainte, ses récoltes ne manquaient jamais, et le commerce circulait librement d'un bout à l'autre du territoire. »

« C'est dans cette abondance qu'apparut un homme dont l'histoire ne retient plus le nom. »

Points à retenir :

• Terravel était un monde unique, sans frontières et sans paliers — l'opposé exact de la carte actuelle.
• L'abondance y était totale, et la richesse revenait « à quiconque savait la saisir » : aucune notion de mérite.
• C'est précisément cette abondance sans garde-fou qui rend la catastrophe possible.

2. L'Innommé#

« On l'appelle aujourd'hui simplement l'Innommé, et ce silence sur son identité n'est pas un oubli. C'est une punition, la seule que les Anciens aient jamais su lui infliger. »

« Il ne naquit pas puissant. Il le devint, lentement, en amassant ce que les autres négligeaient — des terres jugées sans valeur, des dettes que personne ne voulait recouvrer, des alliances que personne ne voulait sceller. En quelques décennies à peine, il possédait plus que n'importe quel royaume de Terravel réuni, sans qu'aucun conseil, aucune couronne, n'ait jamais vu venir le danger. »

Points à retenir :

• L'anonymat est une sanction, pas une lacune historique : les Anciens ont effacé son nom faute d'avoir pu l'arrêter autrement.
• Sa puissance est acquise, pas innée — construite par accumulation patiente de ce que les autres méprisaient.
• Personne ne l'a vu venir : ni conseil, ni couronne.

3. La Guerre du Silence#

« Elle ne commença pas par des armées ni par des batailles ouvertes. Elle commença par des marchés fermés, des récoltes rachetées avant même d'être semées, des cités entières mises à genoux sans qu'un seul coup ne soit porté. »

« Quand les royaumes de Terravel comprirent enfin ce qui se tramait, il était déjà trop tard. L'Innommé ne conquit pas le monde par la force. Il l'acheta, pièce par pièce, jusqu'à ce qu'il n'y ait plus rien à posséder. »

Points à retenir :

• Une guerre économique, sans bataille : c'est de là que vient son nom.
• La défaite de Terravel est une défaite de marché, pas d'armes.
• Le motif « la richesse est une arme » est le socle thématique de tout le serveur.

🆕 Une figure de cette époque devient jouable. Le premier boss de donjon, annoncé le 31/08/2026, est Le Veilleur Muet : *« un ancien gardien de pierre posté aux frontières bien avant la Guerre du Silence »*. Il appartient donc à la strate la plus ancienne du récit, celle des défenses dressées avant que l'Innommé n'achète le monde — et son mutisme prend tout son sens dans une guerre dont le nom même est le silence. Voir 15-donjons-et-boss.md.

4. La Rupture#

« Les Anciens, ce conseil de sages qui avait survécu à la chute de tous les royaumes, refusèrent de lui céder Terravel dans son entièreté. Dans un dernier acte de résistance, ils scellèrent le monde originel derrière une porte que nulle richesse ne pourrait jamais acheter, et fragmentèrent ce qui restait du territoire en cinq terres séparées — chacune conçue comme une épreuve. »

« Non pas pour punir les voyageurs à venir, mais pour s'assurer qu'aucun d'entre eux ne referait jamais l'erreur qu'avait commise Terravel entière : laisser un seul homme accumuler sans jamais avoir à prouver sa valeur. »

Points à retenir :

• Les Anciens sont un conseil de sages, survivants de la chute de tous les royaumes.
• Ils scellent Terravel derrière une porte insensible à la richesse — le seul verrou que l'Innommé ne peut acheter.
• Les cinq terres ne sont pas une punition : ce sont cinq épreuves, un dispositif de sécurité contre la répétition de l'histoire.

5. Les Cinq Royaumes#

Les cinq terres issues de la Rupture, telles que décrites dans les Chroniques :

🌲 Sylvange — la forêt des premiers pas, où l'on apprend à survivre avec ce que la terre veut bien offrir.

⛏️ Ferconte — les collines de cuivre et de fer, où le vent porte encore l'écho des marteaux d'une civilisation disparue.

🏜️ Solarande — les sables dorés et désolés, où l'on dit que l'or qu'on y trouve fut autrefois arraché aux coffres de l'Innommé lui-même, avant qu'il ne disparaisse.

❄️ Glacime — les sommets de diamant et de lapis, si froids que seuls les plus déterminés osent encore y monter.

🏘️ Aubécie — la dernière cité, la garnison ultime des Anciens, bâtie au plus près de la porte scellée de Terravel. Ses villageois sont bien plus vieux qu'ils n'en ont l'air. Certains, tard le soir, murmurent avoir connu l'Innommé de leur vivant. Aucun n'accepte jamais de le confirmer tout à fait.

Identité, ressource et ambiance de chaque royaume#

⚠️ Point à confirmer : le lore attribue à Glacime « diamant et lapis », ce que confirme le patch du 24/08/2026 (« nouvelle dimension avec diamant + lapis exclusifs »). En revanche, le wiki du 16/08 et le document technique annonçaient pour cette même zone « Diamant + Ancien Débris / Netherite ». La version diamant + lapis semble être celle retenue.

6. Aujourd'hui#

« On raconte que l'Innommé n'est pas mort. Qu'il observe encore, depuis quelque part que nul ne connaît, patient, presque amusé, à regarder les voyageurs tenter d'atteindre une porte qu'il a lui-même autrefois tenté de posséder. »

Un vieux forgeron d'Aubécie, interrogé sur l'apparence réelle de l'Innommé, répondit seulement ceci :

« Il n'avait pas besoin d'un visage. Il en avait déjà trop, empruntés à tous ceux qu'il avait ruinés, et aucun ne lui allait plus. »

Et l'avertissement adressé directement au joueur, qui clôt les Chroniques :

« Vous voilà prévenu, voyageur. Chaque pièce que vous amassez, chaque richesse que vous bâtissez, chaque royaume que vous traversez — quelqu'un l'a peut-être déjà fait avant vous, avec des conséquences que Terravel entière a mis des générations à effacer. »

« Reste à savoir si vous suivrez son chemin, ou si vous saurez, vous, réussir là où il a échoué. »

Points à retenir :

• L'Innommé est présumé vivant, spectateur, jamais confirmé mort.
• Le motif du visage manquant est repris directement par Mérielle à Aubécie (voir 03-personnages.md).
• Le récit désigne explicitement le joueur comme le successeur potentiel de l'Innommé : même chemin, issue différente à écrire.

7. Ce que la progression par paliers raconte#

La mécanique du serveur n'est pas plaquée sur le lore : elle est le lore. La Rupture a fragmenté le monde en cinq épreuves ; le joueur les traverse dans l'ordre.

Le mot d'ordre du projet reformule exactement la leçon des Anciens :

« FactionWar continue de grandir, chaque semaine, avec la même exigence : rien de gratuit, tout de mérité. »

Et l'objectif narratif déclaré :

« Le système de quêtes n'est qu'un début. Une véritable chaîne narrative se prépare, avec un objectif clair à l'horizon : faire de la Capitale la porte d'entrée vers la suite de l'aventure. »

Correspondance royaumes / paliers#

⚠️ À confirmer : les noms de royaumes (Sylvange, Ferconte, Solarande, Glacime, Aubécie) et les noms techniques de zones (Bois, Cuivre, Or, Diamant, Capitale) coexistent dans les sources sans qu'un document unique ne pose la correspondance officielle. Celle-ci est reconstituée ici à partir des ressources annoncées et du découpage du Chapitre 1 (sous-arc Bûcheron = Sylvange, sous-arc Cuivre = Ferconte, sous-arc Or = Solarande).

Le récit se déroule par chapitres#

Le Chapitre 1 « L'Éveil » couvre 12 étapes et les premières zones, réparties en sous-arcs :

• Sous-arc Bûcheron (Sylvange) → 4 quêtes
• Sous-arc Cuivre (Ferconte) → 4 quêtes
• Sous-arc Or (Solarande) → 4 quêtes
• Les sous-arcs Glacime / Diamant restent à écrire (état au 25/08/2026)

⚠️ À confirmer : aucune source ne décrit le contenu d'un Chapitre 2. La roadmap indique seulement qu'il reste « l'écriture des quêtes pour les zones et PNJ restants (au-delà du Chapitre 1 déjà terminé) ».

Sources#

• #factionwar-histoire (Discord PingHeberg) — « 📖 LES CHRONIQUES DE TERRAVEL — Le récit complet » (! Hynata), qui fournit l'intégralité des passages cités en blockquote de ce document
• #factionwar-dev (Discord PingHeberg) — patchs Zone Diamant / Zone Capitale (24/08/2026), récapitulatif des quêtes et découpage du Chapitre 1 (25/08/2026), infrastructure multi-serveurs et rôle de Terravel comme monde vanilla final (25/08/2026)
• #wiki-factionwar (Discord PingHeberg) — wiki officiel du 16/08/2026 et document de référence « Wiki complet du système de menus et de progression » (dimensions, biomes, conditions de déblocage, exclusivité des minerais)
• #factionwar-annonces (Discord PingHeberg) — roadmap mise à jour du 29/08/2026 (évolution du concept vers les Cinq Royaumes)
• sources/discord/factionwar-annonces-COMPLET.txt — annonce du 31/08/2026 01:52 : système de donjons instanciés et premier boss Le Veilleur Muet (voir 15-donjons-et-boss.md pour le détail et le sourçage complet).

Les personnages de FactionWar#

Recensement des PNJ narratifs du serveur : Osric l'éclaireur de Sylvange, les quatre gardiens d'Aubécie (Aldric, Séraphine, Bram, Mérielle), le mystérieux Cinquième, ainsi que le système de dialogue, les arcs narratifs connus et la réputation individuelle par PNJ.

1. Comment fonctionnent les PNJ#

Les PNJ de FactionWar ne sont pas des villageois marchands vanilla.

« Contrairement aux villageois classiques, ces PNJ n'ouvrent jamais l'écran de troc vanilla. Chaque interaction ouvre une véritable fenêtre de dialogue, propre à chaque personnage, avec son propre texte selon votre progression. »

Interaction : clic droit sur le PNJ → une fenêtre de dialogue dédiée s'ouvre.

Boutons possibles selon l'état :

Une catégorie de quêtes à part. Le menu Quêtes compte quatre catégories (Faction, Principale, Secondaire, PNJ). Les quêtes PNJ sont invisibles tant qu'un personnage ne vous les a pas confiées, et l'onglet PNJ ne sert qu'au suivi — il n'y a pas de bouton « Réclamer ».

« La récompense ne se réclame jamais dans le menu. Il faut retourner parler en personne au PNJ qui vous a confié la quête pour la rendre — exactement comme dans un vrai RPG. »

« Rien n'apparaît dans votre menu tant que vous n'avez pas fait le premier pas vers eux. »

Les récompenses vont dans le trésor de la faction, jamais dans un portefeuille personnel.

2. Osric — l'Éclaireur de Sylvange#

« Ah, un nouveau visage à Sylvange. Bienvenue, voyageur. »

Rôle : premier PNJ rencontré du jeu, guide du Chapitre 1 « L'Éveil ». Il est le narrateur de la progression sur les premières zones.

Personnalité — un vieil éclaireur sans mystère, à la patience de quelqu'un qui a tout vu :

« Personne ne sait vraiment depuis combien de temps Osric arpente ces bois. Certains disent qu'il était déjà là avant les premières cabanes. D'autres pensent qu'il a simplement l'air d'avoir toujours été là, comme les arbres eux-mêmes. Lui ne dit jamais son âge, seulement qu'il en a vu passer, des voyageurs. »

« Pas de mystère profond chez cet homme-là, pas de secret à percer. Juste un vieil éclaireur qui croit à une idée simple : "Ici, on n'apprend pas à accumuler. On apprend à mériter." »

Ce qu'il propose au joueur :

• Les 12 étapes du Chapitre 1 « L'Éveil », « une vraie histoire à chacune, à votre rythme »
• Les premiers repères de survie (hache, bois, charbon), sans brusquer
• Des indices sur Aubécie et les Anciens, glissés entre deux conseils, qui préparent la suite du parcours

« Le charbon que tu rapportes... les Anciens s'en servaient, autrefois, pour garder les feux d'Aubécie allumés. Tu en entendras reparler, de cette cité. »

Sa fonction narrative est de se rendre inutile :

« Osric ne vous accompagnera pas jusque-là. Ce n'est pas son rôle. Le sien, c'est de vous préparer, un pas après l'autre, jusqu'à ce que vous n'ayez plus besoin de lui. »

« Sylvange t'a appris ce qu'elle pouvait. Le reste, tu devras l'apprendre seul, ou auprès d'autres qui t'attendent plus loin. Bonne route, voyageur. »

Confort de jeu associé :

• Un badge rouge discret apparaît en haut à gauche de l'écran dès qu'Osric a quelque chose à dire — aucune interruption forcée, pas de popup
• Touche J : parler à Osric depuis n'importe où, sans retourner à Sylvange à chaque étape
• Le suivi de quête bascule automatiquement sur la nouvelle étape dès qu'elle est acceptée

📍 Osric attend le joueur à Sylvange, dès son arrivée.

3. Les gardiens d'Aubécie#

« Aubécie n'était jusqu'ici qu'un nom sur la carte, une plateforme d'arrivée, un décor. Aujourd'hui, elle respire enfin. Cinq personnages y prennent racine, chacun porteur d'un fragment de l'histoire de Terravel — et l'un d'entre eux préfère encore rester dans l'ombre. »

📍 Les quatre personnages disponibles se tiennent côte à côte sur la plateforme d'arrivée d'Aubécie (Zone Capitale). Chaque personnage propose sa propre quête, indépendante des autres.

🛡️ Aldric — Gardien d'Aubécie#

Rôle : premier visage rencontré à l'arrivée, et premier PNJ narratif jamais ajouté à FactionWar. Vêtu de la robe des Clercs, immobile et patient depuis des générations.

Personnalité : franc, sans secret apparent, mais attentif — il jauge.

« Aldric ne cache rien — il attend simplement de voir si vous méritez sa confiance. »

« Bienvenue, voyageur. Cette cité est la dernière avant la porte scellée de Terravel. »

Ce qu'il propose : la quête « Le Premier Service » — apporter 10 émeraudes pour prouver sa bonne foi envers la cité.

« Un début simple, mais Aldric n'oublie jamais un service rendu. » « Aldric garde peut-être plus de secrets qu'il n'y paraît. Reste à savoir ce qu'il attend vraiment de vous, une fois votre premier service rendu. »

Cadeau de réputation : 🍞 Pain.

💰 Séraphine — Marchande d'Aubécie#

Rôle : le commerce de la cité. Elle n'ouvre pas sa boutique au premier venu.

Personnalité : méfiante, observatrice, dotée d'une mémoire trop longue.

« Elle a vu passer des centaines de voyageurs, et se souvient de chacun. Séraphine ne fait confiance à personne d'emblée — elle teste, elle évalue, elle observe la façon dont vous manipulez la richesse avant de vous ouvrir son commerce. On raconte qu'elle garde un vieux registre de comptes, bien plus ancien qu'elle ne veut l'admettre. »

« Certains reviennent riches. D'autres ne reviennent jamais. »

Fil narratif ouvert : ce « vieux registre de comptes, bien plus ancien qu'elle ne veut l'admettre » — écho direct de l'Innommé, qui achetait des dettes que personne ne voulait recouvrer.

Cadeau de réputation : 💎 Émeraude.

⚒️ Bram — Forgeron d'Aubécie#

Rôle : la forge. Il ne laisse approcher son enclume qu'à ceux qui ont prouvé leur courage au combat.

Personnalité : dur, taiseux, troublé par sa propre mémoire des gestes.

« Les bras couverts de suie, le regard dur, Bram ne laisse approcher son enclume qu'à ceux qui ont prouvé leur courage au combat. Ce qui le trouble, sans qu'il sache vraiment pourquoi, ce sont ces gestes de forge qu'il maîtrise sans jamais les avoir appris de personne. »

« Mes mains connaissent des gestes que je n'ai jamais appris de personne. Un jour, peut-être, je comprendrai pourquoi. »

Fil narratif ouvert : une mémoire ancienne inscrite dans le corps, cohérente avec les villageois d'Aubécie « bien plus vieux qu'ils n'en ont l'air ». ⚠️ Aucun arc dédié à Bram n'est encore décrit dans les sources.

Cadeau de réputation : ⛏️ Lingot de fer.

📜 Mérielle — l'Ancienne d'Aubécie#

Rôle : gardienne de la mémoire de la cité, et la seule à parler ouvertement de Terravel et de la Rupture.

Personnalité : archiviste obstinée, qui écrit contre l'effacement.

« Chaque fragment d'histoire qu'elle confie a un prix : du papier, beaucoup de papier, pour continuer à écrire ce qu'elle refuse de laisser s'effacer. Certains de ses souvenirs, pourtant, semblent plus troublants que les autres. »

« L'Innommé n'avait pas de visage, disent les vieux récits. Mais moi, je me souviens d'un visage. Je ne sais juste plus s'il était vraiment le sien. »

Ce qu'elle propose : la quête d'entrée « Fragments de mémoire », puis l'arc narratif complet « La Mémoire Scellée » (voir § 5).

Cadeau de réputation : 📖 Livre.

🕯️ Le Cinquième#

Rôle : inconnu. Cinquième personnage annoncé d'Aubécie, jamais rencontré à ce jour.

« Il n'a ni nom, ni visage, ni portrait affiché. Personne, à ce jour, ne l'a rencontré. Certains prétendent l'avoir aperçu, à la lisière d'Aubécie, disparaissant dès qu'on s'approche. D'autres pensent qu'il n'existe pas encore — qu'il faudra gagner la confiance des quatre autres avant qu'il n'accepte de se montrer. »

« Une chose est certaine : quand il apparaîtra, il ne sera pas là par hasard. »

« Quatre histoires commencent aujourd'hui. Une cinquième attend son heure. »

⚠️ À confirmer : la condition d'apparition du Cinquième (« gagner la confiance des quatre autres ») est présentée dans les sources comme une rumeur in-game, pas comme une règle technique documentée. Rien n'indique si un palier de réputation précis le déclenche.

4. Le système de réputation par PNJ#

Un système de réputation individuelle est actif pour les quatre PNJ d'Aubécie : Aldric, Séraphine, Bram et Mérielle. Chaque réputation est suivie séparément.

Gagner de la réputation#

Objets-cadeaux requis#

Procédure : avoir l'objet en inventaire → parler au PNJ → cliquer sur « Faire un cadeau ». L'objet est consommé automatiquement, la réputation augmente aussitôt.

Paliers de réputation#

Le palier actuel s'affiche directement dans la fenêtre de dialogue du PNJ. Le détail complet (points, palier, statut de quête) se consulte dans menu Quêtes → onglet PNJ.

« Tissez des liens durables avec Aubécie. 🗡️ »

⚠️ À confirmer : les sources ne précisent pas ce que débloquent concrètement les paliers de réputation (dialogues, prix, quêtes supplémentaires, accès au Cinquième). Avec +20 points par quête et +5 par cadeau quotidien, le palier « Allié » (2000 pts) représente un investissement très long — l'équilibrage mériterait d'être vérifié.

5. Arc narratif « La Mémoire Scellée » (Mérielle)#

Une chaîne de quêtes entièrement narrative, en 10 étapes, qui s'ouvre après la première rencontre avec Mérielle.

Prérequis : avoir terminé « Fragments de mémoire » chez Mérielle. Elle accueille ensuite le joueur avec un nouveau dialogue dès qu'il revient lui parler.

De quoi ça parle :

« Mérielle commence à se souvenir de choses qu'elle avait oubliées, ou qu'on avait voulu lui faire oublier. Aidez-la à reconstituer des fragments de mémoire, quête après quête, jusqu'à découvrir un secret enfoui sous Aubécie depuis des générations. »

L'aboutissement — une voûte scellée (donjon) :

« L'arc culmine sur la découverte d'une voûte oubliée, gardée par des mécanismes anciens qui ne cèdent qu'à ceux qui prouvent leur valeur au combat. Ce qu'on y trouve pourrait bien être lié à l'un des plus grands mystères de Terravel. »

Récompenses :

• Chaque étape rapporte des pièces pour la faction
• La dernière quête offre en plus un objet unique : 💠 Fragment de la Voûte — « un éclat arraché aux ténèbres, qui semble contenir un fragment de mémoire qui ne vous appartient pas »

« Aubécie garde encore beaucoup de secrets. Certains ne demandent qu'à être déterrés. 🗝️ »

⚠️ À confirmer : le contenu exact des 10 étapes, le fonctionnement du donjon (mécanismes, mobs, mise en place) et l'usage du Fragment de la Voûte ne sont pas détaillés dans les sources. Le « plus grand mystère de Terravel » auquel il serait lié n'est jamais nommé — le rapprochement avec le visage dont Mérielle se souvient reste une lecture, pas une information confirmée.

🆕 Mise à jour du 31/08/2026. Un premier boss de donjon a été annoncé : Le Veilleur Muet, « ancien gardien de pierre posté aux frontières bien avant la Guerre du Silence ». C'est le premier personnage du lore à devenir un adversaire jouable plutôt qu'un interlocuteur — voir 15-donjons-et-boss.md. Rien n'établit toutefois qu'il garde la voûte de Mérielle : l'annonce le rattache à la fin du Chapitre 1. ⚠️ À confirmer.

6. Appo — le guide du lobby#

Un PNJ nommé Appo a été ajouté au spawn du lobby, présenté comme « votre guide sur le serveur ». Il porte le nom du porteur du projet.

⚠️ À confirmer : les sources n'indiquent pas s'il propose des quêtes, des dialogues narratifs, ou seulement de l'aide et de l'orientation.

7. Récapitulatif et zones d'ombre#

⚠️ Points à confirmer, transversaux :

1. Nombre de PNJ. La roadmap du 29/08/2026 annonce « 6 PNJ avec dialogues et réputation individuelle ». Les sources n'en nomment que six au total en comptant Osric et Appo (Aldric, Séraphine, Bram, Mérielle, Osric, Appo), mais la réputation individuelle n'est documentée que pour les quatre PNJ d'Aubécie. Le décompte exact reste à trancher.
2. Tableau des quêtes PNJ tronqué. Le récapitulatif du 25/08/2026 annonce « 👤 PNJ (4 quêtes) » avec un tableau PNJ / Objectif / Récompense, mais la capture Discord s'interrompt juste après l'en-tête. Seule la quête d'Aldric est documentée ; les objectifs et récompenses de Séraphine, Bram et Mérielle manquent.
3. Extension prévue. Le système technique derrière ces PNJ est explicitement conçu pour s'étendre : « pensé pour accueillir de nombreux autres PNJ à travers les Cinq Royaumes — chacun avec ses propres dialogues, ses propres quêtes, ses propres exigences. Certains PNJ pourraient un jour révéler des fragments de l'histoire de Terravel que même le grand livre de la légende ne raconte pas entièrement. » Aucun PNJ n'est pour l'instant documenté à Ferconte, Solarande ou Glacime.

Sources#

• #factionwar-histoire (Discord PingHeberg) — « 🌲 SYLVANGE — À la rencontre d'Osric », « 🏰 FACTIONWAR — CINQ VISAGES POUR AUBÉCIE », « 🕯️ NOUVEL ARC NARRATIF : "La Mémoire Scellée" chez Mérielle » (! Hynata) — origine de la quasi-totalité des citations de ce document
• #factionwar-dev (Discord PingHeberg) — arrivée d'Aldric à Aubécie (24/08/2026), fonctionnement complet du système de dialogue et des catégories de quêtes, récapitulatif des 46 quêtes (25/08/2026), PNJ Appo dans le lobby (28/08/2026), système de réputation des PNJ d'Aubécie, Chapitre 1 « L'Éveil » et touche J
• #factionwar-annonces (Discord PingHeberg) — roadmap mise à jour du 29/08/2026 (mention des 6 PNJ et de l'arc de 10 quêtes)
• sources/discord/factionwar-annonces-COMPLET.txt — annonce du 31/08/2026 01:52 : système de donjons instanciés et premier boss Le Veilleur Muet (voir 15-donjons-et-boss.md pour le détail et le sourçage complet).

04 — Zones et progression#

Résumé. FactionWar n'est plus un monde unique coupé en deux camps : c'est une progression linéaire à 5 paliers, chaque palier étant une carte (dimension) dédiée à une seule famille de ressources, correspondant à l'un des Cinq Royaumes de l'univers Terravel. On démarre en Zone Bois, on débloque la zone suivante en prouvant sa progression (niveau de métier + stock de ressources), et le déblocage est permanent. L'ensemble tourne sur une infrastructure multi-serveurs (Lobby + serveurs de progression + Terravel) avec synchronisation totale du joueur. Ce document décrit le système tel qu'il fonctionne aujourd'hui ; l'ancien modèle « Zone Riche / Zone Pauvre » est traité en fin de fichier, section Historique.

1. Le principe des zones à paliers#

Chaque type de ressource a sa propre carte dédiée. Il n'y a plus de minerai mélangé partout : un listener serveur (OreStripListener) retire physiquement les minerais non autorisés à la génération de chaque nouveau chunk, une seule fois, jamais aux rechargements.

Conséquence de design annoncée : même une faction déjà riche et installée doit un jour repasser par ces zones pour progresser.

2. Tableau récapitulatif des 5 paliers#

Chaque joueur avance à travers cinq mondes entièrement construits, chacun avec sa propre identité, ses propres ressources et son propre défi de déblocage :

🪵 Zone Bois → 🟠 Zone Cuivre/Fer → 🟡 Zone Or/Redstone → 💎 Zone Diamant/Lapis-Lazuli → 🏘️ Zone Capitale

Chaque transition demande d'avoir vraiment progressé : niveaux de métiers, stocks de ressources, parfois les deux combinés. Formule officielle de l'équipe : « Rien n'est offert, tout se mérite. »

⚠️ À ne pas confondre : la Zone Capitale (Aubécie) n'est pas le Lobby. Le Lobby est le hub de connexion ; Aubécie est le cinquième palier de progression.

3. Détail palier par palier#

Palier 1 — 🌲 Zone Bois (Sylvange)#

Ambiance / lore. Sylvange, « la forêt des premiers pas, où l'on apprend à survivre avec ce que la terre veut bien offrir ». On y rencontre Osric, l'Éclaireur de Sylvange, PNJ narratif du Chapitre 1 « L'Éveil » (12 étapes).

Guide de démarrage en Zone Bois#

Scénario de survie officiel publié par l'équipe (guide « 📘 Survivre en Zone Bois », 16/08/2026), pour un joueur qui arrive « les mains presque vides ».

Étape 1 — S'installer

Étape 2 — Le métier Bûcheron

Étape 3 — Organiser la faction (répartition conseillée pour un petit groupe)

Une fois un stock confortable accumulé : direction la boutique de faction (/f shop) — même depuis la Zone Bois, le trésor sert à renforcer le Core situé ailleurs.

Étape 4 — Préparer la suite

La Zone Bois est « un tremplin, pas une fin en soi ». Avant de passer au palier suivant :

• ✅ Avoir un stock de bois confortable en réserve
• ✅ Avoir crafté ses premiers outils (pioche en bois minimum)
• ✅ Avoir sécurisé sa base ici — on peut toujours y revenir chercher du bois plus tard

Sans outils adaptés, miner efficacement dans la zone suivante sera compliqué : la logique classique de Minecraft s'applique, chaque palier de ressource demande le bon outil pour en tirer parti.

Note de datation. Ce guide date du 16/08/2026 et présentait alors la Zone Cuivre/Fer comme « bientôt disponible » ; elle est ouverte depuis. Il mentionne aussi le Core « sur zone1/zone2 », vocabulaire d'infrastructure antérieur au découpage en 5 paliers. Les chiffres du guide sont cohérents avec le reste de la documentation (bois seule ressource, niveau max 30, borne de +30 %, XP convertie en pièces vers le trésor) — à une nuance près : le guide parle d'un « rendement » majoré, alors que le mécanisme réel est une probabilité de doubler le drop (voir le tableau de l'étape 2 ci-dessus et 07-metiers.md). La borne chiffrée est la même, la nature de l'effet ne l'est pas.

Palier 2 — ⛏️ Zone Cuivre/Fer (Ferconte)#

Ambiance / lore. Ferconte, « les collines de cuivre et de fer, où le vent porte encore l'écho des marteaux d'une civilisation disparue ».

Particularité. C'est sur la plateforme de la Zone Cuivre qu'est posé le bouton physique de déblocage vers la Zone Or. Un second portail décoratif y prépare la Zone Diamant.

Palier 3 — 🟡 Zone Or/Redstone (Solarande)#

Ambiance / lore. Solarande, « les sables dorés et désolés, où l'on dit que l'or qu'on y trouve fut autrefois arraché aux coffres de l'Innommé lui-même ».

Limitation documentée (pas un bug). Le biome étant forcé uniformément, les structures liées à un biome précis (Monument Océanique notamment) ne peuvent pas se placer, même manuellement via /place structure. Le Portail en Ruine, seule structure compatible avec tous les biomes, fonctionne sans restriction.

Palier 4 — 💎 Zone Diamant (Glacime)#

Ambiance / lore. Glacime, « les sommets de diamant et de lapis, si froids que seuls les plus déterminés osent encore y monter ».

Évolution. Les premières annonces décrivaient ce palier comme « Zone Diamant/Netherite » (ressources : diamant + ancien débris). La version livrée est Diamant + Lapis. C'est cette dernière qui fait foi.

Palier 5 — 🏘️ Zone Capitale, Aubécie#

Un changement complet de registre. La Zone Capitale rompt avec les quatre paliers précédents : fini le minage pur, place à un vrai hub vivant — villages généreusement répartis, villageois à qui parler et avec qui commercer, plaines à perte de vue parsemées de tournesols. L'équipe la décrit comme « le cœur battant de la fin de progression ».

Ambiance / lore. Aubécie, « la dernière cité, la garnison ultime des Anciens, bâtie au plus près de la porte scellée de Terravel ».

PNJ de la plateforme d'arrivée. Quatre PNJ narratifs côte à côte : Aldric (Gardien), Séraphine (Marchande), Bram (Forgeron), Mérielle (l'Ancienne). Un cinquième personnage est annoncé mais non encore rencontrable. Ces PNJ n'ouvrent jamais l'écran de troc vanilla mais une vraie fenêtre de dialogue. (Détail des quêtes et de la réputation : voir la documentation dédiée aux quêtes/PNJ.)

4. La mécanique de déblocage#

Le passage d'un palier au suivant fonctionne toujours de la même façon :

1. Un bouton physique est posé sur la plateforme de la zone précédente.
2. Clic droit → vérification en direct du niveau de métier requis et du stock de ressources porté.
3. Si les conditions sont remplies : consommation des ressources, marquage du déblocage en base de données (une table dédiée par palier, ex. passage_unlocked_or), puis téléportation.
4. Le déblocage est définitif : ensuite, le bouton — ou le bouton équivalent de l'onglet Zones du menu — téléporte directement, sans repasser à la caisse.

Dans l'onglet Zones du menu, une zone verrouillée affiche son statut de progression en direct (niveau actuel / requis, ressources actuelles / requises) et un bouton grisé ; une zone débloquée affiche un bouton « s'y rendre » cliquable.

Évolution. L'annonce d'ouverture du système (16/08/2026) décrivait une règle générique : « monter son métier au niveau 10 dans la ressource correspondante + avoir un stock suffisant de cette ressource ». Cette formulation a été remplacée par des conditions chiffrées propres à chaque palier (tableau §2), qui sont la référence actuelle.

5. Le passage entre zones (voyage et synchronisation)#

5.1 Depuis le menu#

L'onglet Zones du menu faction (/factionmenu, ou /f → Zones) permet de voyager d'un clic, peu importe le serveur sur lequel on se trouve (lobby, zone de guerre, zone de ressources) : le jeu transfère automatiquement le joueur et le téléporte au bon endroit.

Techniquement, le voyage passe par ZoneTravelChannel (plugin factionsystem), qui route vers le bon monde/coordonnées ; si le joueur est sur un autre serveur, un transfert réseau est déclenché puis la téléportation est différée (PendingTeleportListener) et finalisée à la connexion sur le serveur cible.

5.2 Synchronisation du joueur#

Note historique. Un système de sauvegarde plus ancien existait dans le plugin ZoneBridge (PlayerDataManager), utilisé uniquement pour les transferts par portail zone1 ↔ zone2 — ce qui provoquait des pertes de stuff (« rollback ») sur les autres chemins (lobby, menu). Il lisait de plus l'inventaire depuis un thread asynchrone (anti-pattern Bukkit). Il a été remplacé par le nouveau PlayerDataManager centralisé dans factionsystem, puis retiré pour éviter toute double écriture.

5.3 Portails et passages physiques#

Des portails décoratifs (panneaux en bois avec texte coloré) matérialisent les passages entre plateformes. À la date des sources : portail fonctionnel Bois → Cuivre, portail fonctionnel Cuivre → Or, et un portail préparatoire vers la Zone Diamant encore purement décoratif au moment de sa pose.

6. L'infrastructure multi-serveurs#

Plugins serveur associés aux zones :

Nether & End désactivés sur zone2 + lobby : impossible d'y créer ou d'utiliser un portail. L'expérience vanilla complète (Nether, End, Élytres) est réservée au serveur Terravel, présentée comme la récompense finale du parcours.

Lobby. Point d'entrée à la connexion. On y consulte les règles et les commandes sur des panneaux, et on clique sur « COMMENCER L'AVENTURE » pour rejoindre le monde de progression. Cycle météo désactivé, ciel forcé au clair. Un PNJ guide, Appo, est présent au spawn.

7. Le système de lits par zone (respawn)#

C'est un système maison, spécifique au multizone. Argument officiel : « Fini le point de respawn unique qui s'efface à chaque nouveau lit. Sur FactionWar, chaque zone se souvient de votre lit à vous — indépendamment des autres. »

Mourir dans une zone ramène donc toujours dans cette zone.

8. La carte /fmap et le brouillard de guerre#

Correctif majeur (15/08/2026). Chaque appel de /fmap créait auparavant une nouvelle carte en mémoire sans jamais la libérer : cette fuite mémoire a provoqué un crash serveur. Le correctif a introduit la carte unique par joueur, le cooldown de 60 s, le rendu natif, et l'augmentation de RAM 10 → 20 Go.

Un brouillard de guerre naturel s'applique par ailleurs à chaque zone à paliers : il faut explorer pour la découvrir.

9. Règles communes à toutes les zones#

• Claims de faction : disponibles partout, y compris dans les zones à paliers. Un territoire claim est protégé — seuls les membres de la faction propriétaire peuvent y construire ou casser des blocs. Les claims sont suivis par monde, aucune confusion entre zones.
• XP de métier réduite dans les zones à paliers, pour étaler la progression. ⚠️ À confirmer : cette règle date du wiki du 16/08/2026 et n'est pas reconfirmée dans les annonces plus récentes.
• Plateformes d'arrivée protégées contre le grief ; respawn sur place réglé par /setworldspawn.
• Airdrops : déclenchables depuis la boutique de faction, uniquement si l'on est physiquement dans la zone visée (Bois ou Cuivre/Fer à l'annonce). Contenu variable selon la zone.
• Loadouts de faction : achetés par zone (Loadout Zone Bois, Loadout Zone Cuivre/Fer). Voir 05-factions.md.
• Messages de connexion/déconnexion masqués dans le chat (avantage tactique PvP) ; les messages de mort restent visibles.

10. État d'avancement des paliers#

Statut global du projet (roadmap mise à jour du 29/08/2026) : Phase 1 (fondations & système maison) terminée ; Phase 2 (gameplay factions) bien avancée, en cours ; Phase 3 (alpha fermée), Phase 4 (bêta publique) et Phase 5 (lancement officiel) pas encore lancées. Restent à faire avant la suite : écriture des quêtes des zones et PNJ restants, poursuite du build zone par zone.

Évolution. Le wiki du 16/08/2026 affichait « Palier 2 en construction, paliers 3 et 4 à venir ». Ce tableau est obsolète : les paliers 2, 3, 4 et 5 ont été livrés entre le 22 et le 24/08/2026.

11. Historique : l'ancien modèle « Zone Riche / Zone Pauvre »#

⚠️ Ce modèle n'existe plus en tant que découpage du monde. Il est documenté ici uniquement pour éviter les confusions avec les anciennes annonces et captures.

Ce que c'était (annonce d'ouverture du 13/08/2026)#

Le monde était divisé en deux zones aux ambiances opposées :

Le joueur choisissait son camp, et surtout : à la création d'une faction, celle-ci était automatiquement rattachée au camp Riche ou Pauvre selon l'endroit où l'on se trouvait au moment de la création. Le menu /f affichait un « indicateur de camp » (lingot d'or si Riche, chair pourrie si Pauvre), les claims étaient suivis séparément sur « Zone Riche / Zone Pauvre », et un claim échouait « si un autre camp a déjà claim la zone ».

Ce qui l'a remplacé, et pourquoi#

Deux remplacements distincts, à ne pas confondre :

1. Le découpage géographique (2 mondes opposés) a été remplacé par les 5 zones à paliers (Sylvange → Ferconte → Solarande → Glacime → Aubécie), annoncées le 16/08/2026. Motif affiché : deux cartes qui se ressemblent n'offraient pas de vraie progression ; le système à paliers force une montée en puissance étape par étape, avec des ressources exclusives et un déblocage mérité — « rien de gratuit, tout de mérité ». L'équipe le formule ainsi dans sa roadmap : « le concept lui-même a évolué : ce n'est plus deux zones opposées, c'est devenu 5 royaumes progressifs avec une vraie mythologie derrière ».

1. Le statut Riche/Pauvre n'a pas disparu, mais a changé de nature : ce n'est plus une zone géographique ni un choix de camp fait à la création. C'est désormais un statut économique dynamique de faction, qui bascule automatiquement selon le trésor accumulé, et qui peut changer plusieurs fois (dépenser en boutique peut faire repasser une faction en Pauvre). Voir 05-factions.md.

Tableau de correspondance ancien → actuel#

Sources#

• sources/discord/factionwar-dev.txt — annonces d'ouverture Zone Bois, annonce « Les zones à paliers » (16/08/2026), ouverture Zone Or (22/08/2026), mise à jour lits + Zone Diamant + Zone Capitale (23-24/08/2026), patch /fmap (15/08/2026), infrastructure multi-serveurs (25/08/2026), FactionWar Client V0.9 et onglet Zones.
• sources/discord/factionwar-dev-rattrapage.txt — messages récupérés lors d'un audit : guide « 📘 Survivre en Zone Bois » (16/08/2026 08:56, version complète en 4 étapes) et annonce « 🏰 L'aventure prend une nouvelle dimension » (24/08/2026 11:26 — chaîne des 5 paliers, registre de la Zone Capitale, lits par zone, Nether/End réservés à Terravel).
• sources/discord/factionwar-dev-extra.txt — guerre économique, expansion territoriale.
• sources/discord/factionwar-annonces.txt — annonce d'origine du projet (13/08/2026, modèle Riche/Pauvre), roadmap mise à jour (29/08/2026), coulisses (30/08/2026).
• sources/discord/factionwar-histoire.txt — Chroniques de Terravel, les Cinq Royaumes, Osric, les PNJ d'Aubécie.
• sources/attachments/wiki-factionwar__message.txt — wiki technique : dimensions, biomes, world border, OreStripListener, ZoneTravelChannel, PlayerDataManager, WorldRespawnListener, plugins fondateurs.
• sources/attachments/wiki-factionwar__Wiki_FactionWar_3.md — wiki joueur du 16/08/2026 (état des paliers désormais obsolète, conservé pour l'historique).
• sources/discord/factionwar-modspack.txt — prérequis client (Fabric 1.21.11, Fabric API, vocal de proximité).

05 — Le système de factions#

Résumé. La faction est l'unité de base de FactionWar : on la crée en une commande, on y recrute, on revendique du territoire au chunk, on y pose un Core de 500 PV qui protège le trésor commun, et on tente de détruire celui des voisins pour leur piller 30 % de leur cagnotte. Tout se pilote depuis un menu graphique (/f, puis le mod client /factionmenu, touche G), qui regroupe aujourd'hui gestion des membres, boutique, classement et historique des raids, cagnotte, Core, zones, métiers et actions de terrain — les commandes en tchat ne sont plus le mode d'emploi principal depuis le 29/08/2026. Le plugin est 100 % maison (FactionSystem), avec persistance MariaDB.

1. Créer, rejoindre et quitter une faction#

Évolution (obsolète). À l'origine, une faction était « rattachée automatiquement au camp Riche ou Pauvre selon l'endroit où tu te trouves au moment de la création ». Ce n'est plus le cas : le statut Riche/Pauvre est désormais dynamique et calculé sur le trésor (voir §9).

2. Rôles et droits#

Trois grades hiérarchiques.

Gestion des membres — sous-menu GUI (ancien /f, réservé au Leader) :

Le Leader n'apparaît jamais dans cette liste (impossible de se gérer soi-même). Le sous-menu se rouvre automatiquement après chaque action, pour enchaîner plusieurs modifications.

Évolution / contradiction arbitrée. Trois états successifs des droits d'Officier : (1) menu /f d'origine — l'Officier peut seulement inviter, la gestion des grades est réservée au Leader ; (2) wiki du 16/08/2026 — l'Officier « peut inviter/exclure des membres » ; (3) mod client V0.9 (16-17/08/2026, le plus récent) — « si vous êtes leader ou officier, vous pouvez directement inviter, promouvoir, rétrograder ou exclure un membre depuis le menu ». La version 3 fait référence. ⚠️ à confirmer : les sources ne disent pas si un Officier peut exclure un autre Officier, ni si le Leader reste seul à pouvoir transférer le leadership via le menu client.

3. Le menu de faction#

3.1 Aujourd'hui — /factionmenu (mod client Fabric)#

Le mod client FactionWar Client (obligatoire pour rejoindre le serveur) fournit une interface complète. Ouverture par la commande /factionmenu, par l'icône F de la sidebar, ou par la touche G (en test, s'ajoute à /newinv sans le remplacer ; réassignable dans Options → Commandes → Divers).

Une sidebar unique relie les écrans principaux : Inv (inventaire custom /newinv), Rct (livre de recettes), F (menu Faction), Que (quêtes).

⚠️ Toutes les actions de l'onglet Gestion se basent sur votre position exacte au moment du clic — il faut être physiquement au bon endroit.

Toutes les données affichées sont connectées en direct au serveur (aucune information statique) et transitent par un canal réseau unique (MenuDataChannel).

⚠️ À confirmer : l'exacte valeur affichée sous « puissance » et « niveau de faction » (formule, barème, effet en jeu) n'est décrite nulle part dans les sources.

3.2 L'ancien menu /f (GUI d'inventaire serveur)#

Toujours documenté dans les sources, antérieur au mod client. Menu à bordure stylée, titre ⚔ FactionWar ⚔ puis [FactionWar] en orange. Interface adaptative selon que l'on a une faction ou non.

État 1 — joueur sans faction (3 boutons) :

État 2 — joueur avec faction :

Le reste des emplacements est occupé par des vitres grises unies (GRAY_STAINED_GLASS_PANE), purement décoratives et sans effet au clic.

3.3 L'onglet « Gestion » — les actions de terrain (29/08/2026)#

Poser le Core, claim ou libérer un chunk, définir la zone AFK : tout se fait désormais directement dans le menu, plus besoin de commandes en tchat.

Accès : ouvrir le menu par la touche G ou /factionmenu, puis onglet Gestion.

⚠️ À savoir : toutes ces actions se basent sur votre position exacte au moment du clic. Placez-vous au bon endroit avant d'appuyer sur le bouton.

Évolution. Ces quatre actions passaient auparavant par des commandes en tchat (/fcore set, /f afk set) ou par les icônes de l'ancien GUI /f (📜 papier pour claim, 🧨 TNT pour unclaim). Le menu est désormais le chemin de référence ; les commandes restent documentées au §14 mais ne sont plus le mode d'emploi principal.

4. Claims de territoire#

Le claim est un prérequis pour trois choses : poser le Core, poser la zone AFK, et protéger ses constructions.

5. Le Core de faction#

Le cœur défensif de la faction : un bloc spécial (Beacon) qui protège le trésor.

5.1 Pose#

5.2 Points de vie et régénération#

5.3 Vulnérabilité — comment on l'attaque#

5.4 Destruction et pillage#

Si le Core tombe à 0 PV :

Règle d'or affichée par l'équipe : « Plus vous êtes riches, plus vous êtes une cible. Plus vous êtes pauvres, plus vous régénérez vite. »

6. Les raids et l'historique#

Un raid réussi n'est pas symbolique : il est capable de faire basculer une faction entière de statut (Riche → Pauvre) en un seul assaut.

7. La zone AFK de faction#

Usage recommandé par l'équipe : en faire un vrai lieu de rassemblement (salon, place, feu de camp) et organiser des sessions AFK collectives.

8. Le chat de faction#

Évolution. Le basculement du chat de faction se faisait auparavant par la commande /fchat, ou par l'icône 🔔 Cloche de l'ancien GUI /f. Depuis le 29/08/2026, le bouton « Chat Faction : ON/OFF » de l'onglet Faction est le chemin de référence ; la commande continue de fonctionner.

Liste des membres. Toujours dans l'onglet Faction, la liste des membres est désormais encadrée et scrollable à la molette : que la faction compte 3 ou 50 membres, tout reste accessible et lisible sans que la liste ne déborde du menu.

9. Trésor, statut Riche/Pauvre, impôt et cagnotte#

9.1 Le trésor de faction#

Chaque faction possède un trésor commun, alimenté automatiquement par l'activité de ses membres.

9.2 Le statut Riche / Pauvre#

Statut dynamique, qui bascule automatiquement selon le trésor accumulé — aucune commande à taper.

⚠️ La valeur chiffrée du seuil de bascule Riche/Pauvre n'est précisée nulle part dans les sources. Ce qui est documenté : une faction devient Riche « passé un certain seuil de richesse ».

Zone tampon (anti-yo-yo). Pour éviter les allers-retours artificiels entre les deux camps à chaque pièce gagnée ou perdue, une zone tampon protège la stabilité du statut : une faction ne repasse Pauvre qu'en tombant nettement sous le seuil, jamais sur un simple coup de moins bien. ⚠️ L'amplitude exacte de cette zone tampon n'est pas chiffrée dans les sources.

Point stratégique important : dépenser en boutique peut faire repasser une faction en Pauvre si le solde tombe sous le seuil. Investir ou conserver son statut Riche est un vrai arbitrage.

9.3 L'impôt progressif et la cagnotte serveur#

Logique de design assumée : thésauriser sans s'exposer est une stratégie perdante. Une faction Riche passive voit 10 % de chaque gain filer vers les Pauvres sans rien récupérer. La seule façon de rentabiliser sa richesse est de l'investir (upgrades Core, boosts XP, loadouts) et de s'étendre par le claim.

10. La boutique de faction#

10.1 Articles et prix#

Évolution. La boutique est passée de 4 articles (annonce d'ouverture) à 6 améliorations (mod client V0.9, ajout des airdrops), puis a reçu les 2 loadouts. L'état le plus récent regroupe : upgrades Core, airdrops, loadouts.

10.2 Les airdrops#

11. Les loadouts de faction#

Évolution. À l'origine, la poubelle bloquait la suppression des objets de loadout, sans autre moyen de s'en débarrasser. Le blocage a été retiré (TrashItemChannel) et déplacé côté dépôt : la poubelle accepte désormais tout, mais on ne peut plus stocker un objet de loadout ailleurs.

12. Liste et classement des factions#

Depuis le 29/08/2026, le classement des factions vit en haut de l'onglet Raids du menu.

Objectif annoncé : repérer ses rivaux, jauger la concurrence et préparer ses prochains raids depuis un seul écran.

⚠️ Aucun classement par puissance, trésor ou nombre de raids n'est décrit dans les sources : le seul critère de tri documenté est le nombre de membres.

Évolution. La liste des factions était auparavant accessible via l'icône 📕 Livre à écrire de l'ancien GUI /f (nom + camp + nombre de membres, sans tri documenté). Elle est désormais intégrée à l'onglet Raids du menu client, triée et scrollable. ⚠️ à confirmer : les sources ne disent pas si l'entrée de l'ancien GUI subsiste en parallèle.

13. PvP, anti-friendly-fire et protections#

14. Récapitulatif des commandes de faction#

Évolution. Depuis le 29/08/2026, la plupart de ces commandes ont un équivalent dans le menu (onglet Gestion pour le Core, les claims et la zone AFK ; bouton « Chat Faction : ON/OFF » pour le chat). Le menu est le chemin de référence ; les commandes ci-dessous restent fonctionnelles.

15. Sous le capot (référence technique)#

Le plugin principal FactionSystem instancie tous les managers au démarrage :

Le mod client n'invente aucune donnée : il affiche et pilote ce que ces managers gèrent déjà côté serveur.

Sources#

• sources/discord/factionwar-dev.txt — documentation complète du menu /f (13/08/2026), anti-friendly-fire, annonce Core + trésor (14/08/2026), protocole de test économie/Core, impôt progressif, /f history, boutique de faction, zone AFK (15/08/2026), FactionWar Client et V0.9 (16-17/08/2026), loadouts, refonte des menus (7 onglets), onglet Gestion et liste des factions (fin août 2026).
• sources/discord/factionwar-dev-rattrapage.txt — 5 messages des 28-29/08/2026 récupérés lors d'un audit : onglet Gestion (29/08 00:54), chat de faction ON/OFF + liste de membres scrollable (29/08 01:24), classement des factions dans l'onglet Raids (29/08 01:43), suivi de quête permanent, Guide d'Osric. Également l'annonce « 🏰 L'aventure prend une nouvelle dimension » (24/08/2026 11:26) : zone tampon protégeant la stabilité du statut Riche/Pauvre.
• sources/discord/factionwar-dev-extra.txt — guerre économique, pillage 30 %, impôt 10 %, mémoire de guerre.
• sources/discord/factionwar-annonces.txt — annonce d'origine (13/08/2026), roadmap mise à jour (29/08/2026), coulisses (30/08/2026).
• sources/attachments/wiki-factionwar__Wiki_FactionWar_3.md — wiki joueur du 16/08/2026 : rôles, Core (Beacon, dégâts à l'arme), boutique, zone AFK, économie.
• sources/attachments/wiki-factionwar__message.txt — wiki technique : sidebar, 7 sections du menu Faction, plugins fondateurs et managers, protection des objets de loadout.
• sources/discord/factionwar-histoire.txt — contexte narratif (récompenses de quêtes versées au trésor de faction).

06 — Économie#

L'économie de FactionWar est entièrement collective : il n'existe pas de portefeuille personnel. Tout ce qu'un joueur produit (métiers, quêtes, temps AFK) alimente le trésor de sa faction. Ce trésor détermine le statut économique de la faction (Riche ou Pauvre), qui conditionne à son tour l'impôt progressif, la régénération du Core et la place de la faction dans la redistribution quotidienne de la cagnotte serveur (/fpot). Le trésor se dépense dans la boutique de faction (/f shop) — upgrades de Core, boosts, airdrops, loadouts — et se perd lors d'un raid réussi sur le Core.

Le principe directeur affiché par l'équipe : « La richesse ne se garde pas sur FactionWar. Elle se défend, elle s'investit. » Thésauriser sans s'exposer est volontairement une stratégie perdante.

1. La monnaie : les pièces#

• Unité unique : la pièce.
• Elle n'est jamais versée à un joueur individuellement : toutes les récompenses (métiers, quêtes de toutes catégories, quêtes PNJ, zone AFK) sont créditées directement au trésor de la faction.
• Le solde est consultable en jeu via l'onglet Cagnotte du menu client (/factionmenu) et via /fcore info.

1.1 Sources de revenus#

Le taux de conversion XP → pièces est le même quel que soit le métier : « une partie de cette XP est automatiquement convertie en pièces pour le trésor de votre faction ». Aucune source ne donne de taux différencié par métier.

2. Le trésor de faction#

• Chaque faction dispose d'un trésor commun, alimenté automatiquement par l'activité de ses membres.
• Il est persistant : stocké en base MariaDB centralisée, synchronisé entre tous les serveurs du réseau (lobby, zones, Terravel).
• Il est géré côté serveur par economy/TreasuryManager (plugin maison FactionSystem), qui gère aussi la cagnotte serveur, la redistribution quotidienne et les multiplicateurs d'XP.
• Seuls le Leader et les Officiers peuvent dépenser le trésor (boutique).

3. Statuts de faction : Riche et Pauvre#

Chaque faction appartient en permanence à l'un des deux camps. La bascule est automatique et dynamique, en fonction du trésor accumulé — aucune commande à taper.

• Valeur exacte du seuil Riche/Pauvre : non précisée dans les sources.
• Valeurs chiffrées de régénération de base (PV/min pour Riche et pour Pauvre) : non précisées dans les sources. Seul l'upgrade de boutique donne un chiffre (+2 PV/min).
• Dépenser en boutique peut faire repasser une faction en Pauvre si le solde retombe sous le seuil — c'est un arbitrage stratégique assumé entre investir et conserver le statut Riche.
• Un raid réussi peut faire basculer une faction entière de statut en un seul assaut (perte de 30 % du trésor).

Affichage du statut#

4. L'impôt progressif et la cagnotte serveur (/fpot)#

Système annoncé le 14/08/2026, présenté comme le cœur de l'« économie de guerre ».

4.1 La règle exacte#

4.2 Conséquence stratégique voulue#

Une faction Riche qui reste passive « voit 10 % de chaque gain filer dans la cagnotte serveur, redistribuée aux Pauvres sans jamais rien récupérer en retour ». La seule façon de rentabiliser sa richesse est de l'investir : upgrades de Core, boosts XP, loadouts, et expansion territoriale par le claim.

⚠️ Les sources ne précisent pas l'heure exacte de la redistribution quotidienne, ni ce qui définit précisément « l'activité » servant de clé de prorata (XP générée ? pièces générées ?). Non précisé dans les sources.

5. Le Core de faction#

Le Core est le coffre-fort de la faction : tant qu'il tient, le trésor est protégé.

6. Le pillage du trésor lors d'un raid#

Historique des raids#

• /f history — les 10 derniers raids impliquant la faction (en tant qu'attaquant ou victime) : qui a attaqué qui, combien de pièces ont été pillées, il y a combien de temps.
• Également disponible dans l'onglet Raids du menu client, dans un cadre scrollable indépendant, avec le montant volé affiché directement.

7. La Boutique de faction (/f shop)#

Accès : /f shop en jeu (menu inventaire cliquable, prix affichés et solde de trésor visible en temps réel), ou onglet Shop du menu client /factionmenu. Réservée au Leader et aux Officiers. Le menu se rafraîchit automatiquement après chaque achat.

7.1 Tableau complet des articles#

⚠️ À confirmer : l'annonce V.0.9 du mod client parle de « 6 améliorations achetables en un clic : PV Core, régénération, soin instantané, boost XP, et les deux petits nouveaux » — les deux nouveautés décrites juste après étant les Airdrops. Le libellé exact des deux entrées Airdrop (une par zone ?) et leur prix ne sont pas précisés dans les sources. Avec les deux loadouts ajoutés ensuite, la boutique compte donc 8 entrées au dernier état documenté.

7.2 Points clés#

• Les upgrades PV max et régénération sont permanents : ils persistent même si le Core est détruit et reposé.
• Le Soin Instantané exige un Core actif au moment de l'achat.
• Dépenser peut faire repasser la faction en camp Pauvre si le solde tombe sous le seuil.
• Le menu affiche le solde en direct et se rafraîchit à chaque achat.

8. Les Loadouts de faction#

Deux articles de boutique introduits le 17/08/2026.

Côté technique : géré par LoadoutManager (plugin FactionSystem), qui gère l'équipement au respawn et la protection anti-grief.

9. La Zone AFK de faction#

Un revenu passif, pensé aussi comme lieu de rassemblement.

Côté technique : economy/AfkZoneManager (plugin FactionSystem).

10. Récapitulatif des commandes économiques#

11. Évolution du système#

Note « Évolution » — l'état actuel est décrit ci-dessus ; ce paragraphe conserve l'historique.

• 13/08/2026 — Camp figé à la création. À l'origine, le camp Riche/Pauvre d'une faction était déterminé par la position géographique du fondateur au moment de la création (monde « Zone Riche » ou « Zone Pauvre »), et le monde lui-même était découpé en deux zones opposées (terres fertiles vs désert hostile). Ce fonctionnement est obsolète : le camp est désormais dynamique, calculé sur le trésor accumulé, et le découpage du monde est passé à un système de 5 royaumes progressifs (zones à paliers).
• 14/08/2026 — Déploiement du trésor et du Core (phase de test actif : trésor alimenté par les métiers, bascule Riche/Pauvre, Core avec PV / régénération / invulnérabilité 24 h).
• 14/08/2026 — Ajout de l'impôt progressif (10 % sur les Riches) et de la cagnotte serveur redistribuée quotidiennement aux Pauvres.
• 15/08/2026 — Ouverture de la boutique de faction avec 4 articles (PV, régénération, soin, boost XP).
• 15/08/2026 — Ajout de la Zone AFK.
• 16-17/08/2026 — Mod client FactionWar Client : boutique, cagnotte, Core, raids et zones accessibles en un clic depuis /factionmenu ; ajout des Airdrops puis des Loadouts (15 000 pièces, 3 jours).
• 20/08/2026 et après — Refonte des menus : navigation unifiée (Inv / Rct / F), inventaire custom /newinv avec panneau Loadout et poubelle (qui accepte désormais aussi les objets de loadout), onglet Gestion regroupant pose du Core, claim, unclaim et zone AFK.
• 29/08/2026 — Roadmap : l'économie complète (statut Riche/Pauvre dynamique + impôt automatique redistribué chaque jour) est déclarée construite, la Phase 2 « Gameplay Factions » restant globalement en cours.

Sources#

• sources/discord/factionwar-dev.txt — annonces et notes de dev du 13/08/2026 au 30/08/2026 : trésor & Core (14/08), impôt progressif & /fpot (14/08), liste des commandes joueurs, /f history, boutique de faction (15/08), zone AFK (15/08), mod client V.0.9 & airdrops, loadouts (17/08), refonte des menus, onglet Gestion.
• sources/discord/factionwar-dev-extra.txt — synthèse « La guerre économique » : pillage 30 %, impôt 10 %, logique d'investissement des factions riches.
• sources/discord/factionwar-annonces.txt — annonce initiale du projet (13/08/2026, zones Riche/Pauvre d'origine) et roadmap mise à jour (29/08/2026).
• sources/attachments/wiki-factionwar__Wiki_FactionWar_3.md — wiki officiel (16/08/2026) : tableau de la boutique, Core, camps, zone AFK, récapitulatif des commandes.
• sources/attachments/wiki-factionwar__message.txt — wiki technique : TreasuryManager, ShopGUI, AfkZoneManager, LoadoutManager, AirdropManager, onglets du menu client.

07 — Les Métiers#

FactionWar propose 5 métiers (Mineur, Bûcheron, Forgeron, Fermier, Chasseur), entièrement codés maison. Depuis la refonte du 17-18/08/2026, les 5 métiers sont débloqués en même temps pour tout le monde : plus de choix exclusif, plus de cooldown de changement. Chaque métier possède sa propre XP et son propre niveau, indépendants les uns des autres, jusqu'au niveau 30. Le bonus n'est pas un rendement moyen mais une probabilité de doubler le drop : +1 point de pourcentage de chance par niveau, cumulatif jusqu'à 30 % de chance au niveau 30.

Les métiers sont le moteur de deux systèmes : l'économie (une part de l'XP gagnée est convertie en pièces pour le trésor de faction) et la progression par zones à paliers (chaque passage de zone exige un niveau de métier minimum).

1. Les 5 métiers et leurs actions#

Mécanisme exact (14/08/2026) : « Chaque niveau de métier te donne +1 % de chance de doubler tes drops (minerai, bois, récoltes, kills, ou craft bonus selon ton métier), jusqu'à +30 % au niveau max (30) ». Ce n'est donc pas un bonus de rendement appliqué à chaque action, mais une probabilité de déclencher un doublement, tirée à chaque action.

Aucune source ne mentionne de bonus de cooldown, de vitesse d'action ou d'effet de potion lié aux métiers : non précisé dans les sources.

2. Progression : niveaux, XP et bonus#

2.1 La règle#

2.2 Chance de doubler le drop, par palier (application de la règle « +1 point par niveau »)#

Les sources donnent explicitement la règle (+1 % de chance de doubler par niveau) et sa borne haute (+30 % au niveau 30). Le tableau ci-dessus applique cette règle linéaire palier par palier ; il n'existe aucune table de paliers officielle listant chaque niveau dans les sources.

2.3 Modificateurs d'XP#

3. Conversion XP → économie de faction#

Une partie de l'XP de métier gagnée est automatiquement convertie en pièces versées au trésor de la faction — pas au joueur.

Voir 06-economie.md pour le détail de l'impôt progressif et de la redistribution.

4. Les métiers comme clé de progression (zones à paliers)#

Le niveau de métier est la condition d'accès aux zones. Le déblocage est permanent : une fois validé, plus jamais besoin de repayer le test.

• La progression vers la zone suivante est affichée en direct dans l'onglet Zones du menu client (niveau actuel / requis, ressources actuelles / requises), le bouton restant grisé tant que les conditions ne sont pas remplies.
• Des mentions de déblocage Zone/Métier ont été ajoutées dans le menu FactionWar (23/08/2026).

Note « Évolution » : l'annonce initiale des zones à paliers (16/08/2026) énonçait une règle générique — « monter son métier au niveau 10 dans la ressource correspondante + avoir un stock suffisant de cette ressource ». Cette règle a été remplacée par les conditions spécifiques par zone listées ci-dessus, plus élevées à mesure qu'on avance.

5. Commandes#

⚠️ À confirmer : /job et /job choose <métier> datent du système à métier unique. Depuis que tous les métiers sont débloqués simultanément, il n'y a plus de choix à faire — les sources ne disent pas si ces deux commandes ont été retirées, conservées telles quelles ou reconverties. Seule /job info est explicitement citée après la refonte (« Tapez /job info pour voir le détail de votre progression sur chaque métier »).

6. L'onglet Métiers du menu client#

Après la refonte, une section Métiers a été ajoutée au menu client /factionmenu (touche F, ou touche G pour le menu général — en test), à côté des onglets Faction, Shop, Raids, Cagnotte, Core et Zones. Elle rend /job info largement superflu.

6.1 Contenu de chaque carte métier#

6.2 Code couleur de la barre de progression#

6.3 Navigation#

• La liste des métiers scrolle à la molette.
• Les données transitent par le canal réseau unique MenuDataChannel : tout est connecté en direct au serveur, rien n'est statique.

7. Historique de la refonte du système de métiers#

Règle actuelle (la plus récente, à retenir) : les 5 métiers sont tous débloqués en même temps, pour tout le monde. Plus de choix à faire, plus de cooldown, plus de blocage. Chaque métier progresse indépendamment avec sa propre XP et son propre niveau (jusqu'au niveau 30, avec bonus associé).

Chronologie#

Ce qui a disparu avec la refonte#

⚠️ Le wiki officiel (Wiki_FactionWar_3.md, daté du 16/08/2026) décrit encore l'ancien système (métier unique + cooldown de 7 jours). Il est antérieur à la refonte et ne fait donc plus foi sur ce point.

8. Métiers et quêtes#

• Les quêtes de Faction (28 quêtes de la première vague) incluent des objectifs de niveau de métier pour les cinq métiers, de « Premiers pas de Forgeron » à « Maître chasseur », aux côtés de livraisons de ressources et de paliers de kills.
• Les récompenses de quête sont versées au trésor de faction.

Voir 08-quetes-et-pnj.md.

Sources#

• sources/discord/EXPORT-REFERENCE-tous-canaux.txt — export exhaustif de référence (message par message, horodaté, tous canaux confondus) : source faisant foi pour la chronologie et les valeurs chiffrées.
• sources/discord/messages-recuperes-audit-passe2.txt — message du 14/08/2026 12:26 (repost à 12:31), absent des captures précédentes : « Chaque niveau de métier te donne +1 % de chance de doubler tes drops (minerai, bois, récoltes, kills, ou craft bonus selon ton métier), jusqu'à +30 % au niveau max (30) » — mécanisme exact du bonus de métier.
• sources/discord/factionwar-dev.txt — annonce de sortie des métiers (5 métiers, niveau 30, +30 %, cooldown 7 jours), notes de test économie (14/08), liste des commandes joueurs, guide Zone Bois (/job choose bucheron), zones à paliers (16/08), annonce de refonte (tous les métiers débloqués, progression conservée), ajout de l'onglet Métiers au menu, mise à jour du menu Métiers (icônes, XP réel, couleurs, molette), déblocages Zone 3 / Zone 4 / Capitale.
• sources/discord/factionwar-annonces.txt — roadmap mise à jour du 29/08/2026 (« 5 métiers actifs simultanément ») et coulisses du 30/08/2026 (« 5 métiers actifs, chacun avec sa propre progression et son économie »).
• sources/attachments/wiki-factionwar__Wiki_FactionWar_3.md — wiki officiel du 16/08/2026 : tableau des 5 métiers, règle +1 %/niveau jusqu'à +30 %, XP réduite en zones à paliers, boost XP +20 %. Décrit l'ancien système de métier unique (antérieur à la refonte).
• sources/attachments/wiki-factionwar__message.txt — wiki technique : jobs/JobManager (cache mémoire + persistance MariaDB), onglet Métiers du FactionMenuScreen, conditions de déblocage par zone.

08 — Quêtes et PNJ#

Le système de quêtes de FactionWar repose sur 4 catégories (Faction, Principale, Secondaire, PNJ) réunies dans un onglet dédié du menu client, un suivi de quête intelligent affiché en jeu, de vrais dialogues avec des PNJ narratifs (fenêtre de conversation dédiée, jamais l'écran de troc vanilla), et un système de réputation individuelle pour les quatre PNJ d'Aubécie.

Règle constante : toutes les récompenses de quête sont versées au trésor de la faction, jamais à un portefeuille personnel. « Progresser seul, c'est bien. Progresser pour son équipe, c'est mieux. »

1. Accéder au menu Quêtes#

2. Les 4 catégories de quêtes#

2.1 Le cas particulier des quêtes PNJ#

L'onglet PNJ ne sert qu'à suivre la progression : aucun bouton « Réclamer » n'y apparaît. Trois états possibles :

« La récompense ne se réclame jamais dans le menu. Il faut retourner parler en personne au PNJ qui vous a confié la quête pour la rendre — exactement comme dans un vrai RPG. »

3. Types d'objectifs et récompenses#

4. Le suivi de quête intelligent#

Système de tracking affiché en jeu, sans jamais interrompre l'action.

4.1 Notification discrète (badge)#

4.2 Touche dédiée : J#

Appuyer sur J, où que vous soyez sur le réseau, ouvre directement le dialogue avec Osric pour avancer dans le Chapitre 1 — plus besoin de retourner physiquement à Sylvange à chaque étape.

⚠️ Les sources ne précisent pas si la touche J est réassignable, ni si elle donne accès à d'autres PNJ qu'Osric. Non précisé dans les sources.

5. Le dialogue avec les PNJ#

5.1 Fonctionnement général#

• Clic droit sur le PNJ → ouverture d'une véritable fenêtre de dialogue, propre à chaque personnage.
• Ces PNJ n'ouvrent jamais l'écran de troc vanilla : pas de menu générique, pas d'interface marchande — une vraie conversation.
• Le texte affiché change selon votre progression avec ce personnage.
• Le palier de réputation actuel s'affiche directement dans la fenêtre de dialogue.

5.2 Options de réponse#

5.3 Quête refusée vs. quête acceptée#

⚠️ Les sources ne mentionnent aucune pénalité (ni perte de réputation, ni verrouillage) en cas de refus d'une quête. Non précisé dans les sources.

5.4 Le cycle complet d'une quête PNJ, étape par étape#

« Comme toujours, les récompenses vont directement dans le trésor de votre faction, pas dans un portefeuille personnel. »

6. Le système de réputation PNJ#

Système actif pour les quatre PNJ d'Aubécie : Aldric, Séraphine, Bram et Mérielle. La réputation est suivie séparément pour chacun et reflète l'historique de vos interactions.

6.1 Gagner de la réputation#

6.2 Objets-cadeaux requis#

Procédure : avoir l'objet requis dans l'inventaire → parler au PNJ → cliquer sur « Faire un cadeau ». L'objet est consommé automatiquement et la réputation augmente aussitôt.

6.3 Paliers de réputation#

6.4 Suivre et perdre de la réputation#

⚠️ À confirmer : la seule piste d'effet est narrative — « il faudra gagner la confiance des quatre autres avant qu'il [Le Cinquième PNJ] n'accepte de se montrer », formulé comme une rumeur de lore et non comme une règle de jeu.

⚠️ À confirmer : la roadmap du 29/08/2026 annonce « 6 PNJ avec dialogues et réputation individuelle », alors que l'annonce du système de réputation ne cite explicitement que les 4 PNJ d'Aubécie. Le statut d'Osric et d'Appo vis-à-vis de la réputation n'est pas précisé dans les sources.

7. Chaînes de quêtes et chapitres#

7.1 Chapitre 1 — « L'Éveil » (quête Principale, chez Osric)#

Découpage en sous-arcs (12 quêtes au total) :

Un système entièrement fait main#

Le Guide d'Osric n'utilise aucun plugin de quête ou de dialogue tout fait. Il a été codé entièrement à la main, du serveur jusqu'au mod client Fabric, spécifiquement pour s'intégrer au reste de FactionWar (factions, réputation, menu maison).

Les solutions du marché (Citizens, BetonQuest, et autres) ont été écartées : pensées pour des architectures génériques, elles ne pouvaient pas s'intégrer proprement à un mod client custom — d'où le choix du développement sur mesure.

7.2 Les arcs d'Aubécie (Zone Capitale)#

Les 4 premiers PNJ se trouvent côte à côte sur la plateforme d'arrivée d'Aubécie (Zone Capitale). Chacun propose sa propre quête, indépendante des autres.

⚠️ La source précise explicitement à propos de ce tableau : « ceci et le 1ere test du System » — ce sont donc des valeurs de première version de test, susceptibles d'être rééquilibrées.

Les récompenses vont directement dans le trésor de la faction, jamais dans un portefeuille personnel.

7.3 « La Mémoire Scellée » — l'arc de Mérielle (10 étapes)#

⚠️ Les mécaniques concrètes de cette voûte-ci (mobs, paliers de combat, nombre de joueurs, temps de reset) ne sont pas précisées dans les sources. Effet mécanique du Fragment de la Voûte : non précisé dans les sources.

🆕 Mise à jour du 31/08/2026. Un système de donjons instanciés et un premier boss (Le Veilleur Muet) ont depuis été annoncés, avec un système d'instanciation décrit comme fonctionnel et testé — voir 15-donjons-et-boss.md. Attention : rien dans les sources ne dit que ce boss est le gardien de la voûte de Mérielle. L'annonce du 31/08 rattache explicitement le donjon à la fin du Chapitre 1, pas à cet arc. Il peut s'agir de deux contenus distincts.

7.4 Quêtes Secondaires#

Ces deux quêtes correspondent à la « vie sociale de la Capitale » : la Zone Capitale (Aubécie) génère de vrais villages naturels, plus rapprochés que la normale, avec villageois et échanges.

7.5 Autre PNJ#

8. Récapitulatif chiffré#

8.1 État au récapitulatif officiel (fin août 2026)#

8.2 Ajout postérieur#

L'arc « La Mémoire Scellée » (10 étapes chez Mérielle) a été annoncé après ce récapitulatif de 46 quêtes. Le total consolidé n'est pas restitué dans les sources — ⚠️ à confirmer.

9. Évolution du système#

Note « Évolution » — l'état actuel est décrit ci-dessus ; ce paragraphe conserve l'historique.

Point d'évolution à retenir : lors de l'annonce d'Aldric (24/08), le flux décrit passait encore par le menu et un bouton « Réclamer ». La règle actuelle, posée dès la mise en place de la catégorie PNJ, est que les quêtes PNJ se rendent exclusivement en personne, l'onglet PNJ ne servant qu'au suivi.

10. Contexte narratif rattaché#

Les quêtes s'inscrivent dans la mythologie de Terravel, du personnage de l'Innommé et des Cinq Royaumes (Sylvange, Ferconte, Solarande, Glacime, Aubécie), chaque royaume correspondant à une zone à paliers. Aubécie est la dernière cité, bâtie au plus près de la porte scellée de Terravel. Le détail du lore est traité dans le document dédié à l'univers ; l'histoire complète est également lisible en jeu via Quêtes → Principale → Histoire.

Sources#

• sources/discord/factionwar-dev.txt — apparition de l'onglet Quêtes avec la Zone Capitale (23/08/2026), première version du système de quêtes et 28 quêtes (24/08), les 3 puis 4 catégories, arrivée d'Aldric et écran de dialogue dédié, documentation complète des PNJ (emplacement, 3 boutons de dialogue, tableau des catégories, statuts de l'onglet PNJ), récapitulatif des 46 quêtes et découpage du Chapitre 1, système de réputation PNJ (28/08 : gains, objets-cadeaux, paliers), arc « La Mémoire Scellée », suivi de quête (« Suivre », encadré haut-droite, persistance), Chapitre 1 narré par Osric (badge rouge, touche J, bascule automatique du suivi), PNJ Appo dans le lobby.
• sources/discord/factionwar-histoire.txt — Chroniques de Terravel, portrait d'Osric et des Cinq Royaumes, présentation des cinq visages d'Aubécie (Aldric, Séraphine, Bram, Mérielle, Le Cinquième), annonce de l'arc « La Mémoire Scellée » (10 étapes, voûte scellée, Fragment de la Voûte), rappel du principe « accepter, accomplir, revenir parler en personne ».
• sources/discord/factionwar-dev-rattrapage.txt — messages du 28-29/08/2026 absents de la capture initiale : « Suivi de quête permanent » (29/08 10:50 : bouton « Suivre », encadré en haut à droite visible hors des menus, une seule quête suivie, persistance à la reconnexion) et « Le Guide d'Osric — Chapitre 1 réinventé » (29/08 14:29 : 12 étapes narrées, badge rouge discret, touche J, suivi intelligent, progression verrouillée, système fait main — Citizens/BetonQuest écartés).
• sources/discord/factionwar-dev-complements.txt — récapitulatif complet des 46 quêtes (Faction 28 / Principale 12 / Secondaire 2 / PNJ 4, avec le découpage des sous-arcs du Chapitre 1), guide complet du système de quêtes PNJ (emplacement des 4 PNJ, 3 boutons de dialogue, tableau des catégories, 3 statuts de l'onglet PNJ, cycle complet en 5 étapes) et tableau des 4 quêtes PNJ avec objectifs et récompenses (150 à 250 pièces, valeurs de premier test).
• sources/discord/factionwar-dev-extra.txt — « Le système de quêtes n'est qu'un début… faire de la Capitale la porte d'entrée vers la suite de l'aventure. »
• sources/discord/factionwar-annonces.txt — roadmap du 29/08/2026 (6 PNJ avec dialogues et réputation, arc narratif de 10 quêtes menant à une voûte cachée, quêtes restantes à écrire) et coulisses du 30/08/2026.
• sources/attachments/wiki-factionwar__message.txt — architecture du menu client et de la sidebar partagée (Inv / Rct / F).
• sources/discord/factionwar-annonces-COMPLET.txt — annonce du 31/08/2026 01:52 : système de donjons instanciés et premier boss Le Veilleur Muet (voir 15-donjons-et-boss.md pour le détail et le sourçage complet).

09 — Le mod client FactionWar Client (Fabric)#

FactionWar Client (identifiant technique : factionwarclient) est un mod client Fabric développé en interne par l'équipe FactionWar / PingHeberg. Il ne contient aucune logique de jeu : il s'agit d'une couche d'affichage et d'interaction branchée en direct sur les plugins serveur maison (factionsystem, zone2resources, zonebridge, lobbysystem). Son objectif affiché est de remplacer les commandes textuelles par des écrans graphiques cohérents : inventaire custom, menu de faction à onglets, livre de recettes, menu de quêtes et écrans de dialogue PNJ, le tout relié par une sidebar de navigation unique.

Le mod est annoncé comme obligatoire pour rejoindre le serveur, tout en étant encore réservé aux testeurs au moment de la dernière source disponible (30/08/2026).

1. Ce que le mod remplace#

Citation d'annonce : « Fini les commandes textuelles éparpillées, un seul menu (/factionmenu) avec tout dedans ».

2. Historique de versions#

⚠️ Une seule version est nommée explicitement dans les sources : V.0.9. Le reste de l'historique se reconstitue par annonces datées, sans numéro de version associé. Toute autre numérotation (par ex. « v0.0.9 ») est non confirmée par les sources.

3. Navigation unifiée#

3.1 La sidebar#

Toute la navigation repose sur une seule classe boîte-à-outils, Sidebar.java — statique, sans état, exposant render(...) et clickedIndex(...). Les écrans l'appellent tous, ce qui garantit un comportement identique partout : un clic sur une icône ferme l'écran courant et ouvre le bon écran, sans jamais avoir à refermer un menu pour en rouvrir un autre.

Avant cette refonte, chaque écran embarquait son propre code de sidebar copié-collé, incohérent entre l'inventaire et le menu Faction.

Structure de la sidebar (état documenté)

⚠️ La documentation technique de référence décrit la sidebar avec 3 icônes et 4 emplacements vides ; l'onglet Que a été ajouté plus tard et est décrit comme étant « juste à côté de Inventaire/Recettes/Faction ». Une annonce le désigne aussi par « Q de l'inventaire → onglet Que » — la casse exacte du libellé est donc à confirmer.

3.2 Raccourcis clavier#

4. Détail de chaque écran et onglet#

4.1 Inventaire custom — CustomInventoryScreen (/newinv, touche G)#

Sur les objets de Loadout : le blocage a été inversé. TrashItemChannel.java a perdu son garde-fou (la poubelle accepte désormais tout), tandis que LoadoutManager.java a été renforcé : un objet de Loadout ne peut plus être déposé dans un conteneur (coffre…) ni rangé dans un Sac (Bundle, toutes couleurs). La faille venait du fait que le code ne vérifiait que le contenu du slot ciblé, pas l'objet porté sur le curseur au moment du clic. Résultat : la poubelle est l'unique moyen de se débarrasser d'un objet de Loadout.

4.2 Menu Faction — FactionMenuScreen (/factionmenu, touche F / G)#

Sept onglets à l'annonce de la refonte, huit après l'ajout de Gestion. Sidebar interne à gauche du panneau.

Conditions de déblocage affichées dans l'onglet Zones

4.3 Livre de recettes — RecipesScreen (onglet Rct)#

Décrit comme « le plus gros morceau client de la session » : une reconstruction quasi complète du livre de recettes vanilla, adaptée au thème du serveur.

Point technique : Minecraft 1.21.11 a introduit un nouveau système de recettes (RecipeDisplayEntry, RecipeCollection, StackedItemContents) qui remplace l'ancien Recipe / RecipeBookMenu. L'implémentation a été vérifiée contre les mappings Mojang avant écriture plutôt que devinée, et le craft automatique a été testé sur des objets sans valeur avant validation sur inventaire réel.

4.4 Menu Quêtes (onglet Que)#

Total documenté : 46 quêtes. Trois types d'objectifs au lancement (atteindre un niveau de métier, livrer une quantité de ressource, éliminer des mobs hostiles). Récompenses versées au trésor de la faction, jamais dans un portefeuille personnel. Progression individuelle et sauvegardée, conservée entre les connexions.

Suivi de quête permanent (29/08) : ouvrir le menu Quêtes → cliquer sur « Suivre » à côté d'une quête → fermer le menu. Un encadré apparaît en haut à droite de l'écran avec le nom, l'objectif et la progression en temps réel, visible en permanence hors des menus. Une seule quête suivie à la fois, changeable à tout moment ; recliquer sur « Suivi » arrête le suivi. Le suivi est enregistré et survit à une déconnexion — inutile de le re-sélectionner à chaque session — et bascule automatiquement sur une nouvelle étape dès qu'elle est acceptée.

Guide d'Osric — Chapitre 1 (29/08) : les 12 étapes du Chapitre 1 « L'Éveil » sont narrées par Osric, l'Éclaireur de Sylvange, chaque quête ayant son propre texte. Une notification discrète (petit badge rouge en haut à gauche de l'écran) signale qu'Osric a quelque chose à dire, sans popup ni interruption forcée. La touche J permet de lui parler depuis n'importe où, sans retourner à Sylvange. Chaque étape doit être explicitement acceptée — aucune quête ne se lance toute seule, exactement comme chez les PNJ d'Aubécie.

4.5 Écrans de dialogue PNJ#

Les PNJ narratifs n'ouvrent jamais l'écran de troc vanilla. Un clic droit ouvre une véritable fenêtre de dialogue propre à chaque personnage, avec un texte qui dépend de la progression du joueur.

5. Architecture technique côté mod#

5.1 Le canal de données#

Toutes les données affichées dans le menu Faction transitent par un seul canal réseau, MenuDataChannel : un flux binaire strict, où chaque champ est écrit côté serveur puis relu dans le même ordre exact côté client (FactionMenuData.java).

⚠️ Contrainte de protocole forte : toute nouvelle donnée doit impérativement être ajoutée à la fin du flux, jamais au milieu, sous peine de décaler la lecture de tous les champs suivants. Aucun mécanisme de versionnage du protocole n'est mentionné dans les sources.

5.2 Les canaux serveur ↔ client#

5.3 Classes client identifiées#

Sidebar.java · CustomInventoryScreen.java · FactionMenuScreen.java · RecipesScreen.java · FactionMenuData.java

6. Prérequis et installation#

Procédure

1. Lancer l'installeur Fabric, sélectionner la version 1.21.11, cliquer « Install ».
2. Placer les .jar dans le dossier mods. ⚠️ Le chemin donné dans la source est %appdata%\Raoming\minecraft\mods — coquille manifeste ; le chemin standard est %appdata%\.minecraft\mods.
3. Lancer Minecraft avec le profil « Fabric Loader 1.21.11 » et se connecter normalement.
4. Le vocal de proximité s'active seul selon la proximité entre joueurs ; touche V pour ses réglages.

⚠️ Incohérence à confirmer : l'annonce liste 3 composants (Fabric Loader, Fabric API, FactionWar Client) puis indique « Placez les deux fichiers .jar dans votre dossier mods ». Fabric Loader étant installé par l'installeur et non déposé dans mods, les deux .jar concernés sont bien Fabric API + FactionWar Client — mais le libellé reste ambigu dans la source.

❌ Le vocal de proximité est indisponible sur Bedrock (limitation technique) — Java Edition uniquement.

7. État actuel (au 30/08/2026)#

8. Limites connues du mod client#

Sources#

• sources/discord/factionwar-dev.txt — annonces du 13/08 au 28/08/2026 (annonce du mod, V.0.9, airdrops, loadouts, onglet Métiers, refonte des menus, onglet Quêtes, PNJ, réputation, onglet Gestion, touches G et J)
• sources/discord/factionwar-dev-rattrapage.txt — 5 messages des 28–29/08/2026 récupérés après audit : classement des factions dans l'onglet Raids, bouton « Chat Faction: ON/OFF » et liste de membres scrollable, onglet Gestion (29/08 00:54), suivi de quête permanent (29/08 10:50), Guide d'Osric (29/08 14:29)
• sources/attachments/wiki-factionwar__message.txt — documentation technique interne (sidebar, CustomInventoryScreen, FactionMenuScreen, RecipesScreen, MenuDataChannel, canaux réseau, chronologie de création)
• sources/discord/factionwar-modspack.txt — versions exactes de Fabric API, Simple Voice Chat, installeur Fabric
• sources/attachments/wiki-factionwar__Wiki_FactionWar_3.md — wiki joueur au 16/08/2026
• sources/discord/factionwar-annonces.txt — roadmap mise à jour du 29/08 et coulisses du 30/08
• sources/discord/wiki-factionwar.txt — récapitulatif de commandes du 16/08
• sources/discord/factionwar-dev-extra.txt

10 — Référence des commandes#

Référence exhaustive des commandes FactionWar, reconstituée en croisant trois récapitulatifs successifs publiés à des dates différentes (annonce du 14/08/2026, récapitulatif Discord du 16/08/2026, wiki joueur du 16/08/2026) avec l'ensemble des annonces de développement jusqu'au 30/08/2026.

Principe de lecture : l'état le plus récent fait foi. Depuis l'arrivée du mod client FactionWar Client, la plupart de ces commandes ont un équivalent graphique dans /factionmenu — elles ne sont pas retirées pour autant, sauf mention contraire.

1. Factions#

Actions du menu /f sans équivalent commande#

Certaines actions n'ont jamais eu de commande dédiée et se font uniquement via le menu :

Sous-menu « Gérer les membres » (leader uniquement) : clic gauche = promouvoir · clic droit = rétrograder · shift + clic droit = exclure. Le leader n'apparaît jamais dans la liste ; le sous-menu se réouvre automatiquement après chaque action.

2. Métiers#

3. Économie et Core#

4. Mod client FactionWar Client#

⚠️ Aucun écran des sources n'associe de commande dédiée à l'onglet Rct (livre de recettes) ni à l'onglet Que (quêtes) : ils s'atteignent par la sidebar. Non précisé dans les sources.

❌ /factionwar n'existe pas : aucune occurrence dans l'ensemble des sources. Ne pas le documenter comme commande.

5. Raccourcis clavier (mod client et mods tiers)#

6. Commandes serveur / administration observées#

Ces commandes apparaissent dans les journaux de développement, pas dans les récapitulatifs joueurs.

7. Évolutions et commandes à surveiller#

8. Récapitulatif consolidé (le plus à jour)#

9. Consulter les commandes en jeu — le PNJ Appo#

Depuis le 28/08/2026, il n'est plus nécessaire de revenir sur Discord pour retrouver une commande : un PNJ nommé Appo attend au spawn du lobby. Un clic droit sur lui ouvre un accès à trois rubriques :

« Un passage obligé si tu débarques ou si t'as un doute sur une commande — plus besoin de fouiller le Discord, tout est directement accessible en jeu. »

⚠️ Le contenu exact de la liste affichée par Appo n'est pas reproduit dans les sources. Impossible de savoir si elle correspond au récapitulatif du §8, si elle est plus courte, ou si elle a été mise à jour après la refonte des menus (onglet Gestion, bouton « Chat Faction: ON/OFF »). En cas de divergence, considérer ce document comme la référence la plus complète, et la liste in-game comme un aide-mémoire de dépannage.

Le Lobby affiche par ailleurs des panneaux de règles et de commandes depuis ses débuts (source : wiki joueur).

Sources#

• sources/discord/factionwar-dev.txt — « LISTE DES COMMANDES JOUEURS » (14/08/2026), documentation du menu /f, patch note /fmap (15/08), annonces /f history, /f shop, /f afk set, refonte des métiers, onglet Gestion, touches G et J
• sources/discord/EXPORT-REFERENCE-tous-canaux.txt — source de référence : ré-extraction exhaustive du Discord (152 messages recensés, 148 récupérés), tous canaux confondus
• sources/discord/messages-recuperes-audit-passe2.txt — message complet du PNJ Appo (28/08/2026 09:08) confirmant l'accès en jeu aux règles, à la liste des commandes utiles et au lien Discord copiable
• sources/discord/factionwar-dev-rattrapage.txt — 5 messages des 28–29/08/2026 récupérés après audit : onglet Gestion et remplacement des commandes en tchat (29/08 00:54), bouton « Chat Faction: ON/OFF » remplaçant /fchat, classement des factions dans l'onglet Raids, suivi de quête permanent (29/08 10:50), touche J et Guide d'Osric (29/08 14:29)
• sources/discord/wiki-factionwar.txt — « Récapitulatif des commandes » du 16/08/2026
• sources/attachments/wiki-factionwar__Wiki_FactionWar_3.md — wiki joueur du 16/08/2026, tableau récapitulatif final
• sources/attachments/wiki-factionwar__message.txt — documentation technique interne (/newinv, /factionmenu, canaux réseau, /setworldspawn, gamerule météo, /place structure)
• sources/discord/factionwar-modspack.txt — touche V du vocal de proximité
• sources/discord/factionwar-annonces.txt
• sources/discord/factionwar-dev-extra.txt

11 — Infrastructure technique#

FactionWar ne tourne pas sur un serveur unique mais sur une infrastructure multi-serveurs hébergée par PingHeberg, articulée autour d'un proxy central, de plusieurs mondes indépendants et d'une base de données MariaDB centralisée. L'ensemble du gameplay repose sur des plugins Paper développés en interne (Minecraft 1.21.11), complétés par un mod client Fabric maison. Le crossplay Java/Bedrock est actif, et le réseau redémarre automatiquement toutes les 6 heures.

Équipe citée dans les sources : Appo / AppoGenesis (développement), Hynata (communication et dev), MissMlx (construction du monde), Poucy (tests du contenu narratif).

1. Hébergement et plateforme#

2. Architecture multi-serveurs#

2.1 Le schéma revendiqué#

« Derrière FactionWar, il n'y a pas un seul serveur qui fait tout — il y a une vraie infrastructure : un proxy central qui répartit intelligemment les joueurs entre plusieurs mondes indépendants (Lobby, la progression vers les Cinq Royaumes, et Terravel, le monde vanilla final). Chaque brique tourne séparément, ce qui veut dire qu'aucune ne s'effondre à cause d'une autre. » (25/08/2026)

⚠️ Le logiciel de proxy n'est jamais nommé dans les sources (Velocity, BungeeCord, Waterfall…). Non précisé dans les sources.

2.2 Rôle de chaque brique#

⚠️ Le décompte des serveurs varie selon les sources : « les 3 serveurs » (doc technique, changement de slots et purge des sauvegardes) ; « Lobby + Terravel + 5 zones » (roadmap du 29/08) ; « lobby, Terravel et Aubécie communiquent en permanence » (30/08). Le premier chiffre correspond à l'état antérieur (lobby + zone1 + zone2) ; la topologie actuelle exacte est à confirmer.

2.3 Évolution du concept#

2.4 Les dimensions à paliers#

Chaque zone est une dimension custom définie par datapack (paire de fichiers JSON dimension_type + dimension, dans world/datapacks/<nom>/data/<namespace>/), avec biome forcé et seed dédiée.

Mécanique d'exclusivité des minerais — OreStripListener.java retire physiquement tous les minerais non autorisés à chaque génération de nouveau chunk, une seule fois, jamais aux rechargements. Le charbon suit une règle spéciale globale : 15 % de chance de survie, dans toutes les zones, indépendamment de la liste d'autorisation.

ZONE_ALLOWED_ORES = {
  "factionwar:bois"   -> aucun minerai,
  "factionwar:cuivre" -> cuivre + fer,
  "factionwar:or"     -> or + redstone
}

Détail Zone Or/Redstone (le mieux documenté) : bordure de monde de 2000 blocs de diamètre ; plateforme d'arrivée en quartz lisse, protégée contre le cassage et la pose de blocs sur un rayon de 20 blocs (réservé aux admins) ; point de respawn calé par /setworldspawn ; message d'accueil automatique à la première entrée (WelcomeTriggerListener.java) ; panneaux décoratifs répliquant le style du portail Bois→Cuivre — un portail fonctionnel vers la Zone Or sur la plateforme Cuivre, et un second purement décoratif préparant la future Zone Diamant.

Une carte de Zone Bois de 1000×1000 blocs est mentionnée pour le palier 1. Chaque zone possède son propre world border. L'XP de métier est volontairement réduite dans les zones à paliers pour ralentir la progression.

3. Transfert et synchronisation entre mondes#

3.1 Ce qui est synchronisé#

Inventaire, points de vie et expérience sont conservés lors d'un changement de serveur : « Système de passage entre zones avec synchronisation complète (inventaire, vie, XP conservés) » (13/08). La roadmap du 29/08 confirme : « synchronisation totale du joueur entre serveurs (inventaire, vie, XP, tout suit sans perte) ».

3.2 Le système PlayerDataManager (refonte)#

Principe clé : peu importe le chemin de transfert (portails, menu, déconnexion), un changement de serveur déclenche toujours un vrai PlayerQuitEvent/PlayerJoinEvent. Ce point d'ancrage unique couvre tous les cas sans avoir à modifier chaque système de téléportation individuellement.

3.3 Voyage inter-zones depuis le menu#

ZoneTravelChannel.java (dans factionsystem) route vers le bon monde et les bonnes coordonnées selon la zone demandée. Si le joueur est sur un autre serveur, le canal déclenche un transfert réseau puis une téléportation différée via PendingTeleportListener.java, finalisée à la connexion sur le bon serveur. Résultat côté joueur : un clic sur « s'y rendre » suffit, quel que soit le serveur d'origine.

ZoneBridge reste responsable du transfert réseau par portails entre zone1 et zone2.

3.4 Respawn multi-monde#

4. Persistance et base de données#

5. Claims et stockage des territoires#

6. Crossplay Java / Bedrock#

6.1 Connexion#