const promocodes = [
    {
        "promocode": "NEWYEAR2007",
        "command": "give @s apple"
    },
];

import { world, system } from "@minecraft/server";
import { ModalFormData } from "@minecraft/server-ui";

world.beforeEvents.itemUse.subscribe((ev) => {
    const player = ev.source;

    let form = new ModalFormData();
    form.title("Заголовок формы");
    form.textField("Введите в текстовое поле ниже промокод", "");

    system.run(() => {
        form.show(player).then((res) => {
            const [ textField ] = res.formValues;
    
            if (res.canceled) return;
    
            promocodes.forEach((data) => {
                if (textField === data.promocode) {
                    player.runCommandAsync(data.command);
                    return;
                } else {
                    player.runCommandAsync('tellraw @s {"rawtext":[{"text":"Такого промокода не существует!"}]}');
                    return;
                };
            });
        });
    });
});

Мне сегодня один подписчик писал. И в ходе разговора он упомянул что он изучал JS и хотел бы видить на канале руководство по JS. Я долго не хотел этого делать, и не собираюсь делать. Но обьяснить что это за ЯП(язык программирования) все таки стоило бы. Итак, начнём!

JavaScript - ЯП, что изначально задумывался как ЯП для веб-разработки. Но его начали использовать как скриптовый язык для написания, к примеру, серверной части проекта(NodeJS в помощь) или даже мобильных приложении(React Native позволяет). Но многие тут JavaScript используют для написания скриптов в аддонах для Майнкрафт Бедрока.

Немного теории и много практики! Сам я именно так изучал JavaScript более полгода назад и продолжаю +- также изучать. Но совет может не для всех работать, это чисто индивидуально. Но попробовать стоит.
А насчет ресурсов и руководств - само руководство по JavaScript, можете только 1 главу читать, а остальное после гуглить при необходимости. Также есть другое руководство, от MDN Web Docs. Выбирайте по желанию, но лично я изучал JS по тому первому руководству. Так что вот.

Публикация вышла маленькая, но я попытался некоторые вещички обкашлить, что задавали ребята под комментариями. Повторюсь - полностью изучать JavaScript на этом канале не будем и не собираемся, есть руководства и видео, на котором понятнее чем если бы мы описывали своими словами. Но некоторые функции в ЯП на канале будут изучены. Как-то так

Какие-то фиксы баков и тому подобное. Но тут будет описано только изменения в Script API. А именно:

- Числовые JavaScript-перечисления теперь корректно обрабатывают и поддерживают обратное отображение значений.
- Исправлен баг, из-за которого вызов

Player.hideAllExcept мог вызывать сбой сервера.

InputPermissions

- Следующие значения перечисления InputPermissionCategory перенесены в 1.17.0:
- LateralMovement, Sneak, Jump, Mount, Dismount, MoveForward, MoveBackward, MoveLeft, MoveRight.
- Следующие методы PlayerInputPermissions перенесены в 1.17.0:
- isPermissionCategoryEnabled(permissionCategory: InputPermissionCategory): boolean;
- setPermissionCategory(permissionCategory: InputPermissionCategory, isEnabled: boolean): void;
- Удалено свойство compostingChance из API ItemStack. Теперь шанс компостирования для ванильных предметов доступен через CompostableItemComponent->compostingChance в Item Component API.
- Исправлены редкие случаи, когда ModalFormData автоматически прокручивался вниз при открытии UI.

Новые классы в бета-модуле 1.17.0

- Добавлены скриптовые привязки в бета-версию для функции Aim-Assist:
- class AimAssistCategory
- class AimAssistCategorySettings
- class AimAssistPreset
- class AimAssistPresetSettings
- class AimAssistRegistry
- enum AimAssistTargetMode
- interface PlayerAimAssistSettings
- class PlayerAimAssist
- Метод Player.getAimAssist для изменения настроек Aim-Assist у игрока
- Метод World.getAimAssist для добавления предустановок и категорий Aim-Assist

Ошибки и аргументы

- Добавлено перечисление InvalidArgumentErrorType, предоставляющее дополнительный контекст об ошибках недопустимых аргументов.
- Добавлено свойство type в InvalidArgumentError для проверки типа ошибки аргумента.

Перенесено из бета-модуля в 1.17.0

- Block::isWaterlogged
- Block::setWaterlogged

// События, другой код и т.д...
system.run(() => {
    ev.cancel = true; // Пытаемся отменить событие, но не получается
    // Другой код...
});

declare class FurnaceFormData {
  /**
   * @param isLit Указывает, включена ли печь в пользовательском интерфейсе.
   */
  constructor(isLit?: boolean);
  /**
   * @remarks Количество слотов в интерфейсе печи.
   */
  public slotCount: number;
  /**
   * @remarks Этот метод устанавливает заголовок для интерфейса печи.
   * @param text Текст заголовка для интерфейса печи.
   */
  title(text: string | RawMessage): FurnaceFormData;
  /**
   * @remarks Добавляет кнопку в интерфейс печи с иконкой из ресурспака.
   * @param slot Слот, в котором будет отображаться предмет. Значение ограничено от 0 до 2.
   * @param itemName Название предмета, которое будет отображаться.
   * @param itemDesc Описание (лора) предмета, которое будет отображаться.
   * @param texture ID типа или путь к текстуре. **НЕОБХОДИМО УКАЗАТЬ ПРЕФИКС ПРЕДМЕТА!** Для ванильных предметов это `minecraft:`. Смотрите `typeIds.js` для действительных предметов и значений данных.
   * @param stackAmount Размер стака предмета. Ограничено значениями от 1 до 99.
   * @param durability Прочность предмета. По умолчанию 0. Ограничено значениями от 1 до 99.
   * @param enchanted Если предмет зачарован, укажите true.
   */
  button(slot: number, itemName?: string | RawMessage, itemDesc?: (string | RawMessage)[], texture?: string, stackAmount?: number, durability?: number, enchanted?: boolean): FurnaceFormData;
  /**
    * @remarks
    * Создает и отображает всплывающее окно. Возвращает результат
    * асинхронно, когда игрок подтверждает или отменяет
    * диалог.
    *
    * Этот метод не может быть вызван в режиме только для чтения.
    *
    * @param player
    * Игрок, для которого будет отображен этот диалог.
   */
  show(player: Player): Promise<ActionFormResponse>;
};