Ensemble de structures

Cette fonctionnalité est exclusive à l'édition Java. 

Un ensemble de structures (nom anglais : structure set) est utilisé pour déterminer la position des structures dans le monde lors de la génération du monde. Les ensembles de structures sont configurés sous la forme de fichiers JSON stockés dans un pack de données, dans le dossier data/<espace de nom>/worldgen/structure_set. Ils ne sont pas référencés dans une dimension ou un biome. À la place, l'existence de la ressource suffit à faire générer les structures. Les biomes valides d'une structure sont déterminés par la structure elle-même.

Les ensembles de structures utilisent le champ  placement pour déterminer le placement des structures. Pour n'importe quelle position, une structure aléatoire est sélectionnée dans la liste  structures. Si la structure sélectionnée ne peut pas être placée car elle ne se trouve pas dans un biome valide, une différente structure est sélectionnée.

Format JSON

•  : L'objet racine.
  •  structures : (Obligatoire, mais peut être vide) Les structures qui peuvent être placées. Un élément de structure configuré ne doit pas être inclus dans deux ensembles de structures.
    •  : Une structure à placer.
      •  structure : Une structure (un ID, ou une nouvelle définition de structure) — La structure à placer.
      •  weight : Détermine les chances qu'elle soit choisie par rapport aux autres. Doit être un nombre entier positif.
  •  placement : La façon dont les structures doivent être placées.
    •  salt : Un nombre qui aide à l'aléatoire ; voir salage (cryptographie). Doit être un nombre entier non négatif.
    •  frequency : (Optionnel, vaut 1.0 par défaut) La probabilité d'essayer de générer si les autres conditions ci-dessous sont remplies. La valeur peut être comprise entre 0.0 et 1.0 (inclusifs). Le définir à un nombre ne signifie pas qu'une structure est générée à cette fréquence, mais simplement que le jeu essaye d'en générer une ; les biomes ou le terrain peuvent empêcher la structure de se générer.
    •  frequency_reduction_method : (Optionnel, vaut default par défaut) Fournit un algorithme de génération de nombre aléatoire pour la fréquence. Peut valoir default (le nombre aléatoire dépend de la graine, de la position et du  salt), legacy_type_1 (le nombre aléatoire dépend seulement de la graine et de la position, et l'aléatoire se produit uniquement quand les emplacements diffèrent considérablement), legacy_type_2 (identique à default, mais avec un salage fixe : 10387320) et legacy_type_3 (le nombre aléatoire dépend seulement de la graine et de la position).
    •  exclusion_zone : Spécifie que le placement est impossible à proximité de certaines structures.
      •  chunk_count : Une valeur entre 1 et 16 (inclusifs).
      •  other_set : Un ID d'ensemble de structures.
    •  locate_offset : (Optionnel, vaut [0,0,0] par défaut) Le décalage de coordonnées de chunk donné en utilisant /locate structure.
      •  : X. Une valeur entre -16 et 16 (inclusifs).
      •  : Y. Une valeur entre -16 et 16 (inclusifs).
      •  : Z. Une valeur entre -16 et 16 (inclusifs).
    •  type : Soit minecraft:concentric_rings, soit minecraft:random_spread.
    • Des champs supplémentaires en fonction de la valeur de  type, voir Types de placement.

Types de placement

Le type de placement détermine la façon dont les structures sont réparties dans un monde. Il y a deux types de placement.

random_spread

Les structures sont réparties uniformément dans le monde entier. Dans le jeu de base, ce type de placement est utilisé pour la plupart des structures (telles que les vestiges de bastion ou la cabane des marais). Le monde est divisé en carrés ayant une longueur de côté de  spacing chunks. Une structure est placée à une position aléatoire dans chaque carré. Une structure ne peut pas être placée dans les chunks de  separation le long du bord positif X ou Z d'un carré.

• Champs supplémentaires :
  •  spread_type : (Optionnel, vaut linear par défaut) Vaut soit linear, soit triangular.
  •  spacing : La distance moyenne entre deux tentatives de génération adjacentes. La valeur peut être comprise entre 0 et 4096 (inclusifs).
  •  separation : La distance minimum (en chunks) entre deux tentatives de génération adjacentes. La valeur peut être comprise entre 0 et 4096 (inclusifs). Doit être strictement inférieure à  spacing. La distance maximum entre deux tentatives de génération adjacentes est 2*spacing - separation.

concentric_rings

Un nombre fixe de structures est placé dans des anneaux concentriques autour de l'origine du monde. Dans le jeu de base, ce type de placement est seulement utilisé pour les forts.

• Champs supplémentaires :
  •  distance : L'épaisseur d'un anneau plus celle de l'écart entre deux anneaux. La valeur peut être comprise entre 0 et 1023 (inclusifs). L'unité est 6 chunks.
  •  count : Le nombre total de tentatives de génération dans cette dimension. La valeur peut être comprise entre 1 et 4095 (inclusifs).
  •  preferred_biomes : Un ou plusieurs biome(s) (un ID, ou un tag avec le caractère #, ou un tableau contenant des IDs) — Les biomes dans lesquels la structure est susceptible d'être générée.
  •  spread : Le nombre de tentatives dans l'anneau le plus proche du point d'apparition. La valeur peut être comprise entre 0 et 1023 (inclusifs). Le nombre de tentatives du N^ème anneau est : spread * (N^2 + 3 * N + 2) / 6, jusqu'à ce que le nombre de tentatives atteigne la valeur de  count.

Ensembles de structures par défaut

Ensemble de structures	Structures	Séparation	Espacement	Salt	[masquer]Notes
ancient_cities	Ancienne cité	8	24	20083232
buried_treasures	Trésor enfoui	0	1	0	Probabilité de 1%
desert_pyramids	Pyramide	8	32	14357617
end_cities	Cité de l'End	11	20	10387313
igloos	Igloo	8	32	14357618
jungle_temples	Temple de la jungle	8	32	14357619
mineshafts	Puits de mine abandonné Puits de mine abandonné badlands	0	1	0	Probabilité de 0.4%
nether_complexes	40% Forteresse du Nether 60% Vestiges de bastion	4	27	30084232
nether_fossils	Fossile du Nether	1	2	14357921
ocean_monuments	Monument sous-marin	5	32	10387313	Type de propagation triangulaire
ocean_ruins	Ruines sous-marines	8	20	14357621
pillager_outposts	Avant-poste de pillards	8	32	165745296	Probabilité de 20%, zone d'exclusion de 10 chunks à partir de n'importe quel village
ruined_portals	Portail en ruine	15	40	34222645
shipwrecks	Épave de navire	4	24	165745295
strongholds	Fort			0	Anneaux concentriques avec les paramètres distance=32, count=128 et spread=3
swamp_huts	Cabane des marais	8	32	14357620
trail_ruins	Ruines de sentier	8	34	83469867
trial_chambers	Chambres des épreuves	12	34	94251327
villages	Village des plaines Village de désert Village de savane Village des neiges Village de taïga	8	34	10387312
woodland_mansions	Manoir	20	80	10387319	Type de propagation triangulaire

Liens externes

• Générateur d'ensemble de structures sur misode.github.io