项目简介
HappyRO 是一个基于 roBrowserLegacy 与 rAthena 构建的开源中文《仙境传说 Online》Web 项目。玩家打开浏览器即可登录、创建角色并进入游戏，无需安装桌面客户端；GM 可以通过独立管理后台维护玩家、资料和游戏参数。
核心能力
- 浏览器 PWA：登录、角色选择、地图渲染、音效与完整查看器启动页。
- 多端界面：提供电脑、手机和平板界面，触屏支持移动、快捷技能和自动战斗。
- 中文本地化：客户端 UI、系统消息、物品、技能、魔物、地图和 NPC。
- 冒险工具：在游戏内查询地图、魔物、NPC、物品，并进行导航和角色维护。
- 管理后台：用户管理、运营发放、在线控制、参数修改和审计记录；在线体验见 happyro-admin.kugarocks.com。
- 离线部署：同时提供
linux/amd64与linux/arm64镜像、运行资源、校验、备份和恢复工具。
项目组成
| 仓库 | 职责 |
|---|---|
| happyro | 部署脚本、配置、本地化资源、文档和发布编排 |
| happyro-client | 浏览器客户端、PWA 与游戏内冒险工具 |
| happyro-server | rAthena 登录、角色、地图和 Web API 服务 |
| happyro-gateway | Node.js 网关、静态资源、HTTP 与 WebSocket 代理 |
| happyro-admin | 管理后台 React / Umi / Ant Design 前端 |
| happyro-api | Go / Gin 后端，为后台与游戏工具提供 API |
| happyro-doc | 公开文档站、玩家指南与安装说明 |
根仓库、五个应用仓库与文档仓库维护独立 Git 历史，长期中文产品分支均为 main。运行关系与开发分工见架构与仓库边界。
技术基线
| 项目 | 基线 |
|---|---|
| kRO 客户端资源 | 2021-11-05 |
PACKETVER | 20211103 |
| 服务端模式 | Renewal |
| Node.js | 22 或更高版本 |
| MariaDB | 10.11 |
| 功能与交付 | 当前功能见 v0.6.0；离线包与镜像的实际交付记录见资源下载 |