whale-town-front-v2/README.md

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 导出模板后可执行：

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