Skip to content

Latest commit

 

History

138 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ServerS4A12 管理工具包

[AGPL v3.0] [.NET 10.0] [Windows 10/11]


项目简介

为 ServerS4A12 服务端模拟器打造的全功能管理套件,专为非技术用户设计,无需了解 .NET SDK、PowerShell 或服务端架构,即可轻松完成:

  • 同步更新:一键增量/全量更新,自动拉取最新源码并编译,失败可切换镜像下载
  • 存档管理:切换/改名/导入/导出/备份,支持拖拽换挡,自动备份上限 10 个
  • DX11/DX12渲染:一键切换补丁,提升游戏流畅度,支持去除 dgVoodoo 水印
  • GM工具:集成官方同步更新版本,一键启动网页管理后台
  • 服务端控制:启停/重启管理 + PVF 状态检测,自动打开游戏客户端
  • 环境检测:自动检测并安装 .NET SDK,兼容性低系统红字提醒
  • 管理器自更新:从 GitHub 拉取最新源码,自动重新编译并替换 EXE
  • 迷你模式:小窗口快捷入口(开始游戏 / GM工具 / 开始更新 / 存档切换)

许可证

采用 AGPL v3.0 许可。

  • 个人及非商业用途完全免费
  • 修改后的版本须以 AGPL v3.0 开源发布
  • 商业使用需获得书面授权

核心特性

功能 说明
增量更新 快速同步最新代码并编译 DfoServer / DfoGmTool
全量更新 首次部署或强制同步
镜像下载 跳过 GitGud 直接使用镜像源,更新失败时重试
更新日志 更新后自动写入「更新日志.txt」,可一键查看
管理器自更新 对比远程版本,自动编译替换两个 EXE 并重启
存档管理 左键双击换挡 / 右键改名 / 拖拽导入 / 备份上限 10 个
一键安装SDK 自动定位 .NET 10 SDK 安装包,调用官方安装程序
DX11/DX12补丁 互斥勾选,自动复制/删除补丁文件,支持去水印
运行日志条 彩色日志、复制/清空/折叠、更新进度条与百分比
深色主题GUI AntdUI 自适应布局,抗拉伸,支持 DPI 缩放
双版本交付 有依赖版 ~3.65MB / 无依赖版 ~50.6MB(单文件压缩,自包含运行时)

目录结构

ServerUI-完整发布包-v2.0/
├── ServerUI-有依赖版.exe      # 依赖版(需系统已装 .NET 10)
├── ServerUI-无依赖版.exe      # 便携版(自包含.NET运行时)
├── 解除卡顿指示.txt           # 游戏卡顿排查指引
└── ServerUI源码\              # 完整 C# 源码

运行时数据目录(在游戏主目录下):

AUM管理组件\
├── ps1核心\                    # 更新 / 编译 / 存档等 PowerShell 核心脚本
├── ServerS4A12-AUM\           # 服务端源码(dist\win-x64 为运行目录)
├── dfogmtool\                 # GM工具源码
├── DX11补丁\ + DX12补丁\      # 渲染补丁(含 无水印 子目录)
├── dotnet-sdk\                # .NET 10 SDK 安装包
├── 存档管理\                  # 切换库 + 备份存档\backup_日期_时间
└── AUM-version.txt            # 管理器版本记录(自更新比对用)

快速开始

系统要求

项目 要求
操作系统 Windows 10 (Build 14393/1607+) / Windows 11 x64
.NET运行时 有依赖版需 .NET 10;无依赖版免安装(自动检测)
磁盘空间 约 2GB
网络 首次更新需联网拉取源码

使用步骤

  1. 解压发布包,将 EXE 放到游戏主目录(与 DNF.exe 同级)
  2. 双击 ServerUI-有依赖版.exeServerUI-无依赖版.exe
  3. 左侧菜单「开始」页,点击「开始更新」拉取并编译服务端(约 5~15 分钟)
  4. 可选:在「设置与关于」页勾选 DX11/DX12 运行方式
  5. 点击绿色大按钮「开始游戏」,程序自动启动服务端(约 5~15 秒)并打开游戏
  6. 创建或选择角色,直接开始游玩

若 DNF.exe 不在同一目录,程序会以醒目的亮红加粗日志提醒。


界面说明

左侧菜单共 4 页:

页面 内容
开始 状态卡片×4(服务端/PVF/版本/SDK)+ 开始更新、开始游戏、停止服务端、GM工具
存档管理 切换库列表、储存当前 / 导入 / 导出 / 撤销换挡 / 刷新 / 清理冗余DB
设置与关于 可选运行方式(DX11/DX12)、去水印开关、打开PVF/主存档、修复赛丽亚房间、迷你模式、更新AUM
使用说明 内置完整图文说明(快速开始 / 服务端控制 / 运行方式 / 目录与工具 / 更新管理 / 存档管理 / 日志区)

技术栈

层级 技术
服务端 C# (.NET 10.0)
图形界面 WinForms (.NET 10.0-windows) + AntdUI 2.4.3 (Apache-2.0)
脚本引擎 PowerShell 5.1
仓库API Codeberg REST API(增量更新)/ GitHub(管理器自更新)
数据库 SQLite (inventory.db)

开发与构建

源码结构

Program.cs                     // 程序入口:全局异常捕获 + Windows 版本预检 + 启动日志
MainForm.cs                    // 主窗体框架 + 菜单导航 + 迷你模式切换
MainForm.Pages.cs              // 开始页 / 存档管理页 / 设置与关于页 / 使用说明页 / 日志条
MainForm.Archive.cs            // 存档管理业务逻辑
MainForm.Server.cs             // 服务端启停 / 日志输出 / 更新流程 / DNF 检测
MiniForm.cs                    // 迷你模式小窗口
Models/
  └── ArchiveEntry.cs          // 存档数据模型
Services/
  ├── ArchiveService.cs        // 存档管理
  ├── ServerService.cs         // 服务端启停
  └── UpdateService.cs         // 调用更新脚本

本地编译

# 有依赖版 (~3.65MB)
dotnet publish ServerUI.csproj -c Release -r win-x64 --no-self-contained -o ./publish-deps

# 无依赖版 (~50.6MB, 单文件压缩, 自包含运行时)
dotnet publish ServerUI.csproj -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=false -o ./publish-self

单文件压缩(EnableCompressionInSingleFile)由 csproj 按 SelfContained 自动启用,体积约 114MB → 50.6MB(降 56%)。注意:WinForms 不支持 Native AOT(NETSDK1175)。


常见问题

Q: 首次使用需要联网吗?
A: 需要,用于下载服务端源码;有依赖版还需安装 .NET 10 SDK。

Q: 便携版和依赖版区别?
A: 无依赖版自包含 .NET 运行时(~50.6MB),适合无环境系统;有依赖版(~3.65MB)需系统已安装 .NET 10 SDK。

Q: 更新失败怎么办?
A: 检查网络和防火墙,勾选日志条的「镜像下载」后重试,或改用「全量更新」。

Q: 游戏黑屏/闪退?
A: 在「设置与关于」页切换「可选运行方式」(DX11/DX12),或取消选择相关运行方式。

Q: 卡在赛丽亚房间?
A: 在「设置与关于」页点「修复赛丽亚房间问题」。

Q: 存档操作被阻止?
A: 服务端运行中会阻止存档操作,请先「停止服务端」。


许可证声明

本软件采用 AGPL v3.0 开源。

  • 个人和非商业用途免费
  • 商业使用需获得书面授权

Copyright (c) 2026 ServerS4A12 Manager Contributors

About

ServerUI-AUM-ServerS4A12 管理工具包 是为 2D 横版游戏服务端模拟器 ServerS4A12 量身打造的全功能管理套件。专为非技术用户设计,让您无需了解 .NET SDK、PowerShell 脚本或服务端架构,即可轻松完成

Resources

Stars

32 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages