CustomStructures - generowanie struktur w świecie

Co to jest CustomStructures

CustomStructures to darmowy plugin autorstwa ryandw11, który umożliwia generowanie niestandardowych budowli w świecie Minecraft. Podobnie jak vanilla generuje wioski, świątynie dżungli czy fortece, CustomStructures pozwala dodawać własne struktury, które automatycznie pojawiają się w nowo eksplorowanych chunkach.

Plugin używa plików schematic (format WorldEdit/FAWE) jako źródła struktur. Budujesz strukturę w grze, zapisujesz ją jako schematic, konfigurujesz warunki spawnowania - i gotowe. Plugin sam umieszcza ją w terenie podczas generacji chunków.

CustomStructures jest dostępny na SpigotMC i obsługuje wersje od 1.13 do 1.21.x.

Jak działa generowanie

Plugin podłącza się do systemu generacji chunków Minecraft. Za każdym razem, gdy serwer generuje nowy chunk (gracz eksploruje nowy teren), CustomStructures sprawdza warunki i z określonym prawdopodobieństwem umieszcza strukturę:

1. Serwer generuje nowy chunk
2. Plugin losuje, czy w tym chunku ma się pojawić struktura (na podstawie spawn chance)
3. Sprawdza warunki: biom, wysokość, otaczające bloki, odległość od spawnu
4. Jeśli warunki spełnione, wkleja schematic w odpowiedniej pozycji
5. Opcjonalnie wypełnia skrzynie losowym łupem z loot tables

Struktury generują się tylko w nowych chunkach. Już wygenerowany teren nie zmieni się po dodaniu nowej struktury - trzeba eksplorować nowe obszary.

Tworzenie struktury

Proces tworzenia nowej struktury krok po kroku:

1. Zbuduj strukturę w grze (lub pobierz gotowy schematic)
2. Zaznacz ją narzędziami WorldEdit (//pos1, //pos2)
3. Zapisz jako schematic: //schem save [nazwa]
4. Skopiuj plik .schem do plugins/CustomStructures/schematics/
5. Utwórz plik konfiguracyjny struktury w plugins/CustomStructures/structures/
6. Przeładuj plugin: /cstructure reload

Wskazówka: podczas budowy struktury zaznacz bloki powietrzne (air) tam, gdzie chcesz, żeby struktura zastąpiła teren. Bloki structure void (Minecraft 1.10+) zostaną zignorowane - przydatne, gdy chcesz zachować naturalny teren wokół.

Konfiguracja struktury

Każda struktura ma plik YAML w plugins/CustomStructures/structures/:

# dungeon_ruin.yml
schematic: dungeon_ruin.schem
probability:
  chance: 1
  number: 500        # 1 na 500 chunków
spawn:
  y: -1              # -1 = poziom terenu
  randomRotation: true
  spawnInWater: false
  spawnInLava: false
biomes:
  - PLAINS
  - FOREST
  - DARK_FOREST
  - TAIGA
worlds:
  - world
distance:
  minFromSpawn: 200  # minimalna odległość od spawnu
  minFromOther: 100  # minimalna odległość od innej struktury

Kluczowe parametry:

• probability - szansa na spawn (chance/number = prawdopodobieństwo na chunk)
• biomes - lista biomów, w których struktura może się pojawić
• worlds - w jakich światach struktura generuje się
• distance - minimalne odległości zapobiegające zbyt gęstemu rozmieszczeniu
• randomRotation - losowa rotacja przy wklejaniu (0/90/180/270 stopni)

Loot tables i skrzynie

CustomStructures obsługuje losowy łup w skrzyniach umieszczonych w strukturach. Konfiguracja loot table:

# W pliku struktury
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

Skrzynie w schematicu automatycznie wypełniają się losowymi przedmiotami z loot table. Waga (weight) określa prawdopodobieństwo wylosowania danego przedmiotu. Rolls to ile razy plugin losuje przedmiot - zakres 3-6 oznacza od 3 do 6 losowań.

Można też używać vanillowych loot tables Minecrafta (np. minecraft:chests/simple_dungeon), co daje spójne łupy z resztą gry.

Porady i optymalizacja

• Testuj przed wdrożeniem - użyj komendy /cstructure test [nazwa] aby wkleić strukturę ręcznie i sprawdzić, czy wygląda dobrze w terenie
• Nie przesadzaj z ilością - zbyt wiele struktur z wysokim prawdopodobieństwem spowalnia generację chunków. Zacznij od niskich szans (1/500-1/1000)
• Używaj structure void - bloki structure void pozwalają zachować naturalny teren wokół struktury, co daje bardziej organiczny efekt
• Pregeneruj świat - po dodaniu struktur warto pregenerować mapę za pomocą Chunky, żeby rozproszyć obciążenie generacji w czasie
• Różnicuj łupy - bardziej odległe lub większe struktury powinny mieć lepszy loot. To motywuje graczy do eksploracji
• Kompatybilność - CustomStructures współpracuje z generatorami terenu jak Terra czy Iris. Struktury wklejają się po wygenerowaniu terenu

Alternatywy: StructureBoxes (prostszy w konfiguracji), Advancius Structures (premium, więcej opcji) oraz wbudowane data packi Minecraft (1.20.5+ umożliwia niestandardowe structure pools).