Contexte
PowerNukkitX se distingue comme une solution logicielle de pointe hautement performante pour propulser un serveur Minecraft Bedrock Edition. Afin de piloter efficacement votre communauté et de garantir la pérennité structurelle de votre instance, la maîtrise des commandes système et d'administration s'avère indispensable.
Ce guide répertorie les commandes fondamentales du moteur PowerNukkitX indispensables à la gestion de votre infrastructure hébergée chez Winheberg. Qu'il s'agisse de modérer les comportements disruptifs, d'altérer l'environnement en temps réel ou d'exécuter des diagnostics de maintenance, ces instructions peuvent être saisies directement depuis le chat textuel en jeu ou via votre console de contrôle.
Prérequis
- Une instance de jeu active initialisée sous l'environnement PowerNukkitX.
- Un accès fonctionnel à votre panel de gestion sur panel.winheberg.com.
- L'attribution des privilèges d'opérateur (statut OP) si vous prévoyez d'exécuter ces directives depuis l'interface client en jeu.
1. Gestion des joueurs et modération
La sécurité et l'intégrité de votre espace applicatif reposent sur des outils de modération robustes. Le tableau ci-dessous synthétise les syntaxes requises pour restreindre ou accorder l'accès à votre serveur.
| Commande | Syntaxe et action système |
|---|---|
/kick |
/kick <player: selection> [reason: message] Interrompt immédiatement la session d'un joueur et le déconnecte. |
/ban |
/ban <player: id> [reason: id] Réalise une exclusion définitive du profil utilisateur ciblé. |
/ban-ip |
/ban-ip <ip: id> [reason: id] ou /ban-ip <player: id> Restreint définitivement l'accès à l'adresse réseau IP associée. |
/pardon |
/pardon <player: selection> Réhabilite un utilisateur en annulant son bannissement nominatif. |
/pardon-ip |
/pardon-ip <ip: id> Révoque la restriction d'accès réseau appliquée sur une adresse IP. |
/whitelist |
/whitelist <add|remove> <player: selection> Ajoute ou retire un profil de la liste d'accès exclusive. |
/whitelist |
/whitelist <on|off|list|reload> Altere l'état global, liste les membres ou recharge la configuration de la liste blanche. |
/op |
/op <player: selection> Élève les privilèges d'un joueur au rang d'administrateur (opérateur). |
/deop |
/deop <player: selection> Destitue un joueur de ses privilèges d'opérateur système. |
2. Contrôle du monde et de l'environnement
PowerNukkitX intègre des commandes avancées pour manipuler la gestion climatique, les repères temporels ainsi que la topologie multi-mondes de votre infrastructure.
| Commande | Syntaxe et action système |
|---|---|
/world list |
/world list Indexe et affiche l'ensemble des dimensions et mondes actuellement chargés en mémoire vive. |
/world tp |
/world <tp> <world|world_the_nether|world_the_end> Transfère instantanément votre positionnement d'une dimension à une autre. |
/time set |
/time <set> <day|night|midnight|noon|sunrise|sunset> Altere immédiatement l'état de l'horloge interne de la partie. |
/weather |
/weather <clear|rain|thunder> [duration: int] Modifie les conditions météorologiques et fixe leur persistance en secondes. |
/tickingarea |
/tickingarea <add> <from: position> <to: position> [name: id] Force le chargement et le calcul permanent d'une zone géographique définie. |
La commande /tickingarea est particulièrement recommandée pour pérenniser l'activité de vos systèmes automatisés complexes (fermes industrielles, systèmes Redstone globaux) même en l'absence physique de joueurs dans la zone.
3. Commandes de gameplay et de personnalisation
Ces variables modifient l'expérience immédiate des utilisateurs connectés ou altèrent les lois physiques par défaut du moteur Minecraft.
| Commande | Syntaxe et action système |
|---|---|
/gamemode |
/gamemode <survival|creative|spectator> [player: selection] Modifie instantanément le mode de jeu alloué à un utilisateur. |
/gamerule |
/gamerule <règle> <true|false> Permet d'activer ou désactiver des règles fondamentales ( domobspawning, dofiretick, etc.). |
/give |
/give <player: selection> <itemName> [amount: int] Injecte une quantité définie d'un item spécifique dans l'inventaire de la cible. |
/tp |
/tp <victim: selection> <destination: selection> Déplace un utilisateur vers les coordonnées exactes d'une autre entité. |
/camera |
/camera <players: selection> <clear|fade|set> Manipule la perspective ou applique des fondus visuels sur l'écran d'un joueur en temps réel. |
4. Diagnostics et maintenance du système
Pour garantir une fluidité d'exécution irréprochable, nos ingénieurs vous invitent à surveiller régulièrement l'état de charge de vos ressources matérielles.
| Commande | Syntaxe et action système |
|---|---|
/status |
/status [full|simple|tps] Génère un rapport analytique de l'usage CPU/RAM et remonte le taux précis de TPS (Ticks Per Second). |
/plugins |
/plugins Dresse l'inventaire complet des extensions Java .jar chargées par le noyau PowerNukkitX. |
/save-all |
/save-all Force l'écriture synchrone immédiate des données du monde sur le stockage NVMe de l'hôte. |
/stop |
/stop Termine proprement le processus du serveur après avoir correctement purgé et fermé les sessions actives. |
Avant toute opération de maintenance majeure ou avant d'initier une sauvegarde manuelle, exécutez impérativement la commande /save-all pour exclure tout risque de corruption ou de perte de données volatiles.
En cas de problème
❌ Message d'erreur : « You do not have permission to use this command »
- Origine : Les droits OP ne sont pas ou mal affectés à votre profil.
- Résolution : Connectez-vous sur votre panel panel.winheberg.com, accédez à l'onglet Console et saisissez la commande suivante (sans le caractère
/) :op VotrePseudoExact
❌ Message d'erreur : « Player not found »
- Origine : Le pseudonyme est erroné, l'utilisateur est hors-ligne, ou son identifiant comporte des caractères spéciaux/espaces.
- Résolution : Si le pseudonyme contient un espace, vous devez impérativement l'isoler au sein de guillemets doubles dans votre syntaxe :
/give "Pseudo Avec Espace" apple 64
Bonnes pratiques d'administration
- Sécurisation des bases de données : Prenez le réflexe d'exécuter un
/save-allavant de couper votre instance pour figer les inventaires et l'état des chunks. - Préservation des ressources matérielles : Utilisez la directive
/tickingareaavec parcimonie. Multiplier les zones chargées en permanence sature l'usage processeur et dégrade les TPS globaux du serveur. - Clarté des journaux d'événements : Configurez la règle
/gamerule commandblockoutput falsepour empêcher les blocs de commande d'inonder votre console web et vos fichiers logs de lignes répétitives inutiles.
Besoin d'aide ?
Si vous rencontrez des dysfonctionnements persistants lors de l'exécution de vos commandes système ou si des instabilités apparaissent après le chargement d'une extension Java, nos équipes d'assistance sont à votre service.
Vous pouvez soumettre un ticket d'assistance auprès de notre département Technique depuis votre espace client sur billing.winheberg.com en prenant soin de lier votre abonnement PowerNukkitX pour une prise en charge personnalisée.
Bonne configuration et d'excellents moments de jeu sur votre infrastructure Winheberg ! 🎮
