REE Path Searcher

A Rust tool for extracting file paths from RE Engine game PAK files and memory dumps.

Acknowledgments: This project is based on parts of the mhrice project. Special thanks to the original authors.

Usage

How to get a DMP file

1. Launch the game and wait until it reaches the state you want to inspect.
2. Open Task Manager.
3. Find the game process under Processes or Details.
4. Right-click the process and choose Create memory dump file.
5. Wait for Windows to finish writing the dump, then use the generated .dmp file with --dmp.

# Extract paths from memory dump and PAK files
./ree-path-searcher.exe --dmp <memory_dump_file> --pak <pak_file_path>

# Multiple PAK files
./ree-path-searcher.exe --pak <pak_file_path_1> --pak <pak_file_path_2>
# or input a list file, each line is a PAK file path
./ree-path-searcher.exe --pak-list <pak_list_file>

# Add reference path lists (each line can be a raw path or a full path; it will strip `natives/<PLATFORM>/` and tail parts like `.version(.platform)(.lang)` then resolve and append matched paths into output.list)
./ree-path-searcher.exe --pak-list <pak_list_file> --ref-list <reference_list_file>

# Use a custom resolver config (languages/prefixes/suffix map)
./ree-path-searcher.exe --config path_searcher.toml --pak <pak_file_path>

# If --config is not specified, the tool will try to load ./config.toml automatically.

Library Usage

To use this as a library, refer to src/main.rs for implementation examples.

Config (TOML)

# path_searcher.toml
languages = ["Ja", "En"]
prefixes = ["natives/STM/"]
use_builtin_suffix_map = true

[suffix_map]
# extension = [version1, version2, ...]
gtex = [240701004, 241106030]

---

RE 引擎路径搜索器

用于从 RE Engine 游戏 PAK 文件和内存转储中提取文件路径的 Rust 工具。

致谢：本项目基于 mhrice 项目的部分代码修改而来，特此感谢原作者。

使用方法

如何获取 DMP 文件

1. 启动游戏，并停留在你想分析的状态。
2. 打开任务管理器。
3. 在“进程”或“详细信息”中找到游戏进程。
4. 右键该进程，选择“创建转储文件”。
5. 等待 Windows 写出完成后，把生成的 .dmp 文件传给 --dmp 即可。

# 从内存转储和PAK文件中提取路径
./ree-path-searcher.exe --dmp <memory_dump_file> --pak <pak_file_path>

# 多个PAK文件
./ree-path-searcher.exe --pak <pak_file_path_1> --pak <pak_file_path_2>
# 或输入一个列表文件，每行是一个PAK文件路径
./ree-path-searcher.exe --pak-list <pak_list_file>

# 添加参考路径列表（每行可以是 raw 路径或完整路径；会自动去掉 `natives/<PLATFORM>/` 头部以及类似 `.version(.platform)(.lang)` 的尾部，再按扫描同样的解析规则匹配并追加进 output.list）
./ree-path-searcher.exe --pak-list <pak_list_file> --ref-list <reference_list_file>

# 使用自定义解析配置（语言/前缀/后缀版本覆盖）
./ree-path-searcher.exe --config path_searcher.toml --pak <pak_file_path>

# 如果未指定 --config，会自动尝试加载当前目录下的 ./config.toml

作为库使用

如需作为库使用，请参考 src/main.rs 文件中的实现示例。

配置文件（TOML）

# path_searcher.toml
languages = ["Ja", "En"]
prefixes = ["natives/STM/"]
use_builtin_suffix_map = true

[suffix_map]
# 扩展名 = [版本1, 版本2, ...]
gtex = [240701004, 241106030]