Migrer votre monde de Minecraft Realms vers ServerPrism

Passer de Minecraft Realms (Java Edition) à votre propre serveur ServerPrism est une copie unidirectionnelle simple — le dossier du monde Realms est un dossier de monde Minecraft standard, il s'intègre donc directement dans un serveur ServerPrism Paper ou Vanilla. La progression de tous (inventaire, XP, position, avancements) est transférée automatiquement tant que vous conservez online-mode=true.

Ce guide couvre l'ensemble du déplacement de bout en bout : ce que vous pouvez et ne pouvez pas transférer, l'exportation depuis Realms, la commande du bon plan ServerPrism, le téléchargement du monde, la reconstruction des listes de permissions que Realms n'exporte pas, et l'orientation de vos joueurs vers la nouvelle adresse.

Avant de commencer : ce qui est réellement transféré

Realms a été conçu comme un monde hébergé verrouillé, donc l'exportation contient tout ce qui est lié au monde mais rien de lié à la plateforme.

Transferts propres :

• Le dossier du monde lui-même (toutes les dimensions, chunks, données de niveau)
• La sauvegarde par joueur de chaque joueur (playerdata/<uuid>.dat) — inventaire, position, XP, coffre de l'Ender, santé
• Statistiques des joueurs (stats/<uuid>.json) et avancements (advancements/<uuid>.json)
• Tous les datapacks que vous aviez installés dans le monde
• Structures, point d'apparition, graine du monde et gamerules

Ne transfère pas (vous devrez le reconstruire) :

• La liste des membres Realms — Realms utilise des invitations de compte Microsoft, pas les fichiers standards ops.json / whitelist.json / banned-players.json
• Paramètres du serveur — Realms n'expose pas de server.properties, donc la difficulté, le PvP, la protection d'apparition, la distance de vue, etc. sont tous définis à nouveau sur votre nouveau serveur
• L'IP du Realm — Realms utilise des adresses éphémères ; les joueurs auront besoin de votre nouvelle adresse ServerPrism

Ne peut pas exister sur Realms en premier lieu (donc rien à migrer) : plugins, mods, packs de ressources groupés côté serveur, ou tout chargeur Forge/Fabric. Si vous souhaitez l'un de ceux-ci après le déménagement, ServerPrism peut l'exécuter.

Étape 1 : Choisissez le bon plan ServerPrism

Realms Java vous limite à 11 joueurs (propriétaire + 10) sans support de plugin/mod. Sur ServerPrism, vous êtes libéré de ces deux limites, c'est donc un bon moment pour choisir ce que vous voulez réellement.

• Identique à avant (jusqu'à ~10 joueurs, style vanilla) : un plan de 2 Go ou 4 Go est amplement suffisant. Choisissez Paper comme runtime — c'est un remplacement vanilla direct qui exécute le même monde mais offre de meilleures performances et prend en charge les plugins si vous les souhaitez plus tard.
• Communauté plus grande ou monde lourd : 6 Go ou 8 Go vous offrent une marge confortable pour 15 à 25 joueurs.
• Vous voulez ajouter des mods après le déménagement : choisissez Forge, NeoForge, ou utilisez notre runtime Modpack Installer. Votre monde Realms s'intègre toujours parfaitement ; les mods peuvent être ajoutés par la suite.

Une fois que vous avez commandé, notez l'IP:port de votre serveur depuis le tableau de bord du panneau — vous le donnerez aux joueurs à la fin.

Étape 2 : Faites correspondre la version de Minecraft

Realms exécute la dernière version stable de Minecraft et ne vous permet pas de choisir une version. Votre serveur ServerPrism doit être sur la même version ou une version plus récente — un monde peut être mis à niveau vers une version MC plus récente, mais jamais rétrogradé.

Sur le panneau ServerPrism, ouvrez votre serveur, cliquez sur Startup, et vérifiez les variables de version (Minecraft Version pour Paper, ou la version que vous avez sélectionnée au moment de la commande). Si elle ne correspond pas à la dernière version du Realm, définissez-la maintenant et redémarrez une fois pour que le serveur télécharge le bon jar. Vous pouvez toujours confirmer la version de votre Realm en vérifiant votre client Minecraft — l'onglet Realms affiche la version en haut.

Étape 3 : Exportez votre monde depuis Realms

Seul le propriétaire du Realm peut le faire (les membres invités ne peuvent pas télécharger).

1. Lancez Minecraft (le même compte que vous utilisez pour posséder le Realm).
2. Depuis le menu principal, cliquez sur Minecraft Realms.
3. Sélectionnez votre Realm dans la liste, puis cliquez sur Configure Realm (l'icône de clé/engrenage).
4. Ouvrez l'onglet Backups. Vous verrez une liste de sauvegardes automatiques ainsi que l'état actuel du monde.
5. Cliquez sur Download World à côté de la version que vous souhaitez (généralement la plus récente).
6. Entrez un nom lorsque vous y êtes invité — cela deviendra le nom de fichier du téléchargement.
7. Attendez que le téléchargement se termine. Vous obtiendrez un fichier .zip, généralement enregistré dans votre dossier Téléchargements.

À l'intérieur du zip, vous trouverez un dossier avec le nom de votre monde contenant level.dat, region/, playerdata/, stats/, advancements/, dimensions/, et (si vous en aviez) datapacks/. C'est le monde entier, et c'est un dossier Minecraft standard — aucune structure spécifique à Realms.

Attention à la double imbrication. Certaines versions clientes produisent un dossier à l'intérieur d'un dossier portant le même nom. Si le premier niveau du zip ne contient qu'un seul dossier qui contient les fichiers du monde réel, utilisez ce dossier interne dans les étapes suivantes.

Étape 4 : Préparez le dossier du monde

Avant de télécharger, effectuez deux petits nettoyages sur votre machine locale :

1. Renommez le dossier en world (tout en minuscules). Les serveurs Minecraft de ServerPrism recherchent un dossier appelé world par défaut. Vous pouvez utiliser un nom différent si vous définissez également level-name=votre_nom dans server.properties, mais world est le chemin le moins surprenant.
2. Supprimez session.lock s'il est présent. Ce fichier est un marqueur de verrouillage pour le serveur précédemment en cours d'exécution ; le laisser peut provoquer une erreur "world already in use" (monde déjà utilisé) lors du premier démarrage.

Étape 5 : Téléchargez le monde sur ServerPrism

Vous avez deux options pour transférer le monde sur votre serveur. Les deux fonctionnent — choisissez celle qui convient à la taille de votre monde.

Option A — SFTP (idéal pour tout ce qui dépasse 100 Mo)

1. Sur le tableau de bord du panneau de votre serveur, recherchez la section SFTP (généralement dans la barre latérale ou en bas). Notez l'hôte, le port et le nom d'utilisateur affichés. Votre mot de passe est votre mot de passe du panneau ServerPrism.
2. Ouvrez un client SFTP — FileZilla ou WinSCP sur Windows, Cyberduck ou Transmit sur macOS, ou tout gestionnaire de fichiers prenant en charge SFTP sur Linux.
3. Connectez-vous avec les identifiants du panneau (pas le port 22 — le SFTP de ServerPrism utilise un port personnalisé affiché sur le tableau de bord).
4. Une fois connecté, vous verrez l'arborescence des fichiers de votre serveur. S'il y a déjà un dossier world de la nouvelle installation, supprimez-le d'abord (ou renommez-le comme sauvegarde).
5. Faites glisser votre dossier world de votre machine vers la racine du serveur. Les mondes volumineux peuvent prendre de 5 à 30 minutes selon votre vitesse de téléchargement.
6. Une fois le transfert terminé, fermez le client SFTP.

Option B — Téléchargement via le gestionnaire de fichiers (pour les mondes plus petits, jusqu'à ~500 Mo)

1. Dans le panneau, ouvrez votre serveur et cliquez sur File Manager.
2. Supprimez ou renommez le dossier world existant à la racine.
3. Cliquez sur Upload et faites glisser votre dossier de monde, OU téléchargez le fichier .zip original et utilisez Unarchive (clic droit sur le fichier → Unarchive) pour l'extraire sur place.
4. Si vous avez téléchargé le zip, supprimez le zip après pour économiser de l'espace disque.

Étape 6 : Démarrez le serveur et vérifiez

1. Sur le panneau, cliquez sur Start dans l'onglet Console.
2. Observez la console pour une ligne Done (X.XXXs)! For help, type "help" — cela signifie que le monde a été chargé et que le serveur accepte les connexions.
3. Si vous voyez des erreurs mentionnant DataVersion ou "world is from a newer version" (le monde provient d'une version plus récente), la version MC de votre serveur est plus ancienne que celle que Realms exécutait. Mettez à jour la version de Minecraft du serveur dans l'onglet Startup et redémarrez.

Étape 7 : Reconstruisez les ops, la whitelist et les paramètres

Puisque Realms n'exporte pas ceux-ci, configurez-les maintenant.

• Donnez-vous les droits d'administrateur. Dans l'onglet Console, exécutez op VotreNomMinecraft. Vous pouvez maintenant utiliser /gamemode, /tp, et toutes les autres commandes d'administrateur.
• Ajoutez vos joueurs. Si vous voulez conserver le comportement "seules ces personnes peuvent rejoindre" que Realms avait, activez une whitelist :

whitelist on
whitelist add PlayerName
whitelist add AnotherPlayer

• Ajustez server.properties. Ouvrez File Manager → server.properties et définissez motd, difficulty, pvp, view-distance, et d'autres bases. Consultez Bases du serveur : server.properties, whitelist et ops pour les paramètres qui comptent réellement.

Étape 8 : Envoyez la nouvelle adresse à vos joueurs

Donnez à vos amis la nouvelle adresse de connexion depuis le panneau. Ce sera un format comme 123.45.67.89:25565 ou un sous-domaine que nous vous avons attribué. Ils l'ajoutent sous Multiplayer → Add Server dans leur client Minecraft et cliquent sur Join — tout ce qu'ils avaient sur le Realm (inventaire, position, XP, coffre de l'Ender, avancements) est exactement tel qu'ils l'ont laissé, car leurs UUID correspondent côté serveur en mode en ligne.

Si un joueur apparaît nu au spawn sans XP, votre serveur fonctionne en online-mode=false (mode hors ligne). Leur UUID hors ligne ne correspond pas à leur UUID Realms, donc leur fichier de sauvegarde n'est pas chargé. Définissez online-mode=true dans server.properties et redémarrez — c'est le paramètre par défaut correct et celui que vous voulez presque certainement.

Pièges courants

• "World is from a newer version" (Le monde provient d'une version plus récente) : votre serveur est sur une version MC plus ancienne que le Realm. Mettez à jour la version dans l'onglet Startup et redémarrez.
• Datapacks non chargés : confirmez qu'ils sont à world/datapacks/ (à l'intérieur du dossier du monde, pas à la racine du serveur), puis exécutez /datapack list dans la console pour voir si le serveur les voit. /datapack enable "file/mypack" en activera un s'il est désactivé.
• Nether ou End est vide : sur les versions MC plus récentes, ces dimensions se trouvent à world/dimensions/minecraft/the_nether/ et world/dimensions/minecraft/the_end/. S'ils manquent à votre téléchargement, vérifiez à nouveau le zip — Realms les inclut généralement.
• "World already in use — is another instance running?" (Monde déjà utilisé — une autre instance est-elle en cours d'exécution ?) : vous avez un session.lock résiduel dans le dossier du monde. Supprimez-le et redémarrez.
• Les joueurs se connectent toujours à l'ancien Realm : les abonnements Realms se renouvellent mensuellement. Annulez le Realm dans les paramètres de votre compte Minecraft si vous en avez terminé avec lui, sinon vous continuerez à payer Mojang en plus de ServerPrism.

Une fois que vous fonctionnez confortablement pendant un jour ou deux sur le nouveau serveur, vous pouvez annuler votre abonnement Realm en toute sécurité. Si vous souhaitez revenir en arrière, le même chemin de dossier fonctionne en sens inverse (téléchargez un zip via le client Realms), mais vous perdriez les plugins et toute personnalisation activée par ServerPrism que Realms ne prend pas en charge.