Скачать Как создать мод с помощью Microsoft Visual Studio (MVS) [tModLoader 0.5]

Переведено и дополнено Warten’ом. Ссылка на оригинал. (На английском)
Внимание! спрашивать тупые вопросы типа: А пачему руски язик не работает? Будет вгонять автора в дикий рэйдж.

Начало
Запомните: если ваша религия запрещает читать FAQ, гуглить и пользоваться переводчиком, помощи здесь можете не ждать. Вообще.

Установите tModLoader
Убедитесь, что у вас установлен последний .NET Framework Microsoft-.NET-Framework-4.52.exe
Microsoft-.NET-Framework-4.6.exe
Убедитесь, что у вас есть XNA Framework .dll файлы (Или скачайте XNA_Framework.zip .
Скачайте и установите Microsoft Visual Studio, Community Edition – vs_community.exe. (Установите с C# workspace. Внимание!: установите с английским языком) Он только на 30 дней! Позже нужно зарегистрировать учетку на офф. сайте и войти в программе, это бесплатно.
Ну и конечно начальные знания С#. Это несложно, почитайте учебники, гайды и сделайте любую обычную программу, прежде чем вы начнете моддинг.

Есть некоторые вещи которые вы должны знать, прежде чем начать моддинг:

Прежде всего, это руководство для tModLoader и оно может (Или не может) изменятся по мере обновлений.
Убедитесь, что у вас последняя .NET Framework Microsoft (4.5 или выше), чтобы предотвратить какие-либо проблемы.
Terraria использует XNA Framework библиотеки, поэтому вам понадобятся DLL-файлы в вашем моде. Они нужны для предотвращения ошибок при написании кода. Вы можете скачать мои или найти их самостоятельно, если у вас есть XNA Framework (Желательно).
И, конечно, не забудьте сам Microsoft Visual Studio.

Введение
MVS поможет вам авто-завершением кода, показывая ошибки, и вообще… Это сделает процесс написания кода куда быстрее и легче.
Microsoft Visual Studio представляет собой приложение для создания многих видов программ. Вы, наверное, слышали о нем раньше, и, возможно, кто-то даже использовал его 😀
Если вы используете MVS в первый раз, я рекомендую просмотреть/читать гайды/учебники по C# в первую очередь. В интернете их достаточно много.

Как создать ваш мод (Далее – проект) в MVS
Пользоваться MVS лучше с установленным англ. языком! После установки и запуска у вас откроется начальная страница, закройте ее. Потом сделайте все как в списке.

Нажмите File -> New -> Project (Templates -> Other project types -> Visual Studio Solutions) назовите его “Mod Sources” (Без кавычек)
Установите расположение: documents\My Games\Terraria\ModLoader
Нажмите OK
Нажмите Add -> New Project -> Windows -> Classic Desktop -> Empty Project
Впишите название мода (На англ языке, без спец. символов и пробелов)
Нажмите OK
Правым кликом по новому проекту (Справа) -> Add -> Class (назовите его так же, как назвали мод)
Потом напишите код как здесь: (MODNAME – это название вашего мода)
using Terraria.ModLoader; namespace MODNAME { public class MODNAME : Mod { public override void SetModInfo(out string name, ref ModProperties properties) { name = "MODNAME"; properties.Autoload = true; properties.AutoloadGores = true; properties.AutoloadSounds = true; } } }
Теперь создайте простой .txt фаил. Впишите туда эти строки:
author = Это ваш ник, имя, да что угодно, пишите что хотите;
version = версия, любые цифры;
displayName = это название мода которое будет показано в меню, здесь уже можно писать пробелы, спец символы, но нельзя кириллицу! (Русские буквы)
Примерно так:author = NAME version = 0 displayName = MOD NAME
Получившийся build.txt скиньте в ваш проект (Просто перетащите)
Потом правым кликом на ваш проект -> references -> Add reference (Добавьте библиотеки (.dll) которые скачали, и модифицированный Terraria.exe (С установленным модлоадером, тобишь))
Вот и все, теперь вы можете запустить террарию и собрать мод во вкладке mod sources, что-бы проверить все ли правильно вы сделали. Если нет то repeat.

Советы
Некоторые советы:

Старайтесь, чтобы внутренние имена, такие как пространства имен и классов, были чисты. То есть постарайтесь, избежать специальных символов, пробелов, тире и т.д. и т.п.
Если вы не понимаете что-либо, спросите себя: Есть ли у вас какие-либо знания C# в этом случае? Если нет, то прочитайте учебники/гайды по С#, а затем возвращайтесь.

Мои советы:

Посмотрите исходный код ExampleMod тщательно, он содержит почти все, что может сделать tModLoader в это время.
Примечание для MVS, он создает папку .vs, которая будет отображаться на вкладке mod sources. Сейчас просто игнорируйте ее.
Прежде чем вы начнете моддинг вы должны по крайней мере знать самые основы C#.
Вы в основном можете узнать эти основы, создавая консольные приложения.
Не бойтесь попробовать сделать что-то самостоятельно!
Опыт работы с программированием других приложений будет огромным плюсом в будущем.

Туториалы по C# (На английском. На русском ищите сами.)

http://www.tutorialspoint.com/csharp/
http://csharp.net-tutorials.com/
http://www.homeandlearn.co.uk/csharp/csharp.html

Дополнительные ссылки.

Документация (Англ)
Пост tModLoader’a на оф. форуме. (Тоже англ. Просьба от автора, не бегите туда спрашивать что либо на русском языке, в большинстве случаев вас там просто проигнорируют)
ID предметов, тайлов и тд

Создание файлов вашего проекта
Создание предмета:
Совет: Название предмета и текстуры должны быть одинаковыми.
Совет: Вот эта штука “//” называется комментарий, программа игнорирует все что после него написано. И да, сюда можно писать кириллицу.

Показать / Скрыть текст

Сначала создайте папку Items. Просто нажмите правым кликом на ваш проект -> Add -> Create folder. Вообще у папки может быть любое имя, но лучше не будем отходить от канона.
Теперь создайте фаил вашего предмета: правый клик по папке -> Add -> Class. (Shift + Alt + C)
В вашем файле появятся бесполезные директивы using, удалите их. Вместо них добавьте другие, более нужные нам:
using Terraria; //собсно террария
using Terraria.ID; //ID предметов, частиц, нпс и тд
using Terraria.ModLoader; //то с помощью чего мы делаем мод
Далее мы видим имя класса (Вашего предмета, не забудьте переименовать ItemName), добавьте ” : ModItem” после него
{
class ItemName : ModItem //Мы говорим программе что эта штука – предмет
Потом добавьте SetDefaults
{
public override void SetDefaults() //свойства предмета
{
//пишем свойства сюда
}
}}
Вот и все! Теперь вы можете редактировать свойства предмета.
Вот перечень свойств. (Здесь не всё.)

//int = 1, float = 0.01f, double = 1.00, bool = true или false.
item.name = “Item name”; //имя предмета, которое будет показано в игре.
item.maxStack = 99; //макс. количество, int
item.value = 01020304; //где 01Plat 02Gold 03Silver 04Copper, то есть 1 платина, 2 золота, 3 серебра и 4 копейки, int.

item.consumable = true; //предмет исчезает после использования, bool
item.healLife = 20; //лечит хп, int
item.healMana = 20; //восстанавливает ману, int

item.damage = 20; //урон, int
item.melee = true; //тип урона, вместо него можно написать item.magic, item.ranged, item.summon, item.thrown. bool
item.crit = 20; //шанс крита, int
item.knockBack = 2; //то как далеко летит моб после удара, int
item.mana = 20; // сколько использует маны, int

item.width = 40; // ширина предмета, int
item.height = 40; // высота предмета, int
item.toolTip = “”; // любой текст
item.toolTip2 = “”; // текст
item.rare = 2; //раритетность, int
item.expert = false; // радужный цвет как у экспертных предметов и надпись expert, bool

item.accessory = true; //одевается как акссесуар, bool
item.defense = 20; //сколько дает защиты, int
item.lifeRegen = 5; //регенерация, int
item.manaIncrease = 20; //добавляет макс. маны, int

item.axe = 5;// предмет работает как топор, int / 5
item.hammer = 25; // как молот, int
item.pick = 25; //как кирка, int

item.useTime = 15; //время использования в тиках, int
item.useAnimation = 30; //анимация в игре, то как быстро мы будем махать текстурой, int
item.useStyle = 1; /*как мы используем это: 1 – машем, 2 – используем как зелья, 3 – тыкаем, как кинжалами,
4 – поднимаем руками, 5 – просто держим в руках(книги, огнестрелы и тд), int */

item.shoot = ; //чем предмет стреляет, int ID
item.shootSpeed = 10f; //скорость, float
Добавление рецепта:
Для начала нам нужно добавить AddRecipes
{
public override void SetDefaults() //свойства предмета
{
//пишем свойства сюда
}
public override void AddRecipes()
{
//рецепт пишем сюда
}
}}
Потом добавляем остальное:

ModRecipe recipe = new ModRecipe(mod); //мы говорим что это рецепт
recipe.AddIngredient(ItemID.DirtBlock, 2); //мы добавляем в рецепт блок земли. Можно написать ID
recipe.AddIngredient(ItemID.DirtWall, 8); //стена земли
recipe.AddTile(TileID.WorkBenches); //для крафта нужен верстак
recipe.SetResult(this, 99); //В итоге получаем 99 предметов
recipe.AddRecipe();// конец рецепта
Делаем из предмета аксессуар
Добавляем UpdateAccessory()
{
public override void SetDefaults() //свойства предмета
{
//пишем свойства сюда
}
public override void UpdateAccessory(Player player)
{
//свойства аксессуара
}
public override void AddRecipes()
{
//рецепт пишем сюда
}
}}
Свойства аксессуара:

// += добавляет, -= вычитает, *= умножает, /= делит
player.meleeDamage += 10f; //melee урон, float
player.thrownDamage += 10f;//thrown урон, float
player.rangedDamage += 10f;//ranged урон, float
player.magicDamage += 10f; //magic урон, float
player.minionDamage += 10f;//minion урон, float

player.statDefense += 100; // защита, int
player.moveSpeed += 100; // скорость, int
player.maxMinions += 10; // макс. миньены, int

player.lifeRegen += 10; //реген хп, int
player.manaRegen += 10; //реген маны, int

player.waterWalk = true; //ходьба по воде, bool
player.noFallDmg = true; //урон от высоты, bool
player.jumpBoost = true; //выше прыжок, bool
player.lavaImmune = true;//иммун к лаве, bool
player.lifeForce = true; // +20% хп?, bool
player.lifeMagnet = true; // притягивает сердца
player.lifeSteal = 5; //лайфстил, int
player.jumpSpeedBoost = 10; // скорость прыжка, int
player.manaCost -= 10; //цена маны, int
player.nightVision = true; //ночное зрение, bool

player.magicCrit += 10; //int
player.rangedCrit += 10;//int
player.meleeCrit += 10; //int
player.thrownCrit += 10;//int
player. //миньоны не наносят криты

player.dash = 1; //рывок, int
player.dashDelay = 10; //время между рывками, int
player.AddBuff(BuffID.Shine, 5, false); //добавляет бафф, int ID, int tic, bool