自定义模组

创作者: Shigure330

已更新:2025-08-01 07:12:25

10.4MB

关于此 MOD

配置编辑器，可编辑大多数简单值、Tmap 和数组

🛠️ UE4SS 自定义模组 - 使用指南

📘 总览
此模组是一组用于UE4SS（虚幻引擎4脚本系统）的Lua脚本，可让你导出、编辑并重新导入《幻兽帕鲁》及同类游戏的虚幻引擎对象属性（包括数组和映射表）。
专为高级模组制作、调试及数据操作而设计。

✨ 游戏特色

将指定类的所有属性导出为Lua文件（包括数组和映射）
编辑导出的文件以修改数值，然后将其重新导入游戏。
可通过 config.lua 进行配置（包括职业列表、属性键、最大迭代次数等）
🛡️ 处理不可访问值，防止无限循环
🌍 仅限国际使用的英文日志与评论
📦 按职业分组的数组与映射导出/导入

📁 文件结构

main.lua — 主入口，统一调度导出/导入与管线流程
🧩 config/config.lua — 全局配置（职业、路径、筛选等）
📤 export/runtime_export.lua — 为每个类导出基础属性
📤 import/runtime_import.lua — 为每个类导入基础属性
🗺️ export/runtime_export_map.lua — 导出地图（TMap）属性
🗺️ import/runtime_import_map.lua — 导入地图属性
📥 export/runtime_export_array.lua — 导出数组属性
📥 import/runtime_import_array.lua — 导入数组属性
🧹 export/clean_dump_clean.lua — 清理转储文件
📂 output/ — 包含生成的导出文件

编辑模式切换
`启用编辑`进入选项`config/config.lua控制模组是否应用修改，或仅导出数据。

✅ 当 enable_edit = true 时：
✔️ 从已编辑的导出文件中导入数值，并在运行时应用。
⚠️ 在编辑前，请先设置 `enable_edit = false` 并运行一次以生成导出文件！

当 enable_edit = false 时：
🔍 仅导出数据与日志信息，不对游戏进行任何修改。
💡 用于安全检视或调试。

🚀 设置与使用

在 `config/config.lua` 中配置你的职业与设置
启动游戏时需启用UE4SS及本模组
📊 此模组将：
- ⏳ 等待游戏准备就绪
- 🧼 运行管线以清理并导出属性
- 📤 导出全部属性、数组与映射
- 将保存结果输出至 `output/` 文件夹（每职业一文件）
根据需要编辑导出的文件
🔁 重启游戏或触发导入钩子以应用更改

注意：导入触发器包括重启客户端或连接至服务器（含本地游戏）。

📄 导出文件类型

简单属性
📄 `output/array/_array_export.lua` — 数组属性
`output/map/_map_export.lua` — 地图（TMap）属性

📥 导入逻辑

✅ 仅处理非空导出文件
🚫 无效或无法访问的值将被忽略
🔁 数组与地图使用类型检查
🧾 日志与错误信息为英文（`UE4SS.log`）

🧠 高级

🧹 管线清理：使用 `clean_dump_clean.lua` 清除空条目
🐞 调试信息：日志已通过 `debug/logger.lua` 保存
🔄 钩子：玩家持有并重启时自动导入
🧪 手动导入：可直接调用导入脚本

📋 要求

📦 UE4SS 已安装并正常运行
✅ 已正确配置 `config.lua`

🛠️ 故障排除

❓ “未找到对象”或“属性被忽略” → 请检查 `config.lua` 中类名和属性键是否正确定义。
📭 导出文件为空 确保管线执行成功，且目标游戏对象在运行时存在。
🔒 不可访问的值 部分属性因UE4SS或虚幻引擎限制而受限。
💥 游戏或服务器崩溃了？ 这通常表示脚本试图读取当前无法访问的属性。
🧾 查看 `debug.log`，确认最后成功读取的属性。🧼 然后，打开 `dump_clean.lua` 或 `Dump_clean_cleaned.lua`，找到最后一个正常属性后的下一个属性。将那条属性添加到 `config.lua` 的 `ignored_property_names` 列表中，后续运行时即可跳过。📌 收到，请提供需要翻译的文本内容。 `PalGameSetting` 中的 `MaxWorldDataNumMap` 是字符串键映射（非整数键），当前不支持该配置，请忽略此项。