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-pt
Updated a month agoWiki do TerrainForge
English · Español · Français · Deutsch · Русский · 中文 · 繁體中文 · 日本語 · 한국어 · Polski · Português · Türkçe · Українська · Italiano
Índice
- Instalação
- Início Rápido
- Controles
- Operações
- Formas
- Modos de Queda
- Stamps (Copiar/Colar)
- Snapshots (Backups)
- Perfis
- Idiomas
- Multijogador
- Configurações
- Solução de Problemas
📥 Instalação
Requisitos
- BepInEx 5 (x64, Mono) no cliente e no servidor. Usuários do Thunderstore já o possuem.
- Jotunn (
ValheimModding-Jotunn) — registra a ferramenta personalizada. Está listado emmanifest.json; o Thunderstore o instala automaticamente.
Passos
- Baixe
TerrainForge-<version>.zipdo Thunderstore ou do GitHub Releases. - Extraia e coloque
TerrainForge.dllem:- Cliente:
...\BepInEx\plugins\TerrainForge\TerrainForge.dll - Servidor:
<servidor>\BepInEx\plugins\TerrainForge\TerrainForge.dll
- Cliente:
- Reinicie o jogo / servidor.
⚠️ Deve ser instalado no cliente E no servidor para edições maiores que ±8 m e replicação correta.
🚀 Início Rápido
- Entre em um mundo. A Varinha TerrainForge (clone do Martelo) é entregue e equipada automaticamente.
- Pressione
F5para abrir o menu (ou clique no botão TerrainForge no menu de pausaESC). - Equipe a varinha se ela não estiver equipada.
- Mire no terreno e segure o clique direito (
Mouse1) para esculpir. - Use
,para alternar operações,.para formas,/para pinturas. - Segure
Q→ menu radial, solte para confirmar. Ctrl+Z/Ctrl+Ypara desfazer/refazer.
⌨️ Controles
| Ação | Tecla padrão | Descrição |
|---|---|---|
| Aplicar pincel | Segurar Mouse1 (clique direito) |
Esculpe o terreno sob a mira |
| Raio + | = ou Ctrl+Roda |
Aumenta o raio do pincel |
| Raio − | - ou Ctrl+Roda |
Diminui o raio do pincel |
| Alternar operação | , |
Alterna as 9 operações |
| Alternar forma | . |
Círculo → Quadrado → Linha → Ret → Poli |
| Alternar pintura | / |
Alterna os 6 tipos de pintura |
| Nivelar aos pés | Segurar Shift esq. |
Aplanar usa a altura do jogador |
| Desfazer | Ctrl+Z |
Desfaz o último traço |
| Refazer | Ctrl+Y |
Refaz o traço desfeito |
| Conta-gotas | G |
Fixa a altura de Aplanar na mira (de novo = libera) |
| Modo de rampa | H |
Alterna: Dois Pontos → Ângulo Fixo → Caminho (ou escolha com 3 botões em CONFIGURAÇÕES) |
| Ângulo de rampa fixo | Segurar Alt + raio/roda |
Ajusta o ângulo no modo fixo |
| Menu radial | Segurar Q |
Escolha uma operação com o mouse, soltar confirma |
| Modo de ajuste | V |
Roda = raio, congela zoom/barra/mapa |
| Ajuste fino (0,1 m) | Segurar Shift + roda/raio |
Ajuste preciso do raio |
| Copiar Stamp | Ctrl+Shift+C |
Copia a área marcada para a área de transferência |
| Colar Stamp | Ctrl+Shift+V |
Preview fantasma, clique confirma |
| Obter Varinha | F8 |
Entrega a Varinha TerrainForge |
| Abrir menu | F5 |
Abre o menu de teclas/ajuda/configurações |
Teclas extras (sem padrão, atribua-as em TECLAS):
- Operação direta: Aplanar, Levantar, Baixar, Suavizar, Pintar, Restaurar, Rampa, Costa, Neve
- Próximo / anterior perfil
- Próximo / anterior stamp (histórico)
Seção "Ações rápidas" (aba TECLAS): botões para funções sem atalho obrigatório — Desfazer, Refazer, Fixar altura, Copiar/Colar stamp, Stamp anterior, Limpar marcas, os mapas de calor e o Diagnóstico de material (despeja o shader + slots de textura no log).
🔄 Operações
| Operação | Descrição |
|---|---|
| Aplanar | Nivela até a altura apontada (Shift = aos seus pés). Altura fixa via Conta-gotas (G) ou a caixa de texto de CONFIGURAÇÕES. |
| Levantar | Eleva o terreno em RaiseDelta por aplicação. O modo de queda dá forma a ele. |
| Baixar | Rebaixa o terreno em RaiseDelta por aplicação. O modo de queda dá forma a ele. |
| Suavizar | Blur de verdade: faz a média de cada vértice com seus 8 vizinhos. Segure para progressivo. Modos: Completo (ambos), Apenas Cristas (rebaixa), Apenas Depressões (eleva). Forma Linha = suaviza um caminho. |
| Rampa | 3 modos (alterna H):• Dois Pontos: marque A e B → uma inclinação reta une as alturas. • Ângulo Fixo: B = direção/comprimento; altura = SlopeAngle (sobe/desce conforme a mira). Ajuste com Alt+raio.• Caminho: marque uma curva A→B→C… (duplo toque com 3+ fecha) → Catmull-Rom suave. Largura = raio do pincel. Suavidade = blend apenas nas bordas laterais. Preview: corredor preenchido + anéis de altura em A/B. |
| Costa | Aplana em direção ao nível da água + margem ShoreOffset (praias). Suavidade como Aplanar. |
| Pintar | Tipos: Dirt, Cultivated, Paved, ClearVegetation, DeepSnow, Reset. Força ajustável. |
| Restaurar | Devolve o terreno ao seu estado original (altura + pintura). |
| Neve | Pintura apenas de neve (mesma máscara do jogo). Shift = remove e restaura o original. |
📐 Formas
Alterne com a tecla .. Todas suportam desfazer.
| Forma | Marcação | Caso de uso |
|---|---|---|
| Círculo | Clique único (centro do pincel) | Escultura geral |
| Quadrado | Clique único (centro) | Plataformas, fundações |
| Linha | 2 cliques (A → B) | Caminhos, muros, trilhas. Meia-largura = raio. |
| Retângulo | 2 cliques (cantos opostos) | Fundações, fazendas, plataformas. Bordas suaves. |
| Polígono | Clique por vértice, duplo clique fecha (3+ vértices) | Formas complexas, áreas personalizadas |
- As formas não circulares mostram apenas o contorno marcado (sem anéis circulares).
- A suavidade afeta o blend das bordas em todas as formas.
⚙️ Modos de Queda (Levantar/Baixar)
Configuração em CONFIGURAÇÕES → "Queda de Raise/Lower":
| Modo | Comportamento |
|---|---|
| Pontudo | Pico central. Controlado pelo slider "Potência da queda" (1–5). |
| Plano | Disco uniforme — mesmo peso em todo o raio. |
| Suave | Campana de cosseno — transição suave, sem borda dura. |
| Linear | Afunilamento reto do centro até a borda. |
🧱 Stamps (Copiar/Colar)
Uma função poderosa para replicar estruturas de terreno.
Seleção por retângulo (recomendada)
- Defina a forma como
Retângulo(tecla.). - Pressione Aplicar (
Mouse1) uma vez para marcar o canto A (isso não faz edição alguma). - Mire no canto B (apenas mova a câmera).
- Pressione
Ctrl+Shift+C→ copia exatamente aquele retângulo, recortado à seleção (não arrasta blocos inteiros de 64 m nem o terreno intocado ao redor). A marca do canto A é consumida após uma cópia bem-sucedida.
Fluxo de trabalho
- Marque a área: use qualquer forma (Círculo, Ret, Linha, Poli, Rampa) — ou a seleção por retângulo acima.
- Copiar:
Ctrl+Shift+C→ "Stamp copiado: X tiles" (área de transferência na RAM). - Preview de colagem:
Ctrl+Shift+V→ wireframe fantasma na mira.Q/E= rotacionar ±15°Alt+Roda = rotação contínuaShift+Roda = escalar 0.25×–4×Esc= cancelar
- Confirmar: clique (
Mouse1) → aplica como um único passo de Desfazer.
Os stamps de seleção gravam apenas dentro da região copiada; o terreno fora dela permanece intocado.
Histórico
- Até 10 stamps na RAM (mais recente primeiro).
- Teclas
Próximo stamp/Stamp anterior(reatribuíveis) os alternam. - Flash: "Histórico de stamps: Copy: 3 tiles [2/5]"
Persistência
- CONFIGURAÇÕES → STAMPS:
- Salvar o stamp atual em disco (
.stampemBepInEx/config/TerrainForge/stamps/, máx 12). - Carregar um stamp para a área de transferência.
- Listar/excluir stamps salvos.
- Salvar o stamp atual em disco (
Ferramenta de stamp
- CONFIGURAÇÕES → "Ferramenta de stamp" (4 opções):
Igual ao pincel(padrão) — usa a mesma ferramenta que o pincelQualquer— sem requisitoPicareta— requer uma picareta equipadaVarinha TerrainForge— requer a varinha do mod
- O HUD mostra
STAMP PRONTO [2/5]quando a ferramenta está equipada + stamps na área de transferência. - Sem a ferramenta:
Stamp: ferramenta não equipada, copiar/colar bloqueados.
💾 Snapshots (Backups)
Backup/restauração completa do terreno.
Salvar
- CONFIGURAÇÕES → SNAPSHOTS.
- Nome (vazio = data/hora automática).
- Salvar → tiles editados para
BepInEx/config/TerrainForge/snapshots/<nome>.dat(máx 12).
Carregar
- Selecione um snapshot.
- Carregar → restaura os tiles com ownership, 1 passo de desfazer.
- Tiles não carregados avisam de forma limpa — importe perto do local original.
Características
- Formato binário versionado (
.dat). - Restaura altura + smooth + pintura + ownership.
- A importação é desfazível (
Ctrl+Zreverte a importação). - Tiles não carregados avisam de forma limpa.
💾 Perfis
Salvar/carregar configurações completas de pincel.
- CONFIGURAÇÕES → PERFIS.
- Nome + Salvar → raio, suavidade, op, forma, pintura, modo de rampa, ângulo, modo de suavização, raise delta, força de pintura, falloff, shore offset.
- Carregar → aplica instantaneamente.
- Máx 12 perfis (formato culture-invariant em
Presets > Slots). - Atalho:
Next Profile(atribua em TECLAS) para alternar.
🌐 Idiomas
15 opções: Auto, English, Español, Français, Deutsch, Русский, 中文, 繁體中文, 日本語, 한국어, Polski, Português, Türkçe, Українська, Italiano — padrão Auto.
Auto-Detect
- O
Autopadrão detecta o idioma do jogo via reflection:Localization.instance.GetSelectedLanguage(). - Mapeia o idioma do Valheim → índice interno.
- Se um idioma não tiver tradução completa → fallback para English.
- Configurável em CONFIGURAÇÕES → "Idioma" (alterna as 15 opções).
- Os rótulos das teclas são reconstruídos ao abrir o menu.
Status das traduções
- Completas: English, Español
- Fallback para English: Français, Deutsch, Русский, 中文, 繁體中文, 日本語, 한국어, Polski, Português, Türkçe, Українська, Italiano
- Traduções da comunidade são bem-vindas via PR.
Esta documentação
Páginas da wiki traduzidas: English · Español · Français · Deutsch · Русский · 中文 · 繁體中文 · 日本語 · 한국어 · Polski · Português · Türkçe · Українська · Italiano.
🌍 Multijogador
Requisitos
- Mod no cliente E no servidor para edições maiores que ±8 m e replicação correta.
UnlockDeltaLimittambém no servidor, caso contrário o servidor limita o terreno.
Autoridade do Servidor (Config Sync)
Quando o servidor roda o mod, sua seção Server prevalece:
AllowTerrainEdits(padrãotrue) — master switch; se forfalse, os clientes não podem aplicar/desfazer/refazer.AdminOnlyEdits(padrãofalse) — apenas admins/host podem editar.RespectWards(padrãotrue) — bloqueia edições dentro de wards alheios.RadiusCap/DeltaCap(0 = off) — limites impostos pelo servidor, visíveis no HUD+preview.
Servidores sem o mod ignoram a seção → o cliente funciona para testes.
Prevenção de Desync
- Mantenha
MaxUpDelta/MaxDownDeltaconsistentes no servidor + clientes. - Raios grandes podem dessincronizar clientes sem o mod.
⚙️ Configurações
Arquivo: BepInEx/config/com.terrainforge.valheim.cfg
Geral
| Setting | Padrão | Descrição |
|---|---|---|
Enabled |
true |
Master switch |
PlayEffects |
true |
Poeira + impacto ao aplicar |
Language |
Auto |
Auto / English / Español / Français / Deutsch / Русский / 中文 / 繁體中文 / 日本語 / 한국어 / Polski / Português / Türkçe / Українська / Italiano |
ToolTint |
true |
Tingem a Varinha TerrainForge (clone do Martelo) para diferenciá-la facilmente do Martelo vanilla |
ToolTintColor |
#4FC3F7 |
Cor hex da varinha (modelo + ícone). Ex.: #FFC400 dourado, #8BC34A verde |
Pincel
| Setting | Padrão | Faixa | Descrição |
|---|---|---|---|
Radius |
8 | 1–100 | Raio do pincel (m) |
RadiusMin |
2 | — | Raio mínimo ao ajustar |
RadiusMax |
60 | — | Raio máximo ao ajustar |
RadiusStep |
1 | — | Variação de raio por tecla/roda |
Softness |
50 | 0–100 | Suavidade da borda (0 = dura, 100 = muito suave) |
FalloffPower |
3 | 1–5 | Expoente de queda (apenas modo Pontudo) |
RaiseLowerMeters |
2 | 0.5–10 | Metros por aplicação de Levantar/Baixar |
PaintStrength |
1 | 0–1 | Força de pintura |
DefaultOperation |
Flatten | — | Operação inicial |
Shape |
Circle | — | Forma inicial |
Paint |
Dirt | — | Pintura inicial |
RampMode |
TwoPoint | — | TwoPoint / FixedAngle / Path |
SlopeAngle |
30 | 5–60 | Ângulo da rampa fixa (graus) |
SmoothMode |
Full | — | Full / Bumps / Dips |
FalloffMode |
Pointy | — | Pointy / Flat / Smooth / Linear |
ShoreOffset |
0.5 | -2–5 | Margem de costa acima da água (m) |
UseFixedHeight |
false | — | Usar altura fixa (estado do conta-gotas) |
FixedHeight |
30 | -10–150 | Altura exata de Aplanar (m) |
Vanilla / integração
BlockVanillaTerrainTools: false — com a varinha equipada, ignora a edição de terreno da enxada/cultivador vanilla. Também há um interruptor em CONFIGURAÇÕES.
Entrada
Todos os atalhos são reatribuíveis na aba TECLAS. Destaques:
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)- Teclas diretas de op (9, sem padrão): OpFlatten/Raise/Lower/Smooth/Paint/Restore/Ramp/Shore/Snow
CycleProfileKey,CycleStampKey,CycleStampBackKeyRequiredTool: Any / Pickaxe / TerrainForgeTool (padrão)AutoGiveTool: true (entrega a varinha ao entrar)
Stamps
StampToolMode: Same as Brush / Any / Pickaxe / TerrainForgeTool (padrão Same as Brush)
Preview
ShowPreview: true,ShowGuides: true (guias de alcance, tonalidade de inclinação, anel de nível)
Histórico
UndoDepth: 50 (0–500, 0 desativa o histórico)
Servidor (Autoritativo via Config Sync)
AllowTerrainEdits: true (master switch)AdminOnlyEdits: false (apenas admins)RespectWards: true (bloqueia wards alheios)RadiusCap/DeltaCap: 0 (off) — limites impostos pelo servidor
Desempenho
TilesPerFrame: 4 (1–32 tiles/frame)
🐛 Solução de Problemas
| Problema | Solução |
|---|---|
| O menu não aparece / cursor invisível | Feche o jogo. Exclua %APPDATA%\Thunderstore Mod Manager\DataFolder\Valheim\profiles\SeuPerfil\BepInEx\plugins\TerrainForge\ e %APPDATA%\Thunderstore Mod Manager\PackageCache\. Reinicie o TMM, verifique as atualizações. |
| Atualização não aparece no TMM | TMM → Settings → "Refresh mod list" (Ctrl+R). Feche/reabra o TMM. Verifique o perfil correto. |
| Conflito de versão no Thunderstore | Aumente a versão (0.3.3 → 0.3.4) em .csproj, Plugin.cs, manifest.json. Rebuild + re-upload. |
| Copiar/colar stamp não faz nada | HUD: STAMP PRONTO [X/Y] = pronto. Se disser "ferramenta não equipada", equipe a ferramenta (CONFIGURAÇÕES → Ferramenta de stamp). |
| Preview invisível debaixo d'água | Corrigido em 0.3.2 — o preview flutua na superfície. Atualize. |
| Círculos em Linha/Ret/Poli | Corrigido em 0.3.2 — apenas o contorno marcado é mostrado. Atualize. |
| A roda radial não funciona | Corrigido em 0.3.2 (ZInput.GetMouseScrollWheel()) e 0.3.4 (a seleção não é mais apagada com o cursor centralizado). Atualize. |
| A config não salva | Feche o menu (F5) para salvar automaticamente. Ou edite BepInEx/config/com.terrainforge.valheim.cfg diretamente. |
| Desync em multijogador | Mod no cliente+servidor. UnlockDeltaLimit em ambos. Mesmos MaxUpDelta/MaxDownDelta. |
| O build falha | Verifique os caminhos ValheimDir, BepInExCoreDir, JotunnDir em .csproj ou via CLI. Requer .NET SDK 8+. |
| Compilar / empacotar | dotnet build -c Release (DLL em build/), -p:Deploy=true (instala no perfil) ou -p:Package=true (zip em build/). |
🔗 Links
- Página no Thunderstore: https://thunderstore.io/c/valheim/p/MRAnalytics/TerrainForge/
- Repositório no GitHub: https://github.com/marceloanton/TerrainForge
- Doações: cafecito.app/byrka
- Changelog: CHANGELOG.md
TerrainForge — Terraforme o Valheim sem limites.