Initial WhaleTown V2 frontend

README.md

@@ -0,0 +1,29 @@
+# WhaleTown Front V2
+
+WhaleTown V2 前端是基于 Godot 4.6 的 2D 多人小镇客户端。
+
+当前包含：
+
+- 账号登录、注册、外观与设置同步。
+- 广场、打工区、咖啡馆和个人空间场景。
+- WebSocket 实时聊天、玩家位置和外观同步。
+- 商城、钱包、家具背包与房间摆放。
+- 咖啡店陪伴机器人与相关雇佣流程。
+
+## 运行
+
+1. 安装 Godot `4.6.x`。
+2. 用 Godot 打开 `project.godot`。
+3. 运行默认主场景。
+
+默认连接 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://` 目录。