Skip to content
Hébergement · Mods et modpacks

KubeJS : recettes et scripts personnalisés

Modifier les recettes et mécaniques d'un modpack sans programmer : structure des scripts KubeJS, rechargement et erreurs courantes.

Mis à jour le 13 août 2026

KubeJS vous permet de modifier un modpack à l'aide de scripts : supprimer et ajouter des recettes, modifier les drops, intercepter des événements. C'est la méthode standard pour équilibrer un modpack.

Structure

kubejs/
  server_scripts/   recipes, drops, server events
  client_scripts/   tooltips, interface
  startup_scripts/  item and block registration

Les scripts serveur sont ceux dont vous avez besoin en hébergement.

Exemples

ServerEvents.recipes(event => {
  event.remove({ output: 'minecraft:diamond_block' })
  event.shaped('4x minecraft:stick', [
    'P',
    'P'
  ], { P: 'minecraft:oak_planks' })
})

Rechargement

/kubejs reload server_scripts

Les recettes s'appliquent sans redémarrage. Les scripts de démarrage nécessitent un redémarrage complet.

Erreurs

Les erreurs de script sont écrites dans logs/kubejs/server.txt, et pas seulement dans le journal général. Vérifiez d'abord à cet endroit : le serveur démarrera quand même, mais vos modifications ne s'appliqueront tout simplement pas.

Attention

  • Le script s'exécute sur le serveur avec toutes les permissions — ne copiez pas les scripts d'autres personnes sans les examiner.
  • Supprimer une recette utilisée dans une chaîne de quêtes d'un modpack casse la progression des joueurs.
  • Les événements qui se déclenchent à chaque tick ou à chaque bloc font facilement chuter les TPS — Optimisation d'un serveur moddé.
Hébergement MinecraftVotre serveur tourne même hors ligneCréer le serveur