系统要求
- 操作系统：Windows 10 / 11（x64）
- 网络：可访问服务端 TCP 5188 与 UDP 5190
- ROM：自备有合法使用权的 ZIP ROM（客户端不附带）
- 输入：键盘；推荐 XInput / 街机摇杆
安装包类型
| 组件 | 说明 | 典型用途 |
|---|---|---|
| Client / Launcher | 登录器 + 大厅 + 对战宿主 | 玩家日常联机 |
| Server | 平台 API · Event Hub · UDP Relay | 自建公网 / 局域网节点 |
| 源码构建 | .NET 9 + Qt / Python 开发环境 | 开发、验收与定制 |
当前产品版本线为 0.8.8。QtCpp V2 重连稳定基线与 Match 服务端配对版本，以项目
docs/QTCPP-V2-REJOIN-STABLE-BASELINE.md 与 releases/ 目录为准。
客户端安装步骤
- 下载并完整解压客户端文件夹，不要只复制主程序 exe。
- 将有权使用的 ROM（例如
kof97.zip、neogeo.zip）放入包内roms目录，或配置扫描路径。 - 运行启动器 / 客户端，填写服务器地址（如
http://your-host:5188）与访问密钥。 - 首次使用需注册账号（8–18 位字母数字下划线；昵称限中文与
-）。 - 进入大厅后双击房间卡片：空房创建、等待房加入、对战房观战。
重要：
ArcadeLink.Client.json 是本机登录配置（服务器、密钥、账号）。升级客户端时请保留该文件，勿被安装脚本无条件覆盖。
服务端简要部署
- 在服务器上解压服务端包，放行入站 TCP 5188 与 UDP 5190。
- 若服务器在 NAT 后，将上述端口转发到内网主机。
- 使用启动脚本指定公网 IP/域名作为 Relay Host，并生成访问密钥。
- 将密钥仅分发给受信任玩家；生产环境建议限制来源 IP，并配置 HTTPS/WSS 反向代理。
# 防火墙示例（管理员 PowerShell）
New-NetFirewallRule -DisplayName 'ArcadeLink TCP 5188' -Direction Inbound -Protocol TCP -LocalPort 5188 -Action Allow
New-NetFirewallRule -DisplayName 'ArcadeLink UDP 5190' -Direction Inbound -Protocol UDP -LocalPort 5190 -Action Allow默认操作（可改）
- 方向：方向键
- A / B / C / D：J / K / U / I
- 开始：数字 1
- 聊天：Enter
- 窗口 / 纯游戏全屏：Tab
如何拿到构建
本官网仓库不托管大型二进制安装包。请联系平台管理员获取正式 release，
或从主项目的 releases/ 目录选取与文档基线一致的 ZIP。
源码开发者可使用项目根目录 start.ps1 / scripts/package-*.ps1 本地打包。