Files
whale-town-front-v2/README.md
2026-07-22 00:45:16 +08:00

41 lines
1.2 KiB
Markdown

# WhaleTown Front V2
WhaleTown V2 前端是基于 Godot 4.6 的 2D 多人小镇客户端。
当前包含:
- 账号登录、注册、外观与设置同步。
- 广场、打工区、咖啡馆和个人空间场景。
- WebSocket 实时聊天、玩家位置和外观同步。
- 商城、钱包、家具背包与房间摆放。
- 咖啡店陪伴机器人与相关雇佣流程。
## 运行
1. 安装 Godot `4.6.x`
2. 用 Godot 打开 `project.godot`
3. 运行默认主场景。
## 导出
仓库包含 Web 和 Linux 导出预设。安装 Godot 4.6 导出模板后可执行:
```bash
godot --headless --path . --export-release Web build/web/index.html
godot --headless --path . --export-release "Linux/X11" build/linux/WhaleTown-V2.x86_64
```
Web 产物是静态文件,必须通过 HTTP/HTTPS 服务器发布,不要直接用 `file://` 打开。
默认连接 WhaleTown 生产 API 和 WebSocket 服务。本地联调时可使用以下环境变量覆盖:
- `WHALETOWN_API_BASE_URL`
- `WHALETOWN_CHAT_WS_URL`
- `WHALETOWN_LOCATION_WS_URL`
- `WHALETOWN_GAME_WS_URL`
- `WHALETOWN_NETWORK_PROFILE`
## 安全
仓库不包含访问 Token、SSH 私钥、`.env` 或本地登录状态。运行时认证信息仅保存在 Godot `user://` 目录。