Текущая версия |
Ваш текст |
Строка 2: |
Строка 2: |
| StructuresAPI - библиотека, упрощающая работу со структурами. | | StructuresAPI - библиотека, упрощающая работу со структурами. |
| <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"> | | <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"> |
− | <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">
| |
| == Загрузка == | | == Загрузка == |
| | | |
− | {| border="1" cellpadding="1" cellspacing="1" style="width: 100%;" | + | {| border="1" cellpadding="1" cellspacing="1" style="width: 500px;" |
| |- | | |- |
| ! colspan="3" scope="col" | '''Библиотека''' | | ! colspan="3" scope="col" | '''Библиотека''' |
Строка 36: |
Строка 33: |
| *Библиотека переписана. Объект StructuresAPI устарел. | | *Библиотека переписана. Объект StructuresAPI устарел. |
| *Сохраняется содержимое сундуков, печей и воронок | | *Сохраняется содержимое сундуков, печей и воронок |
− |
| |
− | |-
| |
− | | style="width: 64px; text-align: center;" | '''1.3'''
| |
− | | style="width: 114px; text-align: center;" | [https://vk.com/wall-80513593_2305 Подробнее]
| |
− | | style="width: 304px;" |
| |
− | *StructuresAPI удален.
| |
− | *Добавлен объект Rotate. Используется для сложных поворотов.
| |
− | *Метод структуры get был изменен. struct.get(x, y, z, rotates, return_index).
| |
− | *Метод структуры set был изменен. struct.set(x, y, z, rotate, progressively, time).
| |
− | *Добавлен метод destroy(x, y, z, rotates, progressively, time) для структуры.
| |
− | *Добавлен метод check(...) для структуры. Эквивалентен методу get(...).
| |
− | *Добавлен метод Structure.setInWorld(name, ...). Альтернатива Structure.get(name).set(...).
| |
− | *Добавлен метод Structure.destroyInWorld(name, ...). Альтернатива Structure.get(name).destroy(...).
| |
− | *Добавлены константы Structure.PROGRESSIVELY и Structure.NOT_PROGRESSIVELY.
| |
− | *Добавлены константы Structure.MIRROR_X, Structure.MIRROR_Y и Structure.MIRROR_Z.
| |
− | *Исправлена установка блоков добавленных модом.
| |
− | *Исправлено сохранение предметов и блоков.
| |
− | *Исправлен поворот на 180 градусов по Y.
| |
− | *Сохраняются TileEntity
| |
− |
| |
− | |-
| |
− | | style="width: 64px; text-align: center;" | '''1.4'''
| |
− | | style="width: 114px; text-align: center;" | [https://vk.com/wall-80513593_2410 Подробнее]
| |
− | | style="width: 304px;" |
| |
− | *Дополнен перевод.
| |
− | *Установка структуры производится в потоке, только если установка в режиме Structure.PROGRESSIVELY.
| |
− | *Блоки воздуха в структуре больше не заменяются на камень.
| |
| | | |
| |- | | |- |
Строка 69: |
Строка 39: |
| | style="width: 304px;" | | | | style="width: 304px;" | |
| |} | | |} |
− | </div> </div> | + | </div> </div> </div> |
− | | |
| == Условия использования == | | == Условия использования == |
| | | |
Строка 175: |
Строка 144: |
| === Полный перечень методов и констант === | | === Полный перечень методов и констант === |
| <div class="mw-parser-output"><div class="mw-parser-output"> | | <div class="mw-parser-output"><div class="mw-parser-output"> |
| + | ==== Structure ==== |
| <div class="mw-parser-output"> | | <div class="mw-parser-output"> |
− | ==== Structure ====
| |
− |
| |
− | <span style="color:#f39c12;">Добавлен с версии 1.2</span>
| |
− | <div class="mw-parser-output"><div class="mw-parser-output">
| |
| ===== Методы ===== | | ===== Методы ===== |
| | | |
Строка 202: |
Строка 168: |
| | | |
| | Возвращает экземпляр объекта Structure с именем ''name'' | | | Возвращает экземпляр объекта Structure с именем ''name'' |
− | |-
| |
− | | style="text-align: center;" | '''1.3'''
| |
− | | style="width: 115px;" | setInWorld(string name, int x, int y, int z, array rotate, bool progressively, int time)
| |
− | | style="width: 248px;" |
| |
− | *name - Имя структуры
| |
− | *x - Начальная координата структуры по оси X
| |
− | *y - Начальная координата структуры по оси Y
| |
− | *z - Начальная координата структуры по оси Z
| |
− | *rotate - Массив матриц поворотов
| |
− | *progressively - Если true, структура будет постепенно "строиться"
| |
− | *time - Время в миллисекундах между установкой блоков
| |
− |
| |
− | | Установить структуру ''name'' в мире по координатам ''x,y,z'', с выбраным рандомно поворотм из массива ''rotate''
| |
− | |-
| |
− | | style="text-align: center;" | '''1.3'''
| |
− | | style="width: 115px;" | destroyInWorld(string name, int x, int y, int z, array rotates, bool progressively, int time)
| |
− | | style="width: 248px;" |
| |
− | *name - Имя структуры
| |
− | *x - Начальная координата структуры по оси X
| |
− | *y - Начальная координата структуры по оси Y
| |
− | *z - Начальная координата структуры по оси Z
| |
− | *rotates - Возможные повороты структуры
| |
− | *progressively - Если true, структура будет постепенно "строиться"
| |
− | *time - Время в миллисекундах между установкой блоков
| |
− |
| |
− | | Установить структуру ''name'' в мире по координатам ''x,y,z'', с возможными поворотами ''rotates''
| |
| |} | | |} |
− | <div class="mw-parser-output"> </div> </div>
| + | </div> |
| ===== Константы ===== | | ===== Константы ===== |
| | | |
Строка 289: |
Строка 229: |
| | ROTATE_Y | | | ROTATE_Y |
| | Поворот по оси Y | | | Поворот по оси Y |
− | |-
| |
− | | style="text-align: center;" | '''1.3'''
| |
− | | PROGRESSIVELY
| |
− | | Установка/уничтожение постройки постепенное
| |
− | |-
| |
− | | style="text-align: center;" | '''1.3'''
| |
− | | NOT_PROGRESSIVELY
| |
− | | Установка/уничтожение постройки не постепенное
| |
− | |-
| |
− | | style="text-align: center;" | '''1.3'''
| |
− | | MIRROR_X
| |
− | | Отражение по оси X
| |
− | |-
| |
− | | style="text-align: center;" | '''1.3'''
| |
− | | MIRROR_Y
| |
− | | Отражение по оси Y
| |
− | |-
| |
− | | style="text-align: center;" | '''1.3'''
| |
− | | MIRROR_Z
| |
− | | Отражение по оси Z
| |
| |} | | |} |
| </div> <div class="mw-parser-output"> | | </div> <div class="mw-parser-output"> |
− | ===== Экземпляр Structure =====
| + | ==== Экземпляр Structure ==== |
| <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"><div class="mw-parser-output"> |
| {| border="1" cellpadding="1" cellspacing="1" style="width: 100%;" | | {| border="1" cellpadding="1" cellspacing="1" style="width: 100%;" |
Строка 320: |
Строка 240: |
| | style="text-align: center;" | '''Описание''' | | | style="text-align: center;" | '''Описание''' |
| |- | | |- |
− | | style="text-align: center;" | <span style="color:#e74c3c;">'''Только 1.2'''</span> | + | | style="text-align: center;" | '''1.2''' |
| | style="text-align: center;" | get(int x, int y, int z, bool rotate_y) | | | style="text-align: center;" | get(int x, int y, int z, bool rotate_y) |
| | | | | |
Строка 329: |
Строка 249: |
| | | |
| | Вернет true, если на координатах данная структура, иначе false | | | Вернет true, если на координатах данная структура, иначе false |
− | |-
| |
− | | colspan="1" rowspan="2" style="text-align: center;" | '''1.3'''
| |
− | | style="text-align: center;" | get(int x, int y, int z, array rotates, bool return_index)
| |
− | | colspan="1" rowspan="2" |
| |
− | *x - Начальная координата структуры по оси X
| |
− | *y - Начальная координата структуры по оси Y
| |
− | *z - Начальная координата структуры по оси Z
| |
− | *rotates - Возможные повороты структуры
| |
− | *return_index - Возвращать ли индекс найденного поворота(По стандарту false)
| |
− |
| |
− | | colspan="1" rowspan="2" | Вернет true, если на координатах данная структура, иначе false
| |
− | |-
| |
− | | style="text-align: center;" | check(int x, int y, int z, array rotates, bool return_index)
| |
| |- | | |- |
| | style="text-align: center;" | '''1.2''' | | | style="text-align: center;" | '''1.2''' |
Строка 353: |
Строка 260: |
| | Сохранить структуру в файл | | | Сохранить структуру в файл |
| |- | | |- |
− | | style="text-align: center;" | <span style="color:#e74c3c;">'''Только 1.2'''</span> | + | | style="text-align: center;" | '''1.2''' |
| | style="text-align: center;" | set(int x, int y, int z, array rotate, bool destroy, bool progressively, int time) | | | style="text-align: center;" | set(int x, int y, int z, array rotate, bool destroy, bool progressively, int time) |
| | | | | |
Строка 365: |
Строка 272: |
| | | |
| | Установить структурув мире по координатам x,y,z, с выбраным рандомно поворотм из массива rotate | | | Установить структурув мире по координатам x,y,z, с выбраным рандомно поворотм из массива rotate |
− | |-
| |
− | | style="text-align: center;" | '''1.3'''
| |
− | | style="text-align: center;" | set(int x, int y, int z, array rotate, bool progressively, int time)
| |
− | |
| |
− | *x - Начальная координата структуры по оси X
| |
− | *y - Начальная координата структуры по оси Y
| |
− | *z - Начальная координата структуры по оси Z
| |
− | *rotate - Массив матриц поворотов
| |
− | *progressively - Если true, структура будет постепенно "строиться"
| |
− | *time - Время в миллисекундах между установкой блоков
| |
− |
| |
− | | Установить структурув мире по координатам x,y,z, с выбраным рандомно поворотм из массива rotate
| |
− | |-
| |
− | | style="text-align: center;" | '''1.3'''
| |
− | | style="text-align: center;" | destroy(int x, int y, int z, array rotates, bool progressively, int time)
| |
− | |
| |
− | *x - Начальная координата структуры по оси X
| |
− | *y - Начальная координата структуры по оси Y
| |
− | *z - Начальная координата структуры по оси Z
| |
− | *rotates - Возможные повороты структуры
| |
− | *progressively - Если true, структура будет постепенно "уничтожаться"
| |
− | *time - Время в миллисекундах между уничтожением блоков
| |
− |
| |
− | | Уничтожить структуру в мире по координатам x,y,z, с возможными поворотами rotates
| |
| |- | | |- |
| | style="text-align: center;" | '''1.2''' | | | style="text-align: center;" | '''1.2''' |
Строка 402: |
Строка 285: |
| | Добавить блок в структуру | | | Добавить блок в структуру |
| |} | | |} |
− | </div> </div> </div> </div> </div> <div class="mw-parser-output"> </div> </div> | + | </div> </div> </div> </div> </div> |
− | | |
− | <div class="mw-parser-output">
| |
− | ==== Rotate ====
| |
− | | |
− | <span style="color:#f39c12;">Добавлен с версии 1.3</span>
| |
− | | |
− | Объект Rotate позволяет задовать сложные повороты, которые будут выполнятся при поиске/уничтожении/установке структуры.
| |
− | <syntaxhighlight lang="JavaScript">var rotate = new Rotate();
| |
− | rotate.addRotate(Structure.ROTATE_90Y);
| |
− | rotate.addRotate(Structure.ROTATE_90X);</syntaxhighlight>
| |
− | | |
− | Данный код позволит повернуть структуру сначала на 90 градусов по оси Y, затем по оси X.
| |
− | | |
− | ===== экземпляр Rotate =====
| |
− | | |
− | {| border="1" cellpadding="1" cellspacing="1" style="width: 100%;"
| |
− | |-
| |
− | ! scope="col" | Версия
| |
− | ! scope="col" | Метод
| |
− | ! scope="col" | Аргументы
| |
− | ! scope="col" | Описание
| |
− | |-
| |
− | | style="text-align: center;" | '''1.3'''
| |
− | | addRotate(array rotate)
| |
− | | colspan="1" rowspan="2" |
| |
− | *rotate - Матрица поворота или экземпляр Rotate
| |
− | | |
− | | colspan="1" rowspan="2" | Добавить поворот
| |
− | |-
| |
− | | style="text-align: center;" | '''1.3'''
| |
− | | add(array rotate)
| |
− | |-
| |
− | | style="text-align: center;" | '''1.3'''
| |
− | | addRotates(array rotates)
| |
− | | colspan="1" rowspan="2" |
| |
− | *rotates - Массив митриц и экземпляров Rotate
| |
− | | |
− | | colspan="1" rowspan="2" | Добавить повороты в указанном порядке
| |
− | |-
| |
− | | style="text-align: center;" | '''1.3'''
| |
− | | adds(array rotates)
| |
− | |}
| |
− | | |
− |
| |
− | </div>
| |
− | | |
| ==== StructuresAPI ==== | | ==== StructuresAPI ==== |
| | | |
− | <span style="color:#c0392b;">'''''Считается устаревшим с версии 1.2<br/> Удален в версии 1.3'''''</span> | + | <span style="color:#c0392b;">'''''Считается устаревшим с версии 1.2'''''</span> |
| | | |
| ===== Методы ===== | | ===== Методы ===== |
Строка 524: |
Строка 361: |
| | style="width: 332px;" | Установить структуру name в мире по координатам x,y,z, с выбраным рандомно поворотм из массива rotate | | | style="width: 332px;" | Установить структуру name в мире по координатам x,y,z, с выбраным рандомно поворотм из массива rotate |
| |} | | |} |
− | | + | </div> |
− | </div> | |
− | | |
| ===== Константы ===== | | ===== Константы ===== |
| | | |
Строка 573: |
Строка 408: |
| | style="width: 824px;" | Поворот по оси Y | | | style="width: 824px;" | Поворот по оси Y |
| |} | | |} |
− | | + | </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> |
− | </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> | |
− | </div> | |