Team Arcadia

The studio behind Arcadia: Echoes Of Power, a French modded Minecraft server where magic meets machinery.

_{Create technology · Magic · Player economy · 7 languages · NeoForge 1.21.1}

English  ·  Français

1. Who we are
2. Arcadia at a glance
3. How everything fits together
4. Repository naming convention
5. Repository index
6. Find your way
7. Versions and compatibility
8. Branches
9. Contributing
10. Security
11. Links and contact
12. License

Team Arcadia builds and runs Arcadia: Echoes Of Power, a modded Minecraft community based in France. Everything the server needs is made here: the modpack players install, the mods that run on the game servers, the patched forks that keep third-party mods stable, the website and its plugins, and the Discord bot.

This organization is the single home for all of it. This page explains how the repositories are named, what each one does, and where to start depending on who you are.

flowchart LR
    P(["Players"])
    P -->|CurseForge launcher| MP["Arcadia modpack<br/>NeoForge 1.21.1"]
    MP --> GS["Game servers<br/>NeoForge 1.21.1"]
    GS --- AM["Server mods<br/>arcadia-* and mods-mc-*"]
    GS --- FK["Patched forks<br/>fork-mc-*"]
    P -->|Browser| WEB["Website<br/>Azuriom + azuriom-*"]
    WEB <-->|AzLink| GS
    WEB -->|Webhooks| DC["Discord"]
    BOT["Bot Arcadius<br/>discord-bot-arcadius"] --> DC
    P --> DC

• Players install the modpack and connect to the game servers.
• Game servers run the Arcadia mods (gameplay, administration, performance) and our fixed builds of third-party mods.
• The website handles accounts, the shop, votes, the wiki and support. It talks to the game servers through AzLink (rewards, in-game announcements, teleports) and to Discord through webhooks.
• Discord is where the community lives, with Arcadius, our AI-assisted bot, answering questions.

Every repository name tells you what family it belongs to before you even open it. The pattern is always:

<family-prefix>-<name>

Rules

1. Lowercase only, words separated by hyphens. No spaces, no underscores, no capitals.
2. The prefix is mandatory. A repository without a family prefix is a repository nobody can find.
3. The name says what the project is. For a mod, the part after the prefix is the mod's name (arcadia-guard is ArcadiaGuard); for a fork, it is the upstream project name; for an Azuriom plugin, it is the plugin's name.
4. Description in English, one sentence, saying what the project does and for which platform.
5. Topics always include team-arcadia, plus the platform (neoforge, azuriom-plugin, minecraft-1-21-1...).

Which prefix for a new project?

flowchart TD
    Q1{"Is it a Minecraft mod?"}
    Q1 -->|Yes| Q2{"Is it someone else's mod<br/>that we patch?"}
    Q2 -->|Yes| F["fork-mc-&lt;upstream&gt;"]
    Q2 -->|No| Q3{"Useful outside Arcadia,<br/>no Arcadia dependency?"}
    Q3 -->|Yes| S["mods-mc-&lt;modid&gt;"]
    Q3 -->|No| A["arcadia-&lt;modid&gt;"]
    Q1 -->|No| Q4{"Website plugin or theme?"}
    Q4 -->|Yes| W["azuriom-&lt;pluginid&gt;"]
    Q4 -->|No| Q5{"Discord bot?"}
    Q5 -->|Yes| D["discord-bot-&lt;name&gt;"]
    Q5 -->|No| O["Ask the team on Discord"]

A few older repositories predate the convention (for example Arcadia-Dungeon). They will be renamed over time; GitHub redirects old links automatically.

Fixed builds of third-party mods used in the modpack. Each fork keeps the upstream license and credits; our changes live on a dedicated branch and are described in the fork's README.

git clone https://github.com/Team-Arcadia/<repository>.git
cd <repository>
./gradlew build          # the jar lands in build/libs/

cd <azuriom>/plugins
git clone https://github.com/Team-Arcadia/azuriom-<name>.git <plugin-id>

mods-mc-rspolymorph also ships a Fabric build. Every repository states its exact requirements in its README.

1. Open or pick an issue describing the bug or the feature, so the work is discussed before it is written.
2. Create a branch from the default branch with a prefix: feat/, fix/, docs/, refactor/, perf/, chore/, test/, ci/.
3. Commit with the format type: descriptive message, in English:

   feat: add weekly leaderboard reset
   fix: prevent duplicate rewards on reconnect
   

4. Open a pull request to the default branch, explain what changed and how you tested it.
5. Wait for a review from a maintainer before merging.

House rules

• Code, identifiers, comments, logs and commit messages are written in English.
• Documentation (README, CHANGELOG) is bilingual: English first, then French.
• Never commit secrets: tokens, API keys, passwords, .env files, server addresses.
• Never change a version number outside of a release.
• Significant changes go into the project's CHANGELOG.md.

Please do not open a public issue for a security problem. Report it privately through the Security tab of the affected repository (Report a vulnerability), or contact an administrator in private on Discord.

Each repository carries its own LICENSE file: open-source licenses (MIT, Apache-2.0, LGPL-3.0...) for most public mods, the upstream license for forks. Always check the repository you use. Azuriom itself is distributed under the MIT license.

1. Qui sommes-nous
2. Arcadia en bref
3. Comment tout s'articule
4. Convention de nommage des dépôts
5. Index des dépôts
6. Par où commencer
7. Versions et compatibilité
8. Branches
9. Contribuer
10. Sécurité
11. Liens et contact
12. Licence

La Team Arcadia crée et fait tourner Arcadia: Echoes Of Power, une communauté Minecraft moddée basée en France. Tout ce dont le serveur a besoin est fait ici : le modpack que les joueurs installent, les mods qui tournent sur les serveurs de jeu, les forks corrigés qui stabilisent des mods tiers, le site web et ses plugins, et le bot Discord.

Cette organisation est la maison commune de tout cela. Cette page explique comment les dépôts sont nommés, à quoi sert chacun, et par où commencer selon votre profil.

flowchart LR
    P(["Joueurs"])
    P -->|Launcher CurseForge| MP["Arcadia modpack<br/>NeoForge 1.21.1"]
    MP --> GS["Serveurs de jeu<br/>NeoForge 1.21.1"]
    GS --- AM["Mods serveur<br/>arcadia-* et mods-mc-*"]
    GS --- FK["Forks corrigés<br/>fork-mc-*"]
    P -->|Navigateur| WEB["Site web<br/>Azuriom + azuriom-*"]
    WEB <-->|AzLink| GS
    WEB -->|Webhooks| DC["Discord"]
    BOT["Bot Arcadius<br/>discord-bot-arcadius"] --> DC
    P --> DC

• Les joueurs installent le modpack et se connectent aux serveurs de jeu.
• Les serveurs de jeu font tourner les mods Arcadia (gameplay, administration, performances) et nos versions corrigées de mods tiers.
• Le site web gère les comptes, la boutique, les votes, le wiki et le support. Il communique avec les serveurs via AzLink (récompenses, annonces en jeu, téléportations) et avec Discord via des webhooks.
• Discord est le lieu de vie de la communauté, avec Arcadius, notre bot assisté par IA, qui répond aux questions.

Le nom de chaque dépôt indique sa famille avant même de l'ouvrir. Le format est toujours :

<préfixe-de-famille>-<nom>

Règles

1. Minuscules uniquement, mots séparés par des tirets. Pas d'espaces, pas d'underscores, pas de majuscules.
2. Le préfixe est obligatoire. Un dépôt sans préfixe de famille est un dépôt que personne ne retrouve.
3. Le nom dit ce qu'est le projet. Pour un mod, la partie après le préfixe est le nom du mod (arcadia-guard, c'est ArcadiaGuard) ; pour un fork, c'est le nom du projet d'origine ; pour un plugin Azuriom, c'est le nom du plugin.
4. Description en anglais, une phrase, qui dit ce que fait le projet et pour quelle plateforme.
5. Topics : toujours team-arcadia, plus la plateforme (neoforge, azuriom-plugin, minecraft-1-21-1...).

Quel préfixe pour un nouveau projet ?

flowchart TD
    Q1{"C'est un mod Minecraft ?"}
    Q1 -->|Oui| Q2{"C'est le mod de quelqu'un d'autre<br/>que nous corrigeons ?"}
    Q2 -->|Oui| F["fork-mc-&lt;mod-origine&gt;"]
    Q2 -->|Non| Q3{"Utile hors d'Arcadia,<br/>sans dépendance Arcadia ?"}
    Q3 -->|Oui| S["mods-mc-&lt;modid&gt;"]
    Q3 -->|Non| A["arcadia-&lt;modid&gt;"]
    Q1 -->|Non| Q4{"Plugin ou thème du site ?"}
    Q4 -->|Oui| W["azuriom-&lt;pluginid&gt;"]
    Q4 -->|Non| Q5{"Bot Discord ?"}
    Q5 -->|Oui| D["discord-bot-&lt;nom&gt;"]
    Q5 -->|Non| O["Demander à l'équipe sur Discord"]

Quelques dépôts plus anciens sont antérieurs à la convention (par exemple Arcadia-Dungeon). Ils seront renommés progressivement ; GitHub redirige automatiquement les anciens liens.

Versions corrigées de mods tiers utilisés dans le modpack. Chaque fork conserve la licence et les crédits d'origine ; nos modifications vivent sur une branche dédiée et sont décrites dans le README du fork.

git clone https://github.com/Team-Arcadia/<depot>.git
cd <depot>
./gradlew build          # le jar se trouve dans build/libs/

cd <azuriom>/plugins
git clone https://github.com/Team-Arcadia/azuriom-<name>.git <plugin-id>

mods-mc-rspolymorph existe aussi en version Fabric. Chaque dépôt précise ses prérequis exacts dans son README.

1. Ouvrez ou choisissez une issue qui décrit le bug ou la fonctionnalité, pour en discuter avant d'écrire le code.
2. Créez une branche depuis la branche par défaut avec un préfixe : feat/, fix/, docs/, refactor/, perf/, chore/, test/, ci/.
3. Commitez au format type: message descriptif, en anglais :

   feat: add weekly leaderboard reset
   fix: prevent duplicate rewards on reconnect
   

4. Ouvrez une pull request vers la branche par défaut, en expliquant ce qui change et comment vous l'avez testé.
5. Attendez la relecture d'un mainteneur avant de fusionner.

Règles de la maison

• Le code, les identifiants, les commentaires, les logs et les messages de commit sont en anglais.
• La documentation (README, CHANGELOG) est bilingue : anglais d'abord, puis français.
• Ne commitez jamais de secrets : jetons, clés d'API, mots de passe, fichiers .env, adresses de serveurs.
• Ne changez jamais un numéro de version en dehors d'une release.
• Les changements importants vont dans le CHANGELOG.md du projet.

Merci de ne pas ouvrir d'issue publique pour un problème de sécurité. Signalez-le en privé via l'onglet Security du dépôt concerné (Report a vulnerability), ou contactez un administrateur en message privé sur Discord.

Chaque dépôt possède son propre fichier LICENSE : licences open source (MIT, Apache-2.0, LGPL-3.0...) pour la plupart des mods publics, licence d'origine pour les forks. Vérifiez toujours le dépôt que vous utilisez. Azuriom est distribué sous licence MIT.

_{Made with copper, brass and a bit of magic by Team Arcadia · Lead development: vyrriox
© 2026 Arcadia: Echoes Of Power. Not affiliated with Mojang Studios or Microsoft.}