Вики TerrainForge

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

TerrainForge 0.3.8 — исправление для 0.3.7

В колесе Q появился отдельный режим «Копировать/вставить». Прямоугольник отмечает A/B клавишей «Применить», Линия — два конца, Многоугольник — вершины (двойное нажатие после 3+ точек), Круг/Квадрат копирует область кисти. HUD показывает следующий шаг. Снег теперь находится в «Покраска» > DeepSnow (удерживайте Shift, чтобы убрать). F5 блокирует локальное движение и камеру; Esc приостанавливает весь мир в одиночной игре. 0.3.6: вкладки F5 расположены в два ряда, а настройки соответствуют выбранной операции. У Ramp есть режимы «Две точки», «Фиксированный угол» и «Непрерывная трасса»; круговые рампы запланированы для 0.4.0.

📥 Установка

Требования

BepInEx 5 (x64, Mono) на клиенте и сервере. У пользователей Thunderstore он уже есть.

Шаги

Скачайте TerrainForge-<version>.zip с Thunderstore или GitHub Releases.
Распакуйте и поместите TerrainForge.dll в: - Клиент: ...\BepInEx\plugins\TerrainForge\TerrainForge.dll - Сервер: <сервер>\BepInEx\plugins\TerrainForge\TerrainForge.dll
Перезапустите игру / сервер.

⚠️ Требуется установка на клиенте И сервере для правок больше ±8 м и корректной репликации.

🚀 Быстрый старт

Зайдите в мир. Жезл TerrainForge (клон молота) выдаётся и экипируется автоматически.
Нажмите F5, чтобы открыть меню (или кликните кнопку TerrainForge в меню паузы ESC).
Экипируйте жезл, если он не экипирован.
Наведитесь на местность и удерживайте правую кнопку мыши (Mouse1) для лепки.
Используйте , для переключения операций, . для форм, / для красок.
Удерживайте Q → радиальное меню, отпустите для подтверждения.
Ctrl+Z / Ctrl+Y для отмены/повтора.

⌨️ Управление

Действие	Клавиша по умолчанию	Описание
Применить кисть	Удерживать `Mouse1` (правая кнопка)	Лепит местность под прицелом
Радиус +	`=` или `Ctrl`+Колесо	Увеличивает радиус кисти
Радиус −	`-` или `Ctrl`+Колесо	Уменьшает радиус кисти
Переключить операцию	`,`	Перебирает 9 операций
Переключить форму	`.`	Круг → Квадрат → Линия → Прямоугольник → Полигон
Переключить краску	`/`	Перебирает 6 типов краски
Выравнивание по ногам	Удерживать `Left Shift`	Выровнять использует высоту игрока
Отмена	`Ctrl+Z`	Отменяет последний штрих
Повтор	`Ctrl+Y`	Повторяет отменённый штрих
Пипетка	`G`	Фиксирует высоту Выровнять на прицеле (повторно = снять)
Режим пандуса	`H`	Перебирает: Две точки → Фиксированный угол → Путь (или выберите 3 кнопками в НАСТРОЙКАХ)
Угол фиксированного пандуса	Удерживать `Alt` + радиус/колесо	Регулирует угол в фиксированном режиме
Радиальное меню	Удерживать `Q`	Выберите операцию мышью, отпустите для подтверждения
Режим настройки	`V`	Колесо = радиус, замораживает зум/панель/карту
Точная настройка (0.1 м)	Удерживать `Shift` + колесо/радиус	Точная регулировка радиуса
Копировать штамп	`Ctrl+Shift+C`	Копирует отмеченную область в буфер обмена
Вставить штамп	`Ctrl+Shift+V`	Призрачный предпросмотр, клик подтверждает
Получить жезл	`F8`	Выдаёт жезл TerrainForge
Открыть меню	`F5`	Открывает меню клавиш/справки/настроек

Дополнительные клавиши (без значения по умолчанию, назначьте их в КЛАВИШАХ): - Прямая операция: Выровнять, Поднять, Опустить, Сгладить, Рисовать, Восстановить, Пандус, Берег, Снег - Следующий / предыдущий профиль - Следующий / предыдущий штамп (история)

Раздел «Быстрые действия» (вкладка КЛАВИШИ): кнопки для функций без обязательного сочетания — Отмена, Повтор, Зафиксировать высоту, Копировать/Вставить штамп, Предыдущий штамп, Очистить метки, тепловые карты и Диагностика материала (выводит шейдер + слоты текстур в лог).

🔄 Операции

Операция	Описание
Выровнять	Выравнивает до указанной высоты (Shift = на уровне ваших ног). Фиксированная высота через Пипетку (`G`) или текстовое поле в НАСТРОЙКАХ.
Поднять	Поднимает местность на `RaiseDelta` за применение. Режим затухания задаёт форму.
Опустить	Опускает местность на `RaiseDelta` за применение. Режим затухания задаёт форму.
Сгладить	Настоящее размытие: усредняет каждую вершину с её 8 соседями. Удерживайте для постепенного эффекта. Режимы: Полный (оба), только гребни (понижает), только впадины (повышает). Форма Линия = сглаживание пути.
Пандус	3 режима (переключение `H`): • Две точки: отметьте A и B → прямая наклонная плоскость соединяет высоты. • Фиксированный угол: B = направление/длина; высота = `SlopeAngle` (вверх/вниз в зависимости от прицела). Регулировка через `Alt`+радиус. • Путь: отметьте кривую A→B→C… (двойное нажатие при 3+ закрывает) → плавный Catmull-Rom. Ширина = радиус кисти. Мягкость = смешивание только по боковым краям. Предпросмотр: заполненный коридор + кольца высот у A/B.
Берег	Выравнивает к уровню воды + отступ `ShoreOffset` (пляжи). Мягкость как у Выровнять.
Рисовать	Типы: Dirt, Cultivated, Paved, ClearVegetation, DeepSnow, Reset. Регулируемая сила.
Восстановить	Возвращает местность в исходное состояние (высота + краска).
Копировать/вставить	Отдельный режим колеса Q для выбора участка земли и размещения штампов.

📐 Формы

Переключение клавишей .. Все поддерживают отмену.

Форма	Разметка	Применение
Круг	Один клик (центр кисти)	Обычная лепка
Квадрат	Один клик (центр)	Платформы, фундаменты
Линия	2 клика (A → B)	Дорожки, стены, тропы. Полуширина = радиус.
Прямоугольник	2 клика (противоположные углы)	Фундаменты, фермы, платформы. Мягкие края.
Полигон	Клик по каждой вершине, двойной клик закрывает (3+ вершин)	Сложные формы, пользовательские области

Некруглые формы показывают только отмеченный контур (без круглых колец).
Мягкость влияет на смешивание краёв у всех форм.

⚙️ Режимы затухания (Поднять/Опустить)

Настройка в НАСТРОЙКАХ → "Затухание Raise/Lower":

Режим	Поведение
Остроконечный	Центральный пик. Управляется слайдером "Сила затухания" (1–5).
Плоский	Равномерный диск — одинаковый вес по всему радиусу.
Плавный	Косинусный колокол — плавный переход, без резкого края.
Линейный	Прямое сужение от центра к краю.

🧱 Штампы (Копировать/Вставить)

Мощная функция для копирования структур местности.

Выделение прямоугольником (рекомендуется)

Выберите «Копировать/вставить» в колесе Q. Клавиша «Применить» задаёт область: два угла прямоугольника, два конца линии, вершины многоугольника (двойное нажатие после 3+ точек) или область кисти для круга/квадрата. HUD подсказывает следующий шаг.

Рабочий процесс

Отметьте область: используйте любую форму (Круг, Прямоугольник, Линия, Полигон, Пандус) — или выделение прямоугольником выше.
Копировать: Ctrl+Shift+C → "Штамп скопирован: X плиток" (буфер в ОЗУ).
Предпросмотр вставки: Ctrl+Shift+V → призрачный каркас на прицеле. - Q/E = поворот ±15° - Alt+Колесо = непрерывный поворот - Shift+Колесо = масштаб 0.25×–4× - Esc = отмена
Confirm: Нажмите клавишу вставки ещё раз, чтобы подтвердить предпросмотр.

Штампы выделения записывают только внутри скопированной области; местность снаружи остаётся нетронутой.

История

До 10 штампов в ОЗУ (сначала самые новые).
Клавиши Следующий штамп / Предыдущий штамп (переназначаемые) перебирают их.
Вспышка: "История штампов: Copy: 3 плитки [2/5]"

Хранение

НАСТРОЙКИ → ШТАМПЫ:
Сохранить текущий штамп на диск (.stamp в BepInEx/config/TerrainForge/stamps/, макс. 12).
Загрузить штамп в буфер обмена.
Список/удаление сохранённых штампов.

Инструмент штампа

НАСТРОЙКИ → "Инструмент штампа" (4 варианта):
Same as brush (по умолчанию) — использует тот же инструмент, что и кисть
Any — без требований
Pickaxe — требуется экипированная кирка
TerrainForge Rod — требуется жезл мода
HUD показывает STAMP READY [2/5], когда инструмент экипирован + есть штампы в буфере.
Без инструмента: Stamp: tool not equipped, копирование/вставка заблокированы.

💾 Снимки (Резервные копии)

Полное резервное копирование/восстановление местности.

Сохранить

НАСТРОЙКИ → СНИМКИ.
Имя (пусто = авто дата/время).
Сохранить → правленые плитки в BepInEx/config/TerrainForge/snapshots/<имя>.dat (макс. 12).

Загрузить

Выберите снимок.
Загрузить → восстанавливает плитки с правами владения, 1 шаг отмены.
Незагруженные плитки корректно предупреждают — импортируйте рядом с исходным местоположением.

Возможности

Версионированный бинарный формат (.dat).
Восстанавливает высоту + сглаживание + краску + права владения.
Импорт можно отменить (Ctrl+Z откатывает импорт).
Незагруженные плитки корректно предупреждают.

💾 Профили

Сохранение/загрузка полных конфигураций кисти.

НАСТРОЙКИ → ПРОФИЛИ.
Имя + Сохранить → радиус, мягкость, операция, форма, краска, режим пандуса, угол, режим сглаживания, дельта подъёма, сила краски, затухание, смещение берега.
Загрузить → применяется мгновенно.
Макс. 12 профилей (формат, независимый от культуры, в Presets > Slots).
Привязка клавиш: Next Profile (назначьте в КЛАВИШАХ) для переключения.

🌐 Языки

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

Автоопределение

Значение по умолчанию Auto определяет язык игры через рефлексию: Localization.instance.GetSelectedLanguage().
Сопоставляет язык Valheim → внутренний индекс.
Если для языка нет полного перевода → откат к английскому.
Настраивается в НАСТРОЙКАХ → "Язык" (перебирает 15 вариантов).
Метки клавиш перестраиваются при открытии меню.

Статус переводов

Полные: English, Español
Откат к английскому: Français, Deutsch, Русский, 中文, 繁體中文, 日本語, 한국어, Polski, Português, Türkçe, Українська, Italiano
Переводы сообщества приветствуются через PR.

Эта документация

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

🌍 Мультиплеер

Требования

Мод на клиенте И сервере для правок больше ±8 м и корректной репликации.
UnlockDeltaLimit также на сервере, иначе сервер ограничивает местность.

Авторитет сервера (синхронизация конфигурации)

Когда сервер использует мод, его секция Server имеет приоритет: - AllowTerrainEdits (по умолчанию true) — главный переключатель; если false, клиенты не могут применять/отменять/повторять. - AdminOnlyEdits (по умолчанию false) — редактировать могут только админы/хост. - RespectWards (по умолчанию true) — блокирует правки внутри чужих вардов. - RadiusCap / DeltaCap (0 = выкл.) — ограничения, применяемые сервером, видны в HUD+предпросмотре.

Серверы без мода игнорируют секцию → клиент работает для тестирования.

Предотвращение рассинхронизации

Держите MaxUpDelta / MaxDownDelta согласованными на сервере + клиентах.
Большие радиусы могут рассинхронизировать клиентов без мода.

⚙️ Настройки

Файл: BepInEx/config/com.terrainforge.valheim.cfg

Общие

Параметр	По умолчанию	Описание
`Enabled`	`true`	Главный переключатель
`PlayEffects`	`true`	Пыль + попадание при применении
`Language`	`Auto`	Auto / English / Español / Français / Deutsch / Русский / 中文 / 繁體中文 / 日本語 / 한국어 / Polski / Português / Türkçe / Українська / Italiano
`ToolTint`	`true`	Окрашивает жезл TerrainForge (клон молота), чтобы его было легко отличить от ванильного молота
`ToolTintColor`	`#4FC3F7`	Hex-цвет жезла (модель + иконка). Напр.: `#FFC400` золотой, `#8BC34A` зелёный

Кисть

Параметр	По умолчанию	Диапазон	Описание
`Radius`	8	1–100	Радиус кисти (м)
`RadiusMin`	2	—	Мин. радиус при регулировке
`RadiusMax`	60	—	Макс. радиус при регулировке
`RadiusStep`	1	—	Изменение радиуса за клавишу/колесо
`Softness`	50	0–100	Мягкость края (0 = жёстко, 100 = очень мягко)
`FalloffPower`	3	1–5	Показатель затухания (только режим Остроконечный)
`RaiseLowerMeters`	2	0.5–10	Метров за применение Поднять/Опустить
`PaintStrength`	1	0–1	Сила краски
`DefaultOperation`	Flatten	—	Начальная операция
`Shape`	Circle	—	Начальная форма
`Paint`	Dirt	—	Начальная краска
`RampMode`	TwoPoint	—	TwoPoint / FixedAngle / Path
`SlopeAngle`	30	5–60	Угол фиксированного пандуса (градусы)
`SmoothMode`	Full	—	Full / Bumps / Dips
`FalloffMode`	Pointy	—	Pointy / Flat / Smooth / Linear
`ShoreOffset`	0.5	-2–5	Отступ берега над водой (м)
`UseFixedHeight`	false	—	Использовать фиксированную высоту (состояние пипетки)
`FixedHeight`	30	-10–150	Точная высота Выровнять (м)

Vanilla / интеграция

BlockVanillaTerrainTools: false — с экипированным жезлом игнорирует редактирование местности ванильной мотыгой/культиватором. Также есть переключатель в НАСТРОЙКАХ.

Ввод

Все горячие клавиши переназначаются на вкладке КЛАВИШИ. Основное: - 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) - Прямые клавиши операций (9, без значения по умолчанию): OpFlatten/Raise/Lower/Smooth/Paint/Restore/Ramp/Shore/Snow - CycleProfileKey, CycleStampKey, CycleStampBackKey - RequiredTool: Any / Pickaxe / TerrainForgeTool (по умолчанию) - AutoGiveTool: true (выдаёт жезл при входе)

Штампы

StampToolMode: Same as Brush / Any / Pickaxe / TerrainForgeTool (по умолчанию Same as Brush)

Предпросмотр

ShowPreview: true, ShowGuides: true (направляющие досягаемости, оттенок уклона, кольцо уровня)

История

UndoDepth: 50 (0–500, 0 отключает историю)

Сервер (авторитетно через синхронизацию конфигурации)

AllowTerrainEdits: true (главный переключатель)
AdminOnlyEdits: false (только админы)
RespectWards: true (блокирует чужие варды)
RadiusCap / DeltaCap: 0 (выкл.) — ограничения, применяемые сервером

Производительность

TilesPerFrame: 4 (1–32 плитки/кадр)

🐛 Решение проблем

Проблема	Решение
Меню не появляется / невидимый курсор	Закройте игру. Удалите `%APPDATA%\Thunderstore Mod Manager\DataFolder\Valheim\profiles\ВашПрофиль\BepInEx\plugins\TerrainForge\` и `%APPDATA%\Thunderstore Mod Manager\PackageCache\`. Перезапустите TMM, проверьте обновления.
Обновление не отображается в TMM	TMM → Settings → "Refresh mod list" (Ctrl+R). Закройте/откройте TMM. Проверьте правильный профиль.
Конфликт версий в Thunderstore	Поднимите версию (0.3.3 → 0.3.4) в `.csproj`, `Plugin.cs`, `manifest.json`. Пересоберите + перезагрузите.
Копирование/вставка штампа ничего не делает	HUD: `STAMP READY [X/Y]` = готово. Если "инструмент не экипирован", экипируйте инструмент (НАСТРОЙКИ → Инструмент штампа).
Предпросмотр невидим под водой	Исправлено в 0.3.2 — предпросмотр плавает на поверхности. Обновитесь.
Круги на Линии/Прямоугольнике/Полигоне	Исправлено в 0.3.2 — показывается только отмеченный контур. Обновитесь.
Радиальное колесо не работает	Исправлено в 0.3.2 (`ZInput.GetMouseScrollWheel()`) и 0.3.4 (выделение больше не стирается при центрированном курсоре). Обновитесь.
Конфигурация не сохраняется	Закройте меню (F5) для автосохранения. Или отредактируйте `BepInEx/config/com.terrainforge.valheim.cfg` напрямую.
Рассинхронизация в мультиплеере	Мод на клиенте+сервере. `UnlockDeltaLimit` на обоих. Одинаковые `MaxUpDelta`/`MaxDownDelta`.
Сборка не удаётся	Проверьте пути `ValheimDir`, `BepInExCoreDir` в `.csproj` или через CLI. Требуется .NET SDK 8+.
Компиляция / упаковка	`dotnet build -c Release` (DLL в `build/`), `-p:Deploy=true` (устанавливает в профиль) или `-p:Package=true` (zip в `build/`).

🔗 Ссылки

Страница Thunderstore: https://thunderstore.io/c/valheim/p/MRAnalytics/TerrainForge/
Репозиторий GitHub: https://github.com/marceloanton/TerrainForge
Пожертвования: cafecito.app/byrka
Список изменений: Changelog

TerrainForge — терраформируй Valheim без ограничений.