Contexte
Au sein d'un environnement PocketMine-MP, la régulation des connexions simultanées constitue un pilier fondamental de l'administration réseau et de la gestion des performances infrastructurelles. Le nombre maximal d'utilisateurs pouvant se connecter de manière concomitante est déterminé par une directive de configuration simple mais hautement critique.
L'ajustement de ce paramètre vous permet de corréler efficacement la charge réseau et l'allocation des ressources matérielles (CPU/RAM) à la formule de votre hébergement de jeu Winheberg ou de votre serveur VPS.
Localiser le fichier de configuration
L'intégralité des directives globales régissant votre instance PocketMine-MP est centralisée dans un unique document texte de configuration :
server.properties
Ce fichier se situe à la racine de votre répertoire de stockage (/). Pour y accéder et altérer ses variables de configuration, deux méthodes s'offrent à vous :
- Le Gestionnaire de fichiers : Accessible directement depuis l'interface web de votre panel.winheberg.com.
- Une liaison SFTP tierce : En utilisant un client spécialisé tel que FileZilla ou WinSCP.
Modifier le nombre maximum de joueurs : Guide pas à pas
Appliquez rigoureusement les étapes suivantes afin de redimensionner vos emplacements de connexions (slots) tout en prévenant les risques d'incohérence ou de perte de données.
1. Interrompre le processus du serveur
Avant toute édition d'un fichier système ou de configuration, vous devez impérativement stopper l'exécution de votre instance de jeu. Si le processus reste actif en arrière-plan, le moteur PocketMine-MP écrasera automatiquement vos modifications lors de son prochain cycle d'écriture ou lors de l'extinction du serveur.
2. Éditer le fichier server.properties
Ouvrez le document à l'aide de l'éditeur de texte intégré à votre panel ou via un environnement de développement local (tel que VS Code ou Notepad++). Localisez la directive max-players. Par défaut, l'instruction se présente sous la forme suivante :
max-players=20
3. Ajuster la valeur numérique
Remplacez la valeur entière par défaut par le seuil restrictif que vous souhaitez imposer à votre infrastructure applicative :
- Configuration privée ou restreinte (Staff / Tests) :
max-players=10 - Configuration communautaire standard :
max-players=50 - Infrastructure optimisée à forte charge :
max-players=100
4. Sauvegarder les modifications
Si vous utilisez l'éditeur web du panel Winheberg, validez vos changements en cliquant sur le bouton Save Content ou utilisez le raccourci clavier standard Ctrl + S (Cmd + S sous macOS). En cas de transfert SFTP, veillez à téléverser et écraser le fichier sur votre espace distant.
5. Initialiser le serveur
Retournez dans l'onglet Console de votre panel de gestion et cliquez sur le bouton de démarrage. Vos modifications sont instantanément appliquées par le noyau et deviennent visibles depuis le menu d'indexation des serveurs sur l'interface client de Minecraft Bedrock.
Allocation des ressources et performances
L'augmentation artificielle de la variable max-players ne garantit en aucun cas que vos ressources matérielles pourront absorber l'afflux d'utilisateurs sans dégradation des performances (TPS drop ou lag).
Chaque profil connecté génère de manière continue des calculs d'entités, des requêtes de rafraîchissement réseau et des allocations de segments de carte (chunks). Les performances réelles de votre instance dépendent des facteurs critiques suivants :
| Composant / Facteur d'impact | Rôle et influence sur la charge système |
|---|---|
| Processeur (CPU) | Élément critique affecté par le calcul de la physique en jeu, des entités (mobs/projectiles) et de la logique synchrone des plugins. |
| Mémoire vive (RAM) | Requise pour maintenir les chunks chargés en mémoire et traiter les banques de données temporaires (sessions joueurs). |
| Extensions (Plugins) | Des scripts lourds, obsolètes ou mal optimisés réduisent drastiquement la capacité d'accueil brute de la machine. |
| Optimisation de la carte | La distance d'affichage (view-distance) multiplie de manière exponentielle l'usage CPU/RAM par joueur connecté. |
En cas de problème
❌ Le nombre de slots revient à sa valeur par défaut au démarrage
- Échec d'extinction du processus : Le serveur n'était pas totalement arrêté lors de l'édition du fichier. Utilisez le bouton Stop de la console, attendez la fin d'exécution du processus d'arrière-plan, puis rééditez le fichier
server.properties. - Erreur de syntaxe : Assurez-vous qu'aucun espace n'est présent autour du signe
=et qu'aucun caractère alphabétique n'a été inséré (ex: saisissezmax-players=50et nonmax-players = 50 slots).
❌ Le serveur subit de lourds ralentissements lorsque la limite est atteinte
- Saturation matérielle : Votre formule d'hébergement ou votre configuration actuelle de plugins ne permet pas de supporter une telle charge. Réduisez le paramètre
max-playersou optimisez vos fichiers de configuration moteur généraux (pocketmine.yml).
Bonnes pratiques d'administration
- Échelonnement progressif : Nous vous recommandons d'augmenter le nombre de slots de manière incrémentale (par paliers de 5 à 10 places) afin d'analyser l'impact de l'afflux sur les graphiques d'utilisation CPU et RAM du panel Winheberg.
- Corrélation avec la View Distance : Si vous augmentez significativement le nombre de joueurs max, réduisez proportionnellement la variable
view-distancedans vos fichiers de configuration pour limiter le volume de chunks chargés simultanément. - Points de restauration système : Prenez le réflexe de générer une sauvegarde manuelle via l'onglet Backups avant d'altérer vos fichiers de configuration afin de pouvoir restaurer rapidement votre environnement en cas de mauvaise manipulation.
Besoin d'aide ?
La régulation du paramètre max-players demeure le mécanisme le plus direct pour prémunir votre architecture PocketMine-MP contre les surcharges système. Trouver le point d'équilibre optimal garantira une expérience de jeu fluide pour votre communauté.
Si vos modifications ne sont pas prises en compte ou si vous rencontrez des difficultés de dimensionnement, nos équipes de techniciens restent à votre disposition. Vous pouvez soumettre un ticket d'assistance auprès de notre département Technique depuis votre espace client sur billing.winheberg.com en rattachant votre abonnement PocketMine-MP pour une expertise personnalisée.
Bonne administration et bon jeu sur votre infrastructure Winheberg ! 🎮
