Wiki di TerrainForge

Overview · English · Español · Français · Deutsch · Русский · 中文 · 繁體中文 · 日本語 · 한국어 · Polski · Português · Türkçe · Українська · Italiano · Website

TerrainForge 0.3.8 — Hotfix per la 0.3.7

La ruota Q include la modalità Copia/Incolla. Rettangolo segna A/B con Applica; Linea segna due estremi; Poligono aggiunge vertici e copia con doppia pressione dopo 3+ punti; Cerchio/Quadrato copia l’impronta del pennello. L’HUD mostra il passo successivo. La neve è in Pittura > DeepSnow (tieni Shift per rimuoverla). F5 blocca movimento e telecamera locali; Esc mette in pausa tutto il mondo in singolo. 0.3.6: F5 dispone le schede su due righe e mostra i controlli dell’operazione selezionata. Ramp offre Due punti, Angolo fisso e Connessa; le rampe circolari sono previste per la 0.4.0.

Indice

1. Installazione
2. Avvio Rapido
3. Comandi
4. Operazioni
5. Forme
6. Modalità di Caduta
7. Stamps (Copia/Incolla)
8. Snapshots (Backup)
9. Profili
10. Lingue
11. Multigiocatore
12. Impostazioni
13. Risoluzione dei Problemi

📥 Installazione

Requisiti

• BepInEx 5 (x64, Mono) su client e server. Gli utenti Thunderstore ce l'hanno già.

Passaggi

1. Scarica TerrainForge-<version>.zip da Thunderstore o GitHub Releases.
2. Estrai e colloca TerrainForge.dll in: - Client: ...\BepInEx\plugins\TerrainForge\TerrainForge.dll - Server: <server>\BepInEx\plugins\TerrainForge\TerrainForge.dll
3. Riavvia il gioco / il server.

⚠️ Deve essere installato su client E server per modifiche superiori a ±8 m e una corretta replicazione.

🚀 Avvio Rapido

1. Entra in un mondo. La Bacchetta TerrainForge (un clone del Martello) viene fornita ed equipaggiata automaticamente.
2. Premi F5 per aprire il menu (o clicca il pulsante TerrainForge nel menu di pausa ESC).
3. Equipaggia la bacchetta se non lo è.
4. Mira al terreno e tieni premuto il clic destro (Mouse1) per scolpire.
5. Usa , per scorrere le operazioni, . per le forme, / per le pitture.
6. Tieni premuto Q → menu radiale, rilascia per confermare.
7. Ctrl+Z / Ctrl+Y per annullare/ripetere.

⌨️ Comandi

Tasti extra (nessun predefinito, assegnali in TASTI): - Operazione diretta: Appiattisci, Alza, Abbassa, Leviga, Pittura, Ripristina, Rampa, Costa, Neve - Profilo successivo / precedente - Stamp successivo / precedente (cronologia)

Sezione "Azioni rapide" (scheda TASTI): pulsanti per funzioni senza scorciatoia obbligatoria — Annulla, Ripeti, Fissa altezza, Copia/Incolla stamp, Stamp precedente, Cancella marcature, le mappe di calore e la Diagnostica materiale (scarica lo shader + gli slot delle texture nel log).

🔄 Operazioni

📐 Forme

Scorri con il tasto .. Tutte supportano l'annullamento.

• Le forme non circolari mostrano solo il contorno marcato (nessun anello circolare).
• La morbidezza influisce sul blend dei bordi su tutte le forme.

⚙️ Modalità di Caduta (Alza/Abbassa)

Config in IMPOSTAZIONI → "Caduta Raise/Lower":

🧱 Stamps (Copia/Incolla)

Una funzione potente per replicare strutture del terreno.

Selezione rettangolare (consigliata)

Scegli Copia/Incolla nella ruota Q. Applica marca l’area: due angoli per Rettangolo, due estremi per Linea, vertici per Poligono (doppia pressione dopo 3+ punti), o l’impronta del pennello per Cerchio/Quadrato. L’HUD indica il passo successivo.

Flusso di lavoro

1. Marca l'area: usa una qualsiasi forma (Cerchio, Rett, Linea, Poli, Rampa) — o la selezione rettangolare qui sopra.
2. Copia: Ctrl+Shift+C → "Stamp copiato: X tile" (appunti in RAM).
3. Anteprima Incolla: Ctrl+Shift+V → wireframe fantasma sul mirino. - Q/E = ruota ±15° - Alt+Rotellina = rotazione continua - Shift+Rotellina = scala 0,25×–4× - Esc = annulla
4. Confirm: Premi di nuovo il tasto Incolla per confermare l’anteprima.

Gli stamp di selezione scrivono solo dentro la regione copiata; il terreno esterno resta intatto.

Cronologia

• Fino a 10 stamp in RAM (più recente per primo).
• Tasti Next stamp / Previous stamp (riassegnabili) per scorrerli.
• Flash: "Cronologia stamp: Copy: 3 tile [2/5]"

Persistenza

• IMPOSTAZIONI → STAMPS:
• Salva lo stamp corrente su disco (.stamp in BepInEx/config/TerrainForge/stamps/, max 12).
• Carica uno stamp negli appunti.
• Elenca/elimina gli stamp salvati.

Strumento stamp

• IMPOSTAZIONI → "Stamp tool" (4 opzioni):
• Same as brush (predefinito) — usa lo stesso strumento del pennello
• Any — nessun requisito
• Pickaxe — richiede un piccone equipaggiato
• TerrainForge Rod — richiede la bacchetta della mod
• L'HUD mostra STAMP READY [2/5] quando lo strumento è equipaggiato + ci sono stamp negli appunti.
• Senza lo strumento: Stamp: tool not equipped, copia/incolla bloccati.

💾 Snapshots (Backup)

Backup/ripristino completo del terreno.

Salva

1. IMPOSTAZIONI → SNAPSHOTS.
2. Nome (vuoto = data/ora automatica).
3. Salva → tile modificati in BepInEx/config/TerrainForge/snapshots/<name>.dat (max 12).

Carica

1. Seleziona uno snapshot.
2. Carica → ripristina i tile con ownership, 1 passo di annulla.
3. I tile non caricati avvisano in modo pulito — importa vicino alla posizione originale.

Caratteristiche

• Formato binario versionato (.dat).
• Ripristina altezza + smooth + pittura + ownership.
• L'importazione è annullabile (Ctrl+Z annulla l'importazione).
• I tile non caricati avvisano in modo pulito.

💾 Profili

Salva/carica configurazioni complete del pennello.

• IMPOSTAZIONI → PROFILES.
• Nome + Salva → raggio, morbidezza, op, forma, pittura, modalità rampa, angolo, modalità levigatura, raise delta, intensità pittura, falloff, shore offset.
• Carica → applica immediatamente.
• Max 12 profili (formato culture-invariant in Presets > Slots).
• Scorciatoia: Next Profile (assegna in TASTI) per scorrere.

🌐 Lingue

15 opzioni: Auto, English, Español, Français, Deutsch, Русский, 中文, 繁體中文, 日本語, 한국어, Polski, Português, Türkçe, Українська, Italiano — predefinito Auto.

Auto-Detect

• Il default Auto rileva la lingua del gioco tramite reflection: Localization.instance.GetSelectedLanguage().
• Mappa la lingua di Valheim → indice interno.
• Se una lingua non ha una traduzione completa → fallback all'inglese.
• Configurabile in IMPOSTAZIONI → "Language" (scorre le 15 opzioni).
• Le etichette dei tasti vengono ricostruite all'apertura del menu.

Stato delle traduzioni

• Complete: English, Español
• Fallback all'inglese: Français, Deutsch, Русский, 中文, 繁體中文, 日本語, 한국어, Polski, Português, Türkçe, Українська, Italiano
• Traduzioni della community benvenute via PR.

Questa documentazione

Pagine wiki tradotte: English · Español · Français · Deutsch · Русский · 中文 · 繁體中文 · 日本語 · 한국어 · Polski · Português · Türkçe · Українська · Italiano.

🌍 Multigiocatore

Requisiti

• Mod su client E server per modifiche superiori a ±8 m e una corretta replicazione.
• UnlockDeltaLimit anche sul server, altrimenti il server limita il terreno.

Autorità del Server (Config Sync)

Quando il server esegue la mod, la sua sezione Server prevale: - AllowTerrainEdits (default true) — interruttore principale; se false, i client non possono applicare/annullare/ripetere. - AdminOnlyEdits (default false) — solo admin/host possono modificare. - RespectWards (default true) — blocca le modifiche dentro ward altrui. - RadiusCap / DeltaCap (0 = off) — limiti imposti dal server, visibili in HUD+anteprima.

I server senza la mod ignorano la sezione → il client funziona per i test.

Prevenzione del Desync

• Mantieni MaxUpDelta / MaxDownDelta coerenti su server + client.
• Raggi grandi possono desincronizzare i client senza la mod.

⚙️ Impostazioni

File: BepInEx/config/com.terrainforge.valheim.cfg

Generale

Pennello

Vanilla / integrazione

• BlockVanillaTerrainTools: false — con la bacchetta equipaggiata, ignora la modifica del terreno di zappa/coltivatore vanilla. C'è anche un interruttore in IMPOSTAZIONI.

Input

Tutte le scorciatoie sono riassegnabili nella scheda TASTI. In evidenza: - 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) - Tasti diretti op (9, nessun default): OpFlatten/Raise/Lower/Smooth/Paint/Restore/Ramp/Shore/Snow - CycleProfileKey, CycleStampKey, CycleStampBackKey - RequiredTool: Any / Pickaxe / TerrainForgeTool (default) - AutoGiveTool: true (fornisce la bacchetta all'ingresso)

Stamps

• StampToolMode: Same as Brush / Any / Pickaxe / TerrainForgeTool (default Same as Brush)

Anteprima

• ShowPreview: true, ShowGuides: true (guide di portata, tinta della pendenza, anello di livello)

Cronologia

• UndoDepth: 50 (0–500, 0 disattiva la cronologia)

Server (Autoritativo via Config Sync)

• AllowTerrainEdits: true (interruttore principale)
• AdminOnlyEdits: false (solo admin)
• RespectWards: true (blocca ward altrui)
• RadiusCap / DeltaCap: 0 (off) — limiti imposti dal server

Prestazioni

• TilesPerFrame: 4 (1–32 tile/frame)

🐛 Risoluzione dei Problemi

🔗 Link

• Pagina Thunderstore: https://thunderstore.io/c/valheim/p/MRAnalytics/TerrainForge/
• Repository GitHub: https://github.com/marceloanton/TerrainForge
• Donazioni: cafecito.app/byrka
• Changelog: Changelog

TerrainForge — Trasforma Valheim senza limiti.