CustomStructures : générer des structures dans votre monde

Qu'est-ce que CustomStructures

CustomStructures est un plugin gratuit de ryandw11 qui génère des constructions personnalisées dans votre monde Minecraft. Comme le jeu de base génère des villages, des temples de la jungle et des forteresses, CustomStructures vous permet d'ajouter vos propres structures, qui apparaissent automatiquement dans les chunks nouvellement explorés.

Le plugin utilise des fichiers schematic (le format de WorldEdit/FAWE) comme source. Vous construisez une structure en jeu, vous l'enregistrez en schematic et vous définissez les conditions d'apparition. C'est tout : le plugin place la structure dans le terrain pendant la génération des chunks.

CustomStructures est disponible sur SpigotMC et prend en charge les versions 1.13 à 1.21.x.

Comment fonctionne la génération

Le plugin s'intègre à la génération des chunks de Minecraft. Chaque fois que le serveur génère un nouveau chunk (un joueur explore un terrain inédit), CustomStructures vérifie les conditions et place une structure avec la probabilité que vous avez définie :

1. Le serveur génère un nouveau chunk
2. Le plugin tire au sort si une structure doit apparaître dans ce chunk (selon la probabilité d'apparition)
3. Il vérifie les conditions : biome, hauteur, blocs environnants, distance par rapport au spawn
4. Si les conditions sont remplies, il colle le schematic à la bonne position
5. En option, il remplit les coffres avec du butin aléatoire issu des loot tables

Les structures ne se génèrent que dans les nouveaux chunks. Le terrain déjà existant ne change pas quand vous ajoutez une nouvelle structure : il faut donc explorer des zones inédites.

Créer une structure

Voici la marche à suivre, étape par étape :

1. Construisez la structure en jeu (ou téléchargez un schematic déjà prêt)
2. Sélectionnez-la avec les outils de WorldEdit (//pos1, //pos2)
3. Enregistrez-la en schematic : //schem save [name]
4. Copiez le fichier .schem dans plugins/CustomStructures/schematics/
5. Créez le fichier de configuration de la structure dans plugins/CustomStructures/structures/
6. Rechargez le plugin : /cstructure reload

Astuce : quand vous sélectionnez la structure, incluez des blocs d'air partout où elle doit remplacer le terrain. Les blocs de vide de structure (Minecraft 1.10+) sont ignorés, ce qui est pratique pour conserver le terrain naturel autour de la structure.

Configuration d'une structure

Chaque structure possède un fichier YAML dans plugins/CustomStructures/structures/ :

# dungeon_ruin.yml
schematic: dungeon_ruin.schem
probability:
  chance: 1
  number: 500        # 1 chunk sur 500
spawn:
  y: -1              # -1 = niveau du sol
  randomRotation: true
  spawnInWater: false
  spawnInLava: false
biomes:
  - PLAINS
  - FOREST
  - DARK_FOREST
  - TAIGA
worlds:
  - world
distance:
  minFromSpawn: 200  # distance minimale par rapport au spawn
  minFromOther: 100  # distance minimale par rapport à une autre structure

Paramètres principaux :

• probability - probabilité d'apparition (chance/number = probabilité par chunk)
• biomes - les biomes où la structure peut apparaître
• worlds - les mondes où la structure se génère
• distance - des distances minimales qui évitent que les structures soient trop serrées
• randomRotation - rotation aléatoire au collage (0/90/180/270 degrés)

Loot tables et coffres

CustomStructures gère le butin aléatoire dans les coffres placés à l'intérieur des structures. Une loot table ressemble à ceci :

# Dans le fichier de la structure
lootTables:
  default:
    rolls: 3-6
    items:
      - material: IRON_INGOT
        amount: 1-5
        weight: 30
      - material: GOLD_INGOT
        amount: 1-3
        weight: 15
      - material: DIAMOND
        amount: 1-2
        weight: 5
      - material: ENCHANTED_BOOK
        amount: 1
        weight: 10

Les coffres du schematic se remplissent automatiquement avec des objets aléatoires tirés de la loot table. Le poids (weight) détermine la probabilité qu'un objet soit choisi. Rolls est le nombre de fois où le plugin tire un objet : une plage de 3-6 signifie de 3 à 6 tirages.

Vous pouvez aussi utiliser les loot tables du jeu de base (par exemple minecraft:chests/simple_dungeon), ce qui garde un butin cohérent avec le reste du jeu.

Conseils et optimisation

• Testez avant de déployer - utilisez /cstructure test [name] pour coller la structure manuellement et voir comment elle s'intègre au terrain
• N'en faites pas trop - trop de structures avec une forte probabilité ralentissent la génération des chunks. Commencez avec de faibles probabilités (1/500 à 1/1000)
• Utilisez le vide de structure - les blocs de vide de structure conservent le terrain naturel autour de la structure, pour un rendu plus organique
• Prégénérez le monde - après avoir ajouté des structures, prégénérez la carte avec Chunky pour étaler la charge de génération dans le temps
• Variez le butin - les structures plus éloignées ou plus grandes devraient offrir un meilleur butin. C'est une raison d'explorer pour les joueurs
• Compatibilité - CustomStructures fonctionne avec les générateurs de terrain comme Terra ou Iris. Les structures sont collées une fois le terrain généré

Alternatives : StructureBoxes (plus simple à configurer), Advancius Structures (premium, plus d'options) et les packs de données intégrés à Minecraft, qui peuvent aussi ajouter des structures personnalisées.