Introduction
Migrer un serveur Minecraft est plus simple que de migrer un FiveM : tout est dans un seul dossier, et la quasi-totalité des configurations sont des fichiers texte (.yml, .properties, .json). Ce guide couvre les cas suivants :
- Migration depuis un autre hébergeur via FTP/SFTP
- Migration depuis un VPS auto-hébergé
- Migration vers le panel Wisp VeryCloud (
panel.verycloud.fr) - Migration vers un VPS Linux indépendant
Prérequis
- Accès SFTP au serveur source
- Accès au serveur de destination (panel Wisp ou VPS root SSH)
- Java 17+ installé côté destination (pour Minecraft 1.18+) ou Java 21 (pour 1.21+)
- Connaissance de la version Minecraft exacte du serveur source
Étape 1 : Identifier la version et les particularités
Sur le serveur source, notez :
- Type de serveur : Vanilla, Paper, Spigot, Bukkit, Forge, Fabric, Velocity, BungeeCord
- Version Minecraft : 1.20.4, 1.21.1, etc.
- Plugins/Mods installés : liste complète
- Taille du dossier :
du -sh .(le world fait souvent 70% du total)
Ces infos déterminent la version Java et le .jar à utiliser côté destination.
Étape 2 : Préparer le serveur de destination
Option A : Sur Wisp (panel VeryCloud)
Sur https://panel.verycloud.fr, commandez ou utilisez un serveur Minecraft existant. Wisp pré-configure Paper / Forge / Fabric selon vos besoins.
Option B : Sur un VPS Linux
# Installer Java 21
sudo apt update
sudo apt install -y openjdk-21-jre-headless screen
# Vérifier
java -version
# Créer l'utilisateur minecraft
sudo useradd -m -s /bin/bash minecraft
sudo passwd minecraft
sudo su - minecraft
# Préparer le dossier
mkdir -p ~/server && cd ~/server
Téléchargez le bon .jar :
# Paper 1.21
wget -O server.jar "https://api.papermc.io/v2/projects/paper/versions/1.21.1/builds/132/downloads/paper-1.21.1-132.jar"
Lancez une première fois pour générer les fichiers :
java -Xms2G -Xmx4G -jar server.jar nogui
Acceptez l'EULA :
echo "eula=true" > eula.txt
Étape 3 : Arrêter le serveur source
Crucial : arrêtez complètement le serveur source avant de transférer le world. Sinon, le fichier level.dat est verrouillé et la sauvegarde sera corrompue.
# Dans la console du serveur source
stop
Étape 4 : Transférer les fichiers
Méthode 1 : SCP direct (si VPS → VPS)
Depuis votre machine locale ou directement entre serveurs :
# Sur le serveur source
cd /chemin/vers/serveur
tar -czf minecraft-backup.tar.gz \
--exclude='logs' \
--exclude='cache' \
--exclude='crash-reports' \
world/ world_nether/ world_the_end/ \
plugins/ config/ \
server.properties bukkit.yml spigot.yml paper-global.yml \
ops.json banned-players.json banned-ips.json whitelist.json
Transférez :
scp minecraft-backup.tar.gz root@IP_DESTINATION:/tmp/
Méthode 2 : SFTP (le plus universel)
Utilisez FileZilla ou WinSCP :
- Source : connectez-vous au SFTP de l'ancien hébergeur
- Destination : connectez-vous au SFTP Wisp (panel.verycloud.fr → Server → SFTP Details) ou au VPS
Téléchargez tout en local, puis re-uploadez. Plus lent mais marche partout.
Méthode 3 : rsync (le plus rapide pour gros volumes)
rsync -avz --progress \
--exclude='logs' --exclude='cache' \
root@SERVER_SOURCE:/chemin/serveur/ \
/home/minecraft/server/
Étape 5 : Extraire et restaurer
Sur la destination :
cd ~/server
tar -xzf /tmp/minecraft-backup.tar.gz
chown -R minecraft:minecraft .
Étape 6 : Adapter la configuration
server.properties
nano ~/server/server.properties
Vérifiez :
server-ip=
server-port=25565
max-players=20
view-distance=10
motd=Bienvenue sur \u00a7b\u00a76VeryCloud
Laissez server-ip= vide (l'IP du VPS sera utilisée).
Permissions LuckPerms (ou autre)
Si vous utilisez LuckPerms, vos données sont dans MySQL ou SQLite. Si SQLite, le fichier luckperms-h2-v2.mv.db doit avoir été transféré. Si MySQL, exportez la base et importez-la :
# Sur source
mysqldump -u user -p luckperms_db > luckperms.sql
# Sur destination
mysql -u user -p luckperms_db < luckperms.sql
Puis adaptez la chaîne de connexion dans plugins/LuckPerms/config.yml.
EssentialsX, EconomyAPI, etc.
La plupart des plugins stockent leurs données dans plugins/NomDuPlugin/. Vérifiez que ces dossiers ont bien été copiés.
Étape 7 : Adapter le script de lancement
Créez un script de démarrage avec les bonnes options JVM :
nano ~/server/start.sh
#!/bin/bash
cd "$(dirname "$0")"
java -Xms4G -Xmx8G \
-XX:+UseG1GC \
-XX:+ParallelRefProcEnabled \
-XX:MaxGCPauseMillis=200 \
-XX:+UnlockExperimentalVMOptions \
-XX:+DisableExplicitGC \
-XX:+AlwaysPreTouch \
-XX:G1NewSizePercent=30 \
-XX:G1MaxNewSizePercent=40 \
-XX:G1HeapRegionSize=8M \
-XX:G1ReservePercent=20 \
-XX:G1HeapWastePercent=5 \
-XX:G1MixedGCCountTarget=4 \
-XX:InitiatingHeapOccupancyPercent=15 \
-XX:G1MixedGCLiveThresholdPercent=90 \
-XX:G1RSetUpdatingPauseTimePercent=5 \
-XX:SurvivorRatio=32 \
-XX:+PerfDisableSharedMem \
-XX:MaxTenuringThreshold=1 \
-Dusing.aikars.flags=https://mcflags.emc.gs \
-Daikars.new.flags=true \
-jar server.jar nogui
Ces flags JVM (les "Aikar's flags") sont reconnus pour optimiser drastiquement les serveurs Minecraft.
chmod +x start.sh
Étape 8 : Premier démarrage
cd ~/server
./start.sh
Surveillez la console : tous les plugins doivent démarrer en Enabled. Les worlds doivent se charger sans erreur.
Connectez-vous avec votre client Minecraft : IP_DESTINATION:25565.
Vérifiez :
- Votre personnage retrouve sa position, son inventaire, sa hotbar
- Les coffres remplis sont intacts
- Les permissions admin / OP fonctionnent
- Les plugins répondent (
/help,/plot info,/money, etc.)
Étape 9 : Configurer le service systemd (sur VPS)
sudo nano /etc/systemd/system/minecraft.service
[Unit]
Description=Minecraft Server
After=network.target
[Service]
Type=forking
User=minecraft
WorkingDirectory=/home/minecraft/server
ExecStart=/usr/bin/screen -dmS minecraft /home/minecraft/server/start.sh
ExecStop=/usr/bin/screen -S minecraft -X stuff "say Arr\u00eat dans 10 secondes...^Mstop^M"
TimeoutStopSec=30
Restart=on-failure
RestartSec=10
[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable --now minecraft
Accéder à la console live :
sudo -u minecraft screen -r minecraft
Étape 10 : Mettre à jour le DNS
Si vous avez un domaine type play.votre-serveur.com, mettez à jour l'enregistrement :
A play.votre-serveur.com → IP_VPS_VERYCLOUD
Pour utiliser un port non-standard sans le forcer aux joueurs, créez un SRV record :
SRV _minecraft._tcp.play.votre-serveur.com → 0 5 25565 play.votre-serveur.com
Dépannage
"Outdated server"
La version du .jar ne correspond pas à votre client. Téléchargez la version exacte de votre serveur source.
Plugins ne démarrent pas
[ERROR] Could not load 'plugins/PluginX.jar'
Cause classique : la version du plugin n'est pas compatible avec Paper/Spigot 1.21. Téléchargez la dernière version sur SpigotMC / Modrinth.
Worlds corrompus
Si vous avez transféré le world serveur tournant, il peut être corrompu. Sauvegardez et utilisez MCAselector pour réparer les chunks endommagés.
Lag important
Vérifiez la RAM allouée (-Xmx). Minecraft moderne aime avoir 4 GB minimum. Pour 20 joueurs : 6-8 GB.
Inspectez les ticks :
# Dans la console
/tps
20.0 = optimal. Inférieur à 18 = lag perceptible.
Commandes utiles
# Console live (VPS)
sudo -u minecraft screen -r minecraft
# Sortir sans tuer : Ctrl+A puis D
# Logs en direct
tail -f ~/server/logs/latest.log
# Sauvegarde rapide
tar -czf backup-$(date +%F).tar.gz ~/server/world ~/server/world_nether ~/server/world_the_end
# Espace disque utilisé
du -sh ~/server/*
# Liste des plugins
ls ~/server/plugins/*.jar
Conclusion
Votre serveur Minecraft est migré sans perte. Pour aller plus loin :
- Configurez des sauvegardes automatiques quotidiennes (cron + tar)
- Installez un anti-cheat (Vulcan, Matrix) si le serveur est public
- Si vous gérez plusieurs serveurs (lobby, survie, créatif), passez sur un proxy Velocity/BungeeCord
VeryCloud propose un service de migration gratuit sur les offres Minecraft Wisp et VPS Gaming : ouvrez un ticket pour qu'on s'en occupe.
Ressources
- Aikar's flags expliqués : https://docs.papermc.io/paper/aikars-flags
- PaperMC : https://papermc.io
- Wisp Panel : https://panel.verycloud.fr
- Outil de validation worlds : https://github.com/Querz/mcaselector


















