Freeserf.net

The Settlers I 清洁室 C# 重实现，跨平台复刻

基本信息

核心技术点

C++ → C# 移植架构

• 全部代码从 C++ freeserf 移植或重实现，Phase 1 (Porting) 100% 完成
• Phase 2 (Optimizing) 100% 完成：bug 修复 + C# 特定优化 + 跨平台
• Phase 3 (Extending) 15% 进行中：新增功能、mod 支持、工具
• 当前主攻方向：多人网络支持

模块化 .NET Standard 2.1 DLL 架构

渲染架构 (Freeserf.Renderer)

• ShaderProgram → Shader.cs (Color/Masked/MaskedTriangle/TextureShader)
• RenderLayer.cs → 分层渲染 (Map/Building/Flag/Serf/Road)
• TextureAtlas.cs + MutableTexture.cs 纹理管理
• VertexArrayObject.cs + BufferObject.cs OpenGL VAO/VBO 封装

AI 系统 (Freeserf.Core)

• AI.cs 主体 + AIStates/ 目录多种 AI 状态机
• 数据驱动配置 (user.cfg / Game.cs ConfigFile)
• 经济链：Serf (工人) 在 Flag (旗帜) 间行走运输 Resource

网络架构 (Freeserf.Network)

• Client.cs + Server.cs 完整网络层
• ConnectionObserver.cs 连接状态观察
• Multiplayer.md 多人模式文档
• 正在进行多人开发

玩法特点

• 经典复刻：完整还原 The Settlers I (DOS/Amiga) 玩法
• 数据文件兼容：支持 DOS (SPAx.PA) 和 Amiga (ADF/disk files) 两种游戏数据
• 混合数据：可混用 DOS 图形 + Amiga 音乐
• 跨平台：Windows + Linux
• 可配置：详细 user.cfg 配置 (graphic/sound/video/logging)
• 内置 AI：添加了原作没有的 AI 逻辑

与原版 freeserf (C++) 的关系

• Freeserf.net 是 freeserf 的 C# 移植分支（而非 fork）
• C++ 源码在移植过程中完全重写为 C#
• Freeserf.Core 作为 .NET Standard 2.1 DLL，可被任何 .NET 项目引用

对公司 AI 游戏的参考价值