Выберите путь#

Нужна небольшая настройка? Рассмотрите готовый API меню настроек. Нужна новая карточка или действие в существующем меню? Начните с расширения штатного UI.

Для собственного окна в Lua можно использовать Helper: создать frame, добавить таблицу, строки и widgets, затем отобразить frame. Ни Python, ни сетевой сервис для такого окна не нужны.

Подключите Lua#

В ui.xml своего расширения объявите файл:

XML
<addon name="wiki_panel">
  <environment type="menus">
    <file name="ui/wiki_panel.lua" />
  </environment>
</addon>

До первого вызова окна убедитесь, что Helper и игровой UI готовы. Загрузка Lua-файла сама по себе не означает, что мир и все меню уже созданы.

Постройте окно#

Учебная заготовка для ui/wiki_panel.lua. Она регистрирует панель один раз; отображение вызывается отдельным событием после готовности игры. Внутренние callbacks и layer нужно сверять с текущей версией UI.

LUA
local menu = { name = "WikiExamplePanel" }

menu.onViewCreated = function() end
menu.onRowChanged = function() end
menu.onSelectElement = function() end

function menu.onCloseElement()
    if menu.shown then
        Helper.clearFrame(menu, 3)
        menu.shown = false
    end
end

Menus = Menus or {}
table.insert(Menus, menu)
Helper.registerMenu(menu)

local function showPanel()
    if menu.shown then return end
    local width = Helper.scaleX(480)
    local height = Helper.scaleY(150)
    local frame = Helper.createFrameHandle(menu, {
        layer = 3,
        x = (Helper.viewWidth - width) / 2,
        y = (Helper.viewHeight - height) / 2,
        width = width, height = height,
        standardButtons = {},
        startAnimation = false,
        playerControls = true,
    })
    local t = frame:addTable(1, { tabOrder = 1, width = width })
    local title = t:addRow(false, {})
    title[1]:createText("Hello, X4!", { fontsize = 14 })
    local row = t:addRow(true, {})
    row[1]:createButton({ height = 28 }):setText("Close")
    row[1].handlers.onClick = menu.onCloseElement
    menu.shown = true
    frame:display()
end

RegisterEvent("Wiki.ShowPanel", function()
    showPanel()
end)

Для отображения отправьте из своего действующего MD-обработчика:

XML
<raise_lua_event name="'Wiki.ShowPanel'" />

Это фрагмент внутри actions. Точку вызова — например, уже работающую кнопку или событие — подключает ваш мод. Пример не добавляет горячую клавишу автоматически.

Проверьте жизненный цикл#

Окно должно открываться повторно без накопления callbacks. Проверьте закрытие кнопкой, поведение ESC/контроллера в выбранном контексте, переключение меню и загрузку сейва. Слишком маленькая высота таблицы может скрыть её целиком.

Не закрывайте чужой frame на занятом layer и не меняйте глобальное управление игроком ради простого текста. Новая заготовка отдельно в игре не проверялась; она показывает используемые формы Helper, а не гарантирует совместимость со всеми обновлениями X4.