9.3 KiB
9.3 KiB
AI Town Game 用户使用手册
🎮 游戏简介
AI Town Game 是一款基于 Godot 引擎开发的 2D 多人在线游戏。玩家可以创建自己的角色，在 Datawhale 办公室场景中与其他玩家进行实时交流和互动。
游戏特色
- 多人在线: 支持多个玩家同时在线互动
- 持久化世界: 角色在玩家离线时仍作为 NPC 存在
- 实时对话: 与其他角色进行文字对话交流
- 品牌场景: 精心设计的 Datawhale 办公室环境
- 跨平台: 支持网页版和桌面版
🚀 快速开始
系统要求
最低配置:
- 操作系统: Windows 10 / macOS 10.14 / Ubuntu 18.04
- 内存: 2GB RAM
- 显卡: 支持 OpenGL 3.3
- 网络: 稳定的互联网连接
推荐配置:
- 操作系统: Windows 11 / macOS 12+ / Ubuntu 20.04+
- 内存: 4GB RAM
- 显卡: 独立显卡
- 网络: 宽带连接
安装和启动
网页版（推荐）
- 打开浏览器（Chrome、Firefox、Safari、Edge）
- 访问游戏网址
- 等待游戏加载完成
- 开始游戏
桌面版
- 下载游戏安装包
- 运行安装程序
- 启动游戏
- 开始游戏
🎯 游戏指南
创建角色
- 首次进入: 游戏会自动显示角色创建界面
- 输入角色名:
- 长度: 2-20 个字符
- 不能为空或只包含空格
- 建议使用有意义的名称
- 确认创建: 点击"创建角色"按钮
- 进入游戏: 角色创建成功后自动进入游戏世界
基础操作
移动控制
- 键盘: 使用 WASD 键或方向键移动角色
- 触摸设备: 使用屏幕上的虚拟摇杆
交互操作
- E 键: 与附近的角色或物体交互
- ESC 键: 打开菜单或退出对话
相机控制
- 自动跟随: 相机会自动跟随你的角色
- 调试模式: 开发者可以使用鼠标滚轮缩放视图
对话系统
开始对话
- 走近其他角色（在线玩家或离线 NPC）
- 按 E 键开始对话
- 对话框会出现在屏幕上
发送消息
- 在对话框中输入文字
- 按回车键或点击发送按钮
- 消息会显示在对话历史中
观察对话
- 其他角色之间的对话会以气泡形式显示在角色头顶
- 你可以看到附近角色的对话内容
结束对话
- 点击对话框的关闭按钮
- 或按 ESC 键退出对话
🏢 游戏世界
Datawhale 办公室
游戏场景是一个精心设计的 Datawhale 办公室，包含以下区域：
入口区域
- 位置: 场景上方
- 特色: 欢迎标识和 Datawhale Logo
- 功能: 新角色的默认出生点
工作区
- 位置: 场景中央
- 设施: 办公桌、电脑、椅子
- 用途: 角色可以在此区域工作和交流
会议区
- 位置: 场景左侧
- 设施: 会议桌、白板
- 用途: 适合多人讨论和会议
休息区
- 位置: 场景右上方
- 设施: 沙发、茶水间
- 用途: 角色休息和非正式交流
展示区
- 位置: 场景右侧
- 特色: 大型 Datawhale Logo、成就墙
- 用途: 展示组织文化和成就
导航提示
- 墙壁: 深灰色，角色无法穿过
- 家具: 棕色，会阻挡角色移动
- 地板: 浅灰色，角色可以自由行走
- 品牌元素: 蓝色 Datawhale Logo 分布在各个区域
👥 多人互动
在线玩家
- 标识: 角色头顶显示绿色在线标识
- 行为: 由真实玩家控制，可以实时对话
- 互动: 可以进行复杂的对话和协作
离线角色（NPC）
- 标识: 角色头顶显示灰色离线标识
- 行为: 作为 NPC 存在，保持最后的位置
- 互动: 可以查看角色信息，但无法对话
社交功能
- 实时对话: 与在线玩家进行文字交流
- 群组对话: 多个角色可以同时参与对话
- 对话历史: 查看之前的对话记录
- 表情符号: 在对话中使用表情符号
⚙️ 设置和选项
游戏设置
- 音量控制: 调整背景音乐和音效音量
- 画质设置: 根据设备性能调整画质
- 全屏模式: 切换全屏和窗口模式
控制设置
- 键位绑定: 自定义键盘控制键位
- 触摸灵敏度: 调整移动端触摸响应
- 相机设置: 调整相机跟随速度和缩放
网络设置
- 服务器地址: 连接到不同的游戏服务器
- 自动重连: 启用/禁用断线自动重连
- 心跳间隔: 调整网络心跳检测频率
🔧 故障排除
常见问题
无法连接服务器
症状: 显示"连接失败"或"网络错误" 解决方案:
- 检查网络连接是否正常
- 确认服务器是否在线
- 尝试刷新页面或重启游戏
- 检查防火墙设置
角色不显示或不移动
症状: 看不到角色或角色无法移动 解决方案:
- 确保游戏窗口处于激活状态
- 检查键盘是否正常工作
- 尝试点击游戏窗口获取焦点
- 查看控制台是否有错误信息
对话功能异常
症状: 无法发送消息或看不到对话 解决方案:
- 确认已与其他角色建立对话
- 检查网络连接是否稳定
- 尝试重新开始对话
- 确认对方角色是否在线
游戏卡顿或性能问题
症状: 游戏运行不流畅，帧率低 解决方案:
- 关闭其他占用资源的程序
- 降低游戏画质设置
- 确保设备满足最低系统要求
- 更新显卡驱动程序
错误代码
网络错误
- E001: 连接超时 - 检查网络连接
- E002: 服务器拒绝连接 - 服务器可能维护中
- E003: 认证失败 - 重新登录游戏
游戏错误
- G001: 角色创建失败 - 检查角色名称是否有效
- G002: 数据加载失败 - 清除浏览器缓存
- G003: 场景加载失败 - 重新启动游戏
📱 移动端使用
触摸控制
- 移动: 使用屏幕左下角的虚拟摇杆
- 交互: 点击屏幕右下角的交互按钮
- 对话: 点击屏幕上的对话气泡
界面适配
- 自动缩放: 界面会根据屏幕尺寸自动调整
- 触摸友好: 按钮和控件针对触摸操作优化
- 横屏模式: 建议使用横屏模式获得最佳体验
性能优化
- 后台运行: 切换到其他应用时游戏会暂停
- 电池优化: 游戏会根据电池状态调整性能
- 网络优化: 在移动网络下会减少数据传输
🎨 个性化
角色外观
- 名称显示: 角色头顶会显示玩家设置的名称
- 状态标识: 不同颜色表示在线/离线状态
- 动画效果: 角色移动时会播放行走动画
界面主题
- Datawhale 主题: 使用 Datawhale 品牌色彩
- 简洁设计: 界面简洁明了，易于使用
- 响应式布局: 适应不同屏幕尺寸
🔒 隐私和安全
数据保护
- 本地存储: 游戏设置保存在本地设备
- 服务器数据: 角色数据安全存储在服务器
- 隐私保护: 不收集个人敏感信息
安全措施
- 输入验证: 防止恶意输入和攻击
- 连接加密: 网络通信使用安全协议
- 数据备份: 定期备份游戏数据
📞 技术支持
获取帮助
- 在线文档: 查看完整的技术文档
- 社区论坛: 与其他玩家交流经验
- 问题反馈: 通过 GitHub Issues 报告问题
联系方式
- 技术支持: 通过项目 GitHub 页面
- 功能建议: 欢迎提出改进建议
- Bug 报告: 详细描述问题和重现步骤
🔄 更新和版本
自动更新
- 网页版: 自动获取最新版本
- 桌面版: 启动时检查更新
版本历史
- v1.0.0: 初始版本，包含核心功能
- 后续版本: 持续改进和新功能添加
新功能预告
- AI 对话: 与 AI 角色进行智能对话
- 更多场景: 扩展更多游戏场景
- 社交功能: 好友系统和私聊功能
🎯 游戏技巧
新手建议
- 熟悉环境: 先在办公室各个区域走动，熟悉布局
- 主动交流: 尝试与其他角色对话，建立联系
- 观察学习: 观看其他玩家的行为，学习游戏玩法
- 耐心等待: 如果没有其他在线玩家，可以与离线角色互动
高级技巧
- 战略位置: 选择合适的位置进行对话和交流
- 群组对话: 组织多人对话，提高互动效果
- 时间管理: 合理安排在线时间，与不同时区的玩家交流
- 社区建设: 帮助新玩家，建立友好的游戏社区
📚 附录
键盘快捷键
- W/↑: 向上移动
- S/↓: 向下移动
- A/←: 向左移动
- D/→: 向右移动
- E: 交互
- ESC: 菜单/退出
- Enter: 发送消息
- Tab: 切换焦点
术语表
- NPC: 非玩家角色，指离线玩家的角色
- 在线角色: 当前由真实玩家控制的角色
- 离线角色: 玩家离线时作为 NPC 存在的角色
- 对话气泡: 显示在角色头顶的对话内容
- 世界状态: 游戏世界中所有角色和对象的当前状态
技术规格
- 游戏引擎: Godot 4.5.1
- 网络协议: WebSocket
- 数据格式: JSON
- 支持平台: Windows, macOS, Linux, Web
- 最大玩家数: 50 人同时在线
祝您游戏愉快！ 🎮
如有任何问题或建议，欢迎通过项目 GitHub 页面联系我们。