FormAPIExExample.js

// LiteLoaderScript Dev Helper
/// <reference path="../HelperLib/src/index.d.ts"/>
/* global ll mc PermType file */

const {
  CustomFormEx,
  SimpleFormEx,
  SimpleFormOperational,
  sendModalFormAsync,
  wrapAsyncFunc,
  FormClose,
} = require('./FormAPIEx')

const PLUGIN_NAME = 'FormAPIExExample'

mc.listen('onServerStarted', () => {
  // 异步发送确认取消表单
  const cmdTestModalForm = mc.newCommand('testmodal', PLUGIN_NAME, PermType.Any)
  cmdTestModalForm.overload()
  cmdTestModalForm.setCallback((_, { player }) => {
    if (!player) return false

    wrapAsyncFunc(async () => {
      const result = await sendModalFormAsync(player, PLUGIN_NAME, 'A test ModalForm~')
      player.tell(String(result))
    })()

    return true
  })
  cmdTestModalForm.setup()

  // 异步自定义表单，带格式化返回值为object
  const cmdTestCustomForm = mc.newCommand('testcustom', PLUGIN_NAME, PermType.Any)
  cmdTestCustomForm.overload()
  cmdTestCustomForm.setCallback((_, { player }) => {
    if (!player) return false

    wrapAsyncFunc(async () => {
      const form = new CustomFormEx(PLUGIN_NAME)
        .addLabel('This is a Label')
        .addSwitch('switch1', 'This is a Switch')
        .addInput('input1', 'this is a Input Box', {
          placeholder: 'Enter some Text',
        })
        .addDropdown(
          'drop1',
          'This is a Dropdown, default item is dropItem2',
          ['dropItem1', 'dropItem2'],
          1,
        )
        .addSlider('slider1', 'This is a Slider, default value is 114', 1, 514, {
          default: 114,
        })
        .addStepSlider('stepSlider1', 'This is a Step Slider', [
          '逸一时',
          '误一世',
          '逸久忆旧罢一龄',
        ])

      /*
      格式化后的返回值是这样的
      {
        "switch1": false,
        "input1": "",
        "drop1": 1,
        "slider1": 114,
        "stepSlider1": 1
      }
    */
      const res = await form.sendAsync(player)
      player.tell(res === FormClose ? String(res) : JSON.stringify(res, null, 2))
    })()

    return true
  })
  cmdTestCustomForm.setup()

  // 快速构建一个列表表单，带搜索带翻页
  const cmdTestSimpleFormEx = mc.newCommand('testsimple', PLUGIN_NAME, PermType.Any)
  cmdTestSimpleFormEx.overload()
  cmdTestSimpleFormEx.setCallback((_, { player }) => {
    if (!player) return false

    wrapAsyncFunc(async () => {
      /** @type {string[]} */
      const buttons = file.getFilesList('./behavior_packs/vanilla/recipes')
      const form = new SimpleFormEx(buttons)
      form.title = PLUGIN_NAME
      form.canTurnPage = true
      form.canJumpPage = true
      form.hasSearchButton = true
      const result = await form.sendAsync(player) // 会返回 buttons 数组中的一个元素
      player.tell(String(result))
    })()

    return true
  })
  cmdTestSimpleFormEx.setup()

  // 构建一个功能性 SimpleForm
  const cmdTestSimpleFormEx2 = mc.newCommand('testsimple2', PLUGIN_NAME, PermType.Any)
  cmdTestSimpleFormEx2.overload()
  cmdTestSimpleFormEx2.setCallback((_, { player }) => {
    if (!player) return false

    wrapAsyncFunc(async () => {
      const form = new SimpleFormOperational(PLUGIN_NAME, '§a请选择要执行的操作：', [
        { text: '点我输出 1', operation: () => player.tell('1') },
        { text: '点我输出 2', operation: () => player.tell('2') },
        { text: '点我输出 114514', operation: () => player.tell('114514') },
      ])
      await form.sendAsync(player) // 返回值是执行后函数的返回值，或者 FormClose
    })()

    return true
  })
  cmdTestSimpleFormEx2.setup()
})

ll.registerPlugin(PLUGIN_NAME, PLUGIN_NAME, [0, 0, 1], {})