动物园之星2模组制作工具包——阅读游戏脚本与界面

创作者: 0Mike

已更新:2026-10-16 18:26:20

23KB

关于此 MOD

面向模组作者：提取并反编译《动物园之星2》约1,100个游戏Lua脚本，解包完整游戏UI（HTML/JS/CSS）以便作为源码阅读。另附一个带PZ2头修复的模组构建器、一个可用的模组模板（含require/manager/mode钩子），以及一个

动物园之星2模组制作工具包
阅读游戏脚本和界面作为源文件。构建你自己的模组。

用于以下用途的资源 模组作者，而不是玩家：它本身不会改变游戏。它汇集了我在制作《动物园之星2》模组时学到的所有东西（基因与黄金) 转化为一份指南和一套小工具。

你会得到什么

游戏的Lua作为源。 pz2_unpack.py 提取并反编译约1100个游戏脚本（GameMain和Content0）：管理器、中心模式、编辑器、存档、Franchise、UI控制器。《动物园之星2》的Lua是带有小型Frontier头部的纯Lua 5.3字节码，cobra-tools自带的luadec可直接读取。
完整的游戏UI作为源文件。 同一工具可解包游戏的界面包： 前端.html, HUD.html 以及大约1850个HTML/JS/CSS文件（一个运行在Coherent Gameface中的Preact应用），包括每个UI数据模式。
一个模组构建器。 pz2_build_pack.py 将普通文件转换为模组文件夹（包含 Main.ovl 以及可选的 UI 覆盖层）。它会设置一个字节，使《动物园之星 2》能够接受该归档文件（头部 version_flag = 0x01），再次解压其构建内容以进行逐字节校验，并且仅在游戏关闭时进行安装。
一个可用的模板模组。 入口点、一个ACSE风格的require钩子，以及普通require钩子遗漏的两个钩子（园区管理器和世界模式），外加一个每帧园区刻的示例。
调试工具。
- crashsum.py 读取游戏的崩溃转储文件，包括每个Lua协程的堆栈信息（即游戏当时处于哪个界面）。
- lua_funcmap.py 将崩溃报告的 Lua 行号转换为该行号所属的函数。
- 一个微型追踪程序（C 源码），为零售版游戏中的模组 Lua 提供日志文件。
指南.md: 《动物园之星2》如何加载模组、Lua在正式版游戏中能做什么和不能做什么（没有io库，文件调用是空壳，园区存档是唯一的存储），UI覆盖层和Gameface的怪癖，崩溃位置，以及安全模组规则。每个事实都标记为已在游戏中证实或仅在文件中看到。

需求

Windows，Steam PC版《动物园之星2》（在1.0.5版本上测试）
Python 3.11
眼镜蛇工具（免费，GitHub），这些工具驱动着
可选：Visual Studio C++（用于构建跟踪器）， pip install minidump （用于碰撞求和）

安装
解压到任意位置（不要解压到游戏文件夹中），然后按照README.txt操作，再按照GUIDE.md操作。快速开始只需三条命令。

这个套件不具备的功能

它从不接触PlanetZoo2.exe或其DRM。它只读取Win64\ovldata目录下的游戏数据档案，这些档案未加密。
它不包含任何Frontier文件或反编译的游戏代码。你需要从自己的安装中提取自己的副本。也请不要上传提取出的游戏文件。
用它制作的模组是即插即用的文件夹：不会更改游戏文件，删除文件夹即可卸载。

备注

非官方内容，与Frontier Developments无关。Frontier目前尚未正式支持《动物园之星2》模组。使用模组风险自负，请勿在 Franchise（在线）模式中使用。
游戏更新可能改变任何内容。本套件已在1.0.5版本（构建1023906）中检查。
制作人员：眼镜蛇工具（OpenNaja 及贡献者）提供的 OVL 格式、luadec（viruscamp）提供的反编译器，以及 ACSE 提供的内容包挂钩模式。
该套件自身文件采用MIT许可证：可在你的模组中使用，注明出处更佳。