Модуль GenerationUtils — различия между версиями
| Строка 1: | Строка 1: | ||
<div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output"><div class="mw-parser-output">Модуль GenerationUtils предоставляет удобные инструменты, используемые для генерации. </div> <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"><div class="mw-parser-output"><div class="mw-parser-output">Модуль GenerationUtils предоставляет удобные инструменты, используемые для генерации. </div> <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"> | ||
== Методы модуля GenerationUtils == | == Методы модуля GenerationUtils == | ||
| Строка 7: | Строка 8: | ||
*canSeeSky(x, y, z) - возвращает true, если на данное место падает солнечный свет (в том числе, через прозрачные блоки). | *canSeeSky(x, y, z) - возвращает true, если на данное место падает солнечный свет (в том числе, через прозрачные блоки). | ||
*randomXZ(cx, cz) - возвращает случайные целые координаты x и z в приделах чанка с координатами cx и cz. | *randomXZ(cx, cz) - возвращает случайные целые координаты x и z в приделах чанка с координатами cx и cz. | ||
| − | *randomCoords(cx, cy, lowest, highest) - возвращает случайные координаты x, y, z в приделах чанка с координатами cx и cz на высоте от lowest до highest. Параметры lowest и highest имеют значения по умолчанию 0 и 128 соответственно. Пример использования (для ''randomXZ'' то же самое, но без''y''): <syntaxhighlight lang="Javascript">let coords = randomCoords(cx, cy, 64); // Random coordinates between 64 and 128 | + | *randomCoords(cx, cy, lowest, highest) - возвращает случайные координаты x, y, z в приделах чанка с координатами cx и cz на высоте от lowest до highest. Параметры lowest и highest имеют значения по умолчанию 0 и 128 соответственно. Пример использования (для ''randomXZ'' то же самое, но без ''y''): <syntaxhighlight lang="Javascript">let coords = randomCoords(cx, cy, 64); // Random coordinates between 64 and 128 |
let x = coords.x; | let x = coords.x; | ||
let y = coords.y; | let y = coords.y; | ||
let z = coords.z;</syntaxhighlight> | let z = coords.z;</syntaxhighlight> | ||
| − | |||
| − | |||
*findSurface(x, y, z) - возвращает самый высокий блок с координатами x, z, находящийся под уровнем y. | *findSurface(x, y, z) - возвращает самый высокий блок с координатами x, z, находящийся под уровнем y. | ||
| Строка 19: | Строка 18: | ||
*findLowSurface(x, z) - возвращает самый высокий блок в приделах от 64 до 0 (под землёй). | *findLowSurface(x, z) - возвращает самый высокий блок в приделах от 64 до 0 (под землёй). | ||
*generateOre(x, y, z, id, data, amount, noStoneCheck) - генерирует руду с id, data на координатах x, y, z, в количестве amount. Если noStoneCheck установлен в true, руда может появиться не смотря на отсутствие камня в данном месте. Может быть использовано для отладки. По умолчанию ''data ''= 0, ''amount ''= 1, ''noStoneCheck ''= false. | *generateOre(x, y, z, id, data, amount, noStoneCheck) - генерирует руду с id, data на координатах x, y, z, в количестве amount. Если noStoneCheck установлен в true, руда может появиться не смотря на отсутствие камня в данном месте. Может быть использовано для отладки. По умолчанию ''data ''= 0, ''amount ''= 1, ''noStoneCheck ''= false. | ||
| − | + | </div> </div> </div> </div> </div> </div> | |
| − | </div> </div> </div> </div> </div> </div> | + | </div> |
| + | </div> | ||
Текущая версия на 00:27, 2 мая 2020
Модуль GenerationUtils предоставляет удобные инструменты, используемые для генерации.
Методы модуля GenerationUtils[править]
- isTerrainBlock(id) - возвращает, является ли блок с заданным id частью ванильного пласта (камень, земля, руды и т.п.).
- isTransparentBlock(id) - проверяет, является ли данный блок прозрачным (для света). Работает как с ванильными блоками, так и с блоками из мода.
- canSeeSky(x, y, z) - возвращает true, если на данное место падает солнечный свет (в том числе, через прозрачные блоки).
- randomXZ(cx, cz) - возвращает случайные целые координаты x и z в приделах чанка с координатами cx и cz.
- randomCoords(cx, cy, lowest, highest) - возвращает случайные координаты x, y, z в приделах чанка с координатами cx и cz на высоте от lowest до highest. Параметры lowest и highest имеют значения по умолчанию 0 и 128 соответственно. Пример использования (для randomXZ то же самое, но без y):
let coords = randomCoords(cx, cy, 64); // Random coordinates between 64 and 128 let x = coords.x; let y = coords.y; let z = coords.z;
- findSurface(x, y, z) - возвращает самый высокий блок с координатами x, z, находящийся под уровнем y.
- findHighSurface(x, z) - возвращает самый высокий блок в приделах от 128 до 0 (на поверхности).
- findLowSurface(x, z) - возвращает самый высокий блок в приделах от 64 до 0 (под землёй).
- generateOre(x, y, z, id, data, amount, noStoneCheck) - генерирует руду с id, data на координатах x, y, z, в количестве amount. Если noStoneCheck установлен в true, руда может появиться не смотря на отсутствие камня в данном месте. Может быть использовано для отладки. По умолчанию data = 0, amount = 1, noStoneCheck = false.