带Lua的按键覆盖

带Lua的按键覆盖

一个高度可定制的Fabric按键覆盖层,利用Lua脚本实现动态视觉主题和实时设计编辑。

工具

⌨️ 键位显示覆盖层(基于 Lua)

一款功能强大且灵活多变的 Minecraft Fabric 键位显示模组,其独特的 Lua 引擎支持深度的视觉自定义。

✨ 主要特性:

  • Lua 驱动主题:所有视觉样式(经典、现代、Apple 和 Lunar)均由外部 Lua 脚本处理。通过向 config/keystrokes/ThemeManager/ 文件夹添加 .lua 文件,即可创建专属于你的独特外观。
  • 实时热重载:在游戏运行时修改你的主题脚本,然后点击设置菜单中的“重载 Lua”按钮,即可立即查看更改效果。
  • 直观的游戏内菜单:按 'K' 键即可打开设置界面。
  • 全面的 RGB 自定义:实时颜色滑块可直接与你的 Lua 脚本同步,实现终极控制。
  • 灵活的界面:可独立拖拽和重新定位键盘及鼠标覆盖层。支持自定义缩放(自动、固定或基于滑块)。

🚀 安装方法:

  1. 确保你已为 Minecraft 1.20 或更高版本安装了 Fabric Loader。
  2. 下载模组并将 .jar 文件放入你的 mods 文件夹中。
  3. 启动 Minecraft,然后按 'K' 键打开设置。
  4. 浏览 config/keystrokes/ThemeManager/ 文件夹以调整默认脚本或添加新脚本。

📜 脚本编写指南:创建你自己的主题

创建主题非常简单。只需在 config/keystrokes/ThemeManager/ 文件夹中创建一个 .lua 文件即可。以下是一个入门模板:

-- 将此文件另存为“my_custom_theme.lua”并放入 config/keystrokes/ThemeManager/ 文件夹中

-- 可选:当主题被加载或选中时,此函数运行一次
function onThemeLoad()
    -- 设置菜单滑块的颜色 (R, G, B, A)
    setMenuColor(255, 165, 0, 255) -- 默认使用橙色
end

-- 此函数每帧为每个按键和鼠标按钮运行
-- 参数:label (字符串), isPressed (布尔值), x, y, w, h (位置/尺寸), r, g, b, a (菜单颜色)
function renderKey(label, isPressed, x, y, w, h, r, g, b, a)
    -- 将菜单中的 R, G, B, A 值组合成单个颜色
    local menuColor = bit.bor(bit.lshift(a, 24), bit.lshift(r, 16), bit.lshift(g, 8), b)
    
    if isPressed then
        -- 使用菜单颜色绘制不透明背景
        fill(x, y, w, h, menuColor)
        -- 告诉模组以黑色绘制文本
        setTextColor(0xFF000000) 
    else
        -- 未按下时绘制半透明黑色背景
        fill(x, y, w, h, 0x80000000)
        -- 告诉模组以白色绘制文本
        setTextColor(0xFFFFFFFF)
    end
end