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é.
