Migrer un serveur Minecraft vers VeryCloud

Migrer un serveur Minecraft vers VeryCloud

Déplacez un serveur Minecraft (Vanilla, Paper, Spigot, Forge, Fabric ou modpack) depuis un autre hébergeur vers un VPS ou panel Wisp VeryCloud sans perte de progression. Worlds, plugins, configs et permissions inclus.

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

Rejoignez notre serveur communautaire Discord

Pour toute question, suggestion ou simplement pour discuter avec la communauté, rejoignez-nous sur Discord !

900+Membres