# PocketSurvival

**Repository Path**: SC-SPM/PocketSurvival

## Basic Information

- **Project Name**: PocketSurvival
- **Description**: 一个用c++制作的SurvivalCraft联机mod服务器
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-04-23
- **Last Updated**: 2026-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PocketSurvival

原作者：攻守兼备

这是一个使用 C++ 制作的生存战争联机版服务端程序，使用 MinGW 或 GCC 进行编译，可以在 Linux (Ubuntu, Debian) 或 Windows 上进行开服。当前版本适用于 x24.03.04。

由于原作者现在工作繁忙，已经没时间继续开发该服务端，又不想见 SC 联机版陨落，开源该项目，希望能有更多有识之士加入到 SC 联机版的大家庭中。

想加入仓库协助后续开发的请加我 QQ: 3052400179

## SCKey相关说明

在版本 dev26.04.12.B2 的 settings.json 中，loginType 字段控制登录模式：0 为游客模式，玩家以游客账号入服；1 启用 SCKey 验证，需绑定 SCKey 角色信息并通过认证后方可入服；2 启用 SCKey 认证模式，服务端读取 sckey_config.json 配置，其中 enableScKeyVerify 控制入服时是否向 SCKey 平台强制校验，false 表示不强制校验。服务端登录与 SCKey 绑定支持邮箱方式。

## 项目特点

- **跨平台支持**：兼容 Linux 和 Windows 系统
- **完整的联机功能**：支持局域网和互联网联机
- **生存模式同步**：包括生命、物品栏、工具等系统的完全同步
- **方块和地形编辑**：支持多人协作建造
- **插件系统**：支持服务器插件扩展功能
- **性能优化**：针对网络带宽使用进行了优化

## 项目结构

项目采用模块化架构设计，主要包含以下核心模块：

### src/Blocks/
游戏中的各种方块实现，包括基础方块、工具方块、电路方块等。

### lib/
第三方依赖库：
- `libhv` - 高性能网络库
- `spdlog` - 日志库
- `json` - JSON 解析库
- `entt` - 实体组件系统
- `SQLiteCpp` - SQLite 数据库封装
- `mbedtls` - 加密库
- `Lua-5.4.6` - Lua 脚本支持
- `cppcodec` - 编解码库
- `asio-cmake` - ASIO 网络库
- `zlib` - 压缩库

### plugins/
服务端插件系统：
- `BedWars` - 起床战争插件
- `ChestLock` - 箱子锁插件
- `SPPlugin` - 基础插件框架
- `TpPlugin` - 传送插件

### Server/
服务端配置文件目录，包含认证和封禁配置。

### content/
游戏资源数据，包括方块、实体、物品等定义文件。

## 编译指南

### 开发环境要求

- **编译器**：GCC 11+ 或 MinGW-w64
- **构建工具**：CMake 3.20+
- **平台**：Linux (Ubuntu/Debian) 或 Windows

### 编译步骤

```bash
# 创建构建目录
mkdir build && cd build

# 生成 Makefile
cmake ..

# 编译
make -j$(nproc)
```

### Windows 编译

使用 MinGW-w64 工具链：

```bash
mkdir build && cd build
cmake .. -G "MinGW Makefiles"
mingw32-make -j4
```

## 依赖项

项目已包含以下第三方库：

- `libhv` 1.3.2 - 高性能 HTTP/WebSocket 网络库
- `spdlog` 1.11.0 - 快速日志库
- `nlohmann/json` 3.11.3 - JSON 解析库
- `entt` 3.11.1 - 实体组件系统
- `SQLiteCpp` 3.3.1 - SQLite 数据库
- `mbedtls` 3.5.2 - TLS/SSL 加密库
- `Lua` 5.4.6 - 脚本语言支持

## 服务器配置

服务器配置文件位于 `Server/` 目录：

- `auth.json` - 认证配置
- `ban.json` - 封禁列表

## 插件系统

项目支持服务器插件扩展功能，目前已实现的插件包括：

- `BedWars` - 起床战争游戏模式
- `ChestLock` - 箱子锁功能，保护玩家物品
- `TpPlugin` - 传送插件

## 注意事项

- 跨平台联机时请注意版本兼容性
- 服务器性能会影响支持的最大玩家数量
- 网络质量对游戏体验有显著影响，建议使用稳定的网络连接