StorageInterface — различия между версиями
(Новая страница: «<div class="mw-parser-output"> Данная библиотека для Inner Core позволяет описать взаимодействие блоков с…») |
|||
| Строка 1: | Строка 1: | ||
| − | <div class="mw-parser-output"> | + | <div class="mw-parser-output"><div class="mw-parser-output"> |
Данная библиотека для Inner Core позволяет описать взаимодействие блоков с трубами, воронками и прочими предметами для транспортировки предметов и жидкостей с помощью интерфейсов хранилищ, а так же добавляет методы для извлечения и загрузки предметов и жидкостей. | Данная библиотека для Inner Core позволяет описать взаимодействие блоков с трубами, воронками и прочими предметами для транспортировки предметов и жидкостей с помощью интерфейсов хранилищ, а так же добавляет методы для извлечения и загрузки предметов и жидкостей. | ||
| Строка 33: | Строка 33: | ||
Добавление интерфейса для tile entity на примере железной печки из мода IndustrialCraft 2 | Добавление интерфейса для tile entity на примере железной печки из мода IndustrialCraft 2 | ||
| − | <div style="background:#eeeeee;border:1px solid #cccccc;padding:5px 10px;">StorageInterface.createInterface(BlockID.ironFurnace, {<br/> slots: {<br/> "slotSource": {input: true,<br/> isValid: function(item, side){<br/> return side != 0 && Recipes.getFurnaceRecipeResult(item.id, "iron");<br/> }<br/> },<br/> "slotFuel": {input: true, <br/> isValid: function(item, side){<br/> return side != 1 && Recipes.getFuelBurnDuration(item.id, item.data) > 0;<br/> }<br/> },<br/> "slotResult": {output: true}<br/> }<br/> });</div> </div> | + | <div style="background:#eeeeee;border:1px solid #cccccc;padding:5px 10px;">StorageInterface.createInterface(BlockID.ironFurnace, {<br/> slots: {<br/> "slotSource": {input: true,<br/> isValid: function(item, side){<br/> return side != 0 && Recipes.getFurnaceRecipeResult(item.id, "iron");<br/> }<br/> },<br/> "slotFuel": {input: true, <br/> isValid: function(item, side){<br/> return side != 1 && Recipes.getFuelBurnDuration(item.id, item.data) > 0;<br/> }<br/> },<br/> "slotResult": {output: true}<br/> }<br/> });</div> |
| + | == Обратная совместимость == | ||
| + | |||
| + | Данная библиотека совместима с модами, используюшими старый стандарт описания слотов tile entity через функцию getTransportSlots и добавляет такую функцию для tile entity при создании его интерфейса. | ||
| + | </div> </div> | ||
Версия 17:30, 3 февраля 2020
Данная библиотека для Inner Core позволяет описать взаимодействие блоков с трубами, воронками и прочими предметами для транспортировки предметов и жидкостей с помощью интерфейсов хранилищ, а так же добавляет методы для извлечения и загрузки предметов и жидкостей.
Загрузка
| Версия | Ссылка | Список изменений | Дата релиза |
| 3 | Скачать | релиз библиотеки | 02.02.2020 |
Импорт
Для добавления библиотеки в мод ее файл (StorageInterface.js) нужно добавить в директорию lib/ в директории мода (если таковой нету, то ее нужно создать).
Для импорта библиотеки в мод в заголовочном файле (или если он остутвует в первом файле кода) следует добавить строку:
IMPORT("StorageInterface");
Интерфейсы хранилищ блоков
На данный момент интерфейсы привязываются только к tile entity, но в будущем по умолчанию интерфейсы будут прописаны у контейнеров из Майнкрафта, прежде всего печки.
В общем виде интерфейс хранилища tile entity выглядит так:
StorageInterface.createInterface(id блока, {
slots: {
"slot1": {
input: bool, // может ли слот принимать предметы
output: bool, // может ли слот отдавать предметы
isValid: function(item, side, tileEntity){ // может ли слот принять предмет item со стороны side
return bool;
},
canOutput: function(item, side, tileEntity){ // можно ли извлечь предмет из слота (item - предмет в слоте)
return bool;
}
},
"slot2": {
...
},
...
},
isValidInput: function(item, side, tileEntity){ // аналогична функции isValid слота, но действует на все слоты контейнера
return true;
},
addItem: function(item, side, maxCount){ return int; }, // кастомная функция добавления предмета
getItems: function(side){ return []; }, // кастомная функция получения предметов для извлечения
// методы работы с хранилищем жидкости
canReceiveLiquid: function(liquid, side){ return false; }, // может ли tile entity принять жидкость (liquid - название жидкости)
canTransportLiquid: function(liquid, side){ return false; }, // может ли tile entity отдать жидкость (liquid - название жидкости)
addLiquid: function(luquid, amount){ // функция добавление жидкости
return this.tileEntity.liquidStorage.addLiquid(luquid, amount);
}
getLiquid: function(luquid, amount){ // функция извлечения жидкости
return this.tileEntity.liquidStorage.getLiquid(luquid, amount);
}
});
slots: {
"slot1": {
input: bool, // может ли слот принимать предметы
output: bool, // может ли слот отдавать предметы
isValid: function(item, side, tileEntity){ // может ли слот принять предмет item со стороны side
return bool;
},
canOutput: function(item, side, tileEntity){ // можно ли извлечь предмет из слота (item - предмет в слоте)
return bool;
}
},
"slot2": {
...
},
...
},
isValidInput: function(item, side, tileEntity){ // аналогична функции isValid слота, но действует на все слоты контейнера
return true;
},
addItem: function(item, side, maxCount){ return int; }, // кастомная функция добавления предмета
getItems: function(side){ return []; }, // кастомная функция получения предметов для извлечения
// методы работы с хранилищем жидкости
canReceiveLiquid: function(liquid, side){ return false; }, // может ли tile entity принять жидкость (liquid - название жидкости)
canTransportLiquid: function(liquid, side){ return false; }, // может ли tile entity отдать жидкость (liquid - название жидкости)
addLiquid: function(luquid, amount){ // функция добавление жидкости
return this.tileEntity.liquidStorage.addLiquid(luquid, amount);
}
getLiquid: function(luquid, amount){ // функция извлечения жидкости
return this.tileEntity.liquidStorage.getLiquid(luquid, amount);
}
});
Для большинства функций указан их код по умолчанию (если вы её не пропишите в интерфейсе), либо тип возвращаемого ими значения.
Добавление интерфейса для tile entity на примере железной печки из мода IndustrialCraft 2
StorageInterface.createInterface(BlockID.ironFurnace, {
slots: {
"slotSource": {input: true,
isValid: function(item, side){
return side != 0 && Recipes.getFurnaceRecipeResult(item.id, "iron");
}
},
"slotFuel": {input: true,
isValid: function(item, side){
return side != 1 && Recipes.getFuelBurnDuration(item.id, item.data) > 0;
}
},
"slotResult": {output: true}
}
});
slots: {
"slotSource": {input: true,
isValid: function(item, side){
return side != 0 && Recipes.getFurnaceRecipeResult(item.id, "iron");
}
},
"slotFuel": {input: true,
isValid: function(item, side){
return side != 1 && Recipes.getFuelBurnDuration(item.id, item.data) > 0;
}
},
"slotResult": {output: true}
}
});
Обратная совместимость
Данная библиотека совместима с модами, используюшими старый стандарт описания слотов tile entity через функцию getTransportSlots и добавляет такую функцию для tile entity при создании его интерфейса.