Основы программирования для Minecraft - мини-версия.
Всем доброго времени суток!
Перед вами будущий учебник для начинающих модостроителей Minecraft'а.
Намечается написать целых 20 и более глав для новичков.
Так же скажу от себя - моддинг под данную игру может быть и не очень сложен, но он отнимает много времени и от вас потребуются железные нервы.
Ахтунг! Учебник по моддингу для Modloadera!
Код на изображениях проверки может отличатся от кода учебника! Например: ID объекта.
Используйте код который указан в главах и проверяйте регистр на картинках!
Мини-версия учебника, специально для Minecraft.my1.ru!
ПОЛНАЯ ВЕРСИЯ НАХОДИТСЯ ЗДЕСЬ.
Вопрос-ответ:
Вопрос: Чем этот учебник отличается от статей WD'kun'a?
Ответ: В данной учебнике больше информации и моддинг осуществляется для клиента с ModLoader'ом.
Вопрос: А зачем этот ModLoader?
Ответ: Делает удобнее и быстрее моддинг в разы.
Вопрос: Я сделал свой первый мод, куда мне можно его залить и кому показывать?
Ответ: Если вы уверены, что Ваш мод достоин внимания и он хорошо проработан как и в плане оптимизации, так и в плане внешнего вида - скидывайте его на minecraftforum.net
Вопрос: А что если у меня не лицензионная копия игры? Я не смогу делать моды?
Ответ: Моды можно делать и на пиратке, на счет этого не беспокойтесь. Разницы нет.
Вопрос: Я там карочи всие сделол как написана и игра паказывает англиские слава какие та ниче ни понятна!!111
Ответ: Для того, чтобы мы Вам помогли, скиньте Log'и (текст) ошибки прямо в эту тему, мы Вам обязательно поможем!
Вопрос: При рекомпиляции выпадает море ошибок. Что делать?
Ответ: Отписать в эту тему или в джаббер конференцию. Если никто Вам не отвечает, проверьте, все ли скобки стоят правильно и совпадает ли регистр букв.
Вопрос: Я зашел в конференцию, а там никого нет? На форуме не отвечают, в конфе тоже пусто. Вы пропали?
Ответ: Скорее всего из авторов учебника никого нет в сети. Будьте терпеливы, как только появится возможность, мы Вам обязательно поможем!
Вопрос: У меня ничего не получается! Сделайте, пожалуйста за меня ...
Ответ: Мы делаем что-то для пользователей только в крайних случаях, если например ошибки неизлечимы, и все это связанно с вашим компьютером, а не руками.
Вопрос: Я прошел весь учебник, но обновлений не наблюдаю. Вы забросили его?
Ответ: Конечно же нет! Просто у нас тоже есть личная жизнь, и иногда приходится отлучаться.
Вопрос: Я видел у буржуев статью про ... Вы добавите ее к себе?
Ответ: Добавьте ссылку на источник статьи, мы ее прочитаем, проверим, проанализируем и запишем по своему :)
Вопрос: Все время вы говорите создать какой-то файл .java. Как его вообще создать?
Ответ: Создаете текстовый файл и просто переименовываете его из Текстовый документ.txt, например, в mod_gcc.java (открывая его, непосредственно, в нотепаде), а затем редактируете и сохраняете.
Вопрос: В учебнике слишком неудобно отписаны некоторые моменты. Можно я какие мне надо строчки в другие файлики перемещу, ведь так удобнее!
Ответ: Ни в коем случае! И даже не пытайтесь.
Вопрос: А как открыть файл .jar винраром?
Ответ: ПКМ --> Открыть с помощью --> WinRar или 7zip.
Вопрос: Я начал работать, но в src/minecraft/ файлов нет! Я что-то забыл сделать?
Ответ: Скорее всего, декомпилятор выдал ошибку и не отдал вам сорцы игры. Ну или в крайнем случае вы просто забыли его включить.
Если где-то, что-то не получается - качайте готовый MCP с двумя главами.
Глава 1. Подготовка рабочего места и настройка MCP.
Я отказываюсь писать статьи по старому стилю оформления как в прошлых уроках, т.к надоедает все время отписывать числа.
Надеюсь, вы меня поймете :)
Требования:
- Java Development Kit 6 (JDK 6).
- Notepad++ - обязательно, иначе вы не сможете пройти главы.
- ModLoader + Клиент (1.8.1) (качать обязательно).
- Руки, но не крюки.
- И желательно базовое знание английского языка.
Установка:
1. Создаем папку в любом удобном для вас месте.
2. Копируем файлы архива MCP в эту папку.
3. Прописываем путь к javac.exe (JDK) в системной переменной PATH.
Щелкните правой кнопкой мыши по ярлыку Мой компьютер и выберите категорию Дополнительно. Там же ниже будет кнопка Переменные среды.
В системных переменных найдите переменную Path (PATH) и допишите в ней строки:
Code;C:\Program Files\Java\jdk1.6.0_25\bin
или
Code;C:\Program Files\Java\jdk1.6.0_26\bin
В зависимости от версии.
Без пробела и с символом "точка с запятой". Путь укажите, конечно же, по вашему усмотрению системы.
4. Кладем из клиента Minecraft папки bin и resources в папку jars, которая непосредственно находится в вашей папке которую вы подготовили ранее (о как сказанул).
5. Откройте папку bin и найдите minecraft.jar. Откройте (не разархивируйте), и удалите папку META-INF.
6. Запускаем decompile.bat.
7. Как только вы пройдете уроки ниже, просто напросто запускайте recompile.bat, а после чего startclient.bat и тестируйте.
8. Ну а когда вы точно решили что мод готов - запускайте reobf.bat, проходите в папочку reobf и все содержимое кидайте в файл minecraft.jar специально подготовленной для этого игры.
Глава 2. Создание блока.
Запоминайте сразу, в пути \src\minecraft\net\minecraft\src находится весь декомпилированный код игры.
Для начала давайте создадим новый файлик посредством нотепада. Называться он будет mod_gcc.java.
Он служит для складывания всей информации о блоках, рецептах, etc.
Впишем такую строчку (используйте Notepad++, детишки!).
Codepackage net.minecraft.src;
Она включает магию которая даст возможность данному файлику работать с Кубокрафтом.
После чего добавим еще две строчечки, но сначала делаем пробел.
Codepublic class mod_gcc extends BaseMod
{
Здесь мы создаем класс.
Codepublic static Block newblock = new BlockNew(110, 0).setHardness(0.5F).setResistance(1.0F).setBlockName("newblock");
Пишем в 5 строке вот такие словечки про наш кубик, тут мы его регистрируем.
Давайте попробуем разобрать данную неразбериху.
Codepublic static Block newblock
newblock - это название, точнее регистр блока (не путайте с обычным названием, или консоль ошибок покарает вас!).
Codenew BlockNew(110, 0)
Ну а вот тут у нас как раз и обычное название. Будет использоваться для обозначения в отдельном файлике для блока (доп. характеристики).
Число 110 - айди блока. Используйте с 110 по 250.
Число 0 - не трогайте, это индексация текстуры по terrain.png, оно вообще не понадобится. Пусть стоит в фазе нуля.
CodesetHardness(0.5F)
Тут у нас крепкость указана. На сколько силен блок, так сказать :diamond: Вполне реально хватит и 0.5F если это блок похожий на землю (по скорости разрушения).
CodesetResistance(0.3F)
Устойчивость от взрыва. 0.3F отлично вписывается.
CodesetLightValue(1.0F)
Если хотите чтобы ваш блок был светящимся (для дополнительных команд вызова я выведу чуть позже целый спойлер :diamond: ), просто укажите это через точку.
1.0F - светится как австралий.
CodesetBlockName("newblock")
Сделан специально чтобы полностью до конца объявить регистр.
Профиряем код.
Теперь давайте создадим специальный файлик BlockNew.java (по названию блока) который определит наш кубик в игре.
Вписываем в первую строчку магические буковки, опять.
Codepackage net.minecraft.src;
Затем импортируем еще одну магию которая даст нам возможность использовать переменную Random.
Codeimport java.util.Random;
Потом создаем публичный класс (не забудьте название).
Codepublic class BlockNew extends Block
{
После чего копипастим вот это.
Codepublic BlockNew(int i, int j)
{
super(i, j, Material.ground);
}
Тут у нас получается что мы объявляем блок, делаем его настоящим (материальным) и задаем свойство (каждое свойство имеет ряд своих особенностей, типа звуков и т.п).
Дальше объявляем выбрасывание и его ID.
Codepublic int idDropped(int i, int j)
{
return mod_gcc.newblock.blockID;
}
public int quantityDropped(Random random)
{
return 1;
}
}
Примечание: У меня там Rock написано в свойстве, пропустите это, ага.
Если все так же - переходим к следующей главе.
Глава 2.1. Рецепт для блока или как добыть кубик.
Добавим четыре строчки для определения версии вашего мода (или названия, не важно).
Code public String Version()
{
return "1.8.1 Tutorial";
}
Ну а теперь перейдем непосредственно к написанию рецепта.
Запишем вот это:
Codepublic mod_gcc()
{
И начнем творить.
Регистрируем блок строкой:
CodeModLoader.RegisterBlock(newblock);
Добавляем название блока в игре.
CodeModLoader.AddName(newblock, "GCC");
И запюливаем сам рецептик.
CodeModLoader.AddRecipe(new ItemStack(newblock, 1), new Object[]{ "##", "##", Character.valueOf('#'), Block.dirt});
Разберем?
Code(new ItemStack(newblock, 1)
При крафте появляется newblock в количестве 1 (изменяйте как душе угодно до 64).
Codenew Object[]{ "##", "##", Character.valueOf('#'), Block.dirt
Тут очень сложно объяснить для детей, взрослые может быть и поймут, но я все же попробую.
Одна решетка обозначает одну ячейку сверху вниз (это может быть и верстак, если решеток более 3 в одной строке).
Т.е. в нашем случае мы заполняем обычной землей (Block.dirt) все крафт-ячейки в инвентаре (их 4).
Для примера, если например ваш объект крафтится не только из земли, да еще и в верстаке, поступать нужно так.
Codenew Object[]{ "#X#", "#Z#", "#X#", Character.valueOf('X'), Block.dirt, Character.valueOf('Z'), Block.sand
В данном примере мы ставим землю по середине в верхней строке, ставим песок по середке в средней строке, и опять землю по середине, но только в третьей строке.
Если какой-то символ (в нашем случае решетка) не указана в Character.valueOf - то значит дефолтно ячейки должны быть пусты (указаны, например символом #).
Проверяем.
Вот и все. Теперь ваш блок можно спокойно скрафтить.
Но мы забыли добавить текстуру, о нет! Об этом читайте в следующей главе.
Глава 2.2. Присваиваем текстуру.
Эта глава очень короткая и легкая, но все же я выделил ей особое место.
Берем вот такую текстуру:
(размеры не изменять!)
И временно кидаем ее в папку jars/bin.
Заходим в папку bin, находим minecraft.jar, открываем ее посредством WinRar или 7-zip и создаем там папочку textures.
И в эту папочку кидаем нашу текстуру java.png.
Теперь открываем mod_gcc.java и добавляем строчки рядом с рецептом.
Codenewblock.blockIndexInTexture = ModLoader.addOverride("/terrain.png", "/textures/java.png");
Разбираем.
Codenewblock.blockIndexInTexture
Сразу предупреждаю, не забывайте изменять название регистра здесь (у меня частенько бывает такое).
CodeModLoader.addOverride("/terrain.png"
Не знаю зачем оно, но вроде индексирует размеры блоков внутри terrain.png. Оставляем как есть.
Code"/textures/java.png"
Ну а тут, непосредственно, указывается путь к текстуре. В нашем случае это java.png в папке textures.
Вот и все!
Проверяем.
Если вы уверены что все сделали правильно, запускайте recompile.bat, проверяйте на наличие ошибок (если есть, отписывайте с вопросами сюда), после чего включайте startclient.bat и наслаждайтесь вашим творением!
Скриншот из игры:
Глава 3. Создание предмета.
Для начала добавим одну строчку:
Codepublic static final Item smileItem = new Smile(3000).setItemName("smileItem");
Непосредственно после строки нашего блока:
Codepublic static Block newblock = new BlockNew(110, 0).setHardness(0.5F).setResistance(1.0F).setBlockName("newblock");
Разберем код предмета.
CodeItem smileItem
Вызываем предмет по тех. названию.
Codenew Smile
Название для будущего Smile.java.
Code(3000)
ID предмета.
CodesetItemName("smileItem")
Объявляем предмет, даем ему тех. название для идентификации.
Делаем отступ на одну строку от строки:
Codenewblock.blockIndexInTexture = ModLoader.addOverride("/terrain.png", "/textures/java.png");
И записываем следующее.
CodeModLoader.AddName(smileItem, "Smile");
Code(smileItem, "Smile")
Даем название в самой игре.
И последняя строка рецепта.
CodeModLoader.AddRecipe(new ItemStack(smileItem, 5), new Object[]{ "X#", "#X", Character.valueOf('X'), Block.dirt});
Code(smileItem, 5)
Число получаемых "смайлов" после крафтинга.
Code"X#", "#X" Character.valueOf('X'), Block.dirt
Сам рецепт. По диагонали ставим грязь - получаем смайл.
Теперь нам нужно создать файлик Smile.java.
В первой строке как обычно:
Codepackage net.minecraft.src;
В третьей и четвертой:
Codepublic class Smile extends Item
{
А далее:
Code public Smile(int i) {
super(i);
maxStackSize = 64;
}
}
CodemaxStackSize = 64;
Максимальное количество предмета в одном стаке (нап. 64).
Глава 3.1. Присвоение текстуры.
Возьмем текстуру смайлика
(размеры не изменять!)
И поместим ее в minecraft.jar/textures как обычно.
Пишем после рецепта:
CodesmileItem.iconIndex = ModLoader.addOverride("/gui/items.png", "/textures/smile.png");
Разбираем.
CodesmileItem.iconIndex
Определяет, чья иконка (текстура).
CodeModLoader.addOverride("/gui/items.png", "/textures/smile.png")
Это вам уже знакомо. Тут промолчу.
Проверяем.
Теперь вам осталось просто запустить recompile.bat и опробовать смайлы :)
Скриншоты из игры:
Глава 4. Генерация блока в мире.
Сейчас я попробую рассказать, как заставить наш блок генерироваться в игровом мире.
Для примера он будет появляться у камня (2-3 блока вниз).
Откроем mod_gcc.java.
После первой строки добавьте строку:
Codeimport java.util.Random;
А после 13 строки сделаем отступ и запишем вот это.
Codepublic void GenerateSurface(World world, Random rand, int chunkX, int chunkZ)
{
for(int i = 0; i < 150; i++)
{
int randPosX = chunkX + rand.nextInt(16);
int randPosY = rand.nextInt(150);
int randPosZ = chunkZ + rand.nextInt(16);
(new WorldGenMinable(mod_gcc.newblock.blockID, 32)).generate(world, rand, randPosX, randPosY, randPosZ);
}
}
Разбираем.
Число 150 отвечает за редкость блока в игровом мире. 150 - это почти вездесущий, и его будет дохрена.
Для теста 150 подойдет отлично. Далее просто экспериментируйте.
Codefor(int i = 0; i < 150; i++)
150 - высота блока от админиума (бедрока). В нашем случае получается он выше камня на один блок в генерации. Тоже можно экспериментировать.
Codeint randPosY = rand.nextInt(150);
mod_gcc - наш мод. newblock - регистр блока. Число 32 - количество блоков на одном месторождении. Для теста я использовал 32 блока.
Code(new WorldGenMinable(mod_gcc.newblock.blockID, 32))
Проверяем.
Вот и все. Запускайте и пробуйте!
Скриншоты из игры:
Глава 5. Создание еды или как слепить хавку.
Добавляем к пабликам строку:
Codepublic static final Item pighead = new ItemFood(3001, 10, false).setItemName("pighead");
Разберем.
Первое число - ID, второе - количество половинок сердца для восстановления (всего 20 половинок), а false можно ли использовать на волке для привлечения. Далее все по прежнему.
Codenew pigHead(3001, 20, false)
Запишем привычные строки.
Codepighead.iconIndex = ModLoader.addOverride("/gui/items.png", "/textures/pighead.png");
ModLoader.AddName(pighead, "Pig Head");
ModLoader.AddRecipe(new ItemStack(pighead, 1), new Object[]{ "XX", "X#", Character.valueOf('X'), Block.dirt});
Закинем текстуру в minecraft.jar/textures.
(размеры не изменять!)
Создаем файлик pigHead.java.
Туда кидаем:
Codepackage net.minecraft.src;
public class pigHead extends ItemFood {
public pigHead(int i, int j) {
super(i, j, true);
}
}
Запускаем и пробуем!
Для развития:
Если хотите чтобы после поедания вашей еды выпадал предмет (например, если это суп), вместо старого паблика впишите новый:
Codepublic static final Item pighead = new Head(3001, 20, false, 16).setItemName("pighead");
Переименуйте pigHead.java в Head.java и весь код замените на:
Codepackage net.minecraft.src;
public class Head extends ItemFood
{
public Head(int i, int j, boolean flag, int k)
{
super(i, j, flag);
healAmount = j;
maxStackSize = k;
}
public ItemStack onItemRightClick(ItemStack itemstack, World world, EntityPlayer entityplayer)
{
itemstack.stackSize--;
entityplayer.heal(healAmount);
entityplayer.dropPlayerItem(new ItemStack(mod_gcc.pighead.shiftedIndex, 1, 0));
return itemstack;
}
public int getHealAmount()
{
return healAmount;
}
protected int healAmount;
}
Единственное что вам тут понадобится - эта строка. После поедания еды выпадает она же в количестве 1. Можете экспериментировать. Для дропа других итемов, пишите Item.название.shiftedIndex.
Codeentityplayer.dropPlayerItem(new ItemStack(mod_gcc.pighead.shiftedIndex, 1, 0))
Учебник разрабатывается коллективом mc.salmons.ru!
