Текущая версия на 19:07, 3 февраля 2013

Custom Stuff - это мод для Minecraft, с которым абсолютно любой человек, не знающий язык Java, может добавить в игру различные блоки, предметы, инструменты, броню, пищу, рецепты и другое (см. ниже).

Установка модификации

• Поместите архив custom stuff.zip в директорию .minecraft/mods (Внимание! Нужен ModLoader ИЛИ Minecraft Forge)
• Запустите игру, в директории .minecraft/config должны появиться папки customX, где X - категория (customBlocks, customItems и т.д.).

Категория:Блоки

• Чтобы добавить свой блок в игру, нужно создать в категории customBlocks файл с расширением .block и открыть с помощью блокнота.

У блоков должны быть в обязательном порядке 3 параметра:

Дополнительные параметры блоков

Пример создания блока (на примере фонаря) и блока, который вызывает молнию

• Как написано выше, нужно создать файл с расширением .block и открыть с помощью блокнота.
• Подготовить текстуру 16х16 для блока.
• Написать основные параметры (id, name и texturefile).

id=170;
name="Фонарь";
texturefile="Lantern.png";

• Добавить вторичные параметры.

id=170;
name="Фонарь";
texturefile="Lantern.png";
light=15;
material="glass";
stepsound="glass";

• Кинуть текстуру Lantern.png (с учётом регистра) в архив .minecraft/mods/custom stuff.zip
• Блок создан.

Блок "Призыватель молний"

• Создаем еще один файл с расширением .block и открываем с помощью блокнота.
• Делаем текстуру 16х16 для "Призывателя".
• Помимо основных параметров пишем еще и вызов функции, при воздействии на блок редстоуна.

id=195;
name="Призыватель молний";
texturefile="имя_вашей_текстуры.png";

• Основные параметры готовы, осталось добавить вторичные и вызов функции.

id=195;
name="Призыватель молний";
texturefile="имя_вашей_текстуры.png";
material="iron";
stepsound="metal";
activated = "world.createThunderbolt(origin);";

• Кидайте вашу_текстуру.png в архив .minecraft/mods/custom stuff.zip
• Тестируйте свое первое эпическое творение:).

Список несложных функций

• Функция вызова молнии.

"world.createThunderbolt(origin);";

• Функция создания взрыва(последняя цифра "3" - это мощность взрыва, можно изменить значение на свое).

"world.createExplosion(origin, 3);";

• Функция включения/выключения дождя (включен - 1, выключен - 0)

"world.setWeather(1);";

• Функция установки времени (ставьте любое значение от 0 до 24, 0 - утро, 12 - полночь)

"world.setTime(0);";

• Функция спавна мобов (можете ставить имена других мобов например 'Cow' или 'Creeper', но они обязательно должны быть заключены в одинарные кавычки.)

"world.spawnMob(origin, 'Pig');";

Категория:Предметы

• Чтобы добавить в игру свой предмет, нужно создать файл с расширением .item в категории customItems и открыть с помощью блокнота.

У предметов в обязательном порядке должны быть три параметра:

Дополнительные параметры для предметов

Пример создания предмета

• Как написано выше, нужно создать файл с расширением .item и открыть с помощью блокнота.
• Подготовить текстуру 16х16 для предмета.
• Написать основные параметры (id, name и iconfile).

id=1503;
name="Derky Pickaxe";
iconfile="Derky_Pickaxe.png";

• Добавить вторичные параметры (хотя в случае с инструментом эти параметры нельзя назвать вторичными).

name="Derky Pickaxe";
id=1503;
iconfile="Derky_Pickaxe.png";
type="normal";
maxuses=2048;
harvestblocks="pickaxediamond";
efficiencyblocks="pickaxe";
efficiency=16;
damage=1;
blockdestroyed="player.damageItem(player.getCurrentSlot(), 1);";
hitmob="player.damageItem(player.getCurrentSlot(), 512);";

Свойства данной кирки:

• Уничтожается с 4 ударов, если атаковать ей мобов. (hitmob)
• Эффективность в два раза выше, чем у алмазной кирки. (efficiency)
• Максимальное количество использований выше, чем у алмазной кирки на ~500. (blockdestroyed)
• Может добывать обсидиан. (harvestblocks, efficiencyblocks)

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

Вы не задумывались, почему же ваш игрок выпивает добавленную вами бутылочку сока с бутылочкой? Если задумывались, то вникайте:

• Создаем файл с расширением .item
• Делаем текстуру - 16х16, естественно.
• А теперь наш предмет - бутылочка с соком!

id = 701;
name = "Бутылочка с соком";
iconfile = "ваша_текстура.png";
type = "food";
maxstack = 1;
saturation = 1.3;
healamount = 2;
eaten = "player.addToInventory(374, 1, 0);";

• Первое число в функции - это id предмета который будет спавнится в инвентарь, после употребления нашего, в данном случае пустой пузырек. Второе число - количество предметов которые заспавнятся в инвентарь. Третье - параметр damage предмета, не менять.
• eaten - вызывает функцию, после съедания предмета.
• Теперь идем пить наш сок...

Категория:Рецепты

• Чтобы создать рецепт, нужно создать файл с расширением .recipe в категории customRecipes и открыть его с помощью блокнота.
• Файл должен быть один (т.е. для создания одного и более рецепта хватает одной строки в блокноте).

Структура создания рецепта

• Для крафта в ячейке 2х2:

recipes.addRecipe("X amount 2 2 1 2 3 4", "vanilla");

• Для крафта в ячейке 3х3:
  

recipes.addRecipe("X amount 3 3 1 2 3 4 5 6 7 8 9", "vanilla");

• Для крафта в нестрогом порядке предметов (размер ячейки указывать не нужно):
  

recipes.addShapelessRecipe("X amount 1 2 3 4 5 6 7 8 9", "vanilla");

• Разбор крафта:

X - выходящий предмет
amount - количество выходящих предметов
2 2 (или 3 3) - сетка крафта
1 2 3 4 - ингредиенты, поставленные по порядку (см. справа нумерацию крафта).

Удаление рецепта

• Для удаления рецепта написанного Mojang или другими модерами, необходимо вписать следующие строки:

recipes.removeRecipe("X amount 3 3 1 2 3 4 5 6 7 8 9", "vanilla");

• Разбор крафта:

X - выходящий предмет
amount - количество выходящих предметов
2 2 (или 3 3) - сетка крафта
1 2 3 4 - ингредиенты, поставленные по порядку (см. справа нумерацию крафта).

• Пример:

recipes.removeRecipe("46 1 3 3 289 12 289 12 289 12 289 12 289 12", "vanilla");

Эта строка позволит удалить рецепт TNT

• Для удаления бесформенного рецепта:

recipes.removeShapelessRecipe(X amount 1 2 3 4 5 6 7 8 9", "vanilla");

Категория:Топливо

• Эта категория добавляет свойство предмету использоваться в печи в качестве топлива. Чтобы создать топливо, нужно создать файл с расширением .fuel в категории customFuels.

Для переплавки одной вещи необходимо 200 энергии (10 секунд). К примеру, у угля энергетический запас составляет 1600 ед. энергии, а у досок/древесины - 300 единиц. В одном файле с расширением .fuel можно хранить плавку всех предметов, т.е. для каждой строки будет определено по одному горючему материалу.

• Пример:

fuels.addFuel("49 3200", "vanilla"); (Обсидиан может проплавить 16 предметов)
fuels.addFuel("1 100", "vanilla"); (Камень может переплавить 0.5 предметов)

Категория:Создания рецепта переплавки

• Эта категория добавляет свойство получать один предмет из другого путём переплавки в печи. Чтобы создать рецепт переплавки, нужно создать файл с расширением .srecipe в категории customSmeltingRecipes.

В файле example.srecipe нужно написать в одну строку:
smeltingRecipes.addRecipe("X 1 amount", "vanilla");
X - какой предмет (или блок) надо переплавить
amount - количество вещей
1 - получившийся предмет.

Категория:Создание генерации руды

• Чтобы создать генерацию руды(блока), нужно создать файл с расширением .oregen в категории customOreGeneration.

Пример:

id=35;
damage=10;
type="normal";
size=10;
rate=10;
generationblocks=1;
heightmin=0;
heightmax=128;

Блоки и предметы с различными функциями

Гравитационная Установка

• Гравитационная Установка (блок имеет два режима: обычный (не подключен редстоун) и ультра (подключен редстоун)), при первом высота подкидывания - 6-8 блоков, при втором - около 40).
• Создаем как было не раз описано выше файл с расширением .block.
• В нём пишем:

id = 205;
type = "normal";
name = "Гравитационная Установка (обычный режим)";
texturefile = "ваша_текстура.png";
damagevalues = 1;
material = "iron";
stepsound = "metal";
hardness = 1;
rightclicked = "player.addVelo(0, 1, 0);";
activated = "world.setBlockMetadata(origin, 1);player.sendMessage('Активирован ультра-режим.');";

name1 = "Гравитационная Установка (ультра-режим)";
iddropped1 = 205;
damagedropped1 = 0;
rightclicked1 = "player.addVelo(0, 3, 0);";
deactivated1 = "world.setBlockMetadata(origin, 0);player.sendMessage('Активирован обычный режим.');";

• Готово! Переключать режимы лучше всего рычагом, выключен - обычный режим, включен - ультра-режим. Чтобы установка вас подкинула, нажмите на нее ПКМ. Летайте на здоровье и не переломайте ноги!

Направленный Телепортатор

• Направленный Телепортатор перемещает ГГ в место прицеливания, при нажатии ПКМ. И дабы избежать великого читерства ограничим радиус действия порталгана до 20 блоков.
• Итак, в папке CustomItems создаем файл с расширением .item, и пишем туда:

name="Направленный Телепортатор";
id=793;
type="normal";
iconfile="ваш_файл.png";
iconindex=1;
maxstack=1;
rightclickair = "customstuff.loadScript('portalgun.script')";

• Сам порталган готов. Теперь делаем скрипт для него.
• В папке customStuffFunctions создаем файл с расширением .script, в нем пишем:

var x = player.getLookX(20);  //    \
var y = player.getLookY(20);  //     > можно выставить свои значения.
var z = player.getLookZ(20);  //    /

player.setPosition(x, y+3, z);

• Все готово. Теперь сохраняем и тестим.
• Кому нужна иконка для Телепортатора, вот: Файл:Teleportator for customstuff.png

Электро-Винтовка

(Материал с minecraftmodcustomstuff.wikia.com)

• Винтовка вызывает электро-разряд с небес в место прицеливания, и для выстрела использует светящуюся пыль. Максимальный радиус 60 блоков.
• В папке CustomItems создаем файл с расширением .item, и пишем в нем:

name="Электро-Винтовка";
id=793;
type="normal";
iconfile="ваш_файл.png";
iconindex=1;
maxstack=1;
rightclickair = "if(player.getItemCount(348, 0) >=1 ){customstuff.loadScript('lightingweapon.script')}"; //проверка, если в инвентаре есть светящаяся пыль то запускаем скрипт.

• Теперь делаем скрипт для винтовки.
• В папке customStuffFunctions создаем файл с расширением .script, туда пишем:

var x = player.getLookX(60);   //    \
var y = player.getLookY(60);   //     > можно выставить свои значения(в блоках)
var z = player.getLookZ(60);   //    /

world.createThunderbolt(x, y, z);//создаем молнию в этих координатах (направление взгляда ГГ)
player.removeFromInventory(348, 1, 0); //забираем 1 светящуюся пыль из инвентаря (первое число id)

• Винтовка готова.
• Кому нужна иконка, вот: Файл:Lightingwpn for customstuff.png

Баги (CS1)

• Если созданной киркой ударить по земле, траве, гравию, песку и многим другим блокам, игра крашнется и выдаст ошибку.
• В мультиплеере нельзя открыть двери с атрибутом "redstoneonly".
• В мультиплеере двери зачастую открываются только со стороны клиента. Из-за этого иногда невозможно пройти через них.
• Атрибут брони "noburning" и тому подобные не работают в сетевой игре.
• До выхода CustomStuff 2 предметы в руке отображались большими в два раза и перевёрнутыми, подобно инструментам и кости.