Вікі 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 - Сервер: <server>\BepInEx\plugins\TerrainForge\TerrainForge.dll
Перезапустіть гру / сервер.

⚠️ Потрібно встановити і на клієнті, І на сервері для редагування понад ±8 m та правильної реплікації.

🚀 Швидкий старт

Приєднайтеся до світу. Жезл 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 m)	Утримуйте `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 для вибору ділянки та розміщення stamp.

📐 Форми

Перемикайте клавішею .. Усі підтримують скасування.

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

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

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

Налаштування в НАЛАШТУВАННЯ → "Затухання Raise/Lower":

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

🧱 Штампи (Копіювати/Вставити)

Потужна функція для копіювання структур місцевості.

Вибір прямокутником (рекомендовано)

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

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

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

Штампи виділення записують лише всередині скопійованої області; місцевість поза нею залишається недоторканою.

Історія

До 10 штампів у RAM (найновіші першими).
Клавіші Next stamp / Previous stamp (можна перепризначити) перемикають їх.
Спалах: "Історія штампів: Copy: 3 tiles [2/5]"

Збереження

НАЛАШТУВАННЯ → STAMPS:
Зберегти поточний штамп на диск (.stamp у BepInEx/config/TerrainForge/stamps/, макс 12).
Завантажити штамп у буфер обміну.
Перелічити/видалити збережені штампи.

Інструмент штампів

НАЛАШТУВАННЯ → "Інструмент штампів" (4 опції):
Так само, як пензель (типово) — використовує той самий інструмент, що й пензель
Будь-який — без вимог
Кирка — потрібна екіпірована кирка
Жезл TerrainForge — потрібен жезл мода
HUD показує STAMP READY [2/5], коли інструмент екіпіровано + є штампи в буфері обміну.
Без інструмента: Stamp: tool not equipped, копіювання/вставлення заблоковано.

💾 Знімки (Резервні копії)

Повне резервне копіювання/відновлення місцевості.

Зберегти

НАЛАШТУВАННЯ → SNAPSHOTS.
Назва (порожня = авто дата/час).
Зберегти → відредаговані плити в BepInEx/config/TerrainForge/snapshots/<name>.dat (макс 12).

Завантажити

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

Можливості

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

💾 Профілі

Зберігайте/завантажуйте повні конфігурації пензля.

НАЛАШТУВАННЯ → PROFILES.
Назва + Зберегти → радіус, м'якість, операція, форма, фарба, режим рампи, кут, режим згладжування, raise delta, сила фарби, затухання, відступ берега.
Завантажити → застосовується миттєво.
Макс 12 профілів (культуро-незалежний формат у Presets > Slots).
Клавіша: Next Profile (призначте в КЛАВІШАХ) для перемикання.

🌐 Мови

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

Автовизначення

Типове Auto визначає мову гри через reflection: Localization.instance.GetSelectedLanguage().
Зіставляє мову Valheim → внутрішній індекс.
Якщо мова не має повного перекладу → відкат до English.
Налаштовується в НАЛАШТУВАННЯ → "Мова" (перемикає 15 опцій).
Мітки клавіш перебудовуються при відкритті меню.

Статус перекладів

Повні: English, Español
Відкат до English: 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 m та правильної реплікації.
UnlockDeltaLimit також на сервері, інакше сервер обмежує місцевість.

Серверний авторитет (Синхронізація конфігу)

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

Сервери без мода ігнорують цей розділ → клієнт працює для тестування.

Запобігання десинхронізації

Тримайте MaxUpDelta / MaxDownDelta узгодженими на сервері + клієнтах.
Великі радіуси можуть десинхронізувати клієнтів без мода.

⚙️ Налаштування

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

Загальні

Setting	Default	Опис
`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` зелений

Пензель

Setting	Default	Діапазон	Опис
`Radius`	8	1–100	Радіус пензля (m)
`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	Відступ берега над водою (m)
`UseFixedHeight`	false	—	Використовувати фіксовану висоту (стан піпетки)
`FixedHeight`	30	-10–150	Точна висота Вирівнювання (m)

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 (видає жезл при вході)

Stamps

StampToolMode: Same as Brush / Any / Pickaxe / TerrainForgeTool (типово Same as Brush)

Preview

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

Історія

UndoDepth: 50 (0–500, 0 вимикає історію)

Сервер (авторитетний через Config Sync)

AllowTerrainEdits: true (головний перемикач)
AdminOnlyEdits: false (лише адміни)
RespectWards: true (блокує чужі ward)
RadiusCap / DeltaCap: 0 (вимк) — обмеження, що застосовує сервер

Продуктивність

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

🐛 Вирішення проблем

Проблема	Рішення
Меню не з'являється / невидимий курсор	Закрийте гру. Видаліть `%APPDATA%\Thunderstore Mod Manager\DataFolder\Valheim\profiles\YourProfile\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]` = готово. Якщо "tool not equipped", екіпіруйте інструмент (НАЛАШТУВАННЯ → Інструмент штампів).
Перегляд невидимий під водою	Виправлено в 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: Changelog

TerrainForge — Terraform Valheim без обмежень.