Aller au contenu principal

Que sont les donjons modulaires ?

Les donjons modulaires sont un systeme de donjons introduit dans BetterStructures 2.0.0 et versions ulterieures. Au lieu d'apparaitre comme un schematic fixe, les donjons modulaires sont assembles dynamiquement a partir de petits modules faconnes a la main. Cette approche permet de grands donjons a plusieurs etages qui semblent uniques dans chaque monde tout en s'integrant harmonieusement au Minecraft vanilla.


Comment les donjons modulaires sont-ils generes

  • Modules Chaque module est generalement construit dans une taille configurable (par defaut 16x16x16 blocs, bien que certains packs de contenu utilisent 32x16x32 ou d'autres dimensions). Les modules sont concus avec des points de connexion standardises utilisant un systeme de balises de bordure pour qu'ils puissent se connecter a d'autres modules sans espaces ni chevauchements. Les dimensions d'un donjon sont definies avec les options de configuration moduleSizeXZ et moduleSizeY dans la configuration du generateur de modules. Les modules peuvent contenir des couloirs, des salles, des escaliers ou des espaces d'affrontement speciaux.

  • Processus de generation Quand un donjon modulaire se genere dans un nouveau chunk, BetterStructures utilise un algorithme Wave Function Collapse (WFC) pour assembler proceduralement les modules a partir du pool disponible. Le systeme selectionne aleatoirement des modules compatibles en fonction de la correspondance des balises de bordure et les "coud" ensemble en un donjon complet. Le temps de generation varie selon les performances du serveur, la taille du donjon (rayon), la plage verticale, le nombre de modules et la complexite des contraintes. Le systeme utilise la distribution de charge pour empecher le lag du serveur pendant la generation.

  • Taille du donjon Les donjons peuvent etre configures pour generer a differentes tailles en utilisant le parametre de rayon. Des valeurs de rayon plus grandes creent des donjons significativement plus grands pouvant s'etendre sur des centaines de blocs. La plupart des donjons incluent plusieurs etages, relies par des modules d'escaliers ou des puits verticaux. Les connexions verticales entre les etages sont realisees grace a des modules ayant upIsPassable et downIsPassable definis sur true.


Variete et integration de packs

  • Free Pack Le Dungeoneering Modules Free Pack comprend 15 modules. Il fonctionne comme un donjon entierement jouable a lui seul.

  • Premium Pack Le Dungeoneering Modules Premium Pack ajoute 38 modules supplementaires. Combines avec le Free Pack, les deux sets s'entrelacent en un seul systeme de donjon avec un pool de modules beaucoup plus large. Cela reduit la repetition et augmente la variete dans les dispositions generees.

  • Integration des props Si vous installez aussi le BetterStructures Prop Pack (via FreeMinecraftModels), les donjons modulaires afficheront des props de modeles personnalises a travers les constructions, comme montre dans nos captures d'ecran de demonstration. Sans le prop pack, les donjons fonctionneront toujours normalement, mais sans les modeles decoratifs.


Integration EliteMobs

La plupart du donjon ne depend que de BetterStructures et des mobs vanilla de Minecraft, certains donjons proposent des combats de boss :

  • Si EliteMobs et FreeMinecraftModels sont tous deux installes : combat de boss personnalise complet avec modele.
  • Si seul FreeMinecraftModels est installe : le modele du boss apparait comme prop decoratif.
  • Si aucun n'est installe : la salle du boss sera simplement vide.

Le systeme utilise un systeme de spawn base sur des panneaux avec des balises speciales pour placer des entites et des conteneurs dans des zones designees. Les niveaux des boss sont mis a l'echelle en fonction de la distance depuis le centre du donjon, offrant un defi adapte a travers la structure.

Types de panneaux de module

Balise de panneauLigne 1Lignes supplementairesDescription
[spawn][spawn]Type d'entite sur la ligne 2Fait apparaitre une entite vanilla a l'emplacement du panneau
[pool: poolname][pool: poolname]Fait apparaitre un boss aleatoire depuis le pool de spawn nomme
[chest][chest]Place un coffre a l'emplacement du panneau
[trapped_chest][trapped_chest]Place un coffre piege a l'emplacement du panneau
[barrel][barrel]Place un tonneau a l'emplacement du panneau
[exit][exit]Noms de fichiers de schematics d'ascenseur sur les lignes 2-3Marque un point de sortie avec des schematics d'ascenseur haut/bas

Si EliteMobs n'est pas installe mais qu'un pack de contenu le necessite, les administrateurs recevront un message d'avertissement.

Cette conception garde les donjons modulaires compatibles avec les configurations de style vanilla, tout en offrant une integration plus profonde pour les utilisateurs avec des plugins supplementaires.


Integration MythicMobs

BetterStructures prend egalement en charge l'integration MythicMobs pour des rencontres de mobs personnalisees dans les donjons modulaires.

Quand MythicMobs est installe, les packs de structures peuvent faire apparaitre des MythicMobs personnalises dans le cadre de la generation de donjons. Cela permet des rencontres de mobs plus sophistiquees et des combats de boss au-dela de ce que le Minecraft vanilla ou EliteMobs offrent.

Si MythicMobs n'est pas installe, le plugin notifiera les administrateurs avec les permissions appropriees et fournira un lien de telechargement.


Integration FMM

Les donjons modulaires peuvent aussi tirer parti des props FreeMinecraftModels (FMM) lors de la creation.

  • Si FMM est installe, les props places par le createur ou constructeur du module apparaitront dans le donjon genere.
  • Les props sont purement decoratifs et n'affectent pas le gameplay, mais ils ameliorent la fidelite visuelle et l'immersion de l'environnement.
  • Si FMM n'est pas installe, le donjon se generera normalement, mais ces props personnalises ne seront pas affiches.

Cela garantit que les createurs peuvent concevoir des donjons avec des details supplementaires tout en maintenant la compatibilite pour les joueurs qui n'ont pas FMM installe.



Dimensions des modules

Important : La taille des modules est configurable, pas fixe.

Chaque generateur de modules definit sa taille de module standard en utilisant :

  • moduleSizeXZ : Largeur et profondeur en blocs (par defaut : 16)
  • moduleSizeY : Hauteur en blocs (par defaut : 16)

Taille par defaut : 16x16x16 blocs Alternative courante : 32x16x32 blocs (utilise dans certains packs de contenu)

Pour les createurs de modules :

  1. Verifiez votre configuration du generateur pour les valeurs moduleSizeXZ et moduleSizeY
  2. Construisez TOUS les modules pour ce generateur avec ces dimensions exactes
  3. Des tailles non concordantes causeront des echecs de connexion

Definir des dimensions personnalisees : Dans votre fichier de configuration du generateur de modules :

moduleSizeXZ: 32  # Width and depth
moduleSizeY: 16 # Height

Note : Tous les modules d'un generateur doivent utiliser les memes dimensions. Vous ne pouvez pas melanger des modules 16x16x16 et 32x16x32 dans le meme systeme de donjon.


Champs de configuration du generateur de modules

En plus de moduleSizeXZ et moduleSizeY, la configuration du generateur de modules supporte les champs suivants :

ChampPar defautDescription
radius1Rayon du donjon en chunks
edgesfalseSi les modules de bordure sont generes
startModuleListe du/des module(s) de depart pour la generation
minChunkY0Limite verticale minimale de chunk
maxChunkY0Limite verticale maximale de chunk
moduleSizeXZ16Largeur et profondeur des modules en blocs
moduleSizeY16Hauteur des modules en blocs
debugfalseActive le mode debug pour le depannage de la generation
useGradientLevelsfalseActive la mise a l'echelle des niveaux basee sur le gradient pour les entites apparues
spawnPoolSuffixSuffixe ajoute aux noms de pools de spawn pour ce generateur
isWorldGenerationfalseSi ce generateur est utilise pour la generation de monde
treasureFileFichier de configuration de tresor
validWorldsListe des noms de mondes valides ou le donjon peut se generer
validWorldEnvironmentsListe des environnements de monde valides
centerModuleAltitude0Altitude du module central

Champs de configuration par module

Chaque module individuel peut definir les champs de configuration suivants :

ChampPar defautDescription
isEnabledtrueSi ce module est active
weight100Poids de selection pour ce module pendant la generation
repetitionPenalty0Penalite appliquee quand ce module est selectionne plusieurs fois
noRepeatfalseEmpeche ce module de se repeter
northIsPassabletrueSi la face nord permet les connexions
southIsPassabletrueSi la face sud permet les connexions
eastIsPassabletrueSi la face est permet les connexions
westIsPassabletrueSi la face ouest permet les connexions
upIsPassabletrueSi la face superieure permet les connexions
downIsPassabletrueSi la face inferieure permet les connexions
enforceVerticalRotationfalseApplique les contraintes de rotation verticale
enforceHorizontalRotationfalseApplique les contraintes de rotation horizontale
minY-4Niveau Y minimum pour ce module
maxY20Niveau Y maximum pour ce module
biomedefaultExigence de biome pour ce module
minecraftBiomenullExigence de biome Minecraft pour ce module
treasureFileFichier de configuration de tresor pour ce module
bordersCarte de balises de bordure definissant la compatibilite de connexion
cloneConfigCloner les parametres depuis un autre fichier de configuration de module
compoundModuleLie ce module comme partie d'un module compose (multi-parties)
isAutomaticallyPlacedtrueSi le module est automatiquement place pendant la generation