# FFOServer

**Repository Path**: weifen/ffoserver

## Basic Information

- **Project Name**: FFOServer
- **Description**: 自由幻想服务器C#版
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-04
- **Last Updated**: 2026-11-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FFO Server

基于 ET8 框架实现的自由幻想游戏服务端与原生客户端。

## 项目简介

FFO Server 是一个完整的游戏服务端实现，采用 ET8 框架开发，包含客户端与服务端的完整逻辑。项目实现了自由幻想游戏的核心功能，包括账号系统、背包、装备、战斗、宠物、副本、打造、仓库等游戏系统。

## 技术栈

- **框架**: ET8 (Unity/ .NET 游戏服务端框架)
- **语言**: C#
- **数据库**: MongoDB
- **通信**: TCP 长连接 + 自定义二进制协议

## 项目结构

```
├── Client/                    # 客户端实现
│   ├── App/                   # 客户端启动程序
│   ├── GmTool/                # GM 工具
│   ├── Hotfix/                # 客户端热更逻辑
│   │   └── Module/            # 各功能模块
│   │       ├── Bag/           # 背包系统
│   │       ├── Battle/        # 战斗系统
│   │       ├── Book/          # 典籍系统
│   │       ├── Craft/         # 打造系统
│   │       ├── Dungeon/       # 副本系统
│   │       ├── Equipment/     # 装备系统
│   │       ├── God/           # 幻神系统
│   │       ├── Map/           # 地图系统
│   │       ├── Pet/           # 宠物系统
│   │       ├── Quest/         # 任务系统
│   │       ├── Shop/          # 商店系统
│   │       ├── Skill/         # 技能系统
│   │       ├── Soul/          # 魂魄系统
│   │       ├── Tutorial/      # 新手引导
│   │       ├── Warehouse/     # 仓库系统
│   │       └── ...
│   ├── Loader/                # 代码加载器
│   └── Model/                 # 客户端数据模型
│
├── Server/                    # 服务端实现
│   ├── App/                   # 服务端启动程序
│   └── Hotfix/                # 服务端热更逻辑
│       └── Module/            # 各功能模块
│           ├── Account/       # 账号模块
│           ├── Bag/           # 背包模块
│           ├── Battle/        # 战斗模块
│           ├── Book/          # 典籍模块
│           ├── Character/     # 角色模块
│           ├── Config/        # 配置模块
│           ├── Craft/         # 打造模块
│           ├── Dungeon/       # 副本模块
│           ├── Equipment/     # 装备模块
│           └── ...
│
├── Config/                    # 游戏配置数据
│   ├── Book/                  # 典籍配置
│   ├── Craft/                 # 打造配置
│   ├── Dungeon/               # 副本配置
│   ├── God/                   # 幻神配置
│   ├── Item/                  # 物品配置
│   ├── Monster/               # 怪物配置
│   ├── Pet/                   # 宠物配置
│   ├── Quest/                 # 任务配置
│   ├── Shop/                  # 商店配置
│   ├── Skill/                 # 技能配置
│   ├── Proto/                 # 协议定义
│   └── ...
│
├── PROTOCOL.md                # 协议文档
└── PROTOCOL_FULL.md           # 完整协议文档
```

## 主要功能模块

### 账号系统
- 登录、登出
- 角色创建、删除、查询

### 背包系统
- 物品存取、移动、整理
- 物品使用与掉落
- 地面物品捡取

### 战斗系统
- 玩家攻击与怪物反击
- 技能释放与伤害计算
- 怪物 AI 与掉落

### 打造系统
- 装备精炼
- 装备打孔与镶嵌
- 装备合成
- 生活技能

### 副本系统
- 远古遗迹
- 天魔劫
- 仙界系统
- 地下城入口

### 装备系统
- 装备穿戴与卸下
- 装备修理
- 装备继承与强化

### 宠物系统
- 宠物召唤与命令
- 宠物装备
- 宠物进化

### 仓库系统
- 仓库存取
- 仓库扩容

## 协议说明

项目使用自定义二进制协议与客户端通信，详细协议定义见：
- `PROTOCOL.md` - 协议速查
- `PROTOCOl_FULL.md` - 完整协议明细

## 构建与运行

### 环境要求
- .NET 8.0 SDK
- MongoDB 数据库

### 配置

1. 修改 `Config/Json/cs/StartConfig/` 下的启动配置
2. 配置 MongoDB 连接信息

### 编译

```bash
# 编译服务端
dotnet build Server/App/AppServer.csproj

# 编译客户端
dotnet build Client/App/AppClient.csproj
```

### 运行

1. 启动 MongoDB
2. 运行服务端 `Server/App/AppServer`
3. 运行客户端 `Client/App/AppClient`

## GM 工具

项目包含 Windows Forms GM 工具，位于 `Client/GmTool/`，可用于：
- 角色查询与修改
- 物品发放
- 等级调整

## 注意事项

- 本项目仅供学习研究使用
- 客户端需要真实的游戏客户端文件配合使用
- 请遵守游戏服务条款及相关法律法规