Tester maintenant (serveurs de test Minecraft)
Jouez à votre plugin Minecraft, Skript ou datapack sur un serveur de test privé, depuis tout client de 1.8 à 26.3. Limites par offre et ce qui est conservé.
Mis à jour
Sur cette page
- Ce que vous pouvez tester
- Démarrer un serveur de test
- Le monde
- Les plugins dont votre plugin a besoin
- Une base de données pour votre plugin
- Limites par offre
- Accès au serveur
- Console, logs et performances
- Quand le serveur s'arrête tout seul
- Pendant que vous jouez
- Mettre à jour le projet
- Ce qui est conservé
- Isolation et sécurité
- Dépannage
Tester maintenant démarre un vrai serveur Minecraft avec votre projet installé, rien que pour vous. Vous le rejoignez depuis votre propre jeu, vous testez le plugin, le script ou le datapack, et le serveur disparaît tout seul quand le temps est écoulé.
#Ce que vous pouvez tester
| Projet | Serveur | Prérequis |
|---|---|---|
| Plugin Spigot / Paper (Java ou Kotlin) | Paper, sur la version de Minecraft choisie lors de la création du projet | Un Compiler réussi du code actuel |
| Skript | Paper 1.21.11 avec Skript et les add-ons pris en charge par Codexe | Au moins un fichier .sk |
| Datapack | Paper, sur la version pour laquelle le pack.mcmeta est prévu | Un pack.mcmeta |
Les mods Fabric et Forge, ainsi que les projets Folia et BungeeCord, ne peuvent pas encore être testés sur un serveur de test.
Les plugins et les projets Skript peuvent aussi être contrôlés par les joueurs de test de Codexe, depuis l'onglet Tests de la même fenêtre : consultez Tests avec des joueurs de test.
#Démarrer un serveur de test
Le serveur de test s'ouvre depuis le bouton Tester maintenant de la barre d'outils, depuis Testez-le maintenant dans Minecraft, gratuitement sous la dernière réponse de l'IA, et depuis la fenêtre de téléchargement (Démarrer le serveur de test), pour que vous puissiez tester un projet avant de le télécharger. Si les serveurs de test du jour sont épuisés, Codexe vous le dit et vous montre l'offre qui en propose davantage.
- Ouvrez le projet. Pour un plugin, appuyez d'abord sur Compiler : le serveur installe le jar compilé.
- Appuyez sur Tester dans Minecraft : sous la dernière réponse du chat (Testez-le maintenant dans Minecraft, gratuitement), dans la barre d'outils à côté de Compiler, et à côté de Télécharger le JAR après un build. C'est gratuit avec toutes les offres, y compris pour les projets que vous n'avez pas téléchargés : c'est la façon d'utiliser un projet avec l'offre Free sans téléchargement.
- Saisissez votre pseudo Minecraft et appuyez sur Démarrer le serveur de test. Ce pseudo est ajouté comme opérateur à votre liste Accès au serveur, et seuls les pseudos de cette liste peuvent rejoindre le serveur.
- Le bouton affiche Démarrage du serveur… pendant le démarrage, en général 20 à 40 secondes. Quand il indique Serveur en ligne avec le temps restant, l'adresse apparaît : votre temps ne commence qu'à ce moment-là.
- Dans Minecraft : Multijoueur, Connexion directe, et collez l'adresse, par exemple
swift-otter-27.codexe.eu. Aucun port n'est nécessaire. Si la fenêtre affiche un jour une adresse numérique avec un port à la place, collez-la exactement telle qu'elle apparaît.
Vous pouvez vous connecter depuis n'importe quelle version de Minecraft Java de 1.8 à 26.3, quelle que soit la version du serveur : chaque serveur de test a ViaVersion, ViaBackwards et ViaRewind installés.
#Le monde
La plupart des projets sont testés dans un monde plat sans structures : il démarre vite, et pour des caisses, des commandes, des menus ou des kits, le terrain n'a pas d'importance.
Quand le projet a besoin d'un vrai terrain, Codexe démarre plutôt le serveur avec un nouveau monde normal, avec biomes, montagnes, grottes et structures comme les villages et les avant-postes de pillards. Vous n'avez pas à le demander : Codexe lit le projet et décide. Par exemple, un datapack qui modifie la génération du monde (montagnes plus hautes, nouveaux biomes), ou un plugin qui agit sur les pics enneigés ou sur les avant-postes de pillards, obtient un monde normal ; un plugin de caisses reste en monde plat. Un datapack est installé avant la génération du monde, si bien que le terrain que vous voyez est le sien. Générer le monde allonge un peu le premier démarrage, et la console explique pourquoi un monde normal a été choisi.
#Les plugins dont votre plugin a besoin
Si votre plugin liste d'autres plugins dans son plugin.yml (depend et softdepend) ou son paper-plugin.yml, comme LuckPerms, Vault, PlaceholderAPI, WorldEdit, WorldGuard ou ProtocolLib, le serveur de test les installe pour vous, dans la version prévue pour sa version de Minecraft, avec ce dont ils ont eux-mêmes besoin. Ils proviennent de Modrinth et de Hangar.
La console indique ce qui a été installé. Les plugins payants (MythicMobs, ItemsAdder, Nexo...) ne peuvent pas être installés automatiquement : la console le signale, et un plugin qui en exige un ne s'activera pas sur le serveur de test.
#Une base de données pour votre plugin
Si votre plugin stocke ses données dans MySQL, le serveur de test lui donne sa propre base de données MySQL. Cela se fait tout seul quand le config.yml du plugin indique storage-type: mysql et contient la section mysql: habituelle (host, port, database, username, password) : le serveur de test crée la base de données, inscrit son adresse et un nouveau mot de passe dans cette section, puis démarre le serveur. La console indique quand c'est fait.
- Les plugins créés avec Codexe utilisent SQLite par défaut, un fichier qui ne demande aucune configuration. Demandez MySQL dans le chat si vous le voulez, et le plugin sera écrit avec
storage-type: mysql. - Seul votre propre plugin reçoit une base de données. Les plugins installés pour lui (LuckPerms et les autres ci-dessus) gardent leur stockage par défaut sur le serveur de test.
- La base de données est supprimée quand le serveur de test s'arrête, avec tout le reste. Elle peut contenir jusqu'à 200 MB : au-delà, le serveur s'arrête.
#Limites par offre
| Plan | Minutes per test server | Test servers per day | People on a test server |
|---|---|---|---|
| Free | 10 min | 3 | 2 |
| Pro | 15 min | 15 | 5 |
| Business | 20 min | 40 | 10 |
| Enterprise | 30 min | 100 | 20 |
Les minutes sont comptées à partir du moment où le serveur est prêt, pas à partir du moment où vous appuyez sur Démarrer. Un seul serveur de test par compte peut tourner à la fois. Quand tous les serveurs de test sont occupés, réessayez quelques minutes plus tard.
#Accès au serveur
Accès au serveur (dans le menu du compte, ou dans l'onglet Joueurs d'un serveur en cours d'exécution) est la liste des personnes autorisées à rejoindre vos serveurs de test. Le nombre de pseudos correspond à la valeur Personnes sur un serveur de test de l'offre, ci-dessus.
- Ajouter un pseudo Minecraft. Codexe le vérifie auprès de Mojang pour indiquer s'il s'agit d'un compte premium et afficher son visage ; les pseudos sans compte Mojang sont ajoutés comme joueurs hors ligne, et pour ceux-là l'orthographe exacte compte.
- Opérateur donne à ce joueur
/opsur le serveur. Vous pouvez l'activer et le désactiver à tout moment. - Retirer enlève un pseudo de la liste.
Les modifications atteignent en quelques secondes un serveur déjà en cours d'exécution, y compris le retrait d'une personne connectée ; sinon, elles s'appliquent au prochain serveur que vous démarrez. La liste indique aussi qui est connecté en ce moment et quand chaque personne s'est connectée pour la dernière fois.
#Console, logs et performances
Le panneau d'un serveur en cours d'exécution a trois onglets de plus :
- Console envoie des commandes Minecraft au serveur, comme le ferait la console du serveur, et affiche la réponse. Il s'agit uniquement de la console Minecraft : les commandes qui arrêtent ou rechargent le serveur, et celles qui modifient les opérateurs ou la liste blanche, sont refusées (utilisez Accès au serveur pour cela). Jusqu'à 10 commandes toutes les 10 secondes.
- Logs affiche le log du serveur en direct, avec les avertissements et les erreurs mis en évidence, et conserve la fin du log après l'arrêt du serveur. Exporter les logs enregistre le log de cette session dans un fichier
.log, avec l'heure et le niveau de chaque ligne, pour déboguer ou pour le partager avec quelqu'un qui vous aide. - Performances affiche le CPU, la mémoire, les TPS, les joueurs connectés et l'utilisation du disque du serveur, mesurés toutes les 10 secondes.
#Quand le serveur s'arrête tout seul
En plus de la fin de son temps, un serveur de test s'arrête :
- Quand vous quittez Codexe. La page du projet signale au serveur que vous êtes toujours là. Si cette page n'est plus ouverte depuis environ une minute (vous avez fermé l'onglet, vous vous êtes déconnecté ou vous avez perdu la connexion), le serveur s'arrête. Se déconnecter l'arrête immédiatement.
- Quand personne ne joue. Après 15 minutes sans personne en ligne, le serveur s'arrête.
La raison est affichée dans le panneau : arrêté par vous, temps écoulé, vous avez quitté Codexe, personne en ligne, ou erreur du serveur.
Si vous n'avez pas encore téléchargé le projet, la fenêtre de téléchargement s'ouvre à nouveau quand le serveur de test s'arrête, pour que vous puissiez télécharger le projet ou choisir une offre. Elle n'affiche plus le bouton permettant de démarrer un autre serveur de test.
#Pendant que vous jouez
- Les amis que vous laissez entrer via Accès au serveur sont accueillis comme invités sur votre serveur, et on leur indique que vous seul pouvez modifier le projet.
- Quand vous vous connectez, un message [Codexe] dans le chat explique qu'il s'agit d'un serveur de test, combien de temps il lui reste, et que tout ce qu'il contient est supprimé à sa fermeture.
- Des rappels apparaissent dans le chat 5 minutes, 3 minutes, 1 minute et 10 secondes avant la fin.
- L'IA ne voit pas ce qui se passe sur le serveur. Pour modifier le projet, décrivez la modification dans le chat du projet, comme d'habitude.
- Les slimes n'apparaissent pas d'eux-mêmes, pour ne pas vous gêner pendant vos tests. Tous les autres mobs apparaissent normalement, et un slime issu d'un œuf d'apparition, d'un générateur ou d'une commande apparaît quand même.
#Mettre à jour le projet
Si vous compilez à nouveau (ou modifiez les fichiers Skript ou le datapack) pendant qu'un serveur de test tourne, la fenêtre affiche Ce serveur utilise un ancien build avec Redémarrer avec le dernier build. Le nouveau serveur a le dernier build et un minuteur remis à zéro.
#Ce qui est conservé
Le serveur lui-même : rien. Quand un serveur de test s'arrête, pour l'une des raisons ci-dessus ou quand vous le redémarrez avec un build plus récent, le serveur et tout ce qu'il contient sont supprimés : mondes, constructions, modifications de configuration et base de données de votre plugin. Il ne peut pas être rouvert.
Codexe conserve un bref relevé de chaque session pour vous et pour le support : quand elle a démarré et s'est arrêtée et pourquoi, la version de Minecraft, les joueurs qui se sont connectés, les commandes envoyées depuis la console, la dernière partie du log et les mesures de performances. Ce qui est conservé et pendant combien de temps figure dans la Politique de confidentialité, section 4.8 et son tableau des durées de conservation.
#Isolation et sécurité
- Chaque serveur de test tourne dans un environnement isolé, avec ses propres limites de mémoire, de CPU et de temps, et sans accès à Internet. Le code qui appelle une API web, une base de données externe ou Mojang ne peut pas les atteindre depuis un serveur de test. La seule base de données qu'il peut atteindre est celle créée pour votre plugin, qu'aucun autre serveur de test ne peut ouvrir.
- Le serveur tourne en mode hors ligne : il ne vérifie donc pas le pseudo du joueur auprès de Mojang. Quiconque connaît à la fois l'adresse et un pseudo de votre liste Accès au serveur pourrait se connecter pendant qu'il tourne. Ne partagez pas l'adresse avec des personnes que vous ne voulez pas y voir.
- La console n'atteint que Minecraft : pas de shell, pas d'accès aux fichiers et aucune commande sur la machine qui se trouve derrière.
- Ce que le serveur de test conserve pendant qu'il tourne, et pour combien de temps, est décrit dans la Politique de confidentialité, section 4.8. Les règles figurent dans les Conditions, sections 15.6 à 15.10.
#Dépannage
| Vous voyez | Que faire |
|---|---|
| Compilez-le d'abord | Le code a changé depuis le dernier build. Appuyez sur Compiler, puis réessayez. |
| Tous les serveurs de test sont occupés | Attendez quelques minutes et réessayez. |
| Vous avez utilisé les serveurs de test du jour | La limite quotidienne de votre offre est atteinte. Elle se réinitialise le lendemain. |
| Votre offre autorise N personnes en ajoutant un pseudo | Retirez quelqu'un d'Accès au serveur, ou passez à une offre qui autorise plus de personnes. |
| Le serveur s'est arrêté après la fermeture de l'onglet | C'est l'arrêt automatique quand vous quittez Codexe. Gardez la page du projet ouverte pendant que vous jouez. |
| Minecraft affiche You are not whitelisted | Ce pseudo n'est pas sur votre liste Accès au serveur, ou il est orthographié différemment. Ajoutez-le là : un serveur en cours d'exécution le prend en compte en quelques secondes. |
Votre plugin n'apparaît pas dans /plugins | Il ne s'est pas chargé sur cette version de Minecraft. Décrivez ce que vous voyez dans le chat du projet, lancez Compiler sur la correction, puis redémarrez le serveur avec le dernier build. |