Features et feature rules

Tout ce qui décore le paysage est une feature : les filons de minerai, les arbres, les fleurs, l'herbe, les rochers, les sources, le corail. Si ce n'est ni le terrain de base ni une créature, c'est sans doute une feature.

Pour faire apparaître une feature dans le monde, il te faut deux fichiers :

• Une feature dit quoi placer : un filon de minerai, un arbre, un simple bloc.
• Une feature rule (règle de feature) dit où et à quelle fréquence : dans quels biomes, combien de fois par chunk, à quelle hauteur.

Dans ce guide, tu vas faire apparaître du minerai de rubis sous terre dans tous les biomes de la Surface.

Les fichiers

BP/
  blocks/
    ruby_ore.json
  features/
    ruby_ore_feature.json
  feature_rules/
    ruby_ore_rule.json

Étape 1 : le bloc de minerai

Il te faut d'abord un bloc à placer. Crée un bloc personnalisé normal appelé wiki:ruby_ore, avec une texture et une table de butin. Si tu n'as encore jamais créé de bloc, suis Ton premier bloc personnalisé.

Étape 2 : la feature

{
  "format_version": "1.13.0",
  "minecraft:ore_feature": {
    "description": {
      "identifier": "wiki:ruby_ore_feature"
    },
    "count": 6,
    "replace_rules": [
      {
        "places_block": "wiki:ruby_ore",
        "may_replace": [
          "minecraft:stone",
          "minecraft:granite",
          "minecraft:diorite",
          "minecraft:andesite"
        ]
      }
    ]
  }
}

• La clé racine, ici minecraft:ore_feature, est le type de feature. Chaque fichier en a exactement un. Le tableau en bas de cette page les liste tous.
• count est le nombre de blocs qu'un filon essaie de placer. Les diamants utilisent de petits filons, le charbon de gros.
• replace_rules dit quel bloc va où. Le minerai remplace seulement les blocs listés dans may_replace, pour qu'il ne flotte jamais dans les grottes et ne ronge pas la terre.

Règles de nommage

• Une feature par fichier.
• Le nom du fichier doit correspondre à la partie « nom » de l'identifiant. wiki:ruby_ore_feature va dans ruby_ore_feature.json. L'espace de noms ne compte pas.
• Si deux packs utilisent exactement le même identifiant, le pack placé plus haut dans la liste l'emporte. C'est comme ça que tu peux remplacer une feature vanilla.

Étape 3 : la feature rule

Une feature ne fait rien tant qu'une feature rule ne l'attache pas à des biomes :

{
  "format_version": "1.13.0",
  "minecraft:feature_rules": {
    "description": {
      "identifier": "wiki:ruby_ore_rule",
      "places_feature": "wiki:ruby_ore_feature"
    },
    "conditions": {
      "placement_pass": "underground_pass",
      "minecraft:biome_filter": [
        {
          "test": "has_biome_tag",
          "operator": "==",
          "value": "overworld"
        }
      ]
    },
    "distribution": {
      "iterations": 4,
      "coordinate_eval_order": "zyx",
      "x": {
        "distribution": "uniform",
        "extent": [0, 16]
      },
      "y": {
        "distribution": "triangle",
        "extent": [-48, 16]
      },
      "z": {
        "distribution": "uniform",
        "extent": [0, 16]
      }
    }
  }
}

La règle a trois parties.

description

• identifier donne un nom à la règle. Comme pour les features, la partie « nom » doit correspondre au nom du fichier.
• places_feature est la feature que cette règle place. Une règle contrôle une seule feature.

conditions

minecraft:biome_filter choisit les biomes. C'est une liste de tests de filtre, et celui que tu utiliseras presque à chaque fois est has_biome_tag. Chaque biome passe le filtre : ceux qui le réussissent reçoivent la feature.

Tu peux combiner les tests avec all_of et any_of. Celui-ci choisit les biomes chauds de la Surface qui ne sont pas des océans :

"minecraft:biome_filter": [
  { "test": "has_biome_tag", "operator": "==", "value": "overworld" },
  {
    "any_of": [
      { "test": "has_biome_tag", "operator": "==", "value": "desert" },
      { "test": "has_biome_tag", "operator": "==", "value": "mesa" }
    ]
  },
  { "test": "has_biome_tag", "operator": "!=", "value": "ocean" }
]

Pour mettre du minerai de rubis seulement dans le Bosquet de rubis, teste son propre tag : "value": "ruby_grove".

placement_pass dit quand la feature est placée par rapport aux autres. Les passes s'exécutent dans cet ordre :

Les features d'une même passe n'ont pas d'ordre fixe entre elles.

distribution

Cette partie décide combien de copies essaient d'apparaître dans chaque chunk, et où.

Pour une feature rule, x et z se comptent depuis le coin du chunk, donc [0, 16] couvre tout le chunk. y est la hauteur dans le monde.

Chaque plage a un type de distribution qui façonne l'endroit où tombent les valeurs :

Pour ce qui pousse au sol, comme les plantes, règle y avec du Molang pour que la feature tombe sur la surface :

"y": "query.heightmap(variable.worldx, variable.worldz)"

Tester

1. Active le pack dans un nouveau monde.
2. Passe en mode spectateur avec /gamemode spectator et vole sous terre vers Y 0.
3. Cherche la texture du rubis dans la pierre. Trop rare ? Augmente iterations ou count.

Si rien n'apparaît, ouvre le journal de contenu. Les causes habituelles sont un nom de fichier qui ne correspond pas à l'identifiant, un mauvais nom dans places_feature, ou une faute de frappe dans le nom du bloc de places_block.

Tous les types de features

Chaque fichier de feature utilise exactement l'un de ces types comme clé racine. Certains placent des blocs, d'autres ne font que choisir entre d'autres features, les déplacer ou les répéter. La plupart des décorations vanilla en enchaînent plusieurs : par exemple, une feature de dispersion qui lance une feature de recherche, qui lance un arbre.

Et ensuite

• Crée un foyer pour ton minerai : Le fichier de biome.
• Cherche les tags de biome à utiliser dans tes filtres : minecraft:tags.