Please disclose if any significant portion of your mod was created using AI tools by adding the 'AI Generated' category. Failing to do so may result in the mod being removed from Thunderstore.
Home-pl
Updated a month agoWiki TerrainForge
English · Español · Français · Deutsch · Русский · 中文 · 繁體中文 · 日本語 · 한국어 · Polski · Português · Türkçe · Українська · Italiano
Spis treści
- Instalacja
- Szybki start
- Sterowanie
- Operacje
- Kształty
- Tryby opadania
- Stemple (Kopiuj/Wklej)
- Migawki (Backupy)
- Profile
- Języki
- Wieloosobowość
- Ustawienia
- Rozwiązywanie problemów
📥 Instalacja
Wymagania
- BepInEx 5 (x64, Mono) na kliencie i serwerze. Użytkownicy Thunderstore już go mają.
- Jotunn (
ValheimModding-Jotunn) — rejestruje niestandardowe narzędzie. Jest wymieniony wmanifest.json; Thunderstore instaluje go automatycznie.
Kroki
- Pobierz
TerrainForge-<version>.zipz Thunderstore lub GitHub Releases. - Rozpakuj i umieść
TerrainForge.dllw:- Klient:
...\BepInEx\plugins\TerrainForge\TerrainForge.dll - Serwer:
<server>\BepInEx\plugins\TerrainForge\TerrainForge.dll
- Klient:
- Uruchom ponownie grę / serwer.
⚠️ Musi być zainstalowany na kliencie ORAZ serwerze dla edycji większych niż ±8 m i poprawnej replikacji.
🚀 Szybki start
- Dołącz do świata. Różdżka TerrainForge (klon Młota) zostaje automatycznie przyznana i założona.
- Naciśnij
F5, aby otworzyć menu (lub kliknij przycisk TerrainForge w menu pauzyESC). - Załóż różdżkę, jeśli nie jest założona.
- Wyceluj w teren i przytrzymaj prawy przycisk myszy (
Mouse1), aby rzeźbić. - Użyj
,, aby przełączać operacje,.dla kształtów,/dla farb. - Przytrzymaj
Q→ menu radialne, puść, aby potwierdzić. Ctrl+Z/Ctrl+Y, aby cofnąć/ponowić.
⌨️ Sterowanie
| Akcja | Domyślny klawisz | Opis |
|---|---|---|
| Zastosuj pędzel | Przytrzymaj Mouse1 (prawy przycisk myszy) |
Rzeźbi teren pod celownikiem |
| Promień + | = lub Ctrl+Rolka |
Zwiększa promień pędzla |
| Promień − | - lub Ctrl+Rolka |
Zmniejsza promień pędzla |
| Przełącz operację | , |
Przełącza 9 operacji |
| Przełącz kształt | . |
Koło → Kwadrat → Linia → Prostokąt → Wielokąt |
| Przełącz farbę | / |
Przełącza 6 typów farb |
| Wyrównaj do stóp | Przytrzymaj Left Shift |
Wyrównywanie używa wysokości gracza |
| Cofnij | Ctrl+Z |
Cofa ostatnie pociągnięcie |
| Ponów | Ctrl+Y |
Ponawia cofnięte pociągnięcie |
| Kroplomierz | G |
Ustala wysokość Wyrównywania w miejscu celownika (ponownie = zwolnij) |
| Tryb rampy | H |
Przełącza: Dwa punkty → Stały kąt → Ścieżka (lub wybierz 3 przyciskami w USTAWIENIACH) |
| Stały kąt rampy | Przytrzymaj Alt + promień/rolka |
Dostosowuje kąt w trybie stałym |
| Menu radialne | Przytrzymaj Q |
Wybierz operację myszą, puszczenie potwierdza |
| Tryb dostosowania | V |
Rolka = promień, blokuje zoom/pasek/mapę |
| Precyzyjna regulacja (0.1 m) | Przytrzymaj Shift + rolka/promień |
Dokładna regulacja promienia |
| Kopiuj stempel | Ctrl+Shift+C |
Kopiuje zaznaczony obszar do schowka |
| Wklej stempel | Ctrl+Shift+V |
Widmowy podgląd, kliknięcie potwierdza |
| Pobierz różdżkę | F8 |
Przyznaje Różdżkę TerrainForge |
| Otwórz menu | F5 |
Otwiera menu klawiszy/pomocy/ustawień |
Dodatkowe klawisze (brak domyślnych, przypisz je w KLAWISZACH):
- Operacja bezpośrednia: Wyrównaj, Podnieś, Obniż, Wygładź, Maluj, Przywróć, Rampa, Brzeg, Śnieg
- Następny / poprzedni profil
- Następny / poprzedni stempel (historia)
Sekcja "Szybkie akcje" (zakładka KLAWISZE): przyciski dla funkcji bez obowiązkowego skrótu — Cofnij, Ponów, Ustal wysokość, Kopiuj/Wklej stempel, Poprzedni stempel, Wyczyść znaczniki, mapy cieplne i Diagnostyka materiału (zrzuca shader + sloty tekstur do loga).
🔄 Operacje
| Operacja | Opis |
|---|---|
| Wyrównaj | Wyrównuje do wskazanej wysokości (Shift = na wysokości twoich stóp). Stała wysokość przez Kroplomierz (G) lub pole tekstowe USTAWIEŃ. |
| Podnieś | Podnosi teren o RaiseDelta na zastosowanie. Tryb opadania nadaje mu kształt. |
| Obniż | Obniża teren o RaiseDelta na zastosowanie. Tryb opadania nadaje mu kształt. |
| Wygładź | Prawdziwe rozmycie: uśrednia każdy wierzchołek z jego 8 sąsiadami. Przytrzymaj dla efektu progresywnego. Tryby: Pełny (oba), Tylko grzbiety (obniża), Tylko zagłębienia (podnosi). Kształt Linia = wygładza ścieżkę. |
| Rampa | 3 tryby (przełącz H):• Dwa punkty: zaznacz A i B → prosta pochyłość łączy wysokości. • Stały kąt: B = kierunek/długość; wysokość = SlopeAngle (w górę/w dół zależnie od celownika). Dostosuj przez Alt+promień.• Ścieżka: zaznacz krzywą A→B→C… (podwójne naciśnięcie przy 3+ zamyka) → gładka Catmull-Rom. Szerokość = promień pędzla. Miękkość = blend tylko na bocznych krawędziach. Podgląd: wypełniony korytarz + pierścienie wysokości w A/B. |
| Brzeg | Wyrównuje w stronę poziomu wody + margines ShoreOffset (plaże). Miękkość jak Wyrównywanie. |
| Maluj | Typy: Dirt, Cultivated, Paved, ClearVegetation, DeepSnow, Reset. Regulowana siła. |
| Przywróć | Przywraca teren do stanu pierwotnego (wysokość + farba). |
| Śnieg | Farba tylko śnieg (ta sama maska co w grze). Shift = usuwa ją i przywraca oryginał. |
📐 Kształty
Przełączaj klawiszem .. Wszystkie obsługują cofanie.
| Kształt | Zaznaczanie | Zastosowanie |
|---|---|---|
| Koło | Pojedyncze kliknięcie (środek pędzla) | Ogólne rzeźbienie |
| Kwadrat | Pojedyncze kliknięcie (środek) | Platformy, fundamenty |
| Linia | 2 kliknięcia (A → B) | Ścieżki, mury, szlaki. Połowa szerokości = promień. |
| Prostokąt | 2 kliknięcia (przeciwległe rogi) | Fundamenty, farmy, platformy. Miękkie krawędzie. |
| Wielokąt | Kliknięcie na wierzchołek, podwójne kliknięcie zamyka (3+ wierzchołki) | Złożone kształty, własne obszary |
- Kształty inne niż koło pokazują tylko zaznaczony kontur (bez okrągłych pierścieni).
- Miękkość wpływa na blend krawędzi we wszystkich kształtach.
⚙️ Tryby opadania (Podnoszenie/Obniżanie)
Konfiguracja w USTAWIENIACH → "Opadanie Raise/Lower":
| Tryb | Zachowanie |
|---|---|
| Spiczasty | Centralny szczyt. Kontrolowany suwakiem "Potęga opadania" (1–5). |
| Płaski | Równomierny dysk — ten sam ciężar na całym promieniu. |
| Gładki | Dzwon kosinusowy — płynne przejście, bez twardej krawędzi. |
| Liniowy | Proste zwężenie od środka do krawędzi. |
🧱 Stemple (Kopiuj/Wklej)
Potężna funkcja do replikowania struktur terenu.
Selekcja prostokątem (zalecane)
- Ustaw kształt na
Prostokąt(klawisz.). - Naciśnij Zastosuj (
Mouse1) raz, aby zaznaczyć róg A (to nie wykonuje żadnej edycji). - Wyceluj w róg B (wystarczy przesunąć kamerę).
- Naciśnij
Ctrl+Shift+C→ kopiuje dokładnie ten prostokąt, przycięty do zaznaczenia (nie przeciąga całych kafelków 64 m ani nietkniętego terenu wokół). Znacznik rogu A jest zużywany po udanym kopiowaniu.
Przebieg pracy
- Zaznacz obszar: użyj dowolnego kształtu (Koło, Prostokąt, Linia, Wielokąt, Rampa) — lub selekcji prostokątem powyżej.
- Kopiuj:
Ctrl+Shift+C→ "Skopiowano stempel: X kafelków" (schowek w RAM). - Podgląd wklejania:
Ctrl+Shift+V→ widmowa siatka w miejscu celownika.Q/E= obrót ±15°Alt+Rolka = ciągły obrótShift+Rolka = skala 0.25×–4×Esc= anuluj
- Potwierdź: kliknięcie (
Mouse1) → stosuje jako pojedynczy krok cofania.
Stemple selekcji zapisują tylko wewnątrz skopiowanego obszaru; teren poza nim pozostaje nietknięty.
Historia
- Do 10 stempli w RAM (najnowsze najpierw).
- Klawisze
Następny stempel/Poprzedni stempel(przypisywalne) przełączają je. - Komunikat: "Historia stempli: Copy: 3 kafelki [2/5]"
Trwałość
- USTAWIENIA → STEMPLE:
- Zapisz bieżący stempel na dysk (
.stampwBepInEx/config/TerrainForge/stamps/, maks. 12). - Wczytaj stempel do schowka.
- Wyświetl/usuń zapisane stemple.
- Zapisz bieżący stempel na dysk (
Narzędzie stempla
- USTAWIENIA → "Narzędzie stempla" (4 opcje):
Same as brush(domyślnie) — używa tego samego narzędzia co pędzelAny— brak wymagańPickaxe— wymaga założonego kilofaTerrainForge Rod— wymaga różdżki z moda
- HUD pokazuje
STEMP GOTOWY [2/5], gdy narzędzie jest założone + stemple znajdują się w schowku. - Bez narzędzia:
Stempel: narzędzie niezałożone, kopiowanie/wklejanie zablokowane.
💾 Migawki (Backupy)
Pełny backup/przywracanie terenu.
Zapisywanie
- USTAWIENIA → SNAPSHOTS.
- Nazwa (pusta = automatyczna data/godzina).
- Zapisz → edytowane kafelki do
BepInEx/config/TerrainForge/snapshots/<name>.dat(maks. 12).
Wczytywanie
- Wybierz migawkę.
- Wczytaj → przywraca kafelki wraz z własnością, 1 krok cofania.
- Niewczytane kafelki ostrzegają w czytelny sposób — importuj blisko pierwotnej lokalizacji.
Cechy
- Wersjonowany format binarny (
.dat). - Przywraca wysokość + smooth + farbę + własność.
- Import można cofnąć (
Ctrl+Zwycofuje import). - Niewczytane kafelki ostrzegają w czytelny sposób.
💾 Profile
Zapisuj/wczytuj pełne konfiguracje pędzla.
- USTAWIENIA → PROFILE.
- Nazwa + Zapisz → promień, miękkość, operacja, kształt, farba, tryb rampy, kąt, tryb wygładzania, raise delta, siła farby, falloff, shore offset.
- Wczytaj → stosuje natychmiast.
- Maks. 12 profili (format niezależny od kultury w
Presets > Slots). - Skrót:
Next Profile(przypisz w KLAWISZACH), aby przełączać.
🌐 Języki
15 opcji: Auto, English, Español, Français, Deutsch, Русский, 中文, 繁體中文, 日本語, 한국어, Polski, Português, Türkçe, Українська, Italiano — domyślnie Auto.
Auto-Wykrywanie
- Domyślne
Autowykrywa język gry przez reflection:Localization.instance.GetSelectedLanguage(). - Mapuje język Valheim → indeks wewnętrzny.
- Jeśli język nie ma pełnego tłumaczenia → następuje powrót do English.
- Konfigurowalne w USTAWIENIACH → "Język" (przełącza 15 opcji).
- Etykiety klawiszy są odbudowywane przy otwarciu menu.
Status tłumaczeń
- Pełne: English, Español
- Powrót do English: Français, Deutsch, Русский, 中文, 繁體中文, 日本語, 한국어, Polski, Português, Türkçe, Українська, Italiano
- Tłumaczenia społeczności mile widziane przez PR.
Ta dokumentacja
Przetłumaczone strony wiki: English · Español · Français · Deutsch · Русский · 中文 · 繁體中文 · 日本語 · 한국어 · Polski · Português · Türkçe · Українська · Italiano.
🌍 Wieloosobowość
Wymagania
- Mod na kliencie ORAZ serwerze dla edycji większych niż ±8 m i poprawnej replikacji.
UnlockDeltaLimitrównież na serwerze, w przeciwnym razie serwer ogranicza teren.
Autorytet serwera (Synchronizacja konfiguracji)
Gdy serwer uruchamia mod, jego sekcja Server ma pierwszeństwo:
AllowTerrainEdits(domyślnietrue) — główny przełącznik; jeślifalse, klienci nie mogą stosować/cofać/ponawiać.AdminOnlyEdits(domyślniefalse) — tylko admini/host mogą edytować.RespectWards(domyślnietrue) — blokuje edycje wewnątrz obcych wards.RadiusCap/DeltaCap(0 = wyłączone) — limity narzucane przez serwer, widoczne w HUD+podglądzie.
Serwery bez moda ignorują tę sekcję → klient działa do testów.
Zapobieganie desynchronizacji
- Utrzymuj spójne
MaxUpDelta/MaxDownDeltana serwerze + klientach. - Duże promienie mogą desynchronizować klientów bez moda.
⚙️ Ustawienia
Plik: BepInEx/config/com.terrainforge.valheim.cfg
Ogólne
| Ustawienie | Domyślnie | Opis |
|---|---|---|
Enabled |
true |
Główny przełącznik |
PlayEffects |
true |
Pył + trafienie przy zastosowaniu |
Language |
Auto |
Auto / English / Español / Français / Deutsch / Русский / 中文 / 繁體中文 / 日本語 / 한국어 / Polski / Português / Türkçe / Українська / Italiano |
ToolTint |
true |
Barwi Różdżkę TerrainForge (klon Młota), aby łatwo odróżnić ją od waniliowego Młota |
ToolTintColor |
#4FC3F7 |
Kolor hex różdżki (model + ikona). Np. #FFC400 złoty, #8BC34A zielony |
Pędzel
| Ustawienie | Domyślnie | Zakres | Opis |
|---|---|---|---|
Radius |
8 | 1–100 | Promień pędzla (m) |
RadiusMin |
2 | — | Minimalny promień podczas dostosowywania |
RadiusMax |
60 | — | Maksymalny promień podczas dostosowywania |
RadiusStep |
1 | — | Zmiana promienia na klawisz/rolkę |
Softness |
50 | 0–100 | Miękkość krawędzi (0 = twarda, 100 = bardzo miękka) |
FalloffPower |
3 | 1–5 | Wykładnik opadania (tylko tryb Spiczasty) |
RaiseLowerMeters |
2 | 0.5–10 | Metry na zastosowanie Podnieś/Obniż |
PaintStrength |
1 | 0–1 | Siła farby |
DefaultOperation |
Flatten | — | Operacja początkowa |
Shape |
Circle | — | Kształt początkowy |
Paint |
Dirt | — | Farba początkowa |
RampMode |
TwoPoint | — | TwoPoint / FixedAngle / Path |
SlopeAngle |
30 | 5–60 | Stały kąt rampy (stopnie) |
SmoothMode |
Full | — | Full / Bumps / Dips |
FalloffMode |
Pointy | — | Pointy / Flat / Smooth / Linear |
ShoreOffset |
0.5 | -2–5 | Margines brzegu nad wodą (m) |
UseFixedHeight |
false | — | Używaj stałej wysokości (stan kroplomierza) |
FixedHeight |
30 | -10–150 | Dokładna wysokość Wyrównywania (m) |
Vanilla / integracja
BlockVanillaTerrainTools: false — przy założonej różdżce ignoruje edycję terenu waniliowej motyki/kultywatora. W USTAWIENIACH jest też przełącznik.
Wejście
Wszystkie skróty są przypisywalne na zakładce KLAWISZE. Najważniejsze:
ApplyKey(Mouse1),RadiusUp/Down(=/-),CycleOp/Shape/Paint(,/.//)UndoKey(Ctrl+Z),RedoKey(Ctrl+Y),EyedropKey(G),RampModeKey(H)RadialKey(Q),AdjustModeKey(V),GiveToolKey(F8),RebindMenuKey(F5)- Bezpośrednie klawisze operacji (9, brak domyślnych): OpFlatten/Raise/Lower/Smooth/Paint/Restore/Ramp/Shore/Snow
CycleProfileKey,CycleStampKey,CycleStampBackKeyRequiredTool: Any / Pickaxe / TerrainForgeTool (domyślnie)AutoGiveTool: true (przyznaje różdżkę po dołączeniu)
Stemple
StampToolMode: Same as Brush / Any / Pickaxe / TerrainForgeTool (domyślnie Same as Brush)
Podgląd
ShowPreview: true,ShowGuides: true (prowadnice zasięgu, przyciemnienie nachylenia, pierścień poziomu)
Historia
UndoDepth: 50 (0–500, 0 wyłącza historię)
Serwer (Autorytatywny przez Config Sync)
AllowTerrainEdits: true (główny przełącznik)AdminOnlyEdits: false (tylko admini)RespectWards: true (blokuje obce wards)RadiusCap/DeltaCap: 0 (wyłączone) — limity narzucane przez serwer
Wydajność
TilesPerFrame: 4 (1–32 kafelków/klatkę)
🐛 Rozwiązywanie problemów
| Problem | Rozwiązanie |
|---|---|
| Menu się nie pojawia / niewidoczny kursor | Zamknij grę. Usuń %APPDATA%\Thunderstore Mod Manager\DataFolder\Valheim\profiles\YourProfile\BepInEx\plugins\TerrainForge\ i %APPDATA%\Thunderstore Mod Manager\PackageCache\. Uruchom ponownie TMM, sprawdź aktualizacje. |
| Aktualizacja nie pojawia się w TMM | TMM → Settings → "Refresh mod list" (Ctrl+R). Zamknij/otwórz ponownie TMM. Sprawdź właściwy profil. |
| Konflikt wersji w Thunderstore | Podnieś wersję (0.3.3 → 0.3.4) w .csproj, Plugin.cs, manifest.json. Przebuduj + wgraj ponownie. |
| Kopiowanie/wklejanie stempla nic nie robi | HUD: STEMP GOTOWY [X/Y] = gotowe. Jeśli "narzędzie niezałożone", załóż narzędzie (USTAWIENIA → Narzędzie stempla). |
| Podgląd niewidoczny pod wodą | Naprawione w 0.3.2 — podgląd unosi się na powierzchni. Zaktualizuj. |
| Okręgi na Linii/Prostokącie/Wielokącie | Naprawione w 0.3.2 — pokazywany jest tylko zaznaczony kontur. Zaktualizuj. |
| Rolka radialna nie działa | Naprawione w 0.3.2 (ZInput.GetMouseScrollWheel()) i 0.3.4 (zaznaczenie nie jest już czyszczone przy wyśrodkowanym kursorze). Zaktualizuj. |
| Konfiguracja się nie zapisuje | Zamknij menu (F5), aby zapisać automatycznie. Albo edytuj BepInEx/config/com.terrainforge.valheim.cfg bezpośrednio. |
| Desynchronizacja w trybie wieloosobowym | Mod na kliencie+serwerze. UnlockDeltaLimit na obu. Te same MaxUpDelta/MaxDownDelta. |
| Budowanie kończy się niepowodzeniem | Sprawdź ścieżki ValheimDir, BepInExCoreDir, JotunnDir w .csproj lub przez CLI. Wymagany .NET SDK 8+. |
| Kompilacja / pakowanie | dotnet build -c Release (DLL w build/), -p:Deploy=true (instaluje w profilu) lub -p:Package=true (zip w build/). |
🔗 Linki
- Strona Thunderstore: https://thunderstore.io/c/valheim/p/MRAnalytics/TerrainForge/
- Repozytorium GitHub: https://github.com/marceloanton/TerrainForge
- Dotacje: cafecito.app/byrka
- Dziennik zmian: CHANGELOG.md
TerrainForge — Terraformuj Valheim bez ograniczeń.