Home-es

Updated a month ago

Wiki de TerrainForge

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


Índice

  1. Instalación
  2. Inicio Rápido
  3. Controles
  4. Operaciones
  5. Formas
  6. Modos de Caída
  7. Stamps (Copiar/Pegar)
  8. Snapshots (Backups)
  9. Perfiles
  10. Idiomas
  11. Multijugador
  12. Configuración
  13. Solución de Problemas

📥 Instalación

Requisitos

  • BepInEx 5 (x64, Mono) en cliente y servidor. Los usuarios de Thunderstore ya lo tienen.
  • Jotunn (ValheimModding-Jotunn) — registra la herramienta personalizada. Está en manifest.json; Thunderstore lo instala automáticamente.

Pasos

  1. Descarga TerrainForge-<version>.zip desde Thunderstore o GitHub Releases.
  2. Extrae y coloca TerrainForge.dll en:
    • Cliente: ...\BepInEx\plugins\TerrainForge\TerrainForge.dll
    • Servidor: <servidor>\BepInEx\plugins\TerrainForge\TerrainForge.dll
  3. Reinicia el juego / servidor.

⚠️ Debe instalarse en cliente Y servidor para edits mayores a ±8 m y una replicación correcta.


🚀 Inicio Rápido

  1. Entra a un mundo. La Varita TerrainForge (clon del martillo) se entrega y equipa automáticamente.
  2. Pulsa F5 para abrir el menú (o haz clic en el botón TerrainForge del menú de pausa ESC).
  3. Equipa la varita si no lo está.
  4. Apunta al terreno y mantén clic derecho (Mouse1) para esculpir.
  5. Usa , para ciclar operaciones, . para formas, / para pinturas.
  6. Mantén Q → menú radial, suelta para confirmar.
  7. Ctrl+Z / Ctrl+Y para deshacer/rehacer.

⌨️ Controles

Acción Tecla por defecto Descripción
Aplicar brocha Mantener Mouse1 (clic derecho) Esculpe el terreno bajo la mira
Subir radio = o Ctrl+Rueda Aumenta el radio de la brocha
Bajar radio - o Ctrl+Rueda Disminuye el radio de la brocha
Cambiar operación , Cicla las 9 operaciones
Cambiar forma . Círculo → Cuadrado → Línea → Rect → Poli
Cambiar pintura / Cicla los 6 tipos de pintura
Nivelar a pies Mantener Shift izq. Aplanar usa la altura del jugador
Deshacer Ctrl+Z Deshace el último trazo
Rehacer Ctrl+Y Rehace el trazo deshecho
Cuentagotas G Fija la altura de Aplanar en la mira (otra vez = libera)
Modo de rampa H Cicla: Dos Puntos → Ángulo Fijo → Senda (o elige con 3 botones en AJUSTES)
Ángulo de rampa fija Mantener Alt + radio/rueda Ajusta el ángulo en modo fijo
Menú radial Mantener Q Elige operación con el mouse, soltar confirma
Modo ajuste V Rueda = radio, congela zoom/barra/mapa
Ajuste fino (0.1 m) Mantener Shift + rueda/radio Ajuste preciso del radio
Copiar Stamp Ctrl+Shift+C Copia el área marcada al portapapeles
Pegar Stamp Ctrl+Shift+V Preview fantasma, clic confirma
Obtener Varita F8 Entrega la Varita TerrainForge
Abrir menú F5 Abre el menú de teclas/ayuda/ajustes

Teclas extra (sin default, asígnalas en TECLAS):

  • Operación directa: Aplanar, Subir, Bajar, Suavizar, Pintar, Restaurar, Rampa, Costa, Nieve
  • Siguiente / anterior perfil
  • Siguiente / anterior stamp (historial)

Sección "Acciones rápidas" (pestaña TECLAS): botones para funciones sin atajo obligatorio — Deshacer, Rehacer, Fijar altura, Copiar/Pegar stamp, Stamp anterior, Limpiar marcas, los mapas de calor y el Diagnóstico de material (vuelca el shader + ranuras de textura al log).


🔄 Operaciones

Operación Descripción
Aplanar Nivela a la altura apuntada (Shift = a tus pies). Altura fija vía Cuentagotas (G) o el textbox de AJUSTES.
Subir Eleva el terreno RaiseDelta por aplicación. El modo de caída le da forma.
Bajar Baja el terreno RaiseDelta por aplicación. El modo de caída le da forma.
Suavizar Blur real: promedia cada vértice con sus 8 vecinos. Mantén para progresivo. Modos: Completo (ambos), Solo Lomos (baja), Solo Hoyos (sube). Forma Línea = suaviza un camino.
Rampa 3 modos (cicla H):
• Dos Puntos: marca A y B → una pendiente recta une las alturas.
• Ángulo Fijo: B = dirección/largo; altura = SlopeAngle (sube/baja según la mira). Ajusta con Alt+radio.
• Senda: marca una curva A→B→C… (doble-pulso con 3+ cierra) → Catmull-Rom suave.
Ancho = radio de la brocha. Suavidad = blend solo en los bordes laterales. Preview: corredor relleno + anillos de altura en A/B.
Costa Aplana hacia el nivel del agua + margen ShoreOffset (playas). Suavidad como Aplanar.
Pintar Tipos: Dirt, Cultivated, Paved, ClearVegetation, DeepSnow, Reset. Fuerza ajustable.
Restaurar Devuelve el terreno a su estado original (altura + pintura).
Nieve Pintura solo nieve (misma máscara que el juego). Shift = la quita y restaura el original.

📐 Formas

Cicla con la tecla .. Todas soportan deshacer.

Forma Marcado Caso de uso
Círculo Clic simple (centro de la brocha) Esculpido general
Cuadrado Clic simple (centro) Plataformas, cimientos
Línea 2 clics (A → B) Caminos, muros, senderos. Semiancho = radio.
Rectángulo 2 clics (esquinas opuestas) Cimientos, granjas, plataformas. Bordes suaves.
Polígono Clic por vértice, doble clic cierra (3+ vértices) Formas complejas, áreas custom
  • Las formas no circulares muestran solo el contorno marcado (sin anillos circulares).
  • La suavidad afecta el blend de bordes en todas las formas.

⚙️ Modos de Caída (Subir/Bajar)

Config en AJUSTES → "Caída Raise/Lower":

Modo Comportamiento
Punta Pico central. Controlado por el slider "Potencia caída" (1–5).
Plano Disco uniforme — mismo peso en todo el radio.
Suave Campana coseno — transición suave, sin borde duro.
Lineal Taper recto de centro a borde.

🧱 Stamps (Copiar/Pegar)

Función potente para replicar estructuras de terreno.

Selección por rectángulo (recomendado)

  1. Pon la forma en Rectángulo (tecla .).
  2. Pulsa Aplicar (Mouse1) una vez para marcar la esquina A (esto no edita nada).
  3. Apunta a la esquina B (solo mueve la cámara).
  4. Pulsa Ctrl+Shift+C → copia exactamente ese rectángulo, recortado a la selección (no arrastra tiles de 64 m enteros ni terreno sin tocar alrededor). La marca de A se consume tras una copia correcta.

Flujo

  1. Marca el área: usa cualquier forma (Círculo, Rect, Línea, Poli, Rampa) — o la selección por rectángulo de arriba.
  2. Copiar: Ctrl+Shift+C → "Stamp copiado: X tiles" (portapapeles en RAM).
  3. Preview Pegar: Ctrl+Shift+V → wireframe fantasma en la mira.
    • Q/E = rotar ±15°
    • Alt+Rueda = rotación continua
    • Shift+Rueda = escalar 0.25×–4×
    • Esc = cancelar
  4. Confirmar: clic (Mouse1) → aplica como un solo paso de Undo.

Los stamps de selección escriben solo dentro de la región copiada; el terreno de fuera no se toca.

Historial

  • Hasta 10 stamps en RAM (más reciente primero).
  • Teclas Siguiente stamp / Stamp anterior (reasignables) para ciclar.
  • Flash: "Stamp historial: Copy: 3 tiles [2/5]"

Persistencia

  • AJUSTES → STAMPS:
    • Guardar el stamp actual a disco (.stamp en BepInEx/config/TerrainForge/stamps/, máx 12).
    • Cargar un stamp al portapapeles.
    • Listar/borrar stamps guardados.

Herramienta stamp

  • AJUSTES → "Herramienta stamp" (4 opciones):
    • Igual a brocha (default) — usa la misma tool que la brocha
    • Cualquiera — sin requisito
    • Pico — requiere un pico equipado
    • Varita TerrainForge — requiere la varita del mod
  • El HUD muestra STAMP LISTO [2/5] si la tool está equipada + hay stamps en el portapapeles.
  • Sin la tool: Stamp: herramienta no equipada, copiar/pegar bloqueados.

💾 Snapshots (Backups)

Backup/restore completo del terreno.

Guardar

  1. AJUSTES → SNAPSHOTS.
  2. Nombre (vacío = fecha/hora automática).
  3. Guardar → tiles editados en BepInEx/config/TerrainForge/snapshots/<nombre>.dat (máx 12).

Cargar

  1. Selecciona un snapshot.
  2. Cargar → restaura los tiles con ownership, 1 paso de undo.
  3. Los tiles no cargados avisan limpiamente — importa cerca de la ubicación original.

Características

  • Formato binario versionado (.dat).
  • Restaura altura + smooth + pintura + ownership.
  • La importación es deshacible (Ctrl+Z revierte la importación).
  • Los tiles no cargados avisan limpiamente.

💾 Perfiles

Guarda/carga configuraciones completas de brocha.

  • AJUSTES → PERFILES.
  • Nombre + Guardar → radio, suavidad, op, forma, pintura, modo de rampa, ángulo, modo de suavizado, raise delta, fuerza de pintura, falloff, shore offset.
  • Cargar → aplica al instante.
  • Máx 12 perfiles (formato culture-invariant en Presets > Slots).
  • Atajo: Next Profile (asigna en TECLAS) para ciclar.

🌐 Idiomas

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

Auto-Detect

  • El default Auto detecta el idioma del juego vía reflection: Localization.instance.GetSelectedLanguage().
  • Mapea el idioma de Valheim → índice interno.
  • Si un idioma no tiene traducción completa → fallback a English.
  • Configurable en AJUSTES → "Idioma" (cicla las 15 opciones).
  • Las etiquetas de teclas se reconstruyen al abrir el menú.

Estado de las traducciones

  • Completas: English, Español
  • Fallback a English: Français, Deutsch, Русский, 中文, 繁體中文, 日本語, 한국어, Polski, Português, Türkçe, Українська, Italiano
  • Traducciones de la comunidad bienvenidas vía PR.

Esta documentación

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


🌍 Multijugador

Requisitos

  • Mod en cliente Y servidor para edits mayores a ±8 m y una replicación correcta.
  • UnlockDeltaLimit también en el servidor, si no el servidor clampa el terreno.

Autoridad del Servidor (Config Sync)

Cuando el servidor corre el mod, su sección Server gana:

  • AllowTerrainEdits (default true) — master switch; si es false, los clientes no pueden aplicar/deshacer/rehacer.
  • AdminOnlyEdits (default false) — solo admins/host editan.
  • RespectWards (default true) — bloquea edits dentro de wards ajenos.
  • RadiusCap / DeltaCap (0 = off) — caps aplicados por el servidor, visibles en HUD+preview.

Los servidores sin el mod ignoran la sección → el cliente funciona para test.

Prevención de Desync

  • Mantén MaxUpDelta / MaxDownDelta consistentes en servidor + clientes.
  • Radios grandes pueden desincronizar clientes sin el mod.

⚙️ Configuración

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

General

Setting Default Descripción
Enabled true Master switch
PlayEffects true Polvo + golpe al aplicar
Language Auto Auto / English / Español / Français / Deutsch / Русский / 中文 / 繁體中文 / 日本語 / 한국어 / Polski / Português / Türkçe / Українська / Italiano
ToolTint true Tiñe la Varita TerrainForge (clon del Martillo) para distinguirla a simple vista del Martillo vanilla
ToolTintColor #4FC3F7 Color hex de la varita (modelo + icono). Ej: #FFC400 oro, #8BC34A verde

Brocha

Setting Default Rango Descripción
Radius 8 1–100 Radio de la brocha (m)
RadiusMin 2 — Radio mínimo al ajustar
RadiusMax 60 — Radio máximo al ajustar
RadiusStep 1 — Cambio de radio por tecla/rueda
Softness 50 0–100 Suavidad de borde (0 = duro, 100 = muy suave)
FalloffPower 3 1–5 Exponente de caída (solo modo Punta)
RaiseLowerMeters 2 0.5–10 Metros por aplicación de Subir/Bajar
PaintStrength 1 0–1 Fuerza de pintura
DefaultOperation Flatten — Operación inicial
Shape Circle — Forma inicial
Paint Dirt — Pintura inicial
RampMode TwoPoint — TwoPoint / FixedAngle / Path
SlopeAngle 30 5–60 Ángulo de rampa fija (grados)
SmoothMode Full — Full / Bumps / Dips
FalloffMode Pointy — Pointy / Flat / Smooth / Linear
ShoreOffset 0.5 -2–5 Margen de costa sobre el agua (m)
UseFixedHeight false — Usar altura fija (estado del cuentagotas)
FixedHeight 30 -10–150 Altura exacta de Aplanar (m)

Vanilla / integración

  • BlockVanillaTerrainTools: false — con la varita equipada, ignora la edición de terreno de la azada/cultivador vanilla. También hay un interruptor en AJUSTES.

Entrada

Todos los atajos son reasignables en la pestaña TECLAS. Destacados:

  • 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 directas de op (9, sin default): OpFlatten/Raise/Lower/Smooth/Paint/Restore/Ramp/Shore/Snow
  • CycleProfileKey, CycleStampKey, CycleStampBackKey
  • RequiredTool: Any / Pickaxe / TerrainForgeTool (default)
  • AutoGiveTool: true (entrega la varita al entrar)

Stamps

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

Preview

  • ShowPreview: true, ShowGuides: true (guías de alcance, tinte de pendiente, anillo de nivel)

Historial

  • UndoDepth: 50 (0–500, 0 desactiva el historial)

Servidor (Autoritativo vía Config Sync)

  • AllowTerrainEdits: true (master switch)
  • AdminOnlyEdits: false (solo admins)
  • RespectWards: true (bloquea wards ajenos)
  • RadiusCap / DeltaCap: 0 (off) — caps aplicados por el servidor

Rendimiento

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

🐛 Solución de Problemas

Problema Solución
El menú no aparece / cursor invisible Cierra el juego. Borra %APPDATA%\Thunderstore Mod Manager\DataFolder\Valheim\profiles\TuPerfil\BepInEx\plugins\TerrainForge\ y %APPDATA%\Thunderstore Mod Manager\PackageCache\. Reinicia TMM, check updates.
Update no aparece en TMM TMM → Settings → "Refresh mod list" (Ctrl+R). Cierra/reabre TMM. Verifica el perfil correcto.
Conflicto de versión en Thunderstore Bumpea la versión (0.3.3 → 0.3.4) en .csproj, Plugin.cs, manifest.json. Rebuild + re-upload.
Copiar/pegar stamp no hace nada HUD: STAMP LISTO [X/Y] = listo. Si dice "herramienta no equipada", equipa la tool (AJUSTES → Herramienta stamp).
Preview invisible bajo el agua Corregido en 0.3.2 — el preview flota en la superficie. Actualiza.
Círculos en Línea/Rect/Poli Corregido en 0.3.2 — se muestra solo el contorno marcado. Actualiza.
La rueda radial no funciona Corregido en 0.3.2 (ZInput.GetMouseScrollWheel()) y 0.3.4 (la selección ya no se borra con el cursor centrado). Actualiza.
La config no guarda Cierra el menú (F5) para auto-guardar. O edita BepInEx/config/com.terrainforge.valheim.cfg directamente.
Desync en multijugador Mod en cliente+servidor. UnlockDeltaLimit en ambos. Mismos MaxUpDelta/MaxDownDelta.
El build falla Verifica los paths ValheimDir, BepInExCoreDir, JotunnDir en .csproj o vía CLI. Se requiere .NET SDK 8+.
Compilar / empaquetar dotnet build -c Release (DLL en build/), -p:Deploy=true (instala en el perfil) o -p:Package=true (zip en build/).

🔗 Enlaces


TerrainForge — Terraforma Valheim sin límites.