Начните вводить название — например, MoreHead, Sodium или PEAK

Mache — иконка
Обложка Sons Of The ForestМод для Sons Of The Forest

Mache

от willis81808

Фундаментальная структура модификации SoTF

  • Эпический
  • 110,2 тыс. скачиваний
  • Версия 0.2.0
  • Обновлён 10 марта 2023
  • Не обновлялся больше года
  • Инструменты
  • Библиотека

О моде Mache

Mache — мод для Sons Of The Forest (Санс оф зе Форест) от автора willis81808. Фундаментальная структура модификации SoTF

Его скачали 110,2 тыс. раз: это 6-е место среди модов Sons Of The Forest в нашем каталоге, редкость — «эпический» (топ-20% по скачиваниям). Мод давно не обновлялся — проверьте совместимость с текущей версией игры, актуальная версия — 0.2.0.

Для работы ему нужны: BepInExPack IL2CPP.

Полное описание Mache

Автоматический перевод текста автора

Маша

Mache — это моддинг-фреймворк, разработанный для Sons of the Forest. В качестве утилиты он обеспечивает поддержку моддеров, позволяя просто создавать новый игровой контент и функции для настройки существующих элементов игры. Mache предоставляет доступ к единому набору инструментов, меню и действий, которые облегчают и упрощают процесс создания и реализации модов.

Использование

Нажмите F1, чтобы открыть меню Mache Mod

Моддинг API

Модное меню

Регистрируйте свое меню с помощью Mache

Комплексное меню

Вы можете реализовать интерактивные элементы пользовательского интерфейса непосредственно в меню Mache для вашего мода! При регистрации мода Mache предоставляет событие OnFinishedCreating, которое выполняется, когда панель мода полностью инициализирована и готова принять дополнительные элементы. Использование GameObject, переданного этому обратному вызову, в качестве родителя для ваших собственных элементов пользовательского интерфейса будет включать их в существующий вид прокрутки панели вашего мода в меню Mache. Например:

Mache.RegisterMod(() => new ModDetails
{
    Name = "Example Mod",
    Id = "your.unique.mod.id",
    Version = "1.0.0",
    Description = "Lorem ipsum dolor sit amet...",
    OnFinishedCreating = (parent) =>
    {
        MenuPanel.Builder()
            .AddComponent(new LabelComponent
            {
                Text = "Hello World!",
                FontSize = 24
            })
            .AddComponent(new ButtonComponent
            {
                Text = "Press Me",
                OnClick = (self) => MachePlugin.Instance.Log.LogMessage("Down the rabbit hole...")
            })
            .BuildToTarget(parent);
    }
});

Стандартное меню

Если вы предоставите значение для OnMenuShow при регистрации вашего мода, Mache будет отображать только данное имя, версию и описание в своем собственном окне. Вместо того, чтобы размещать там параметры, он создаст кнопку «Открыть настройки», которая при нажатии выполнит обратный вызов OnMenuShow. Это предназначено для использования, когда вы хотите иметь полностью независимое меню. Это зависит от вас, как ваш мод реагирует, когда пользователь нажимает эту кнопку.

Mache.RegisterMod(() => new ModDetails
{
	Name = "Example Mod",
	Id = "your.unique.mod.id",
	Version = "1.0.0",
	Description = "Lorem ipsum dolor sit amet...",
	OnMenuShow = () => Log("Player clicked the 'Open Settings' button for your mod")
});

Расширенная база данных

Легкий доступ к идентификаторам и данным всех внутриигровых предметов

ItemData meatData = GameItem.Meat.GetData();
int meatId = GameItem.Meat.GetId();

Создание сетевых событий

Все сетевые события должны использовать уникальные идентификаторы, и идентификатор для данного события должен быть одинаковым для всех клиентов!

Существует два способа создания и регистрации пользовательского сетевого события:

  1. Автосериализация/десериализация
  2. Собственная сериализация/десериализация

Авто (De)Сериализация

Для автосериализации создают класс, который расширяет SimpleEvent, например:

public class ExampleEvent : SimpleEvent
{
    public string Message { get; set; }
    public int MessageCount { get; set; }

    // called when an event of this type has been receieved
    public override void OnReceived()
    {
        for (int i = 0; i < MessageCount; i++)
        {
            MachePlugin.Instance.Log.LogMessage(Message);
        }
    }
}

Зарегистрируйтесь в Mache:

EventDispatcher.RegisterEvent();

Плюсы:

  • Гораздо легче
  • Меньше болтовни

Минусы:

  • В вашем классе событий должны быть реализованы только поля, которые могут быть автоматически сериализованы в JSON (как правило, типы значений и коллекции типов ценностей)
  • Это относится только к классам, которые расширяют SimpleEvent

Custom (De) Сериализация

Для более сложных сценариев может потребоваться внедрение пользовательских методов сериализации и десериализации для вашего класса, или если вы хотите создать сетевое событие для типов, которые вы не контролируете, вы можете определить свой собственный метод сериализации / десериализации их. В этих случаях вы должны определить свои собственные методы сериализации, десериализации и обратного вызова, например:

EventDispatcher.RegisterEvent("Some.Unique.Event.Id", SomeEvent.Serialize, SomeEvent.Deserialize, SomeEventHandler.OnReceived);

Плюсы:

  • Максимальная гибкость
  • Может регистрировать события, сериализующие любой тип

Минусы:

  • Этот метод гораздо более вовлечен
  • Значительно больше бойлерплейта

Расширение сетевых событий

События могут быть подняты в любом месте и отправлены всем клиентам. Используя пример события сверху:

EventDispatcher.RaiseEvent(new ExampleEvent
{
    Message = "Hello World!",
    MessageCount = 10
});

Нужно для работы

В r2modman ставится автоматически

Моды, которым нужен Mache

8 в каталоге · показаны самые популярные

BowTrajectory — иконка

BowTrajectory

Увидеть предсказанный путь стрел

Эпический82,4 тыс.

Warps — иконка

Warps

Создайте пользовательские деформации для телепортации по всему миру

Редкий31,5 тыс.

MultiplayerUnlimiter — иконка

MultiplayerUnlimiter

Настройка макса разрешена игрокам в многопользовательской игре

Редкий15,9 тыс.Инструменты

Better Sons — иконка

Better Sons

Modpack for me and the bois

Редкий14,6 тыс.Сборки

Wraiths Quality of Life ModPack — иконка

Wraiths Quality of Life ModPack

Моды, которые должны были быть встроены в игру с самого начала

Обычный10,7 тыс.Сборки

Videtoiles Sons of the Forest Modpack — иконка

Videtoiles Sons of the Forest Modpack

Модак в основном для моих друзей и меня, чтобы легко загрузить наши коллективные моды. Ничего не должно быть сломано, мультиплеер готов.

Обычный4,9 тыс.Сборки

Как установить Mache

Файл скачивается с официального сервера Thunderstore, без перезаливов и сторонних установщиков

Подробная инструкция для Sons Of The Forest
  1. Скачайте менеджер модов r2modman (или Gale) и выберите в нём игру Sons Of The Forest.
  2. Создайте профиль — так моды не смешаются с чистой версией игры.
  3. Найдите «Mache» во вкладке Online и нажмите Download — BepInEx и все зависимости подтянутся сами.
  4. Нажмите «Start modded» — игра запустится с модами.
  5. Чтобы сыграть без модов, запустите игру как обычно из Steam — r2modman не трогает чистую версию игры.
Вы автор мода? Поставьте ссылку на русское описание

Вставьте значок в описание на Thunderstore, в README или в Discord — русскоязычные игроки сразу попадут на страницу с переводом и инструкцией.

Описание на русском — Модка
Markdown[![Описание на русском — Модка](https://modka.app/badge.png)](https://modka.app/sons-of-the-forest/willis81808-mache/)
HTML<a href="https://modka.app/sons-of-the-forest/willis81808-mache/"><img src="https://modka.app/badge.png" alt="Описание на русском — Модка" height="44"></a>
Steam (BBCode)[url=https://modka.app/sons-of-the-forest/willis81808-mache/]Описание на русском — Модка[/url]

Частые вопросы о Mache

Как установить Mache?

Скачайте менеджер модов r2modman (или Gale) и выберите в нём игру Sons Of The Forest. Создайте профиль — так моды не смешаются с чистой версией игры. Найдите «Mache» во вкладке Online и нажмите Download — BepInEx и все зависимости подтянутся сами. Нажмите «Start modded» — игра запустится с модами. Чтобы сыграть без модов, запустите игру как обычно из Steam — r2modman не трогает чистую версию игры.

Безопасен ли Mache?

Файл скачивается с официального сервера Thunderstore, куда его загрузил willis81808. Мы не перезаливаем и не изменяем моды.

Что нужно для работы Mache?

Установите вместе с ним: BepInExPack IL2CPP. В менеджере модов зависимости подтягиваются автоматически.

Когда Mache обновлялся последний раз?

10 марта 2023, актуальная версия — 0.2.0. Это больше года назад: перед установкой проверьте, работает ли мод на текущей версии игры.

DebugConsole — иконка

DebugConsole

Включает консоль отладки.

Легендарный184,9 тыс.Инструменты

Better FPS Low Spec GPU — иконка

Better FPS Low Spec GPU

Простой плагин для отключения графического рендеринга внутриигровых элементов (например, деревьев) или изменения расстояния рендеринга камеры в игровой сцене, что позволяет повысить производительность

Эпический52,8 тыс.Инструменты

SOTFEdit — иконка

SOTFEdit

Скачать игру Sons of the Forest

Редкий33,7 тыс.Инструменты

SaveAnywhere — иконка

SaveAnywhere

Новый мод сохранения, поддерживает AutoSave и многое другое!

Редкий23 тыс.Инструменты

RadioSpawner — иконка

RadioSpawner

Позволяет просто создать один или несколько функциональных RADIO'S через комбинацию ALT + O. Работает в кооперативе (согласно последнему тесту).

Редкий20,2 тыс.Инструменты

MultiplayerUnlimiter — иконка

MultiplayerUnlimiter

Настройка макса разрешена игрокам в многопользовательской игре

Редкий15,9 тыс.Инструменты