Skript : créer ses commandes et fonctions sans coder en Java

Skript est un plugin qui permet d'ajouter des commandes et des mécaniques à un serveur Paper ou Spigot avec un langage proche de l'anglais, sans écrire une ligne de Java. Pour une commande /discord, un message de bienvenue ou une récompense quotidienne, c'est souvent la solution la plus rapide.

Installer Skript

1. Téléchargez la version de Skript compatible avec votre version du serveur, depuis sa page officielle (SkriptLang sur GitHub).
2. Déposez le .jar dans plugins/, redémarrez.
3. Les scripts se placent dans plugins/Skript/scripts/, avec l'extension .sk.

Après une modification, pas besoin de redémarrer :

/sk reload monscript

Skript affiche les erreurs avec leur ligne. Comme en YAML, l'indentation compte : utilisez toujours le même nombre d'espaces (ou des tabulations partout, jamais un mélange).

Premier script : une commande

command /discord:
    description: Le lien de notre Discord
    trigger:
        send "&9Rejoignez notre Discord : &fdiscord.gg/votre-lien" to player

La commande existe dès le rechargement. Les codes &9, &f sont les couleurs du chat ; l'outil texte en dégradé génère des pseudos et titres en dégradé à coller dans vos messages.

Réagir à un événement

on join:
    if {premiere::%player's uuid%} is not set:
        set {premiere::%player's uuid%} to now
        broadcast "&aBienvenue à &f%player% &asur le serveur !"
        give player 16 bread

on join s'exécute à chaque connexion. La variable {premiere::…} retient qui est déjà venu : le message et le cadeau ne sont donnés qu'une fois. Les variables entre accolades sont sauvegardées automatiquement, même après un redémarrage.

Une annonce régulière

every 30 minutes:
    broadcast "&eUn vote par jour fait monter le serveur : &f/vote"

Pour les messages plus riches (cliquables, avec texte au survol), le générateur /tellraw produit la commande à placer dans le script :

every 30 minutes:
    execute console command "tellraw @a [...]"

Remplacez [...] par le texte généré. Dans une chaîne Skript, un guillemet s'écrit en double : "". Le JSON {"text":"Votez"} devient donc {""text"":""Votez""}.

Les extensions (addons)

Skript seul couvre l'essentiel. Des extensions ajoutent des fonctions :

• SkBee : tableaux de score, textes avancés, structures, et bien plus ;
• skript-reflect : accès direct à l'API Java, pour les cas que Skript ne couvre pas.

Installez-en le moins possible : chaque extension doit suivre les mises à jour de Skript et du serveur.

Les bonnes pratiques

• Un fichier par fonction (bienvenue.sk, discord.sk) : une erreur dans un fichier n'empêche pas les autres de se charger.
• Pas de boucle sur tous les joueurs à chaque tick : every 1 tick avec des calculs sur chaque joueur fait ramer n'importe quel serveur. Préférez les événements.
• Des permissions sur les commandes sensibles : permission: monserveur.admin sous la commande. Le guide LuckPerms explique comment les donner.
• Testez sur un serveur de test, surtout les scripts qui donnent des objets ou de l'argent : une erreur d'une ligne peut distribuer mille diamants.

Quand passer à un plugin Java

Skript est parfait pour les petites mécaniques. Il devient un problème quand :

• les scripts dépassent quelques centaines de lignes et plus personne ne s'y retrouve ;
• un script tourne en permanence et apparaît dans un profil Spark ;
• un plugin existant fait déjà la même chose, en mieux et maintenu.

Avant d'écrire un script, cherchez s'il existe déjà un plugin : le guide Les plugins indispensables couvre les besoins les plus courants. Et si votre projet demande un vrai développement, le recrutement de CubeVote permet de trouver un développeur pour votre équipe.