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-uk
Updated a month agoВікі TerrainForge
English · Español · Français · Deutsch · Русский · 中文 · 繁體中文 · 日本語 · 한국어 · Polski · Português · Türkçe · Українська · Italiano
Зміст
- Встановлення
- Швидкий старт
- Керування
- Операції
- Форми
- Режими затухання
- Штампи (Копіювати/Вставити)
- Знімки (Резервні копії)
- Профілі
- Мови
- Мультиплеєр
- Налаштування
- Вирішення проблем
📥 Встановлення
Вимоги
- BepInEx 5 (x64, Mono) на клієнті та сервері. У користувачів Thunderstore він уже є.
- Jotunn (
ValheimModding-Jotunn) — реєструє власний інструмент. Він вказаний уmanifest.json; 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. Регульована сила. |
| Відновити | Повертає місцевість до початкового стану (висота + фарба). |
| Сніг | Фарба лише снігу (та сама маска, що й у грі). Shift = видаляє його та відновлює оригінал. |
📐 Форми
Перемикайте клавішею .. Усі підтримують скасування.
| Форма | Позначення | Випадок використання |
|---|---|---|
| Коло | Один клік (центр пензля) | Загальне ліплення |
| Квадрат | Один клік (центр) | Платформи, фундаменти |
| Лінія | 2 кліки (A → B) | Шляхи, стіни, стежки. Половина ширини = радіус. |
| Прямокутник | 2 кліки (протилежні кути) | Фундаменти, ферми, платформи. М'які краї. |
| Полігон | Клік на кожну вершину, подвійний клік закриває (3+ вершин) | Складні форми, власні області |
- Нециркулярні форми показують лише позначений контур (без круглих кілець).
- М'якість впливає на змішування країв у всіх формах.
⚙️ Режими затухання (Підняти/Опустити)
Налаштування в НАЛАШТУВАННЯ → "Затухання Raise/Lower":
| Режим | Поведінка |
|---|---|
| Гострий | Центральний пік. Керується повзунком "Сила затухання" (1–5). |
| Плоский | Рівномірний диск — однакова вага по всьому радіусу. |
| Плавний | Косинусний дзвін — плавний перехід, без різкого краю. |
| Лінійний | Пряме звуження від центру до краю. |
🧱 Штампи (Копіювати/Вставити)
Потужна функція для копіювання структур місцевості.
Вибір прямокутником (рекомендовано)
- Встановіть форму
Rectangle(клавіша.). - Натисніть Застосувати (
Mouse1) один раз, щоб позначити кут A (це не вносить жодних змін). - Наведіться на кут B (просто перемістіть камеру).
- Натисніть
Ctrl+Shift+C→ копіює саме цей прямокутник, обрізаний до виділення (він не захоплює цілі плити 64 m або недоторкану землю навколо). Позначку кута A використано після успішного копіювання.
Робочий процес
- Позначте область: використайте будь-яку форму (Коло, Прямокутник, Лінія, Полігон, Рампа) — або вибір прямокутником вище.
- Копіювати:
Ctrl+Shift+C→ "Stamp скопійовано: X tiles" (буфер обміну в RAM). - Перегляд вставки:
Ctrl+Shift+V→ примарний каркас на прицілі.Q/E= обертання ±15°Alt+Колесо = безперервне обертанняShift+Колесо = масштаб 0.25×–4×Esc= скасувати
- Підтвердити: клік (
Mouse1) → застосовується як один крок скасування.
Штампи виділення записують лише всередині скопійованої області; місцевість поза нею залишається недоторканою.
Історія
- До 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,CycleStampBackKeyRequiredTool: 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, JotunnDir у .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.md
TerrainForge — Terraform Valheim без обмежень.