PALFORGE ASCENSION - EVOLUTIONSUITE 服务器伴侣

PALFORGE ASCENSION - EVOLUTIONSUITE 服务器伴侣

这是PalForge的官方服务器伴侣

PALFORGE ASCENSION - EVOLUTIONSUITE 服务器伴侣预览查看大图

PALFORGE ASCENSION

EVOLUTIONSUITE 服务器配套组件

Windows 专用服务器 • UE4SS • 原生 DPS 读取器 • 私有 RPC 传输

解锁 PALFORGE ASCENSION 联动存储与 DPS 系统的专用服务器桥接组件。

欢迎使用 PALFORGE ASCENSION

EvolutionSuiteServer 是 PALFORGE ASCENSION 的专用服务器配套组件。

它将 PALFORGE 客户端与实时的服务器权威帕鲁信息相连接，同时保持服务端组件专注、私有且轻量。它处理经过验证的请求、读取相应的实时维度帕鲁存储数据、维护同步快照，并通过私有的 PlayerController RPC 通道返回结果。

这不是客户端的替代品，本身也不会添加独立的玩家界面。

玩家仍然需要安装匹配的 PALFORGE ASCENSION 客户端模组。

https://www.nexusmods.com/palworld/mods/4690

服务器配套组件提供的内容

  • 专用服务器集成，适用于 PALFORGE ASCENSION
  • 服务器权威的玩家识别与请求处理
  • 实时维度帕鲁存储发现
  • 经过验证的 DPS 所有权与来源检查
  • 自动生成存储快照
  • 支持代际感知的缓存与同步
  • 私有 BEGIN / DATA / END 传输
  • 自动向客户端传送 READY 状态
  • 实时存储变更检测，以保持 PALFORGE 最新
  • 紧凑的分块记录，专为安全传输设计
  • 进程内原生 DPS 解析，无需辅助可执行文件
  • 详细诊断信息，方便服务器所有者与错误报告

该配套组件使 PALFORGE 能够将客户端可观察到的信息与必须由专用服务器权威解析的信息结合起来。

安全、窄范围且只读

原生组件的职责被有意限制为一项：

读取、解析并验证正确的实时 <玩家 UID>_dps.sav 文件。

它不管理 PALFORGE 的界面、目标定位、缓存策略、请求代次或客户端存储展示。这些系统与原生读取器保持分离。

当前架构不需要：

  • 零散的辅助 EXE
  • cmd.exe
  • Shell 命令
  • 子进程
  • 运行时下载
  • 临时提取器 JSON 文件
  • 游戏聊天数据传输
  • 专有的 Oodle DLL

DPS 存档读取器以只读方式打开选定的实时文件。它不会有意写入、修改或替换玩家的 DPS 存档。

PALFORGE 数据通过既定的服务器/客户端 RPC 路径私密返回给请求的玩家。它不会被转储到公共的游戏聊天系统中。

需求

  • Palworld Windows 专用服务器
  • 已在服务器上安装并正常运行的 UE4SS
  • 每位使用 PALFORGE 的玩家都需要安装 PALFORGE ASCENSION 客户端模组
  • 与本配套组件版本兼容的 PALFORGE 客户端版本

平台须知：

本版本面向 Windows 专用服务器环境。当前官方的《幻兽帕鲁》服务器端 Workshop 模组部署系统不为此软件包提供等效的 Linux 支持。

安装 — 服务器所有者

在安装或更新前请停止服务器。

1. 备份服务器

备份 Palworld 服务器的 Saved 目录以及任何现有的 PALFORGE 或 EvolutionSuiteServer 安装。

2. 安装 UE4SS

安装兼容的 UE4SS 服务器版本，并在添加 EvolutionSuiteServer 之前确认其能正常加载。

3. 安装 EvolutionSuiteServer

如果 PalServer.exe 旁边尚不存在以下目录，请创建它：

Mods\Workshop\EvolutionSuiteServer

将 EvolutionSuiteServer 发布包解压到该文件夹中。

解压后，包的元数据必须直接位于此处：

<PalServer 目录>\Mods\Workshop\EvolutionSuiteServer\Info.json

不要将包放在额外嵌套的文件夹中。

错误示例：

Mods\Workshop\EvolutionSuiteServer\EvolutionSuiteServer\Info.json

正确示例：

Mods\Workshop\EvolutionSuiteServer\Info.json

4. 启用软件包

打开：

Mods\PalModSettings.ini

确认必需条目已启用：

[PalModSettings]
bGlobalEnableMod=true
ActiveModList=UE4SS
ActiveModList=EvolutionSuiteServer

不要使用 -NoMods 启动参数运行服务器。

5. 启动服务器

《幻兽帕鲁》的模组部署系统应在启动时将该软件包安装到受管理的 UE4SS 位置。

6. 验证部署

确认存在以下清单文件：

Mods\ManagedMods\EvolutionSuiteServer\InstallManifest.json

确认部署的模组位于：

Mods\NativeMods\UE4SS\Mods\EvolutionSuiteServer

然后检查服务器的 UE4SS 日志，查看 EvolutionSuiteServer 启动和原生读取器初始化消息。

关于官方服务器模组目录与配置模型，请参阅：

官方《幻兽帕鲁》服务器模组指南

从旧版本更新

不要盲目合并新旧程序文件。

  1. 停止服务器。
  2. 备份现有 EvolutionSuiteServer 文件夹。
  3. 保留任何服务器拥有的 Saved 数据或有意的配置。
  4. 将新版本作为一次干净的程序部署进行安装。
  5. 启动服务器并在 UE4SS 日志中确认部署成功。
  6. 使用匹配的 PALFORGE 客户端加入游戏并完成实时同步测试。

较旧的开发版本可能包含外部 DPS 提取器、临时输出路径或过时的 Tools 目录。这些不属于当前原生读取器架构。

在新版本通过真实服务器连接测试之前，不要删除可正常工作的旧安装。

切勿在模组更新过程中删除《幻兽帕鲁》玩家存档或 DPS 存档。

工作原理

PALFORGE 客户端
        |
        | 私有请求
        v
EvolutionSuiteServer Lua
        |
        | 已验证的 UID 与实时 DPS 路径
        v
原生 DPS 读取器
        |
        | 只读解析与验证
        v
服务器快照缓存
        |
        | 私有代际感知 RPC
        v
PALFORGE 客户端 READY

原生读取器仅负责文件解析与验证。

Lua 服务器层负责：

  • 玩家与发送者权限
  • 请求 ID
  • 实时世界的 DPS 路径解析
  • 缓存标识与策略
  • 快照与代次管理
  • 记录分块
  • 私有 RPC 传输
  • 客户端完成状态传送

这使原生层保持精简，并防止无关的 PALFORGE 逻辑与二进制组件绑定。

自动同步

PALFORGE 的设计目标之一是让普通玩家无需每次帕鲁变更存储时都手动点击刷新按钮。

客户端与配套组件会监控相关存储状态，并在检测到有意义的变化时请求更新信息。这包括常见情况，例如：

  • 帕鲁进入存储
  • 帕鲁离开存储
  • 新捕获的帕鲁出现
  • 帕鲁在槽位间移动
  • 帕鲁在帕鲁终端与维度存储之间移动
  • 目标位置变更
  • 存储界面被打开、更新或关闭

更新受代次控制，因此旧结果不能静默替换新接受的较新状态。

积极开发通知

PALFORGE ASCENSION 是一个雄心勃勃、正在积极开发的系统。其核心存储发现、同步和原生 DPS 传输功能已经可用，但一些高级展示和边缘情况行为仍在完善中。

目前正在持续测试的领域包括：

  • 跨所有帕鲁终端与维度存储面板的目标辅助高亮
  • 快速跨存储移动后的即时视觉校正
  • 不寻常存储序列期间的 MiniHUD 位置更新
  • 新角色与完全空的帕鲁终端的启动行为
  • 在活动同步期间存储发生变化时的优雅恢复
  • 其他 UE4SS 模组替换或大量修改相同《幻兽帕鲁》界面时的兼容性行为

目前，关闭并重新打开存储可能会强制《幻兽帕鲁》重建存储组件并视觉校正过时的高亮或位置。这是一个客户端展示问题，不一定表示服务器快照或存档数据有误。

发布此服务器配套组件是为了让专用服务器架构在最终客户端展示案例继续完善的同时，能够公开使用和测试。

任何存档数据问题都不应被轻率忽视。在安装或更新任何模组之前，请备份您的服务器。

单人游戏与非 PALFORGE 服务器

EvolutionSuiteServer 面向专用服务器设计。

PALFORGE 客户端还包含适用于单人游戏和不运行此配套组件的服务器的本地模式路径。这些环境将不具备 EvolutionSuiteServer 提供的服务器权威 DPS 增强功能。

玩家不应仅仅因为服务器未安装配套组件而永久无法使用 PALFORGE。但仅由配套组件提供的信息无法由客户端自行生成，因此这些信息可能不可用。

如果本地模式无法就绪，请更新到最新的 PALFORGE 客户端，并在报告问题时附上客户端 UE4SS 日志。

模组兼容性

EvolutionSuiteServer 被有意设计为范围狭窄的组件，应与许多其他 UE4SS 模组共存。

然而，当其他模组出现以下情况时，可能会发生冲突：

  • 替换相同的存储组件
  • 挂钩相同的帕鲁终端或维度存储功能
  • 中断玩家控制器 RPC 行为
  • 产生重复的 Lua 异常
  • 使用不兼容的 UE4SS 构建
  • 修改《幻兽帕鲁》存档或所有权结构
  • 在 PALFORGE 启动期间冻结游戏主线程

在日志中看到另一个模组并不自动意味着该模组有责任。一份可靠的兼容性报告应包含一个受控测试，仅包含：

  • UE4SS
  • PALFORGE ASCENSION
  • EvolutionSuiteServer

然后逐个恢复其他模组。

故障排除

EvolutionSuiteServer 未出现在 ManagedMods 中

  • 确认 Info.json 直接位于 EvolutionSuiteServer Workshop 文件夹内。
  • 确认 bGlobalEnableMod=true。
  • 确认 EvolutionSuiteServer 在 ActiveModList 中。
  • 确认 UE4SS 已安装并启用。
  • 确认服务器未使用 -NoMods 参数。
  • 完全重启服务器。

服务器已加载，但 PALFORGE 超时

  • 确认客户端与服务器配套组件版本兼容。
  • 检查客户端和服务器的 UE4SS 日志。
  • 确认原生读取器初始化成功。
  • 确认连接玩家拥有有效的实时 DPS 存档。
  • 确认文件权限允许服务器进程读取其自身的存档目录。

原生读取器验证失败

当所需原生或 UE4SS 身份与预期环境不匹配时，读取器会以失败安全的方式关闭。不要通过重命名随机 DLL 或从无关版本复制二进制文件来绕过此验证。

安装文档中列出的依赖版本并重启服务器。

PALFORGE 一直停留在加载条

收集客户端日志和服务器日志。客户端就绪问题可能看起来与服务器响应缺失类似，但它们是不同的故障。

安装多个模组后游戏冻结或崩溃

首先使用最简模组集进行测试。从游戏启动到冻结或崩溃的完整日志都要包含。最后一行可见内容并不总是最初的原因。

如何报告 Bug

请包含以下信息：

PALFORGE 客户端版本：
EvolutionSuiteServer 版本：
《幻兽帕鲁》版本：
UE4SS 版本：
专用服务器或单人游戏：
Windows 服务器版本：
其他已安装模组：

您期望的结果：
实际发生的情况：
按顺序执行的确切操作：
是否可以复现：
关闭并重新打开存储是否能解决：

在测试专用服务器时，请附上两份日志：

  • 客户端 UE4SS.log
  • 服务器 UE4SS.log

请在加入世界之前开始记录日志，并在问题发生之后才停止。除非小片段包含完整的启动和失败序列，否则请不要只发送小片段。

在公开发布日志前，请移除密码、私人地址、认证令牌或其他敏感信息。

https://discord.gg/KUYe4yjgcJ

常见问题解答

每个玩家都需要安装 EvolutionSuiteServer 吗？

不需要。该配套组件由专用服务器管理员安装一次。玩家只需安装 PALFORGE ASCENSION 客户端。

这会将帕鲁数据通过公共游戏聊天发送吗？

不会。当前传输使用私有的服务器/客户端 RPC 通信。

原生读取器会修改 DPS 存档文件吗？

不会。其角色仅为只读解析与验证。

这包含 UE4SS 吗？

不包含。UE4SS 是独立的依赖项，归其自身作者所有，遵循其自身的许可和分发条款。

这在 Linux 专用服务器上能用吗？

当前支持的分发形式尚不支持。此版本面向 Windows 版《幻兽帕鲁》专用服务器。

我可以在没有服务器配套组件的情况下使用 PALFORGE 客户端吗？

可以，但功能会受限或仅限本地模式。专用服务器的 DPS 增强功能需要配套组件。

需要手动刷新吗？

预期的正常体验是在帕鲁所有权或存储发生有意义变化后自动同步。开发与诊断期间可能仍保留手动恢复控制。

为什么重新打开存储能修复视觉问题？

《幻兽帕鲁》重建了底层存储组件。PALFORGE 正在持续改进即时校正功能，使重新打开不再必要。

服务器所有者可以检查配套组件在做什么吗？

可以。重要的请求、同步、验证和失败转换都会写入 UE4SS 日志。

当前版本

EvolutionSuiteServer 1.4.3-workshop-1

  • 原生进程内 DPS 读取器
  • 外部提取器进程已从分发路径中移除
  • 只读实时 DPS 解析与验证
  • 私有 DPS6 兼容 RPC 传输
  • 代际感知同步
  • 自动存储变更请求处理
  • 官方《幻兽帕鲁》服务器模组元数据
  • 确定性的受管理部署规则
  • 仅服务器软件包边界
  • 附带了原生源对应关系及所需的许可证声明
  • 不包含客户端模组文件
  • 不包含存档文件
  • 不包含服务器特定配置
  • 不包含运行时下载器

软件包完整性

官方发布 ZIP SHA-256：

f7ec770ca15b7211bbb09c9983e64b2608879a493ef15331b3054938d89f859c

原生读取器 DLL SHA-256：

5fee27fae088f00be00f33d2e8abfc3126f11a3831a7a0f05036629bbca126d6

如果您下载的发布包被有意重新打包或更新，其压缩包哈希值将有所不同。请使用该确切文件版本发布的哈希值。

致谢与许可

PALFORGE ASCENSION / EvolutionSuiteServer 由 Ian Blackhawk 创建与维护。

特别感谢测试者们，他们以各种存储组合移动帕鲁、打破状态转换、提供宝贵的日志，并帮助将棘手的边缘情况转化为可复现的工程问题。

此软件包包含集成第三方组件所需的声明和相应的原生源材料。

原生 DPS 读取器包含一个 ooz 派生的解压缩组件，受其适用的 GPL 许可条款约束。详情请查看附带的许可和源文档。

UE4SS 是独立项目，不属于 PALFORGE 的一部分。

《幻兽帕鲁》及相关名称、角色、资产和商标均归 Pocketpair 及其各自所有者所有。

这是一个非官方社区项目。它与 Pocketpair 无关联、未经其认可，也未获得其赞助。

锻造更智能。培育更优。飞升。

PALFORGE ASCENSION