PZ 反向映射器

# PZ 反向地图

《僵尸毁灭工程》地图逆向导出工具，适配WorldEd与TileZed工作流。

PZ 地图逆向解析工具，是一款用于读取《僵尸毁灭工程》已编译地图数据的Windows软件。
并重建可编辑的映射资源：TMX单元格、PZW项目、对象、RoomDef
TBX文件、附加建筑TBX文件、预览图及生物地图
图块集

这不是一个玩法模组。它是一个为地图制作者或模组作者提供的工具。
检视、恢复、研究或重建已编译的地图数据，并将其保存为可用文件。
使用《僵尸毁灭工程》官方地图工具打开。

## 功能说明

正在读取 `.lotheader` 和 `world_X_Y.lotpack` 文件。
- 支持旧版Build 41及更早版本的`300x300`编译单元格。
- 支持 Build 42 POT `256x256` 编译区块。
将源单元格重新投影为可编辑的 `300x300` WorldEd TMX 单元格。
- 也可以导出原生的 `256x256` TMX 单元以供检查。
将 `objects.lua` 中的对象恢复至 `.pzw` 项目中。
导出房间定义TBX文件。
导出补充的重建建筑TBX文件。
生成 `Map.png`、`Map_veg.png`、`world.png` 以及僵尸密度预览图。
将 `biomemap_X_Y.png` 地块重新拼接，生成完整的 `biomemap.png`。
提取瓦片集图集图像并重新生成 `Tiles/*.png` 资源表。
- 能读取一个独立的可选模组资源文件夹，内含自定义的 `.tiles` 文件
  `.pack` 文件，无需复制到游戏 `media` 文件夹中。

## 存在原因

旧版《Project Zomboid》地图使用了与经典风格匹配的编译网格。
`300x300` 可编辑的世界编辑器单元格工作流程。Build 42 将已编译的地图单元格改为
256x256尺寸，但可编辑的TMX工作流程仍普遍依赖旧版单元格
布局

PZ反向映射器通过转换每一个地块、房间和物件，解决了这一不匹配问题。
在写入目标文件之前，通过世界坐标进行处理。实际操作中，此步骤
允许将已编译的Build 42地图重建为经典可编辑的WorldEd风格地图
导出。

## 主要输出

- `tmx/*.tmx` - 可编辑的 WorldEd/TileZed 地图格子
- `<project>.pzw` - WorldEd 项目文件
`tmx/tbx/<cell>/*.tbx` - 房间定义TBX文件
- `tbx_buildings/<源单元格>/*.tbx` - 补充重建建筑TBX文件
`maps_img/*` - 每个单元格的预览图像
- `Map.png`、`Map_veg.png`、`world.png` - 合并后的预览图
- `Map_ZombieSpawnMap.png` —— 僵尸密度预览（可用时显示）
- `biomemap.png` — 当存在源瓦片时，合并后的 Build 42 生物群落地图
- `TilesRaw/*` —— 从 `.pack` 文件中提取的原始图集图片
`Tiles/*.png`——重构后的 WorldEd/TileZed 瓦片图集

`Map.png` 特意设计为基础地形图片，不显示房间定义（RoomDefs）。
因其在映射流程中被用作基础图像。

## 要求

- 窗明几净。
.NET8 运行时桌面版
对不起，我无法处理您提供的链接内容。请直接提供需要翻译的文本。
- 本地已安装《僵尸毁灭工程》
- 用于《僵尸毁灭工程》的地图编辑工具，如WorldEd和TileZed。
- 如果您需要图块集定义，请前往「Project Zomboid」的 `media` 文件夹
  瓷砖包提取中。

此存檔未包含《Project Zomboid》遊戲素材。圖塊表
从您的本地安装目录中提取。

## 安装

1. 下载压缩包。
2. 将其解压到《僵尸毁灭工程》游戏文件夹之外的任意位置。
3. 运行 `PZReverseMapper.exe`。
4. 选择你已编译的地图文件夹。
5. 选择一个输出文件夹。
6. 选择《Project Zomboid》的 `media` 文件夹，以获取图块集和物体对象。
  瓦片提取。
7. 对于模组地图，只有在已准备独立文件夹的情况下，才启用「模组资源」选项。
  包含模组的 `.tiles` 文件以及所需的 `texturepacks/*.pack` 文件。

使用专用输出文件夹。若启用「清理输出文件夹」选项，应用会弹出询问确认。
确认后，将现有输出内容移至Windows回收站。
它拒绝访问桌面、文档、下载等受保护位置。
资料，并激活根源。

文件夹选择器默认打开应用目录，而非桌面。
默认情况下，输出文件会存放在应用所在目录的 `export` 子文件夹中，以及项目文件夹内。
名称默认与所选地图文件夹名称一致，除非您自行输入自定义名称。

可选命令行用户可使用 `PZReverseMapper.Cli.exe`。

## 推荐工作流程

从一个小范围的源单元格过滤器开始，例如 `46_26` 或 `46_26,46_27`。
2. 点击「验证」，检查源单元格尺寸、层级以及缺失的Lotpack文件。
3. 先跑一小批出口看看。
4. 在 WorldEd/TileZed 中打开生成的 `.pzw` 和 TMX 文件。
5. 小范围测试无误后，再运行完整地图导出。

针对Build 42地图，推荐预设为：

• B42源256 → TMX 300
  

对于旧版地图，请使用：

• v41 源文本 300 → TMX 300
  

## 图块集

TMX文件遵循《僵尸毁灭计划》常规的逻辑性图块集协定。PNG资源
可能是1倍、2倍，或在特殊情况下（如巨型方块）更大。方块包
提取器从`.pack`文件中读取实际的`tileWidth`和`tileHeight`元数据。
条目代替强制将所有图片设为固定大小。

图块表提取可能数据量较大，通常每个项目运行一次即可。
僵尸毁灭工程版本或贴图更新，并非每次小测试导出都如此。

对于模组地图，请保持原版 `media` 路径指向你的《Project Zomboid》
已识别源语言为英文，翻译如下： 安装并将修改过的瓦片放入单独的文件夹，例如：

我的模组资源/


  my_tiles.tiles


  纹理包/


    我的背包.背包

该工具也支持使用 `texturespack/` 文件夹来存放已准备好的资源目录。
在基础游戏媒体文件夹之后读取，以便模组表可以添加或替换图块集
不修改游戏安装元数据。输出仍仅写入。
到选定的导出文件夹。

## 正在生成TBX导出文件

TBX建筑包为补充重建内容，内含房间数据分组。
将类似建筑的TBX文件导入，并裁剪这些房间周边的瓦片图层。

这些文件适用于检查、实验或构建包工作流程。
但它们并非来自独立石工作室的原始TBX源文件。

## 已知限制

此工具为逆向工程产物，可能存在边缘情况。
全地图导出可能会占用大量磁盘空间和内存。
TBX 输出正在重建补充中。
图块表提取依赖于本地《Project Zomboid》安装程序及
  可用的 `.pack` / `.tiles` 元数据。
- 导出完整地图前，务必先在单元格小范围内测试。

## 兼容性

已针对「Build 41」时代的《Project Zomboid》编译地图格式进行了测试。
Build 42 POT风格地图。

## 制作人员

工具制造与逆向工程由 Alree // Unjammer 完成。

Project Zomboid、WorldEd 和 TileZed 属于 The Indie Stone 所有。本工具并非其官方产品。
官方，未与The Indie Stone联属，且不重新分发游戏内容。
资源。

## 权限

生成的文件可用于个人的地图制作、数据恢复、检查与复核用途。
模组制作流程，遵循《僵尸毁灭工程》自身条款及相关权利规定。
地图/资产正在导出中。

未经授权，请勿重新分发《Project Zomboid》的游戏提取资源。
有权这样做。