# flyluaio

**Repository Path**: FlyLuaIo/flyluaio

## Basic Information

- **Project Name**: flyluaio
- **Description**: use Lua to control flight simulation(X-Plane 11/12) USB HID/MobiFlight hardware
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-24
- **Last Updated**: 2026-09-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Lua, x-plane, usb, HID

## README


[English](README.md) | [中文](README_CH.md) 

# USB HID & MobiFlight 设备插件 (FlyLuaIo)

使用 Lua 控制 X-Plane 11/12 飞行模拟器的 USB HID 与 MobiFlight 串口硬件

## 视频演示

[![视频演示](https://i0.hdslb.com/bfs/archive/98a4bc3892cd4f517ce9000261a5db56d82e5c5f.jpg)](https://www.bilibili.com/video/BV1hXMT6bEPi/)

# 功能特性

*   **实时添加设备**：Json + Lua 即可成为新设备，无需编译代码。
*   **ZERO X-Plane FPS impact（零帧率影响）**：内嵌 LuaJIT **不是**市面常见的性能模型。XLua、SASL、FlyWithLua 等通常在模拟器主线程 / Flight Loop 每帧跑 Lua（复杂机模下社区可见可观 frametime 占用）；FlyLuaIo 将脚本工作移出该路径 —— **对 X-Plane 帧率绝对零影响**。
*   **自动飞行设备按键分配**：告别手动设置数百个按键的痛苦。
*   **平滑的飞机切换**：告别在整个互联网上搜索配置文件文件的麻烦。
*   **旋转编码器加速**：优化您的操作体验。
*   **内置 Lua 语言引擎**：使用简单，易于定制。
*   **轻松调试**：编辑 Lua 文件后自动重新加载 Lua 脚本，加快调试过程。
*   **飞机状态同步**：支持冷舱和黑舱驾驶舱状态同步。
*   **模拟故障同步**：支持模拟飞机故障状态同步。
*   **跨平台操作**：全面支持 Windows、Linux 和 Mac 系统。
*   **原生 Apple ARM 支持**：为 Apple M 系列芯片提供原生支持。
*   **JSON 定义 USB HID**：添加 Json，即可添加 USB HID 设备。
*   **JSON 定义 MobiFlight**：添加 Json，即可添加 MobiFlight 串口设备。
*   **MobiFlight 串口自动匹配**：按板卡序列号匹配 `mobiflight/*.json` 配置。
*   **MobiFlight IO 桥接**：按键、编码器、步进电机、舵机、移位寄存器、数码管/LCD。
*   **Skunkcrafts 支持**：轻松更新软件的小改动。

# 游戏兼容性列表

请通过以下链接查看详细的兼容性列表：
[设备游戏兼容性列表](https://docs.qq.com/sheet/DWERFQnRmVUFZeHBi?tab=000001)

## USB HID 硬件
- Honeycomb Bravo
- Saitek Multi Panel
- Saitek Radio Panel
- Saitek Switch Panel
- WinWing/WinCtrl ECAM
- VKBsim Gunfighter MCG Ultimate Twist
- Quickmadesim QGMC710, QMCP737C, QG1K, QFCU, QCDU, QMPE, QMOVH-A
- 正在添加中 ... (Json + Lua 即可成为新的 USB HID 设备)

## MobiFlight 硬件
- Rowsfire A107 / B107
- CfMega (G1000)
- 自定义 MobiFlight 兼容 Arduino 板卡
- 正在添加中 ... (Json + Lua 即可成为新的 MobiFlight 设备)

## 贡献脚本

https://github.com/FlyLuaIo/flyluaioscripts

## 下载

您可以从以下地址获取插件的最新版本：
[最新版本下载](https://gitee.com/FlyLuaIo/flyluaio/releases)

## 致开发者

[访问开发者文档中心](https://gitee.com/FlyLuaIo/flyluaio/wiki)