Creer du contenu
Creer la construction
Il n'y a aucune restriction sur ce que vous pouvez construire pour BetterStructures, bien qu'il soit recommande de maintenir la taille des structures en dessous de 100x100x100 blocs pour une bonne adaptation au monde et des raisons de performance. Cela dit, il peut facilement gerer des structures beaucoup plus grandes.
Blocs speciaux
BetterStructures possede deux blocs speciaux : les barrieres et la bedrock. Tout autre bloc que WorldEdit peut coller sera colle normalement, mais les blocs de barriere et de bedrock sont l'exception.
| Bloc | Comportement | Cas d'utilisation |
|---|---|---|
| Barriere | Ne place aucun bloc a cet emplacement - preserve le terrain original | Arrondir les bords du collage, mouler les murs aux grottes, integration naturelle |
| Bedrock | Garantit qu'un bloc solide existe. Si air/liquide, remplace par le materiau de piedestal | Creer des sols pour les rails, garantir l'existence du sol sans ecraser les blocs existants |
Panneaux d'apparition
BetterStructures peut utiliser des panneaux avec un texte specifique pour faire apparaitre des mobs et des boss d'EliteMobs et MythicMobs a des emplacements specifiques.
Remarque : les panneaux d'apparition sont consommés lors du collage de la structure — BetterStructures remplace le bloc du panneau par de l'air au moment où il fait apparaître l'entité, si bien que les joueurs ne les voient jamais. Un panneau dont la balise n'est pas reconnue est simplement collé comme un panneau ordinaire et reste visible.
| Type de panneau | Ligne 1 | Ligne 2-4 | Plugin requis |
|---|---|---|---|
| Mobs vanilla | [spawn] | Type d'entite sur la ligne 2 | Aucun |
| EliteMobs | [elitemobs] | Nom du fichier du boss, réparti sur les lignes 2 à 4 | EliteMobs |
| MythicMobs | [mythicmobs] | Nom du mob sur la ligne 2, niveau facultatif sur la ligne 3 | MythicMobs |
N'importe quel panneau fonctionne. Tous les types de bois ainsi que les variantes sur pied et murales sont acceptés, y compris les panneaux suspendus et les panneaux issus de types de bois ajoutés après l'écriture du plugin — la vérification porte sur le fait que le bloc soit un panneau, et non sur une liste figée de matériaux.
La ligne de niveau MythicMobs est facultative. Laissez la ligne 3 vide et le mob apparaît au niveau 1.
Exemples de panneaux d'apparition
Mobs vanilla
[spawn]
ZOMBIE
Fait apparaitre un zombie persistant a cet emplacement. Fonctionne pour tout Spigot EntityType y compris les porte-armures et les cristaux de l'End.
EliteMobs
[elitemobs]
test_boss_with
_a_long_name
.yml
Les noms de fichier longs peuvent s'etendre sur plusieurs lignes. Les arenes de combat sont protegees par WorldGuard jusqu'a ce que tous les boss soient elimines.
MythicMobs
[mythicmobs]
SkeletalKnight
10
Fait apparaitre un SkeletalKnight au niveau 10.
Schematics
Les schematics sont des fichiers generes par WorldEdit ou FastAsyncWorldEdit qui contiennent les blocs de la construction que BetterStructures utilisera. BetterStructures utilise le format de fichier .schem (le standard moderne de WorldEdit). Assurez-vous de sauvegarder vos schematics au format .schem, et non au format ancien .schematic.
Les instructions detaillees sur la creation d'un schematic ne sont pas incluses ici, car elles sont documentees en detail dans les documentations de WorldEdit et FastAsyncWorldEdit, mais cela se fait generalement de la maniere suivante :
- Choisissez un coin de la construction et utilisez la commande
//pos1 - Choisissez le coin diagonalement oppose et utilisez la commande
//pos2 - Utilisez la commande
//copy - Utilisez la commande
/schem save <schematicname>ou<schematicName>est le nom de fichier que vous souhaitez utiliser pour votre schematic.
Assurez-vous d'executer la commande //pos1 sur le point 1 et //pos2 sur le point 2 !
Point d'ancrage
Les points d'ancrage sont l'endroit ou vous executez la commande //copy pour le schematic. Ils determinent le point d'origine de la structure lorsqu'elle est placee dans le monde.
| Type de construction | Position d'ancrage recommandee | Raison |
|---|---|---|
| Surface | Point le plus bas du sol | Assure un alignement correct au sol |
| Souterrain | Au sommet de la construction | Permet une determination correcte de la profondeur d'enfouissement |
| Liquide | A la surface de l'eau | Placement correct a la surface de l'eau |
| Air/Ciel | Au sommet de la construction | Positionnement correct en altitude |
Important : Soyez toujours tres proche ou directement au-dessus des constructions lors de la copie. Plus vous etes eloigne, plus l'operation de collage sera saccadee.
Configurations de schematic
Chaque fichier de schematic a une configuration de schematic. Si un fichier de schematic vient d'etre ajoute au serveur, la configuration sera generee apres un redemarrage ou apres /betterstructures reload.
Le .yml est généré dans le même dossier que le .schem. plugins/BetterStructures/schematics est analysé récursivement : un paquet de contenu qui livre ses schematics dans un sous-dossier voit ses configurations écrites dans ce même sous-dossier. Les noms de fichiers doivent être uniques dans l'ensemble de l'arborescence schematics : deux fichiers .schem portant le même nom dans des dossiers différents rendent la recherche de configuration ambiguë, et BetterStructures refuse désormais de démarrer plutôt que de deviner lequel vous vouliez.
Un .yml sans .schem correspondant est ignoré avec un avertissement, et la structure n'est pas enregistrée.
Ces configurations vous permettent de definir les parametres suivants pour le collage du schematic :
| Cle | Par defaut | Obligatoire | Description |
|---|---|---|---|
isEnabled | true | ❌ | Si le schematic est active. S'il est desactive, il ne sera place nulle part. |
weight | 1.0 | ❌ | Poids de selection. Plus eleve = plus de chances d'etre choisi. 2.0 = 2 fois plus probable, 0.5 = moitie moins probable. |
pedestalMaterial | Detection automatique | ❌ | Materiau pour les blocs de piedestal (noms de Material Spigot). Detecte automatiquement le meilleur ajustement si non defini. |
generatorConfigFilename | - | ✅ | Nom du fichier de configuration du generateur incluant l'extension .yml. Les schematics sans ceci n'apparaitront pas. |
treasureFile | Par defaut du generateur | ❌ | Remplacer le fichier de tresor pour les coffres de cette structure. Il est generalement preferable de modifier le generateur a la place. |
barrelTreasureFilename | Par defaut du generateur | ❌ | Remplacer le fichier de tresor pour les tonneaux de cette structure. Par defaut, ce que le generateur (ou son fallback treasure_barrel_food.yml) fournit. |
Conteneurs de butin : BetterStructures detecte automatiquement les coffres, les coffres pieges et les boites de shulker unies (non colorees) places dans les schematics et les remplit avec le fichier de tresor des coffres. Les tonneaux sont remplis separement avec le fichier de tresor des tonneaux (par defaut treasure_barrel_food.yml), et peuvent etre desactives par generateur avec generateLootInBarrels: false. Aucun panneau special ni configuration n'est necessaire pour marquer ces conteneurs.
Générateurs désactivés : si le générateur nommé par generatorConfigFilename a isEnabled: false, le schematic est entièrement ignoré, même si le isEnabled propre au schematic vaut true.
Details de configuration
pedestalMaterial
Les piedestaux sont des blocs places sous les batiments de surface/souterrains pour combler les espaces d'air et ameliorer l'integration au terrain. Ce sont egalement les blocs qui remplacent les blocs de bedrock dans le schematic.
Quand rien n'est defini, le plugin analyse les blocs sous l'emplacement de placement de la structure et selectionne le type de materiau le plus courant en utilisant une selection aleatoire ponderee. Par defaut : Nether = netherrack, End = pierre de l'End, Autre = pierre.
generatorConfigFilename
Exemple : generatorConfigFilename: generator_surface_global.yml
Le fichier du generateur se trouve dans le dossier de configuration des generateurs.
treasureFile
Consultez la documentation des fichiers de tresor et la documentation des generateurs pour plus de details.
Personnaliser le contenu
Tout ce qui est distribue dans BetterStructures est modifiable. Vous pouvez modifier tous les fichiers de schematic et les parametres de generateur a votre guise.
Le guide de creation de contenu ci-dessus est egalement un guide qui peut vous aider a modifier le contenu existant.
Depannage
Si votre structure n'apparait pas, verifiez que :
- Le fichier de schematic est au format .schem
- Une configuration de generateur valide est specifiee
- L'option isEnabled est definie sur true, a la fois sur la configuration du schematic et sur le generateur vers lequel elle pointe
- Votre version de WorldEdit/FastAsyncWorldEdit est compatible
- Le
.ymldu schematic se trouve à côté du.schem, et non dans une arborescence parasiteplugins/BetterStructures/plugins/BetterStructures/.... Les anciennes versions écrivaient les configurations à ce mauvais chemin, ce qui laissait les structures livrées sans générateur et les empêchait silencieusement d'apparaître. Si vous voyez ce dossier, les configurations qu'il contient n'ont jamais été lues — supprimez-le et laissez le plugin régénérer les configurations au bon endroit.
Si le serveur refuse de démarrer avec un message concernant un nom de fichier de schematic en double, c'est que le même nom de .schem existe dans deux dossiers différents sous schematics (ou modules). Renommez-en un.
Le dossier .schematic_cache
BetterStructures conserve des copies converties de vos schematics dans plugins/BetterStructures/.schematic_cache. Les fichiers .schem livrés sont enregistrés dans une version de données Minecraft plus ancienne, et les convertir à chaque démarrage est de loin la partie la plus coûteuse du chargement d'une installation de contenu complète ; le résultat converti est donc stocké et réutilisé.
Vous n'avez pas besoin de gérer ce dossier :
- les entrées sont indexées sur le contenu du schematic, votre version de Minecraft et votre version de WorldEdit, de sorte que modifier un schematic ou mettre à jour l'un de ces plugins reconstruit automatiquement les entrées concernées
- les entrées qui ne correspondent plus à aucun schematic (par exemple après la suppression d'un paquet de contenu) sont élaguées au démarrage
- il ne s'agit jamais que d'une optimisation — si une entrée est manquante, illisible ou échoue à la vérification, le
.schemd'origine est lu à la place
Sa suppression est sans danger ; le démarrage suivant le reconstruit simplement et prend plus de temps.
« Skipped N unsupported legacy block entries »
Les fichiers .schem livrés enregistrent la version de Minecraft avec laquelle ils ont été sauvegardés, si bien que WorldEdit fait passer leurs block entities par le convertisseur de données de Mojang au chargement. Les entrées dont le type n'existe plus — minecraft:bed est le cas courant, les block entities de lit ayant disparu en 1.13 lorsque la couleur du lit est passée dans l'état du bloc — échouent à la conversion et sont journalisées par le serveur au niveau ERROR, une fois par bloc. Une installation de contenu complète produit des centaines de lignes identiques qui ressemblent à une installation cassée mais sont inoffensives : le bloc lui-même se convertit correctement et la structure se colle sans problème.
BetterStructures condense ce bruit en une seule ligne informative indiquant combien d'entrées ont été ignorées et quelles clés étaient concernées. Il n'y a rien à corriger lorsque vous la voyez.
Si les panneaux d'apparition ne fonctionnent pas :
- Verifiez que le format du panneau correspond exactement aux exemples
- Pour EliteMobs/MythicMobs, assurez-vous que les plugins sont installes
- Verifiez que les types d'entite/noms de mob sont correctement orthographies
- Consultez les journaux du serveur pour des messages d'erreur specifiques