MGFXModern GMod FX

local mgfx = include("mgfx/init.lua")

function PANEL:Paint(w, h)
    mgfx.StartPanel(self, w, h)

    mgfx.RoundedBoxEx(0, 0, w, h, {
        radius = 10,
        fill = Color(8, 14, 20, 170),
        backdrop = {blur = 8, tint = Color(0, 8, 12, 120)},
        outerGlow = {color = Color(70, 205, 255, 64), width = 12},
    })

    mgfx.ProgressBarEx(24, 84, w - 48, 10, 0.72, {
        radius = 5,
        track = Color(10, 18, 24, 190),
        fill = mgfx.LinearGradient(0, 0, 1, 0, Color(30, 130, 255), Color(255, 210, 110)),
    })

    mgfx.EndPanel()
end

lux

import * as mgfx from "@lux/mgfx"

fn PANEL:Paint(w, h) {
  local draw = mgfx.api
  draw.startPanel(self, w, h)

  draw.roundedBoxEx(0, 0, w, h, {
    radius = 10,
    fill = Color(8, 14, 20, 170),
    backdrop = {blur = 8, tint = Color(0, 8, 12, 120)},
    outerGlow = {color = Color(70, 205, 255, 64), width = 12},
  })

  draw.progressBarEx(24, 84, w - 48, 10, 0.72, {
    radius = 5,
    track = Color(10, 18, 24, 190),
    fill = draw.linearGradient(0, 0, 1, 0, Color(30, 130, 255), Color(255, 210, 110)),
  })

  draw.endPanel();
}

从这里开始

GLua普通 GLua 快速开始include mgfx/init.lua，并把返回的 PascalCase API 表保存在当前 addon 内。LuxLux 快速开始安装 @lux/mgfx，导入 mgfx.api，并使用 lowerCamelCase 门面。Guide核心概念理解 frame scope、Name/NameEx、style table、文字路径和命名映射。ReferenceAPI 参考查询准确签名、参数表、style 字段、返回值和边界条件。

边界

MGFX 是 renderer，不是 UI framework。它不拥有 layout、input、focus、component lifecycle、transition state 或 hit testing。调用方每帧计算视觉状态，再把明确参数传给 Plain GLua API 表或 mgfx.api.*。

普通标签优先使用原生 GMod text 或 Text。只有需要渐变字面、描边、glow 或高质量 shadow 时才使用 TextEx。

维护规则

public API 变化必须同步更新核心概念和对应的 API 参考页。
面向用户的通用示例应同时给出 GLua 与 Lux；明确只讨论某一运行时的页面除外。
shader 参数、gradient LUT、alpha 或 shaderpack 变化同步更新 Shader 与打包。
性能路径变化同步更新性能模型。
不要手改 docs-site/；修改 docs/ 后重新构建。

MGFXModern GMod FX

先选运行时

Renderer，不是 UI framework

按形状裁剪的效果

GLua / Lux 对照示例

对社区更友好的授权

快速开始 ​

从这里开始 ​

推荐阅读顺序 ​

边界 ​

维护规则 ​

快速开始

从这里开始

推荐阅读顺序

边界

维护规则