Custom tiers

Création de custom tiers

Pour les custom tiers je vous conseil de créer deux nouveaux fichier dédiés, ce sera plus simple de s'y retrouver par le suite. Créez un fichier armortiers.js et tooltiers.js dans le dossier startup_scripts en prenant le code donné ci dessous.

armortiers.js ou tooltiers.jsjavascript
StartupEvents.registry('item', event => { //Vous pouvez changer le mot "event" par ce que vous voulez, j'ai pour habitude de juste mettre "e" personnellement.

//Ici sera mon code

})

Les custom tiers vous permet de mettre des bases par défaut à un tier que vous allez créer.

Tool Tiers

Les tiers pour les outils on besoin de plusieurs paramètres donc voici un exemple.

javascript
ItemEvents.toolTierRegistry(event => {
  event.add('nether_star', tier => {
    tier.uses = 10000
    tier.speed = 15
    tier.attackDamageBonus = 10
    tier.level = 5
    tier.enchantmentValue = 30
    tier.repairIngredient = '#forge:nether_stars'
  })
})

Voici les détails concernant les paramètres pour créer un tier pour les outils.

  • .uses
    ➡️ Durabilité des outils
  • .speed
    ➡️ Vitesse de minage
  • .attackDamageBonus
    ➡️ Base des dégâts par défaut
  • .level
    ➡️ Niveau de minage (exemple wood = 0, netherite = 4)
  • .enchantmentValue
    ➡️ Qualité des enchantements obtenus (exemple gold = 22)
  • .repairIngredient
    ➡️ Objet utilisé pour réparer l'outil. (id ou tag)

Armor Tiers

Les tiers pour les armures est un peu plus complexe et demande différents paramètre, voici un exemple.

javascript
ItemEvents.armorTierRegistry(event => {
  event.add('nether_star', tier => {
    tier.durabilityMultiplier = 10
    tier.slotProtections = [2, 5, 6, 2]
    tier.enchantmentValue = 30
    tier.equipSound = 'minecraft:entity.cat.ambient'
    tier.repairIngredient = '#forge:nether_stars'
    tier.toughness = 5
    tier.knockbackResistance = 0.5
  })
})

Voici les détails concernant les paramètres pour créer un tier pour les armures.

  • .durabilityMultiplier
    ➡️ Est un multiplicateur de durabilité suivant l'ordre suivant:
    diamond_boots[13] diamond_leggings[15] diamond_chestplate[16] diamond_helmet[11]
  • .slotProtections
    ➡️ Correspond au niveau de protection des pièces d'armure du même ordre que le durabilityMultiplier
  • .enchantmentValue
    ➡️ Qualité des enchantements obtenus (exemple gold = 22)
  • .equipSound
    ➡️ Joue un son spécifique au moment de porter votre équipement.
  • .repairIngredient
    ➡️ Objet utilisé pour réparer l'armure. (id ou tag)
  • .toughness
    ➡️ Indique le toughness de votre armure.
  • .knockbackResistance
    ➡️ Indique le knockback Resistance de votre armure.

Une fois votre tier custom créé, vous pourrez l'utiliser exactement comme un tier vanilla avec .tier('nether_star') sur vos armures et vos outils. Veillez simplement à reprendre exactement le même nom que celui défini dans votre registry, sinon KubeJS ne trouvera pas votre tier.

Mise à jour le 11/10/2026