ФЭНДОМ


TModLoader-Logo1

tModLoader — загрузчик модов для Террарии. С помощью Microsoft Visual Studio (далее - VS) мы научимся создавать небольшие модификации к игре.

Начало

  1. Установите tModLoader
  2. Установите .NET Framework
  3. Скачайте и установите VS Community Edition

Как создать проект в VS

  1. Нажмите: Файл - Создать - Проект
    Шаблоны - Другие типы проектов - Решения Visual Studio - Новое решение
    Назовите его "Mod Sources" (без кавычек)
  2. Установите расположение: <Имя пользователя>\Documents\My Games\Terraria\ModLoader
  3. Далее добавляем новый проект:
    Файл - Добавить - Создать проект...
    Установленные - Visual C# - Windows - Классическое приложение - Пустой проект
  4. Называем проект так, как вы хотите (на английском языке, без пробелов). Я назову его "TestMod".
  5. Далее добавим ссылки:
    1. Нажимаем:
      Проект - Добавить ссылку...
      Обзор - Обзор - Выбираем модифицированный файл Terraria.exe (по умолчанию C:\Program Files (x86)\Steam\steamapps\common\Terraria)
      Выбираем в списке Terraria.exe, нажимаем ОК и сохраняем весь проект (Ctrl + Shift + S)
    2. Идем по адресу <Имя пользователя>\Documents\my games\Terraria\ModLoader\Mod Sources\TestMod и открываем TestMod.csproj любым текстовым редактором
    3. Ищем строчку <Reference Include="Terraria"> и добавляем перед ней
<Reference Include="Microsoft.Xna.Framework" />
<Reference Include="Microsoft.Xna.Framework.Game" />
<Reference Include="Microsoft.Xna.Framework.Graphics" />

VS скажет, что "Проект "TestMod" был изменен вне окружения". Нажимаем "Перезагрузить"

Настройка среды разработки

  1. Делаем ПКМ по проекту, выбираем "Свойства", переходим во вкладку "События сборки". Нажимаем "Изменить событие "После сборки"..." и вводим туда
    "C:\Program Files (x86)\Steam\steamapps\common\Terraria\tModLoaderServer.exe" -build "$(ProjectDir)\" -eac "$(TargetPath)"
    Ваше расположение может отличаться от моего
  2. Переходим во вкладку "Отладка"
  3. В "Запуск внешней программы" устанавливаем следующее
    C:\Program Files (x86)\Steam\steamapps\common\Terraria\Terraria.exe
    Ваше расположение может отличаться от моего
  4. Не забываем сохранить файл (Ctrl + S)

Создание базового класса мода

  1. Нажимаем:
    Проект - Добавить новый класс... (Shift + Alt + C)
    Выбираем "Класс"
    Называем так же, как и проект (В моём случае TestMod.cs)
    Нажимаем ОК

VS автоматически создаст шаблон класса, но он нам не нужен. Удаляем всё, что там есть и пишем:

using System;
using Terraria;
using Terraria.Graphics.Effects;
using Terraria.Graphics.Shaders;
using Terraria.ID;
using Terraria.ModLoader;
using Microsoft.Xna.Framework;
using System.Collections.Generic;
using System.Linq;
using System.IO;

namespace TestMod
{
    public class TestMod : Mod
    {
        public TestMod()
        {
            Properties = new ModProperties()
            {
                Autoload = true,
                AutoloadGores = true,
                AutoloadSounds = true
            };
        }
    }
}
Пояснение
public bool Autoload
Будет ли контент мода загружаться автоматически по умолчанию. Это значит, что вам не нужно вручную добавлять содержимое с помощью методов. 
public bool AutoloadGores
Мод будет автоматически добавлять изображения к классам, которые имеют одинаковые имена с изображением. Вам не нужно вручную вызвать Mod.AddGore. 
public bool AutoloadSounds
Вам не нужно вручную вызвать AddSound.

Создание описания

  1. Нажимаем ПКМ по проекту:
    Добавить - New Empty File... (Shift + F2)
    Называем его "build.txt" (без кавычек)
  2. Пишем туда:
author = Автор мода (Ваш ник, имя или что-то другое) 
version = Версия мода, например, 0.0.0.1
displayName = Название мода, тут уже можно использовать пробелы, но нельзя использовать русские символы
homepage = Ссылка на ваш мод
hideCode = Скрыть код мода (true/false)
hideResources = Скрыть контент мода (true/false)
includeSource = true
buildIgnore = *.csproj, *.user, obj\*, bin\*, .vs\*
includePDB = true

Последние 3 строчки не трогаем

  • Таким же образом создаем файл "description.txt"
    • В него мы записываем описание мода, например, "Test Mod by DarkProhet"

Теперь вы можете запустить Террарию (Это можно сделать, нажав на кнопку "Пуск" на панели инструментов). Далее: Mod Sources - TestMod - Build + Reload. Теперь ваш мод появился во вкладке Mods, там вы можете увидеть название, автора, версию и описание (More Info).

Ссылки

Официальная документация на английском языке
Страница tModLoader на официальном форуме
Страница помощи на официальном форуме

Материалы сообщества доступны в соответствии с условиями лицензии CC-BY-SA , если не указано иное.