本页目录

NoobHub:Lua 游戏引擎多人联机与 Pub/Sub 消息库

NoobHub · Overtorment/NoobHub

面向 CoronaSDK、Moai、Gideros、LÖVE 与 Defold 的 Lua 多人联机与网络消息方案:仓库同时包含用 Node.js 编写的 socket 服务器和各引擎客户端,采用发布/订阅(pub/sub)模式;README 称服务端零依赖(WebSocket 桥接依赖 ws 模块),...

多人对战 LÖVE2D Lua 网络联机 中级
★ Stars 357 Forks 54 License 未明确 更新 2026-10-05

国内开发环境适配

Windows
未知
Linux
未知
macOS
未知
引擎 / 框架:LÖVE2D 暂无中文教程标记 未标记站长实测
服务端运行依赖 Node.js;README 称默认零依赖,启用 WebSocket 桥接时需 npm install 安装 ws。国内安装 npm 依赖可能需配置镜像源;具体网络与端口连通性待核验。

中文项目介绍

NoobHub 是一个面向 Lua 游戏引擎的多人联机与网络消息库。README 将其定位为 CoronaSDK、Moai、Gideros、LÖVE 与 Defold 的开源联机与消息方案。仓库同时包含用 Node.js 编写的 socket 服务器,以及各引擎的 Lua 客户端;它通过发布/订阅(pub/sub)模型,让客户端订阅频道并在收到 JSON 消息时触发回调,或向频道内所有订阅者广播消息。

README 强调:连接经由 socket 服务器转发,延迟较低,适合动作类游戏;接口简单;服务端基于 Node.js;默认零依赖,开箱即用(WebSocket 桥接依赖 ws 模块);可穿透 NAT;CPU 与内存占用低。仓库还自述该方案已在生产环境运行,承载数千 CCU、每天服务数十万局多人游戏、每秒路由数百条消息,并保持数月 uptime。这些指标来自 README 自述,具体数值与场景需自行核验。

该项目不是完整游戏,而是一个可自托管的联机后端加多引擎客户端库。你可以使用作者提供的演示服务器测试,凭据硬编码在 demo 项目中;也可以部署自己的服务器。

补充说明

使用方式:服务端与客户端

服务端启动命令:

nodejs node.js

如需启用 WebSocket 桥接,在配置中取消 wsPort 注释,并执行 npm install 以安装 ws 模块。README 说明该桥接主要用于浏览器客户端,其他场景可不启用。

客户端初始化时传入服务器地址与端口:

hub = noobhub.new({ server = "127.0.0.1"; port = 1337; });

订阅频道并注册回调:

hub:subscribe({
  channel = "hello-world";
  callback = function(message)
    if message.action == "ping" then
      print("Pong!")
    end
  end;
});

向频道广播消息:

hub:publish({
  message = {
    action = "ping",
    timestamp = system.getTimer()
  }
});

README 也给出了 Node.js 客户端的等价写法,说明该协议并不绑定某一门语言。Lua 客户端代码可作为 LuaSocket 库用法的示例。

客户端支持与仓库结构

README 列出的客户端包括:

  • CoronaSDK
  • Gideros
  • Moai
  • LÖVE
  • Node.js
  • PHP(仅调试控制台)
  • JS / 浏览器

仓库包含服务端代码与 CoronaSDK/Moai/Gideros/LÖVE 客户端,README 表示后续还会加入更多客户端。对使用上述 Lua 引擎的开发者来说,NoobHub 提供的是一种轻量、可自托管的联机选型,而不是绑定某一家云服务的 SDK。

测试

仓库提供简单的验收测试,用 Node.js 客户端测试服务端本身:

./run-tests.sh

README 展示的输出为:启动 NoobHub 服务端、监听 1337 端口、运行测试、输出 tests ok。该测试覆盖的是服务端基本收发流程,不替代针对具体游戏逻辑的压力测试。

面向生产环境的准备

README 给出两条生产部署提示:

  • 如果预期并发连接超过 1000,需要提高服务器的限制,例如最大打开文件描述符数量、最大 TCP/IP 连接数,并可选择性调优 TCP/IP 栈。
  • 为保证服务端进程持续存活,可使用 forever.js 或 supervisord 之类的进程守护工具。

这些提示属于运维层面的通用建议,实际容量仍取决于硬件、网络与消息频率。

作者与许可

作者为 Igor Korsakov 与 Sergii Tsegelnyk。项目采用 WTFPL 许可,README 链接到 WTFPL 的协议文本。使用前建议阅读许可证原文,确认其条款符合你的项目需求。

讨论与反馈

README 列出了 Corona Labs 的官方讨论帖,分为旧版与新版的论坛链接,供开发者交流使用经验与问题。由于论坛链接可能随站点迁移而变化,访问前可先确认链接可用性。

开源许可证与版权说明

许可证标识:未明确。源码、资源与依赖许可可能不同,请以官方仓库为准。本站仅做索引,不托管源码。

相似项目