# 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://` 目录。