Aller au contenu
+90 850 303 07 52 [email protected]
Assistance Espace client
Sur une sélection d'offres d'hébergement annuelles et de VDS sur 3 mois, nom de domaine .com / .com.tr offert la première année · Voir les offres

Guides

Des guides pas à pas pour installer et gérer votre propre serveur, serveur de jeu ou site web, rédigés par l'équipe qui exploite notre infrastructure à Istanbul.

Minecraft

Qu'est-ce que Purpur et comment l'installer ? Migration depuis Paper et réglages de purpur.yml

26 août 2026 14 min de lecture Mis à jour :
Partager cet article

Purpur est un logiciel de serveur Minecraft Java basé sur Paper, qui permet d'ajuster finement le gameplay grâce au fichier purpur.yml. Dans ce guide, vous verrez en quoi Purpur diffère de Paper, comment télécharger le fichier JAR et démarrer un nouveau serveur, comment passer votre serveur Paper existant à Purpur sans perdre votre monde, ainsi que les principaux réglages, les permissions et la compatibilité des plugins. Une comparaison générale des logiciels de serveur se trouve dans le guide Vanilla, Spigot, Paper, Purpur et Folia : lequel choisir ?, et les autres sujets sur la page Guides Minecraft.

Avant de commencer

  • Un VDS sous Windows ou Linux. Comme Purpur fonctionne comme Paper avec les réglages par défaut, ses besoins matériels sont les mêmes que ceux de Paper ; pour Minecraft, ce qui compte, c'est la version de Java et la RAM. Les offres se trouvent sur la page Location de serveur Minecraft. Si vous n'avez pas encore choisi de système d'exploitation, consultez le guide Windows ou Linux pour un serveur Minecraft ?.
  • La bonne version de Java. La page d'installation de Purpur renvoie au guide de démarrage de Paper. D'après le tableau de Paper, Java 17 est recommandé pour Minecraft 1.17–1.19, Java 21 pour 1.20–1.21.11 et Java 25 pour 26.1 et les versions suivantes. Vérifiez la version installée avec java -version ; l'installation de Java et l'écriture des scripts de démarrage sont expliquées dans le guide Comment installer un serveur Minecraft à partir de zéro.
  • Une sauvegarde complète. Si vous comptez migrer, copiez l'intégralité du dossier du serveur (mondes, dossier plugins et fichiers de configuration). Sur un VDS, les sauvegardes sont sous votre responsabilité ; vous pouvez transférer la copie en SFTP vers un stockage extérieur au serveur, comme l'espace de sauvegarde cloud.
  • La version et la liste des plugins. Notez la version de Minecraft que vous utilisez actuellement ainsi que vos plugins.
  • Un port ouvert. Le port TCP 25565, auquel se connectent les joueurs, doit être ouvert dans le pare-feu du système d'exploitation ; la marche à suivre figure dans le guide Comment ouvrir les ports d'un serveur Minecraft (25565, 19132, proxy).

1. Comprendre ce qui distingue Purpur de Paper

Purpur est un fork de Paper ; sa propre documentation le présente comme un remplaçant direct (drop-in) de Paper qui ne demande aucune modification. Comme il s'agit d'un fork, il reprend toutes les fonctionnalités et les correctifs de performances de Paper, ainsi que le profileur spark, intégré depuis la 1.21. D'après la FAQ de Purpur, aucune des modifications qu'il apporte ne prend effet tant que vous ne l'activez pas dans purpur.yml ; si vous ne touchez pas à ce fichier, faire tourner Purpur ne diffère en rien de Paper.

En bref, Purpur n'est pas « un Paper plus rapide », mais un Paper avec davantage de réglages. Si vous passez à Purpur uniquement pour augmenter les TPS (ticks par seconde), vous ne verrez aucune différence avec les réglages par défaut.

SujetPaperPurpur
BaseFork de SpigotFork de Paper
Fichiers de configurationserver.properties, bukkit.yml, spigot.yml, config/paper-global.yml, config/paper-world-defaults.ymlTous les fichiers de Paper, plus purpur.yml dans le répertoire racine
Gameplay par défautComportement de PaperIdentique à Paper ; les différences apparaissent quand vous les activez dans purpur.yml
Commandes ajoutées par Purpur—/purpur, /tpsbar, /rambar, /ram, /uptime, /ping, /compass, /credits, /demo
API pour les pluginsBukkit, Spigot, PaperL'API Purpur en plus de celles-ci
Permissions supplémentaires—Par exemple allow.ride.<mob> ; désactivées par défaut, même pour les OP (opérateurs)
TéléchargementPage de téléchargement de PaperMCpurpurmc.org/downloads et api.purpurmc.org

2. Choisir entre Purpur et Paper

Votre situationRecommandation
Un serveur survie, mini-jeux ou économie avec des plugins ; vous voulez garder un gameplay proche de VanillaPaper suffit.
Vous voulez des changements de gameplay, comme des mobs que l'on peut chevaucher, un coffre de l'Ender à six rangées ou des générateurs de monstres (spawners) que l'on peut miner avec Toucher de soie (Silk Touch)Purpur
Vous voulez désactiver l'IA des villageois qui ne peuvent pas bouger dans des halls d'échange bondésPurpur (le réglage lobotomize)
Vous voulez annoncer les joueurs absents (AFK) au lieu de les expulserPurpur
Vous voulez passer tout de suite à une nouvelle version de MinecraftPurpur étant un fork de Paper, les builds pour une nouvelle version arrivent après ceux de Paper ; toutes les versions mineures n'ont pas non plus de build (il n'y en a pas pour 1.20.3 ni 1.20.5). Si votre version ne figure pas sur la page de téléchargement, restez sur Paper.

3. Télécharger le fichier JAR de Purpur

Téléchargez Purpur uniquement depuis la source officielle : la page purpurmc.org/downloads ou l'API de téléchargement qu'utilise cette page. Sur la page, vous pouvez sélectionner la version et télécharger le dernier build ; n'utilisez pas les builds marqués « Experimental » sur un serveur en production. Les adresses de l'API sont les suivantes :

  • https://api.purpurmc.org/v2/purpur : liste les versions de Minecraft pour lesquelles il existe des builds.
  • https://api.purpurmc.org/v2/purpur/<version> : liste les numéros de build de cette version.
  • https://api.purpurmc.org/v2/purpur/<version>/latest/download : télécharge le dernier build de cette version. Sur une nouvelle version, ce build peut être expérimental ; si vous ouvrez l'adresse sans /download et voyez "type": "experimental", attendez un build stable.

Sous Linux, créez le dossier du serveur et téléchargez le fichier sous le nom purpur.jar (l'exemple utilise la version 26.2 ; indiquez votre propre version) :

mkdir ~/purpur
cd ~/purpur
curl -o purpur.jar https://api.purpurmc.org/v2/purpur/26.2/latest/download

Sous Windows, créez un dossier comme C:\purpur, ouvrez PowerShell dans ce dossier et exécutez la commande suivante ; -UseBasicParsing évite la demande de confirmation de sécurité de Windows PowerShell 5.1 :

Invoke-WebRequest -UseBasicParsing -Uri https://api.purpurmc.org/v2/purpur/26.2/latest/download -OutFile purpur.jar

Un fichier téléchargé avec un navigateur porte la version et le numéro de build dans son nom, sous la forme purpur-26.2-2633.jar ; utilisez ce nom dans la commande de démarrage ou renommez le fichier en purpur.jar.

4. Démarrer un nouveau serveur Purpur

Si vous partez de zéro, placez le fichier purpur.jar dans un dossier vide et exécutez la commande suivante dans ce même dossier ; la commande est identique sous Windows PowerShell et sous Linux :

java -Xms4G -Xmx4G -jar purpur.jar --nogui

-Xms et -Xmx définissent la mémoire allouée au serveur, tandis que --nogui empêche l'ouverture d'une fenêtre graphique séparée. Paper recommande de garder ces deux valeurs identiques et de retirer environ 1000–1500 Mo de la mémoire totale du serveur (par exemple 6500 Mo sur un serveur de 8 Go) ; les détails se trouvent dans le guide Comment allouer de la RAM à un serveur Minecraft : Xms, Xmx et flags d'Aikar.

Au premier lancement, le serveur crée le fichier eula.txt puis s'arrête. Acceptez l'EULA de Minecraft en remplaçant la ligne eula=false du fichier par eula=true, puis relancez la commande. Au démarrage du serveur, server.properties, bukkit.yml, spigot.yml, le dossier config/ et purpur.yml sont créés dans le répertoire racine. Purpur écrit toutes les options dans ce dernier fichier avec leurs valeurs par défaut. Pour vérifier le logiciel en cours d'exécution, tapez ceci dans la console :

purpur version

5. Migrer de Paper vers Purpur

  1. Prévenez les joueurs et arrêtez le serveur avec la commande stop dans la console. Le guide de mise à jour de Paper recommande de ne pas remplacer le JAR sur un serveur en marche.
  2. Faites une sauvegarde complète du dossier du serveur.
  3. Téléchargez le build de Purpur correspondant à la version de Minecraft que vous utilisiez sous Paper. Faites une éventuelle montée de version dans une étape séparée ; si vous changez de logiciel et de version en même temps, il devient plus difficile d'isoler l'origine d'un problème.
  4. Retirez le fichier JAR de Paper, placez le fichier JAR de Purpur et faites correspondre son nom à la commande de démarrage. Si votre script de démarrage indique paper.jar, remplacez ce nom par purpur.jar dans le script.
  5. Démarrez le serveur et lisez le journal du premier démarrage (logs/latest.log). Les mondes, les plugins et les réglages de Paper sont repris tels quels ; le seul nouveau fichier du répertoire racine est purpur.yml.

Si vous venez de Spigot ou de Vanilla, les règles de migration vers Paper s'appliquent, car Purpur utilise la structure de monde de Paper. Pour la 26.1 et les versions suivantes, la documentation de Paper indique qu'une migration directe depuis Spigot n'est pas possible ; la marche à suivre figure dans la section consacrée à la migration du guide Vanilla, Spigot, Paper, Purpur et Folia : lequel choisir ?.

Revenir à Paper consiste, là aussi, simplement à remplacer le JAR. En revanche, les fonctionnalités que vous avez activées dans purpur.yml et les plugins qui reposent uniquement sur l'API Purpur ne fonctionnent pas sous Paper. Par exemple, si vous avez activé le coffre de l'Ender à six rangées, Paper revient aux trois rangées standard ; avant de revenir en arrière, demandez aux joueurs de vider les rangées supplémentaires et gardez une sauvegarde à portée de main.

6. Comprendre la structure de purpur.yml

purpur.yml se trouve dans le répertoire racine du serveur et se compose de deux sections principales :

  • settings : les réglages généraux qui concernent tout le serveur (commandes, messages, réseau et certains blocs comme le coffre de l'Ender).
  • world-settings : les réglages par monde. Les valeurs placées sous default s'appliquent à tous les mondes qui n'ont pas leur propre section. Pour configurer différemment un seul monde, ouvrez une section portant le nom de ce monde au même niveau que default et n'y écrivez que les lignes que vous voulez modifier. Jusqu'à la 1.21.11 incluse, ce nom est celui du dossier du monde (par exemple world_nether) ; dans les versions 26.x, c'est la clé du monde (par exemple minecraft:the_nether). Lorsque vous mettez à jour depuis une ancienne version, Purpur renomme lui-même ces sections.

L'en-tête du fichier vous prévient d'ailleurs : certaines options modifient le gameplay. Changez un seul réglage à la fois et observez le résultat. La méthode sûre pour appliquer les modifications est de redémarrer le serveur. /purpur reload relit le fichier ; toutefois, à l'exécution, la commande affiche un avertissement indiquant que cette méthode n'est pas prise en charge, qu'elle peut causer des problèmes et qu'en cas de problème il faut redémarrer le serveur avec /stop. Pour suivre l'effet d'un réglage, la commande /tpsbar affiche en haut de l'écran une barre indiquant les TPS, le MSPT (millisecondes par tick) et le ping.

7. Accorder les permissions et vérifier la compatibilité des plugins

Les permissions de joueur ajoutées par Purpur (comme allow.ride.cow) sont, d'après la page des permissions, désactivées par défaut pour tout le monde, même pour les OP ; vous devez les accorder avec un plugin de permissions comme LuckPerms. Activez d'abord la fonctionnalité dans purpur.yml, puis accordez la permission. Pour donner la permission de chevaucher les vaches au groupe default, auquel appartiennent tous les joueurs dans LuckPerms, exécutez ceci dans la console :

lp group default permission set allow.ride.cow true

Les commandes de Purpur sont liées aux permissions bukkit.command.<command> (par exemple bukkit.command.tpsbar). Si Essentials (EssentialsX) est installé, il remplace les commandes /ping, /uptime et /compass par les siennes ; pour utiliser celles de Purpur, ajoutez ces commandes à la liste disabled-commands de la configuration d'Essentials.

D'après la FAQ de Purpur, les plugins CraftBukkit, Spigot et Paper fonctionnent sur Purpur ; une incompatibilité apparaît lorsque l'auteur d'un plugin limite sa prise en charge à CraftBukkit ou Spigot et ignore Paper et ses forks. L'installation d'un plugin se fait comme sous Paper : placez le fichier .jar dans le dossier plugins, redémarrez le serveur et tapez plugins dans la console. Les noms en vert sont les plugins activés ; les noms en rouge sont les plugins non activés (généralement ceux qui n'ont pas pu se charger). Si un plugin pose problème, essayez le même plugin sous Paper avec une copie du monde ; si le problème n'apparaît que sous Purpur, signalez-le sur la page GitHub ou le serveur Discord de Purpur.

Exemple de configuration : les principaux réglages de purpur.yml

Les valeurs proviennent de la référence de configuration de Purpur ; la colonne « Section » indique sous quelle rubrique principale se trouve le réglage.

SectionRéglagePar défautÀ quoi sert-il ?
settingsuse-alternate-keepalivefalseEnvoie au joueur une vérification de connexion (keepalive) chaque seconde et ne l'expulse que si aucune ne reçoit de réponse pendant 30 secondes ; un seul paquet perdu ne déconnecte pas le joueur.
settingstps-catchuptrueAprès une chute des TPS sous 20, fait tourner le serveur au-dessus de 20 pour maintenir la moyenne. D'après la documentation, cela a des effets secondaires, par exemple des mobs qui tuent le joueur d'un seul coup pendant le lag.
settingsblocks.ender_chest.six-rowsfalseAgrandit le coffre de l'Ender à six rangées.
world-settings.defaultmobs.<mob>.ridablefalsePermet de chevaucher le mob. Le joueur monte dessus avec Maj + clic droit ; nécessite la permission allow.ride.<mob>.
world-settings.defaultmobs.villager.lobotomize.enabledfalseDésactive l'IA des villageois qui ne peuvent pas bouger ; les échanges continuent de fonctionner. L'intervalle de vérification se règle avec check-interval (100 ticks par défaut).
world-settings.defaultgameplay-mechanics.player.idle-timeout.kick-if-idletrueSi la valeur est false, un joueur qui dépasse le temps d'inactivité défini dans server.properties par player-idle-timeout n'est pas expulsé, mais annoncé comme AFK. Si ce temps vaut 0 (valeur par défaut), le suivi AFK ne fonctionne pas.
world-settings.defaultgameplay-mechanics.silk-touch.enabledfalseLes générateurs de monstres peuvent être minés avec une pioche enchantée Toucher de soie ; nécessite les permissions purpur.drop.spawners et purpur.place.spawners.
world-settings.defaultgameplay-mechanics.use-better-mendingfalseL'enchantement Raccommodage (Mending) répare d'abord l'objet le plus endommagé.

L'exemple ci-dessous active certains de ces réglages. Comme les clés existent déjà dans le fichier, modifiez les valeurs existantes au lieu d'ajouter de nouvelles lignes :

settings:
  use-alternate-keepalive: true
  blocks:
    ender_chest:
      six-rows: true
world-settings:
  default:
    gameplay-mechanics:
      use-better-mending: true
      player:
        idle-timeout:
          kick-if-idle: false
    mobs:
      cow:
        ridable: true
      villager:
        lobotomize:
          enabled: true

Dans cet exemple, les joueurs qui ont la permission peuvent chevaucher les vaches et, si player-idle-timeout est supérieur à 0, les joueurs AFK sont annoncés au lieu d'être expulsés. Toutes les options sont listées sur la page de configuration de Purpur.

Erreurs fréquentes

  • Le serveur ne démarre pas et affiche l'erreur « Could not load purpur.yml, please correct your syntax errors ». L'indentation YAML est cassée. Indentez avec des espaces, pas avec des tabulations ; comparez la dernière ligne modifiée avec le fichier de votre sauvegarde, ou restaurez le fichier purpur.yml depuis la sauvegarde.
  • Le serveur s'arrête immédiatement avec une erreur Java (par ex. UnsupportedClassVersionError). La version de Java installée est trop ancienne pour la version de Purpur. Les versions 26.x exigent Java 25, et les versions 1.20–1.21.11 Java 21 ; vérifiez avec java -version.
  • Erreur « Unable to access jarfile purpur.jar ». Le nom du fichier ne correspond pas à celui de la commande ; un fichier téléchargé avec un navigateur contient la version et le numéro de build. Renommez le fichier.
  • ridable: true est défini, mais on ne peut pas chevaucher le mob. La permission manque. La permission allow.ride.<mob> est désactivée même pour les OP ; accordez-la avec LuckPerms et montez sur le mob avec Maj + clic droit.
  • Aucune annonce AFK n'apparaît, ou les joueurs sont toujours expulsés. La valeur de kick-if-idle doit être false et, dans server.properties, player-idle-timeout doit être supérieur à 0.

Questions fréquentes

Purpur est-il plus rapide que Paper ?

En général, non : la base de performances est celle de Paper et, tant que purpur.yml n'est pas modifié, Purpur fonctionne comme Paper. Certaines options, comme la désactivation de l'IA des villageois, visent des situations précises. Pour mesurer l'effet d'une modification, réalisez un profil de dix minutes avec spark, qui provient de Paper : /spark profiler start --timeout 600.

Puis-je revenir de Purpur à Paper ?

Oui, il suffit de placer le fichier JAR de Paper correspondant à la même version de Minecraft. Les fonctionnalités et les plugins propres à Purpur sont alors désactivés ; faites d'abord une sauvegarde.

Quel build de Purpur choisir ?

Choisissez le dernier build publié pour la version de Minecraft de votre serveur et n'utilisez pas les builds marqués comme expérimentaux sur un serveur en production. Purpur ne publie pas forcément de build pour chaque version ; vérifiez votre version sur la page de téléchargement ou dans la liste https://api.purpurmc.org/v2/purpur.

Que deviennent mes réglages Paper existants ?

Ils restent tels quels et continuent d'être utilisés. Les valeurs de config/paper-global.yml, config/paper-world-defaults.yml, spigot.yml et bukkit.yml s'appliquent aussi sous Purpur ; purpur.yml est une couche supplémentaire qui s'y ajoute.

Guides associés

Commentaires0

Pas encore de commentaire

Soyez le premier à partager votre avis.

Rejoignez la discussion

Veuillez vous connecter ou vous inscrire pour laisser un commentaire.

Ne manquez aucun article

Recevez nos derniers tutoriels, guides et actualités produit dans votre boîte de réception.

Votre abonnement à notre newsletter est confirmé.