Руководство по скриптам
Скрипт это небольшая программа на JavaScript, которая ставит блоки Minecraft. В этом руководстве рассказано, как её написать, запустить в браузере и опубликовать в публичном каталоге. Всё это может сделать любой, у кого есть аккаунт Bloxelizer.
Введение
Скрипты выполняются целиком в вашем браузере, в изолированном интерпретаторе JavaScript. Во время экспериментов ничего не загружается: вы пишете код с одной стороны редактора, нажимаете «Запустить», и поставленные блоки появляются в 2D- и 3D-просмотрщиках с другой.
Смысл скрипта, в отличие от разовой постройки, в том, что другие могут запускать его с другими настройками. Скрипт, объявляющий входные данные, получает панель элементов управления рядом с просмотрщиком, так что тот, кто никогда не читал ваш код, может изменить размер, материал или seed и экспортировать результат.
Когда результат вас устроит, нажмите «Сохранить». Скрипт отправится на проверку, а после одобрения получит собственную страницу в каталоге скриптов.
Для экспериментов аккаунт не нужен
Писать и запускать скрипты может каждый. Вход в аккаунт нужен только для сохранения скрипта и отправки его на проверку.
Ваш первый скрипт
Откройте редактор, замените его содержимое следующим кодом и нажмите «Запустить». Он выложит каменный пол 8 на 8 и поставит в его центре факел.
function main(context) {
const { Creation } = context;
const creation = Creation('My first build');
creation.fillBox(0, 0, 0, 7, 0, 7, 'minecraft:stone');
creation.setBlock(3, 1, 3, 'minecraft:torch');
return { creation };
}Стоит заметить три вещи. Координаты это целые числа, а y это вертикальная ось, поэтому факел стоит на один блок выше пола. fillBox принимает два противоположных угла и заполняет всё между ними, что гораздо быстрее цикла. И каждый скрипт отдаёт результат, возвращая { creation }; скрипт, который создаёт creation, но не возвращает его, ничего не создаст.
Идентификаторы блоков ванильные, с пространством имён minecraft:. Редактор подсказывает их, как только вы начинаете печатать внутри строки, так что искать их приходится редко.
Устройство скрипта
Скрипт это обычный JavaScript с двумя особыми функциями верхнего уровня. Можно использовать синтаксис TypeScript: типы удаляются перед сохранением или запуском скрипта.
main(context, inputs)
Обязательна. Она выполняется, когда кто-то нажимает «Запустить». Она получает объект context со всеми помощниками и текущие значения объявленных вами входных данных. Она должна вернуть объект с creation и может также вернуть camera.
defineInputs(context)
Необязательна. Верните карту определений входных данных, и редактор отобразит элемент управления для каждого. Значения затем придут вторым аргументом в main под теми же ключами.
function defineInputs(context) {
const { Input } = context;
return {
size: Input.number({
label: 'Size',
description: 'Length of each side, in blocks',
defaultValue: 8,
min: 1,
max: 64,
}),
material: Input.block({
label: 'Material',
defaultValue: 'minecraft:stone',
}),
};
}
function main(context, inputs) {
const { Creation } = context;
const creation = Creation('Platform');
const last = inputs.size - 1;
creation.fillBox(0, 0, 0, last, 0, last, inputs.material);
return { creation };
}defineInputs выполняется до загрузки ресурсов
На момент вызова defineInputs ничего ещё не загружено, поэтому там доступны только вызовы получения списков из Textures, например listBlockNames() или listMobModels(). Поиск цветов, модели и спрайты относятся к main.
Установка блоков
Creation собирает операции с блоками в том порядке, в каком вы их выполняете. Более поздние записи в ту же ячейку выигрывают, так что можно выложить сплошную форму, а затем вырезать в ней.
Строить в начале координат необязательно. При экспорте постройка нормализуется по собственному ограничивающему параллелепипеду, так что отрицательные координаты и любые удобные для ваших вычислений смещения допустимы.
Для всего крупного используйте fillBox вместо вложенных циклов: одну операцию на миллион блоков создавать, хранить и отрисовывать дешевле, чем миллион операций. Циклом пользуйтесь, только если форма действительно меняется от блока к блоку.
Состояния блоков
Лестницы смотрят в сторону, брёвна имеют ось, у дверей есть половина. Это состояния блоков, и они всегда передаются строками, включая "true" и "false".
// States are always strings, including "true" and "false".
creation.setBlock(0, 0, 0, 'minecraft:oak_stairs', {
facing: 'east',
half: 'bottom',
shape: 'straight',
waterlogged: 'false',
});
// Ask rather than guess: a bare banner has no placeable default.
const states = Textures.getPlacementStates('minecraft:white_banner');
creation.setBlock(2, 0, 0, 'minecraft:white_banner', states);
// Two-cell blocks place their other half for you, in the right
// direction: this one call leaves a whole bed facing east, so the
// head lands in the cell at x=5.
creation.setBlock(4, 0, 0, 'minecraft:red_bed', { facing: 'east' });Собственные значения блока по умолчанию часто непригодны для установки, и это самая частая причина того, что одноячеечный блок выглядит неправильно в просмотрщике. Textures.getPlacementStates возвращает состояния, при которых блок стоит на земле, а Textures.getStateOptions перечисляет все состояния, которые принимает блок, вместе с допустимыми значениями. Используйте их вместо догадок по названию блока.
Отрисовка блока может выходить за пределы его ячейки
Стоящий флаг это один блок, но его полотнище отрисовывается примерно на 1,6 блока выше ячейки, в которой он стоит. Это отрисовка, а не блок: она ничего не добавляет к числу слоёв, списку материалов или высоте постройки, так что флаг на верхнем слое не делает постройку выше над тем, на чём он стоит.
Блоки из двух ячеек ставятся целиком
Двери, кровати и высокие цветы занимают две ячейки. Вы ставите одну, а setBlock добавляет вторую половину сам, перенося ваши состояния и ставя изголовье кровати с той стороны, куда она повёрнута. Чтобы намеренно поставить одну половину, укажите её: передав { half: 'upper' } или { part: 'head' }, вы поставите только её.
Входные данные
Каждый помощник в Input создаёт один элемент управления. Тип значения, которое попадает в main, зависит от использованного помощника.
| Помощник | Значение в main | Параметры для типа |
|---|---|---|
Input.number | number | min, max, step |
Input.string | string | defaultValue |
Input.boolean | boolean | defaultValue |
Input.select | string | options: string[] | { value, label }[] |
Input.multiselect | string[] | options: string[] |
Input.block | string | options: идентификаторы блоков (по умолчанию все блоки) |
Input.file | ScriptFile | null | accept, required, paintable, allowMultipleFiles |
Параметры, которые принимает любой вход
| Параметр | Тип | Описание |
|---|---|---|
label | string | Подпись элемента. Обязательно. |
description | string | Справочный текст под элементом управления. |
defaultValue | varies | Значение, используемое, пока зритель ничего не тронул. |
folder | string | Группирует этот элемент с другими из той же папки. |
order | number | Позиция сортировки внутри папки. Меньшие значения идут первыми. |
visibleWhen | { input, in?, notIn? } | Скрывает элемент, если другой вход не содержит одно из этих значений. |
resetsInputs | string[] | Сбрасывает эти входы к значениям по умолчанию при изменении данного. |
resetValuesByOption | Record<string, Record<string, unknown>> | Предустановленные значения вместо значений по умолчанию, по значению этого входа. |
folder и order стоит использовать, как только в скрипте больше нескольких элементов, а visibleWhen не даёт панели вводить в заблуждение, когда скрипт ветвится: вход, важный только в одном режиме, не должен быть виден в другом.
Файлы и изображения
Скрипты не имеют доступа к сети, поэтому всё внешнее поступает через файловый вход. Файл приходит как ScriptFile: name, type, size, а также text для текстовых файлов, dataUrl и imageData для изображений.
imageData это { width, height, data }, где data это плоский RGBA, по четыре значения на пиксель, строки идут сверху вниз. Поскольку в постройке Y направлена вверх, индекс строки обычно нужно переворачивать.
function defineInputs(context) {
const { Input } = context;
return {
image: Input.file({
label: 'Image',
accept: 'image/*',
paintable: true,
}),
};
}
function main(context, inputs) {
const { Creation, Textures } = context;
const creation = Creation('Pixel art');
const image = inputs.image;
if (!image || !image.imageData) return { creation };
const { width, height, data } = image.imageData;
for (let y = 0; y < height; y++) {
for (let x = 0; x < width; x++) {
const at = (y * width + x) * 4;
if (data[at + 3] < 128) continue; // Skip transparent pixels.
const block = Textures.findClosestBlockToColor(
data[at],
data[at + 1],
data[at + 2],
);
// Image rows run top-down, Y runs up, so flip the row.
creation.setBlock(x, height - 1 - y, 0, block);
}
}
return { creation };
}Если задать paintable: true для входа-изображения, у зрителя вместо выбора файла появится встроенный редактор рисования, что хорошо подходит для скриптов, где изображение это набросок, а не фотография.
Файловый вход со структурным файлом особенный: хост разбирает его за вас до запуска main, а Structures.getLoadedSchem() возвращает содержащиеся в нём блоки. Без имени он берёт вход под названием schematic; передайте имя входа, чтобы выбрать нужный, когда скрипт принимает несколько построек, как при сравнении.
function defineInputs(context) {
const { Input } = context;
// The host pre-parses a file input named exactly `schematic`.
return {
schematic: Input.file({ label: 'Build', accept: '.litematic,.schem,.nbt' }),
};
}
function main(context) {
const { Creation, Structures, Logger } = context;
const creation = Creation('Doubled');
const loaded = Structures.getLoadedSchem();
if (!loaded.ok) {
Logger.warn(loaded.error);
return { creation };
}
for (const op of loaded.operations) {
creation.setBlock(op.x * 2, op.y, op.z * 2, op.name, op.states);
}
return { creation };
}Кадрирование результата
Верните camera рядом с creation, чтобы выбрать, откуда начнёт 3D-просмотрщик. Полезно, когда интересная сторона постройки не совпадает с той, на которую попадает камера по умолчанию.
return {
creation,
camera: {
position: [40, 30, 40],
target: [0, 8, 0],
},
};Отметка блоков
Верните highlights, чтобы 3D-просмотрщик нарисовал цветную рамку вокруг указанных ячеек. Блоки сохраняют свои модели, так что это сообщает о ячейке что-то, не перекрашивая постройку: какие блоки добавило сравнение, какие ячейки отметила проверка, каких коснулся проход.
Каждая запись это пара { color, blocks }, где color это hex-строка вроде #22c55e, а blocks это список ячеек [x, y, z]. За один запуск рисуется до восьми групп и 200 000 обведённых ячеек, а запись, которую просмотрщик не может прочитать, пропускается, и скрипт не завершается ошибкой.
function main(context) {
const { Creation } = context;
const creation = Creation('Review');
const added = [];
creation.setBlock(0, 0, 0, 'minecraft:stone');
added.push([0, 0, 0]);
// Each block still renders as itself; only the border is coloured.
return {
creation,
highlights: [{ color: '#22c55e', blocks: added }],
};
}Справочник: context
И defineInputs, и main получают объект context. Берите из него то, что нужно, через деструктуризацию, а не обращайтесь к глобальным переменным.
function main(context, inputs) {
const { Creation, Logger, Textures, Structures } = context;
// ...
}| Помощник | Назначение |
|---|---|
Creation | Создаёт результат. |
Logger | Пишет в панель журнала редактора. |
Textures | Данные блоков: названия, цвета, состояния, модели, модели мобов и скинов. |
Structures | Ванильные структуры jigsaw и схематика, переданная просмотрщиком. |
Tree, Trees, Rocks, Gradients | Готовые генераторы, возвращающие операции. |
Редактор знает всё это
Полные определения типов поставляются с редактором, поэтому при наведении на помощник или нажатии Ctrl + Space точная сигнатура и документация показываются прямо на месте. Эта страница охватывает то, что нужно чаще всего.
Справочник: Creation
Creation(name?: string): CreationInstanceСоздаёт объект, в который строит ваш скрипт. Большинство скриптов создают ровно один, в начале main.
| Параметр | Тип | Описание |
|---|---|---|
name | string | Название, которое попадает в экспорт. По умолчанию "Untitled". |
Возвращает новый creation, в который ставятся блоки.
creation.setBlock(x, y, z, name, states?): voidСтавит один блок. При повторной записи в ячейку сохраняется последняя. У блока из двух ячеек вторая половина ставится тоже, если в переданных состояниях половина не указана.
| Параметр | Тип | Описание |
|---|---|---|
x, y, z | number | Позиция. Целые числа; Y направлена вверх. |
name | string | Идентификатор блока, например minecraft:stone. |
states | Record<string, string> | Состояния блока. Значения это строки, включая "true". |
creation.setBlock(0, 0, 0, 'minecraft:oak_log', { axis: 'y' });creation.fillBox(x1, y1, z1, x2, y2, z2, type): voidЗаполняет все ячейки между двумя углами. Используйте его вместо цикла, когда блок не меняется.
| Параметр | Тип | Описание |
|---|---|---|
x1, y1, z1 | number | Один угол, включительно. |
x2, y2, z2 | number | Противоположный угол, включительно. |
type | string | { name, states } | Идентификатор блока или блок с состояниями. |
creation.fillBox(0, 0, 0, 15, 0, 15, {
name: 'minecraft:oak_log',
states: { axis: 'x' },
});creation.addOperations(ops): voidДобавляет операции списком. Так встроенные генераторы передают свой результат в creation.
| Параметр | Тип | Описание |
|---|---|---|
ops | Operation[] | Операции, например те, что возвращает генератор. |
creation.getOperations(): Operation[]Возвращает всё, что поставлено к этому моменту, что позволяет скрипту проверить или доработать собственный результат перед возвратом.
creation.reset(): voidОтбрасывает все операции, оставляя пустой creation.
Справочник: Input
Доступно в context, передаваемом в defineInputs. Полные таблицы параметров см. выше в разделе Входные данные.
Input.number(config)
Input.string(config)
Input.boolean(config)
Input.select(config)
Input.multiselect(config)
Input.block(config)
Input.file(config)Каждый возвращает типизированное определение входа. Возвращайте их из defineInputs под именем, которое хотите читать в main.
sourceEntity: Input.select({
label: 'Entity',
options: Textures.listMobModels().map((model) => model.id),
visibleWhen: { input: 'sourceType', in: ['entity'] },
})Справочник: Logger
Logger.info(...args)
Logger.warn(...args)
Logger.error(...args)
Logger.debug(...args)Пишет строку в панель журнала под редактором. Вывод ограничен 1000 строками за запуск, поэтому выводите сводки, а не по строке на блок.
Logger.info('placed', creation.getOperations().length, 'operations');Справочник: Textures
Самое большое пространство имён, которое превращает скрипт из генератора форм в нечто, знающее о Minecraft. Внутри defineInputs работают только вызовы получения списков.
Список блоков
| Вызов | Что возвращает |
|---|---|
listBlockNames(mcVersion?) | Все идентификаторы блоков, при желании ограниченные одним релизом Minecraft. |
listPaletteBlocks() | Полные, непрозрачные кубы, добываемые в режиме выживания: набор, на который может попасть подбор цвета. |
listBuildableBlocks() | Блоки палитры, которые к тому же остаются на месте, без песка, бетонного порошка и источников света. |
listModelBlocks() | Блоки, собственную модель которых можно вокселизировать в статую самих себя. |
listItems() | Все предметы, для которых есть спрайты. |
listMobModels() | Шаблоны моделей мобов в виде { id, displayName }. |
listEntityModels() | Те же модели, из которых стоит делать статую, включая стойку для брони. |
listPosePresets() | Позы, в которых можно построить моба, в виде { id, displayName }. |
listMinecraftVersions() | Версии, по которым может фильтровать listBlockNames, от старых к новым. |
Подбор цвета
Textures.findClosestBlockToColor(r, g, b, palette?, options?): stringНаходит блок, чей запечённый цвет ближе всего к значению RGB. У блоков с узором среднее значение по умолчанию может быть цветом, которого нет нигде в текстуре, поэтому для глазурованных и узорчатых блоков обычно лучше подходит dominant.
| Параметр | Тип | Описание |
|---|---|---|
r, g, b | number | Компоненты цвета, от 0 до 255. |
palette | string[] | Ограничивает поиск этими блоками. По умолчанию все блоки палитры. |
options | { colorSource?, metric? } | colorSource это "average" или "dominant"; metric это "lab" или "ciede2000". |
Возвращает идентификатор ближайшего блока.
const block = Textures.findClosestBlockToColor(200, 60, 40, palette, {
colorSource: 'dominant',
metric: 'ciede2000',
});Textures.getBlockColor(blockName, colorSource?): { r, g, b } | nullОбратный поиск. Сочетайте с findClosestBlockToColor, чтобы подобрать один блок к другому, например ковёр, ближайший к полу.
Возвращает цвет блока или null, если данных о цвете нет.
Состояния и формы
Textures.getPlacementStates(blockName): Record<string, string> | nullПередавайте их в setBlock, а не ставьте блок «голым». Модель, выбирающая вариант по facing, без него ничего не покажет, кнопки по умолчанию получают face=wall и парят в воздухе, а живые кораллы по умолчанию получают waterlogged=true.
Возвращает состояния, при которых блок стоит на земле, или null.
Textures.getStateOptions(blockName): Record<string, string[]> | nullСочетайте с getPlacementStates, когда важна форма. Панель, забор или стена, которым не к чему присоединиться, рисуются как голый столб, поэтому запрашивайте нужные соединения.
Возвращает все состояния, которые принимает блок, и их допустимые значения.
Textures.getSecondPart(blockName): { states, offset } | nullДля дверей, кроватей и высоких цветов; null для всего, что стоит само по себе. setBlock уже ставит вторую половину, поэтому обращайтесь к этому, только если скрипту нужно знать форму блока, например чтобы проверить, хватает ли места перед установкой.
Возвращает состояния и смещение другой половины или null.
Textures.getBlockTraits(blockName): BlockTraits | nullВажные для постройки факты о блоке, чтобы решать, предлагать ли его или ставить. Надёжнее догадок по подстрокам названия блока.
Возвращает флаги вроде BlockEntity, NeedsSupport и CreativeOnly.
Модели и текстуры
Textures.getBlockModel(blockName, blockProperties?): BlockModel | nullИсходная структура модели, для вокселизации блока в большую статую самого себя. Блоки в стиле сущностей, такие как сундуки и кровати, возвращаются с синтезированной геометрией, отмеченной entityModel; блоки совсем без геометрии, такие как головы, возвращают null.
Возвращает элементы модели и текстуры граней или null.
Textures.sampleTextureAtUV(textureName, u, v, options?): [r, g, b, a] | nullЧитает один пиксель текстуры. Без exact неквадратная текстура считается полосой анимации, а неизвестное имя молча читает угол атласа, поэтому передавайте его, когда возможно то или другое.
| Параметр | Тип | Описание |
|---|---|---|
textureName | string | Название текстуры из граней модели. |
u, v | number | Координаты от 0 до 1. |
options | { exact?: boolean } | exact читает собственный прямоугольник текстуры и возвращает null, если его нет. |
Textures.getTextureSize(textureName): { width, height } | nullПозволяет вокселизировать с тем разрешением, в котором блок был нарисован: ванильные спрайты 16 на 16, наборы ресурсов могут быть 32 или 64.
Возвращает размер одного кадра или null.
Textures.getItemSprite(itemId): { width, height, data } | nullПеред запуском загружается только предмет, названный во входе sourceItem, поэтому запрос другого возвращает null. Спрайты поставляются в 64 пикселях для графики, нарисованной в 16, поэтому усредняйте каждый участок 4 на 4, а не читайте отдельные пиксели.
Возвращает строки RGBA, верхняя строка первой, или null.
Мобы и скины
Textures.getMobModel(name, options?): { blocks, size, sourceBounds } | nullВокселизирует моба в блоки, которые можно поставить. Передавайте возвращённые blocks в setBlock по одному или сначала сместите их.
| Параметр | Тип | Описание |
|---|---|---|
name | string | Идентификатор модели из listMobModels или listEntityModels. |
options | { scale?, offset?, textureName?, palette?, pose? } | Масштаб вокселей, смещение, блоки для построения и то, как моб стоит. |
Textures.listPosePresets(): Array<{ id, displayName }>Передайте идентификатор обратно как pose или задайте углы сами: headTurn, headTilt, rightArmSwing, rightArmRaise, leftArmSwing, leftArmRaise, rightLegSwing и leftLegSwing, каждый в градусах. Взмах вперёд при положительном значении, подъём уводит руку от тела, а голова поворачивается влево от моба и наклоняется вниз при положительном значении. Каждая часть поворачивается вокруг своего сустава, поэтому все параметры принимает только моб, устроенный как человек: четвероногий моб поворачивает голову и стоит как есть. Поворот пересэмплируется на сетку блоков, поэтому для статуи в крутой позе нужен больший scale, чтобы она осталась чистой.
Возвращает позы, в которых можно построить моба, для выбора.
Textures.getSkinModel(name, options): { blocks, size, sourceBounds } | nullТо же самое для модели игрока с текстурой скина, загруженного зрителем.
| Параметр | Тип | Описание |
|---|---|---|
name | string | Модель игрока из getPlayerModels. |
options | { textureFile, scale?, offset?, palette? } | textureFile это ScriptFile из файлового входа с изображением скина. |
Справочник: Structures
Structures.getLoadedSchem(name?): { ok, operations?, error? }Хост разбирает каждый вход со структурным файлом до запуска main, в любом формате, который поддерживает импортёр схематик, до четырёх за запуск. Проверяйте ok перед чтением operations: отсутствующая или нечитаемая постройка сообщает о собственной error, не лишая вас остальных.
| Параметр | Тип | Описание |
|---|---|---|
name | string | Файловый вход для чтения. По умолчанию тот, что назван schematic, или первый объявленный. |
Возвращает разобранные блоки схематики, которую содержит этот вход.
Structures.listLoadedSchems(): string[]В порядке, в котором их разрешает getLoadedSchem(), так что первая запись это то, что вернёт вызов без имени.
Возвращает имена входов, под которыми была разобрана схематика.
Structures.generate(options): Promise<string[]>Генерирует ванильную структуру jigsaw, например деревню или аванпост разбойников, и сразу отрисовывает её.
| Параметр | Тип | Описание |
|---|---|---|
options.structureId | string | Пул структур, например "minecraft:village/plains/town_centers". |
options.depth | number | Сколько частей поставить. |
options.radius | number | Максимальный радиус по горизонтали. |
options.height | number | Максимальная высота по вертикали. |
const chunkIds = await Structures.generate({
structureId: 'minecraft:village/plains/town_centers',
depth: 7,
});Справочник: Generators
Четыре пространства имён создают готовые формы. Все они возвращают операции setBlock с привязкой к началу координат, а не рисуют сами, так что их результат можно сместить, отфильтровать или повторить до попадания в creation.
function main(context) {
const { Creation, Trees, Rocks } = context;
const creation = Creation('Grove');
// Generators return operations rather than drawing anything themselves,
// so you can filter or offset them before they reach the creation.
creation.addOperations(Trees.generate({ species: 'Oak', seed: 1, count: 3, spread: 12 }));
creation.addOperations(Rocks.generate({ formation: 'Boulder', seed: 7, size: 5 }));
return { creation };
}| Пространство имён | Создаёт | Обнаружение |
|---|---|---|
Trees | Детальные деревья и рощи по видам, с кронами, украшениями и лианами. | Trees.species() |
Rocks | Валуны, жеоды и базальтовые столбы. | Rocks.formations() |
Gradients | Линейные, радиальные и четырёхугловые градиенты из блоков с дизерингом. | options: kind, stops, dither, paletteFilter |
Tree | Прежний генератор деревьев с параметрами. | Tree.getDefaults() |
Песочница и ограничения
Скрипты выполняются в изолированном интерпретаторе QuickJS. Нет DOM, нет window, нет document, нет таймеров и нет доступа к сети. Скрипту, которому нужны внешние данные, нужен файловый вход.
Пока выполняется скрипт
| Ограничение | Значение |
|---|---|
| Память | 128 MB |
| Время выполнения | 10 минут, затем запуск прерывается |
| Размер исходного кода в редакторе | 1 000 000 символов |
| Диапазон координат | ±30,000,000 |
| Вывод журнала | 1000 строк, 2000 символов в строке |
| Поставлено блоков | Без ограничений |
При отправке
Отправленный код проверяется на сервере ещё раз, и эти правила строже, чем в редакторе.
- Скомпилированный код должен быть не больше 100 КБ. Поэтому очень большой скрипт можно запустить локально, но нельзя опубликовать.
- Код не должен содержать ничего из следующего:
eval(,Function(,setTimeout,setInterval,XMLHttpRequest,fetch(,import(,require(,process.,child_process,fs.,globalThis,global.,__proto__,constructor.constructor. - Одинаковый код отклоняется как дубликат: сервер хеширует скомпилированный скрипт, поэтому дословная повторная публикация чужой работы не пройдёт.
Проверка шаблонов это обычное текстовое совпадение
Он не разбирает ваш код, поэтому срабатывает и внутри комментариев и строк, а безобидная переменная с именем fetchRow будет отклонена, так как содержит fetch(. Переименуйте её и отправьте снова.
Отправка скрипта
Нажмите «Сохранить», выполнив вход. У вас спросят название и описание, и скрипт попадёт в очередь на проверку.
- Скрипт на проверке виден только вам. На его странице перечислены все отправленные вами версии и состояние каждой.
- После одобрения скрипт появляется в публичном каталоге со своей страницей и адресом, и любой может его запустить.
- Повторное сохранение создаёт новую версию, которая проверяется отдельно. Одобренная версия тем временем остаётся доступной, так что правка никогда не сломает то, чем пользуются другие.
- Свои скрипты можно удалить в любое время на странице скрипта.
Перед отправкой
- Дайте ему название до 100 символов и описание не короче 10, в котором сказано, что он строит и что делают входные данные.
- Убедитесь, что он выполняется до конца с входными данными по умолчанию. Скрипт, который работает только с одним конкретным файлом, трудно одобрить.
- Дайте каждому входу разумное значение по умолчанию, понятную подпись и диапазон, который не может создать слишком большую для рендера постройку.
- Названия и описания проходят через фильтр содержимого, а ссылки в описании проверяются по чёрному списку.
Название и описание фиксируются
Когда скрипт создан, последующие сохранения меняют код и создают версию. Они не переименовывают его, поэтому выберите название, которое вас устроит надолго.
Устранение неполадок
Функция main не определена
Скрипт разобран, но main в нём не объявлена. Объявите её как функцию верхнего уровня, а не вложенной в другую и не присваиваемой по условию.
Недопустимое название блока в скрипте
Вызов setBlock или fillBox получил то, что не является строкой с идентификатором блока. Обычно это следствие поиска, который может промахнуться, например индекса палитры, вышедшего за конец массива.
Недопустимая координата в скрипте
Координата была NaN, бесконечной или вышла за ±30 000 000. Почти всегда это деление на ноль или вход, превратившийся в NaN.
Скрипт выполняется, но ничего не появляется
Убедитесь, что main возвращает { creation } и что возвращаемый creation это тот, в который вы ставили блоки.
Блок отображается как простой куб или голый столб
Он был поставлен без пригодных состояний. Используйте Textures.getPlacementStates, а для соединений панелей, заборов и стен Textures.getStateOptions.
Что-то другое? Напишите нам через страницу FAQ.