https://github.com/morpheus-tech-io/caith-server
CaiTH's server, still working
https://github.com/morpheus-tech-io/caith-server
rust server
Last synced: over 1 year ago
JSON representation
CaiTH's server, still working
- Host: GitHub
- URL: https://github.com/morpheus-tech-io/caith-server
- Owner: Morpheus-tech-io
- License: other
- Created: 2025-02-23T00:15:10.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-02-23T06:02:21.000Z (over 1 year ago)
- Last Synced: 2025-02-23T07:18:13.611Z (over 1 year ago)
- Topics: rust, server
- Language: Rust
- Homepage:
- Size: 152 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CaiTH-server
CaiTH (Cai Treasure Hunt) 是一个基于 WebSocket 的宝藏寻找游戏服务器，还在继续开发。
## 项目架构
```
CaiTH-server/
├── src/
│ ├── main.rs # 程序入口
│ ├── config.rs # 配置管理
│ ├── error.rs # 错误处理
│ ├── gateway/ # WebSocket网关
│ │ ├── mod.rs
│ │ ├── handler.rs # 连接处理
│ │ └── state.rs # 连接状态管理
│ ├── matchmaking/ # 匹配服务
│ │ ├── mod.rs
│ │ ├── service.rs # 匹配逻辑
│ │ └── models.rs # 匹配相关模型
│ ├── models/ # 数据模型
│ │ ├── mod.rs
│ │ ├── message.rs # 消息定义
│ │ └── game.rs # 游戏相关结构
│ └── db/ # 数据库交互（待实现）
```
## 已实现功能
### WebSocket 网关
- WebSocket 连接管理
- 消息路由
- 连接状态维护
- 心跳检测
### 匹配系统
- 多种匹配模式 (1v1, 2v2, 5v5)
- 房间池管理
- 动态房间创建/回收
- 玩家加入/退出管理
### 消息协议
```json
// 客户端到服务器 (C2S)
{
"msg_id": "uuid-string",
"cmd": "command-string",
"data": "command-data"
}
// 服务器到客户端 (S2C)
{
"msg_id": "uuid-string",
"code": 0,
"data": {},
"error": null
}
```
## 开发指南
### 环境要求
- Rust 1.75+
### 依赖配置
```toml
[dependencies]
# 异步运行时和WebSocket服务器, futures-tile用于处理 WebSocket 的读写流
tokio = { version = "1.36.0", features = ["full"] }
axum = { version = "0.7.4", features = ["ws"] }
futures-util = "0.3.30"
# 数据库
sqlx = { version = "0.7.3", features = ["runtime-tokio-rustls", "postgres", "uuid"] }
# 基础工具
serde = { version = "1.0.196", features = ["derive"] }
serde_json = "1.0.113"
jsonwebtoken = "9.2.0"
chrono = { version = "0.4.33", features = ["serde"] }
uuid = { version = "1.7.0", features = ["v4", "serde"] }
# 错误处理和日志
thiserror = "1.0.56"
tracing = "0.1.40"
tracing-subscriber = { version = "0.3.18", features = ["env-filter"] }
```
### 运行服务器
```bash
cargo run
```
### 测试
1. 运行服务器
2. 打开 `test.html` 进行 WebSocket 测试
3. 使用多个客户端测试匹配功能
## 待开发功能
1. 数据库集成
- 用户认证
- 比赛记录
- 分数统计
2. 游戏逻辑
- 宝藏生成
- 得分计算
- 比赛结算
3. 系统优化
- 错误处理完善
- 日志系统
- 监控指标
## 协议指令
当前支持的指令：
- `match.start`: 开始匹配
- `match.cancel`: 取消匹配
- `sys.ping`: 心跳检测