InstallInstallation
Download the installer from the download section and run it. Kodexium installs for your user only, so it doesn't need administrator rights. Requirements: Windows 10 or 11 (64-bit) and a Minecraft: Java Edition account.
You don't need to install Java. Kodexium downloads the right runtime for each Minecraft version automatically.
Téléchargez l'installeur depuis la section téléchargement et lancez-le. Kodexium s'installe pour votre utilisateur uniquement et ne demande pas de droits administrateur. Prérequis : Windows 10 ou 11 (64 bits) et un compte Minecraft : Java Edition.
Inutile d'installer Java. Kodexium télécharge automatiquement le bon environnement pour chaque version de Minecraft.
Sign inConnexion
Kodexium uses Microsoft's official device-code sign-in:
- Click Sign in. The launcher shows a short code and opens
microsoft.com/linkin your browser. - Enter the code and sign in with the Microsoft account that owns Minecraft.
- Go back to the launcher. It continues on its own.
Your password is only typed on Microsoft's website. The session is stored in the Windows Credential Manager and refreshed automatically, so you stay signed in between launches.
Kodexium utilise la connexion officielle Microsoft par code :
- Cliquez sur Sign in. Le launcher affiche un code court et ouvre
microsoft.com/linkdans votre navigateur. - Saisissez le code et connectez-vous avec le compte Microsoft qui possède Minecraft.
- Revenez au launcher : il continue tout seul.
Votre mot de passe n'est saisi que sur le site de Microsoft. La session est stockée dans le Gestionnaire d'identification Windows et renouvelée automatiquement : vous restez connecté d'un lancement à l'autre.
Join a serverRejoindre un serveur
The Browse page lists the servers you can see, with live ping and player counts. Your last played server is pinned at the top. Open a server to see its mods and online players, then press Play:
- The server's files are synced (see below).
- Minecraft starts with the right version and loader.
- You connect to the server automatically.
Add by IP
Is your server not in the list? Click Add by IP and enter its address. Manual servers are saved on your computer only and show a "Manual" badge. You can remove them at any time.
La page Browse liste les serveurs auxquels vous avez accès, avec le ping et le nombre de joueurs en direct. Le dernier serveur joué est épinglé en haut. Ouvrez un serveur pour voir ses mods et les joueurs connectés, puis appuyez sur Play :
- Les fichiers du serveur se synchronisent (voir plus bas).
- Minecraft démarre avec la bonne version et le bon loader.
- Vous êtes connecté au serveur automatiquement.
Ajouter par IP
Votre serveur n'apparaît pas ? Cliquez sur Add by IP et saisissez son adresse. Les serveurs manuels sont enregistrés uniquement sur votre ordinateur et portent un badge « Manual ». Vous pouvez les retirer à tout moment.
How sync worksLa synchronisation
Each server publishes a manifest, a list of every file players need with its size and SHA-1 checksum. Before each launch, Kodexium compares that list with your files:
- Missing or changed files are downloaded, then their checksum is verified.
- Up-to-date files are skipped, so later launches are fast.
- Leftover files that the server no longer lists are removed from the managed folders.
| Folders | Behavior |
|---|---|
mods config resourcepacks shaderpacks kubejs scripts datapacks defaultconfigs | Fully managed: kept identical to the server. |
| Game folder (root) | Add-only: files are added or updated, never deleted. |
| Worlds, screenshots, options | Never touched. |
Every server runs in its own instance folder, so mods from one server never end up in another.
Chaque serveur publie un manifeste : la liste de tous les fichiers dont les joueurs ont besoin, avec leur taille et leur empreinte SHA-1. Avant chaque lancement, Kodexium compare cette liste à vos fichiers :
- Les fichiers manquants ou modifiés sont téléchargés, puis leur empreinte est vérifiée.
- Les fichiers à jour sont ignorés : les lancements suivants sont rapides.
- Les fichiers en trop, que le serveur ne liste plus, sont supprimés des dossiers gérés.
| Dossiers | Comportement |
|---|---|
mods config resourcepacks shaderpacks kubejs scripts datapacks defaultconfigs | Entièrement gérés : identiques au serveur. |
| Dossier du jeu (racine) | Ajout uniquement : les fichiers sont ajoutés ou mis à jour, jamais supprimés. |
| Mondes, captures, options | Jamais modifiés. |
Chaque serveur fonctionne dans son propre dossier d'instance : les mods d'un serveur ne se retrouvent jamais dans un autre.
Modpacks
The Modpacks page can install a pack as a separate local instance. You can:
- search Modrinth or CurseForge and pick a version,
- import a local
.mrpackor CurseForge.zip, - or open a pack from a URL.
CurseForge search needs a free CurseForge API key, which you add in Settings. Server owners can also deploy a pack to their server. A built-in scanner reads each mod's metadata, sorts it as client, server or both, and shows you the list before anything is uploaded.
La page Modpacks installe un pack comme instance locale séparée. Vous pouvez :
- chercher sur Modrinth ou CurseForge et choisir une version,
- importer un
.mrpackou un.zipCurseForge, - ou ouvrir un pack depuis une URL.
La recherche CurseForge nécessite une clé API CurseForge gratuite, à ajouter dans les paramètres. Les propriétaires de serveurs peuvent aussi déployer un pack sur leur serveur. Un scanner intégré lit les métadonnées de chaque mod, le classe en client, serveur ou les deux, et vous montre la liste avant tout envoi.
SettingsParamètres
| MemoryMémoire | Turn the RAM dial to set how much memory Minecraft gets. Most modpacks run well with 6 to 8 GB.Tournez le cadran RAM pour régler la mémoire allouée à Minecraft. La plupart des modpacks tournent bien avec 6 à 8 Go. |
| DisplayAffichage | Window resolution or fullscreen.Résolution de la fenêtre ou plein écran. |
| Java | Leave empty to use the automatic runtime, or choose your own Java and JVM arguments.Laissez vide pour l'environnement automatique, ou choisissez votre propre Java et vos arguments JVM. |
| Game folderDossier du jeu | Where instances are stored.Emplacement des instances. |
| AppearanceApparence | Accent colors plus seasonal and flag themes.Couleurs d'accent, thèmes saisonniers et thèmes drapeaux. |
Host a serverHéberger un serveur
A Kodexium server has two parts: the Minecraft server itself, and a filehost that publishes the manifest and serves the files to players.
- Run the Kodexium filehost on a machine reachable over HTTPS, and set up your server on it: name, game address, Minecraft version and loader (Forge, Fabric or NeoForge). The launcher only sends your account credentials to HTTPS hosts.
- In the launcher, open Admin, paste your filehost's address and click Publish my filehost. Every server it hosts is listed on all directories. To create a single listing by hand, use Advanced.
- Add files from the Files tab, or deploy a modpack from the Modpacks page.
- Choose public or private visibility, and manage the whitelist and admins from the server's admin page.
To keep the Minecraft server's own mods folder matched to the same manifest, use the server-sync command-line tool. It downloads server-side files, verifies checksums and removes stale files. It never touches your world or server.properties.
Live badge
Show your server's live status on your own site or forum with an embeddable badge. It refreshes every 30 seconds and is also readable at the status page.
<iframe src="https://kodexium.app/badge?server=SERVER_ID" width="340" height="64" style="border:0" loading="lazy"></iframe>
Un serveur Kodexium a deux parties : le serveur Minecraft lui-même, et un filehost qui publie le manifeste et distribue les fichiers aux joueurs.
- Lancez le filehost Kodexium sur une machine accessible en HTTPS, et configurez-y votre serveur : nom, adresse de jeu, version de Minecraft et loader (Forge, Fabric ou NeoForge). Le launcher n'envoie vos identifiants qu'à des hôtes HTTPS.
- Dans le launcher, ouvrez Admin, collez l'adresse de votre filehost et cliquez sur Publish my filehost. Chaque serveur qu'il héberge est listé sur tous les annuaires. Pour créer une seule annonce à la main, utilisez Advanced.
- Ajoutez des fichiers depuis l'onglet Files, ou déployez un modpack depuis la page Modpacks.
- Choisissez la visibilité publique ou privée, et gérez la whitelist et les admins depuis la page d'administration du serveur.
Pour que le dossier mods du serveur Minecraft reste aligné sur le même manifeste, utilisez l'outil en ligne de commande server-sync. Il télécharge les fichiers côté serveur, vérifie les empreintes et supprime les fichiers obsolètes. Il ne touche jamais à votre monde ni à server.properties.
Badge en direct
Affichez l'état de votre serveur en direct sur votre site ou forum grâce à un badge intégrable. Il s'actualise toutes les 30 secondes et est aussi lisible sur la page d'état.
<iframe src="https://kodexium.app/badge?server=SERVER_ID" width="340" height="64" style="border:0" loading="lazy"></iframe>
DirectoriesAnnuaires
The server list comes from the Kodexium directory, which runs as several full copies. The launcher asks all of them at once and merges the answers, so the list stays available even if some copies are down.
If none of them answer, the launcher shows your last saved list with a warning. You can still play, because files are downloaded straight from each server's filehost, not from the directory.
La liste des serveurs vient de l'annuaire Kodexium, qui fonctionne en plusieurs copies complètes. Le launcher les interroge toutes en même temps et fusionne les réponses : la liste reste disponible même si certaines copies sont hors service.
Si aucune ne répond, le launcher affiche votre dernière liste enregistrée avec un avertissement. Vous pouvez quand même jouer, car les fichiers sont téléchargés directement depuis le filehost de chaque serveur, et non depuis l'annuaire.
FAQ
Is Kodexium free?Kodexium est-il gratuit ?
Yes. The launcher is free to download and use.Oui. Le launcher est gratuit à télécharger et à utiliser.
Do I need to own Minecraft?Faut-il posséder Minecraft ?
Yes. You need a Microsoft account that owns Minecraft: Java Edition. Offline and cracked accounts aren't supported.Oui. Il faut un compte Microsoft qui possède Minecraft : Java Edition. Les comptes hors ligne et crackés ne sont pas pris en charge.
Does it work on macOS or Linux?Ça marche sur macOS ou Linux ?
Not yet. Kodexium is Windows-only for now.Pas encore. Kodexium fonctionne uniquement sous Windows pour le moment.
Will it change my normal Minecraft install?Est-ce que ça modifie mon installation Minecraft habituelle ?
No. Kodexium keeps everything in its own folder and never touches .minecraft.Non. Kodexium garde tout dans son propre dossier et ne touche jamais à .minecraft.
Can I add my own mods to a server instance?Puis-je ajouter mes propres mods à une instance de serveur ?
Not inside managed folders like mods. Sync keeps them identical to the server, so extra files are removed on the next launch. Your worlds, screenshots and options.txt are never touched. For a personal setup, use a modpack instance instead.Pas dans les dossiers gérés comme mods. La synchronisation les garde identiques au serveur, donc les fichiers en trop sont supprimés au lancement suivant. Vos mondes, captures d'écran et options.txt ne sont jamais modifiés. Pour une configuration perso, utilisez plutôt une instance de modpack.
Is my account safe?Mon compte est-il en sécurité ?
You sign in on Microsoft's own website, so the launcher never sees your password. The session is stored in the Windows Credential Manager, and the launcher only sends it over HTTPS to hosts it trusts.Vous vous connectez sur le site de Microsoft : le launcher ne voit jamais votre mot de passe. La session est stockée dans le Gestionnaire d'identification Windows, et le launcher ne l'envoie qu'en HTTPS à des hôtes de confiance.
The server list doesn't load. What can I do?La liste des serveurs ne charge pas. Que faire ?
Check your internet connection. If the directory is unreachable, the launcher shows your last saved list and you can still play. You can check each service's status at kodexium.app/status.Vérifiez votre connexion internet. Si l'annuaire est injoignable, le launcher affiche votre dernière liste enregistrée et vous pouvez quand même jouer. L'état de chaque service est visible sur kodexium.app/status.
Where are my files stored?Où sont stockés mes fichiers ?
Settings are in %APPDATA%\Kodex\Kodexium\config. Each server's instance is in %APPDATA%\Kodex\Kodexium\data\instances\server-<id>, unless you changed the game folder in Settings.Les paramètres sont dans %APPDATA%\Kodex\Kodexium\config. L'instance de chaque serveur est dans %APPDATA%\Kodex\Kodexium\data\instances\server-<id>, sauf si vous avez changé le dossier du jeu dans les paramètres.
How do I uninstall Kodexium?Comment désinstaller Kodexium ?
Go to Windows Settings, then Apps, then Kodexium, then Uninstall. To also remove your instances and settings, delete %APPDATA%\Kodex\Kodexium.Allez dans Paramètres Windows, puis Applications, puis Kodexium, puis Désinstaller. Pour supprimer aussi vos instances et paramètres, effacez %APPDATA%\Kodex\Kodexium.