Aller au contenu
Premiers pas

Votre premier projet

Un premier projet réel pas à pas, un plugin Paper de homes, de la demande au JAR testé.

Mis à jour

Sur cette page
  1. La demande
  2. Ce qui se passe ensuite
  3. Examinez le résultat
  4. Modifiez quelque chose
  5. Compilez et testez
  6. Et ensuite

Ce guide pas à pas crée un plugin petit mais réel, pour que vous voyiez chaque étape une fois. Le même parcours s'applique à tous les types de projets.

#La demande

Sur Créer, choisissez Plugin Bukkit/Spigot/Paper (Java) et écrivez :

Text
A Paper 1.21.4 plugin called SimpleHomes.
- /sethome saves the player's current location as their home (one home per player).
- /home teleports them there after a 3 second warm-up; moving cancels it.
- 30 second cooldown on /home, configurable in config.yml.
- Homes persist across restarts in a YAML file.
- Permissions: simplehomes.use (default true), simplehomes.bypasscooldown (default op).
- Messages configurable in config.yml, with color codes.

Remarquez ce qu'elle contient : la plateforme et la version, chaque commande et ce qu'elle fait, les règles de temporisation, le stockage, les permissions et ce qui doit être configurable. C'est ce qui rend le premier résultat utilisable.

#Ce qui se passe ensuite

  1. Codexe affiche les fichiers au fur et à mesure : un pom.xml Maven, la classe principale, les classes de commandes et de listeners, plugin.yml et config.yml.
  2. Le bandeau passe à Vérification du projet… puis à Build en cours…. Codexe compile le plugin.
  3. Si le compilateur signale une erreur (par exemple un import erroné), vous verrez Correction d'un problème…. Codexe corrige le code et relance le build. Cela n'utilise pas vos tokens.
  4. Le projet passe à Prêt.

#Examinez le résultat

  • Ouvrez plugin.yml et vérifiez que les commandes et les permissions correspondent à votre demande.
  • Ouvrez config.yml : le délai de récupération et les messages doivent s'y trouver.
  • Parcourez la classe principale. Inutile de comprendre chaque ligne, mais vous pouvez repérer les manques évidents.

#Modifiez quelque chose

Dans le chat du projet, tapez :

Text
Allow up to 3 named homes per player: /sethome <name>, /home <name>, /delhome <name>, /homes to list them.

Codexe modifie les fichiers existants au lieu de tout recommencer. Les demandes de suivi coûtent bien moins cher qu'un nouveau projet, car seuls les fichiers concernés sont réécrits. Quand la modification touche un projet compilable, Codexe le vérifie à nouveau.

#Compilez et testez

Appuyez sur Compiler pour lancer un nouveau build, puis sur Télécharger le JAR. Placez le JAR dans le dossier plugins/ de votre serveur et redémarrez. Testez chaque commande, y compris les cas limites (bouger pendant la temporisation, le délai de récupération, un redémarrage).

#Et ensuite

Votre premier projet | Codexe Docs