口袋广场 (PokePlaza) - 项目使用指南

这是一个基于 Godot 4.5 + Node.js 的复古像素风格多人在线聊天室（Pixel Art Cozy MMO）。

🏗️ 项目架构

whale_town/
├── server/              # Node.js 后端服务器
│   ├── index.js         # WebSocket 游戏服务器 (默认端口: 8910)
│   └── package.json     # npm 依赖
├── Scenes/              # Godot 场景文件
├── Scripts/             # Godot 脚本
└── project.godot        # Godot 项目配置

🚀 快速开始

0. 环境准备 (Prerequisites)

在开始之前，请确保已安装以下软件：

Node.js: v18 或更高版本
- 检查命令: node -v
- 下载 Node.js
Godot Engine: 4.5 或更高版本
- 下载 Godot

1. 启动游戏服务器 (Server)

服务器负责处理多玩家同步。

# 1. 进入服务器目录
cd server

# 2. 安装依赖 (仅首次运行需要)
npm install

# 3. 启动服务器
node index.js

成功标志:
终端输出: PokePlaza Server listening on ws://localhost:8910

2. 启动游戏客户端 (Client)

启动 Godot Engine。
导入本项目 (project.godot)。
点击右上角的 运行 (Run) 按钮 (快捷键 F5)。
登录界面:
- 输入你的名字 (例如: "Ash")。
- 点击 Start 按钮。
- 默认会自动连接到本地服务器 ws://127.0.0.1:8910。

3. 多人联机测试

要在本地测试多人功能：

运行一个客户端实例，登录并在地图上移动。
在 Godot 编辑器中，再次点击运行，或使用 Debug -> Run Multiple Instances 启动第二个窗口。
用不同的名字登录。
现在你应该能看到两个角色在同一个世界中互动！

⚙️ 配置说明 (Configuration)

修改服务器端口

如果你需要修改 WebSocket 服务器端口 (默认 8910)：

打开 server/index.js。
找到第 3 行: const PORT = 8910;。
修改为你想要的端口号。
重启服务器生效。

修改客户端连接地址

如果你将服务器部署在局域网或其他机器上：

打开 Godot 脚本 Scripts/StartMenu.gd。
找到代码中的 SERVER_URL 常量 (通常在顶部):
```
const SERVER_URL = "ws://127.0.0.1:8910"
```
将其修改为你的服务器 IP 地址，例如 ws://192.168.1.5:8910。

🎮 操作说明

动作	按键
移动	`W`, `A`, `S`, `D` 或方向键
聊天	点击左下角输入框 -> 输入消息 -> `Enter` 发送
互动	靠近物体/椅子 (如果有互动提示)

⚠️ 常见问题 (Troubleshooting)

Q: 客户端显示 "Connection failed"?

检查服务器终端是否正在运行 (node index.js)。
检查端口是否被防火墙拦截 (默认 8910)。
确认 StartMenu.gd 中的地址是否正确。

Q: 无法看到其他玩家?

确保所有玩家都连接到了同一个服务器 IP。
如果在局域网测试，请使用具体的局域网 IP (如 192.168.x.x) 而不是 127.0.0.1，并确保防火墙允许通信。

Q: 报错 Script Error?

请检查 Godot 控制台底部的 Debug 信息，确保脚本语法兼容 Godot 4.5+。

3.4 KiB Raw Permalink Blame History Unescape Escape