Configurer Paper Minecraft pas à pas — guide complet 2026

Paper est le logiciel serveur Minecraft le plus utilisé au monde. Il surpasse Vanilla et Spigot en performances, intègre des centaines de corrections de bugs et offre une configuration granulaire via plusieurs fichiers YAML. Ce guide vous accompagne dans la configuration complète de Paper, de l'installation à l'optimisation avancée.

Configuration d'un serveur Paper Minecraft via le panel OnPowered

Prérequis : installer Paper sur votre serveur

Avant de configurer, assurez-vous d'avoir Paper actif sur votre serveur. Depuis le panel panel.onpowered.net :

Ouvrez votre serveur → onglet Versions
Sélectionnez Paper + la version Minecraft cible (1.21.x recommandé)
Cliquez Installer et attendez le redémarrage automatique
Vérifiez dans la console : la ligne This server is running Paper confirme l'installation

Au premier démarrage, Paper génère automatiquement tous ses fichiers de configuration dans le répertoire racine du serveur.

Vue d'ensemble des fichiers de configuration Paper

Fichier	Rôle	Priorité
`server.properties`	Paramètres fondamentaux (port, gamemode, monde)	⭐⭐⭐
`paper-global.yml`	Paramètres globaux Paper (async chunks, anti-exploit)	⭐⭐⭐
`paper-world-defaults.yml`	Comportement du monde (mob spawning, redstone)	⭐⭐⭐
`spigot.yml`	Paramètres Spigot hérités (mob ranges, view distance)	⭐⭐
`bukkit.yml`	Paramètres Bukkit (spawn limits, ticks per animal)	⭐

server.properties — les paramètres essentiels

C'est le premier fichier à configurer. Voici les paramètres les plus importants :

# Nombre de joueurs maximum
max-players=20

# Distance d'affichage en chunks (8-10 recommandé pour économiser la RAM)
view-distance=8

# Distance de simulation des entités (toujours ≤ view-distance)
simulation-distance=6

# Mode de jeu par défaut (survival, creative, adventure, spectator)
gamemode=survival

# Difficulté (peaceful, easy, normal, hard)
difficulty=normal

# Whitelist (true = serveur privé, false = ouvert)
white-list=false

# IMPORTANT : mettre à true si vous utilisez un proxy Velocity/BungeeCord
online-mode=true

💡 Règle d'or : simulation-distance est le paramètre qui impacte le plus les performances. Sur un serveur avec 4 Go de RAM et 10 joueurs, commencez à 4-5. Vous pouvez augmenter progressivement selon l'utilisation CPU.

paper-world-defaults.yml — optimisations du monde

C'est le fichier de configuration principal de Paper. Voici les clés à modifier en priorité :

chunks:
  # Génération async des chunks (TOUJOURS true)
  auto-save-interval: 6000  # Sauvegarde toutes les 5 min (en ticks)

entities:
  spawning:
    # Réduire pour économiser le CPU sur les serveurs chargés
    spawn-limits:
      monsters: 50      # Défaut Paper : 70
      animals: 8        # Défaut : 10
      water-animals: 3

misc:
  # Désactiver les features inutiles sur les serveurs sans mods
  disable-teleportation-suffocation-check: false

# Comportement des mobs (optimisation importante)
mobs:
  # Évite que les mobs parcourent de grandes distances inutilement
  despawn-ranges:
    soft: 28
    hard: 96

paper-global.yml — paramètres anti-exploit

Paper intègre des protections contre les exploits Vanilla. Ces paramètres sont actifs par défaut, mais voici ceux à vérifier :

anti-xray:
  # Activer l'anti-xray côté serveur (recommandé)
  enabled: true
  engine-mode: 2  # Mode 2 = remplacement aléatoire (plus efficace)

packet-limiter:
  # Limite le flood de paquets réseau (anti-lag malveillant)
  max-packet-rate: 500.0

async-chunks:
  # Génération et chargement async des chunks
  threads: -1  # -1 = automatique (recommandé)

spigot.yml — distance des mobs et du spawn

world-settings:
  default:
    mob-spawn-range: 6        # Rayon de spawn des mobs (défaut : 8)
    entity-activation-range:
      animals: 16             # Distance d'activation des animaux
      monsters: 32            # Distance d'activation des monstres
      misc: 16
    merge-radius:
      item: 2.5               # Fusionne les items proches (évite les entités multiples)
      exp: 3.0

Vérifier les performances après configuration

Après chaque modification, surveillez les TPS (Ticks Per Second) de votre serveur. Un serveur sain tourne à 20 TPS stables.

Commandes utiles depuis la console du panel :

/tps — affiche les TPS des 1, 5 et 15 dernières minutes. Cible : 19.8+
/mspt — millisecondes par tick. Cible : <25ms à 20 TPS. Si >50ms = lag
/paper heap — analyse la mémoire Java utilisée
/chunklimit — nombre de chunks chargés par joueur

✅ Configuration recommandée pour un départ : view-distance=8, simulation-distance=5, spawn-limits monsters=50. Ajustez selon vos TPS réels après 30 minutes de jeu avec des joueurs connectés.

Foire aux questions

Quelle version de Paper choisir en 2026 ?
Paper sort une version stable pour chaque version Minecraft peu après sa sortie. En 2026, Paper 1.21.x est la version recommandée — c'est la plus supportée avec le plus de plugins compatibles. Évitez les versions 1.8-1.12 sauf si vous gérez un serveur PvP legacy (beaucoup de joueurs nostalgiques l'exigent).

Faut-il redémarrer le serveur après chaque modification YAML ?
Oui pour la plupart des changements (world-defaults, global). Certains plugins permettent un /reload confirm mais ce n'est pas recommandé en production — préférez un redémarrage complet depuis le panel Pterodactyl.

Paper est-il compatible avec les plugins Spigot et Bukkit ?
Oui, à 100%. Paper est une fourche de Spigot, lui-même basé sur Bukkit. Tous les plugins compatibles Spigot/Bukkit fonctionnent avec Paper — et Paper offre en plus ses propres APIs pour des plugins encore plus performants.

Puis-je utiliser Paper avec des mods Forge ou Fabric ?
Non. Paper ne supporte pas les mods Forge/Fabric — il supporte uniquement les plugins (.jar Bukkit). Si vous voulez à la fois des mods et des plugins, explorez Mohist (Forge+Bukkit) ou Quilt (Fabric), mais ces solutions sont moins stables.

Articles liés

Publié le 8 juillet 2026 par l'Équipe OnPowered — hébergeur belge de serveurs Minecraft et VPS.