80LK (обсуждение | вклад) м |
80LK (обсуждение | вклад) м |
||
(не показано 5 промежуточных версий этого же участника) | |||
Строка 1: | Строка 1: | ||
<div class="mw-parser-output"><div class="mw-parser-output"> | <div class="mw-parser-output"><div class="mw-parser-output"> | ||
+ | <div class="mw-parser-output"> | ||
== GuideAPI == | == GuideAPI == | ||
<div class="mw-parser-output">'''GuideAPI '''– мод-библиотека, предоставляющая большие возможности для создания игровых документаций.</div> <div class="mw-parser-output"><syntaxhighlight lang="JavaScript">ModAPI.addAPICallback("GuideAPI", function(api) { | <div class="mw-parser-output">'''GuideAPI '''– мод-библиотека, предоставляющая большие возможности для создания игровых документаций.</div> <div class="mw-parser-output"><syntaxhighlight lang="JavaScript">ModAPI.addAPICallback("GuideAPI", function(api) { | ||
Строка 37: | Строка 38: | ||
});</syntaxhighlight> | });</syntaxhighlight> | ||
− | Регистрация происходит через метод ''GuideAPI.registerGuide(unique, params)'', где '''''unique'''''– уникальный идентификатор, '''''params'''''– объект с параметрами.<br/> Параметры: | + | Регистрация происходит через метод ''GuideAPI.registerGuide(unique, params)'', где '''''unique''''' – уникальный идентификатор, '''''params''''' – объект с параметрами.<br/> Параметры: |
− | *Объект '''''textures'''''задаёт текстуры для интерфейса. Если не объявлен, будет использоваться стандартное оформление | + | *Объект '''''textures''''' задаёт текстуры для интерфейса. Если не объявлен, будет использоваться стандартное оформление |
**<u>''background''</u>'' ''– текстура заднего фона | **<u>''background''</u>'' ''– текстура заднего фона | ||
**<u>''nextLink''</u>''– текстура для кнопки “вперёд”'' | **<u>''nextLink''</u>''– текстура для кнопки “вперёд”'' | ||
Строка 46: | Строка 47: | ||
*Объект '''item''' задаёт ид предмета, при клике которым происходит открытие интерфейса. Является необязательным параметром | *Объект '''item''' задаёт ид предмета, при клике которым происходит открытие интерфейса. Является необязательным параметром | ||
*Если '''debug''' объявлен и равен true, у интерфейса вызывается метод setDebugEnabled(true) | *Если '''debug''' объявлен и равен true, у интерфейса вызывается метод setDebugEnabled(true) | ||
− | *Объект '''pages''' содержит страницы. Каждая имеет правую'''''(right)''''' и левую'''''(left)''''' секции, для которых задаются контроллеры'''''(controller)'''''. Любую из них можно пропустить. '''''nextLink'''''содержит идентификатор страницы, на которую происходит переход при нажатии кнопки “вперёд”, '''''preLink'''''при нажатии кнопки “назад”. При открытии интерфейса происходит загрузка страницы с идентификатором '''''default'''''. | + | *Объект '''pages''' содержит страницы. Каждая имеет правую'''''(right)''''' и левую'''''(left)''''' секции, для которых задаются контроллеры'''''(controller)'''''. Любую из них можно пропустить. '''''nextLink''''' содержит идентификатор страницы, на которую происходит переход при нажатии кнопки “вперёд”, '''''preLink'''''при нажатии кнопки “назад”. При открытии интерфейса происходит загрузка страницы с идентификатором '''''default'''''. |
− | <div class="mw-parser-output"> | + | <div class="mw-parser-output"><div class="mw-parser-output"> </div> </div> </div> </div> |
− | <div class="mw-parser-output"> | + | |
== Контроллеры == | == Контроллеры == | ||
Строка 73: | Строка 74: | ||
*'''link''' – идентификатор страница, на которую будет осуществлён переход при клике на текст | *'''link''' – идентификатор страница, на которую будет осуществлён переход при клике на текст | ||
</div> </div> | </div> </div> | ||
+ | <div class="mw-parser-output"> | ||
=== ITEM_PAGE === | === ITEM_PAGE === | ||
+ | Котроллер ''ITEM_PAGE ''позволяет создавать страницы с группой предметов и текстом. | ||
+ | <syntaxhighlight lang="JavaScript">{ | ||
+ | controller: PageControllers.ITEM_PAGE, | ||
+ | items: [ | ||
+ | { id: 1, data: 1 }, | ||
+ | { id: 264 }, | ||
+ | { id: 266 }, | ||
+ | ], | ||
+ | elements: [ | ||
+ | { text: "I'm text", size: 20 }, | ||
+ | { text: "And I'm text too" } | ||
+ | ] | ||
+ | }</syntaxhighlight> | ||
+ | |||
+ | '''''items''''' – массив из отображаемых предметов. Первый из них будет помещён в большой слот. | ||
+ | </div> | ||
+ | |||
+ | <div class="mw-parser-output"> | ||
=== ITEM_GRID_PAGE === | === ITEM_GRID_PAGE === | ||
+ | Контроллер ''ITEM_GRID_PAGE ''позволяет располагать предметы сеткой. | ||
+ | <syntaxhighlight lang="JavaScript">{ | ||
+ | controller: PageControllers.ITEM_GRID_PAGE, | ||
+ | columns: 8, | ||
+ | item_size: 30, | ||
+ | items: [ | ||
+ | { id: 1, data: 1, count: 34 }, | ||
+ | { id: 264, link: "test" }, | ||
+ | { | ||
+ | id: 265, | ||
+ | clicker: { | ||
+ | onClick: function() { | ||
+ | alert("CLICK!!!!!!!!!!!!!!!!!!11"); | ||
+ | } | ||
+ | } | ||
+ | }, | ||
+ | { id: 4 }, | ||
+ | { id: 5 }, | ||
+ | { id: 6 }, | ||
+ | { id: 7 }, | ||
+ | { id: 8 }, | ||
+ | { id: 9 }, | ||
+ | { id: 10 }, | ||
+ | ], | ||
+ | elements: [ | ||
+ | { text: "HELLO", size: 15, underline: true, bold: true } | ||
+ | ] | ||
+ | }</syntaxhighlight> | ||
+ | |||
+ | '''''items''''' – массив из отображаемых предметов<br/> '''''сolumns''''' – количество колонок. По умолчанию 6<br/> '''''item_size''''' – размер предмета. По умолчанию 60<br/> Параметры для предметов: | ||
+ | |||
+ | *'''''link''''' – идентификатор страница, на которую будет осуществлён переход при клике на текст | ||
+ | *'''''clicker''''' – объект клика. | ||
+ | **<u>''onClick''</u> – короткий клик | ||
+ | **''<u>onLongClick</u>'' - длинный | ||
+ | </div> | ||
+ | |||
+ | <div class="mw-parser-output"> | ||
=== OTO_RECIPE_PAGE === | === OTO_RECIPE_PAGE === | ||
+ | Котроллер ''OTO_RECIPE_PAGE'' позволяет создавать страницы с рецептами ''“Один к одному”''. | ||
+ | <syntaxhighlight lang="JavaScript">{ | ||
+ | controller: PageControllers.OTO_RECIPE_PAGE, | ||
+ | title: "Furnace Recipe", | ||
+ | type: 0, | ||
+ | bar_texture: "furnace_bar_guide", | ||
+ | recipes: [ | ||
+ | { | ||
+ | input: { id: 4, data: 1, count: 10 }, | ||
+ | output: { id: 264 } | ||
+ | }, | ||
+ | { | ||
+ | input: { id: 264 }, | ||
+ | output: { id: 265 } | ||
+ | } | ||
+ | ], | ||
+ | elements: [ | ||
+ | { text: "Text" }, | ||
+ | { text: "And Text" }, | ||
+ | ] | ||
+ | }</syntaxhighlight> | ||
+ | |||
+ | Если '''''type''''' равен 0, '''''recipes''''' – массив из объектов, в которых содержится предмет на вход'''''(input)''''' и предмет на выход'''''(output)'''''. | ||
+ | <syntaxhighlight lang="JavaScript">{ | ||
+ | controller: PageControllers.OTO_RECIPE_PAGE, | ||
+ | title: "Furnace Recipe", | ||
+ | type: 1, | ||
+ | bar_texture: "furnace_bar_guide", | ||
+ | recipes: [ | ||
+ | { id: 1 }, | ||
+ | { id: 17, data: 1 } | ||
+ | ], | ||
+ | elements: [ | ||
+ | { text: "This is type 1" } | ||
+ | ] | ||
+ | }</syntaxhighlight> | ||
+ | |||
+ | Если '''''type''''' равен 1, '''''recipes''''' – массив из объектов, которые содержат информацию о предмет на вход. В выходной слот будет помещаться результат обработки указанного предмета в печи.<br/> Остальные параметры: | ||
+ | |||
+ | *'''''title''''' – заголовок страницы | ||
+ | *'''''bar_texture''''' – текстура для индикатора прогресса | ||
+ | </div> | ||
+ | |||
+ | <div class="mw-parser-output"> | ||
=== GRID_3x3_PAGE === | === GRID_3x3_PAGE === | ||
+ | Котроллер ''GRID_3x3_PAGE'' позволяет создавать страницы рецептов с сеткой 3x3. | ||
+ | <syntaxhighlight lang="JavaScript">{ | ||
+ | controller: PageControllers.GRID_3x3_PAGE, | ||
+ | title: "Workbench Recipe", | ||
+ | recipes: [{ | ||
+ | grid: [ | ||
+ | ["b", "b", "b"], | ||
+ | ["b", "g", "b"], | ||
+ | ["b", "8", "b"] | ||
+ | ], | ||
+ | materials: { | ||
+ | "b": { id: 4, data: 0 }, | ||
+ | "g": { id: 1, data: 0 }, | ||
+ | }, | ||
+ | result: { id: 61, count: 3 } | ||
+ | }], | ||
+ | elements: [ | ||
+ | { text: "Text"} | ||
+ | ], | ||
+ | } | ||
+ | </syntaxhighlight> | ||
+ | </div> | ||
+ | |||
+ | <div class="mw-parser-output"> | ||
=== Создание собственных контроллеров === | === Создание собственных контроллеров === | ||
+ | |||
+ | Для создания собственных контроллеров необходимо в поле ''controller'' передать функцию, которая будет рисовать элементы на странице. | ||
+ | <syntaxhighlight lang="JavaScript">PageControllers["MY_TEST_PAGE"] = function(params, elements, container, section) { | ||
+ | let x = section === "left" ? 50 : 550; | ||
+ | elements["text_" + section + "_" + i] = { | ||
+ | type: "text", | ||
+ | x: section, | ||
+ | y: 40, | ||
+ | text: params.title | ||
+ | }; | ||
+ | |||
+ | if (params.elements) | ||
+ | GuideHelper.drawTextArray(params.elements, x, 55, globalSize, elements, section); | ||
+ | }; | ||
+ | //... | ||
+ | { | ||
+ | controller: PageControllers.MY_TEST_PAGE, | ||
+ | title: "I'm title", | ||
+ | elements: [ | ||
+ | { text: "Text" } | ||
+ | ], | ||
+ | } | ||
+ | //...</syntaxhighlight> | ||
+ | |||
+ | Передаваемые аргументы: | ||
+ | |||
+ | *'''''params''''' – объект секции, для которой вызывается функция | ||
+ | *'''''elements''''' – элементы интерфейса | ||
+ | *'''''container''''' – контейнер интерфейса | ||
+ | *'''''section''''' – название секции(left, right) | ||
</div> | </div> |
ModAPI.addAPICallback("GuideAPI", function(api) {
const GuideAPI = api.GuideAPI;
const GuideHelper = api.GuideHelper;
const PageControllers = api.PageControllers;
IDRegistry.genItemID("testGuide");
Item.createItem("testGuide", "Test Guide", {
name: "stick"
});
GuideAPI.registerGuide("guideTest", {
item: ItemID.testGuide,
debug: false,
textures: {
background: "your_texture",
nextLink: "your_texture",
preLink: "your_texture",
close: "your_texture",
},
pages: {
"default": {
nextLink: "test",
left: {
controller: PageControllers.BASIC_PAGE,
elements: []
},
right: {
controller: PageControllers.BASIC_PAGE,
elements: []
}
}
}
});
});
Регистрация происходит через метод GuideAPI.registerGuide(unique, params), где unique – уникальный идентификатор, params – объект с параметрами.
Параметры:
Контроллер – функция, указанная под идентификатором controller в объекте секции. GuideAPI предоставляет стандартные контроллеры, находящиеся в объекте PageControllers, которые позволяют решить большинство задач.
{
controller: PageControllers.BASIC_PAGE,
elements: [
{text: "I'm simple text!" },
{ text: "I'm big text!", size: 20 },
{ text: "I'm red text!", color: android.graphics.Color.RED },
{ text: "I'm underlined bold text!", underline: true, bold: true },
{ text: "I'm link. Click me, please!", color: android.graphics.Color.BLUE, link: "page2" }
]
}
Объект elements доступен для использования во всех стандартных контроллерах. Он содержит массив строк, каждая из которых отображается на новой строке. Если текст не влезает в границы секции, он будет перенесён.
Параметры текста:
Котроллер ITEM_PAGE позволяет создавать страницы с группой предметов и текстом.
{
controller: PageControllers.ITEM_PAGE,
items: [
{ id: 1, data: 1 },
{ id: 264 },
{ id: 266 },
],
elements: [
{ text: "I'm text", size: 20 },
{ text: "And I'm text too" }
]
}
items – массив из отображаемых предметов. Первый из них будет помещён в большой слот.
Контроллер ITEM_GRID_PAGE позволяет располагать предметы сеткой.
{
controller: PageControllers.ITEM_GRID_PAGE,
columns: 8,
item_size: 30,
items: [
{ id: 1, data: 1, count: 34 },
{ id: 264, link: "test" },
{
id: 265,
clicker: {
onClick: function() {
alert("CLICK!!!!!!!!!!!!!!!!!!11");
}
}
},
{ id: 4 },
{ id: 5 },
{ id: 6 },
{ id: 7 },
{ id: 8 },
{ id: 9 },
{ id: 10 },
],
elements: [
{ text: "HELLO", size: 15, underline: true, bold: true }
]
}
items – массив из отображаемых предметов
сolumns – количество колонок. По умолчанию 6
item_size – размер предмета. По умолчанию 60
Параметры для предметов:
Котроллер OTO_RECIPE_PAGE позволяет создавать страницы с рецептами “Один к одному”.
{
controller: PageControllers.OTO_RECIPE_PAGE,
title: "Furnace Recipe",
type: 0,
bar_texture: "furnace_bar_guide",
recipes: [
{
input: { id: 4, data: 1, count: 10 },
output: { id: 264 }
},
{
input: { id: 264 },
output: { id: 265 }
}
],
elements: [
{ text: "Text" },
{ text: "And Text" },
]
}
Если type равен 0, recipes – массив из объектов, в которых содержится предмет на вход(input) и предмет на выход(output).
{
controller: PageControllers.OTO_RECIPE_PAGE,
title: "Furnace Recipe",
type: 1,
bar_texture: "furnace_bar_guide",
recipes: [
{ id: 1 },
{ id: 17, data: 1 }
],
elements: [
{ text: "This is type 1" }
]
}
Если type равен 1, recipes – массив из объектов, которые содержат информацию о предмет на вход. В выходной слот будет помещаться результат обработки указанного предмета в печи.
Остальные параметры:
Котроллер GRID_3x3_PAGE позволяет создавать страницы рецептов с сеткой 3x3.
{
controller: PageControllers.GRID_3x3_PAGE,
title: "Workbench Recipe",
recipes: [{
grid: [
["b", "b", "b"],
["b", "g", "b"],
["b", "8", "b"]
],
materials: {
"b": { id: 4, data: 0 },
"g": { id: 1, data: 0 },
},
result: { id: 61, count: 3 }
}],
elements: [
{ text: "Text"}
],
}
Для создания собственных контроллеров необходимо в поле controller передать функцию, которая будет рисовать элементы на странице.
PageControllers["MY_TEST_PAGE"] = function(params, elements, container, section) {
let x = section === "left" ? 50 : 550;
elements["text_" + section + "_" + i] = {
type: "text",
x: section,
y: 40,
text: params.title
};
if (params.elements)
GuideHelper.drawTextArray(params.elements, x, 55, globalSize, elements, section);
};
//...
{
controller: PageControllers.MY_TEST_PAGE,
title: "I'm title",
elements: [
{ text: "Text" }
],
}
//...
Передаваемые аргументы: