罪恶都市 IFP 动作名编辑器

版本 1.2 ｜ 免安装单文件 ｜ Windows 64 位

一个用来查看、修改和整理《侠盗猎车手：罪恶都市》IFP 动画文件的可视化小工具。 不用记十六进制偏移，不用碰十六进制编辑器，打开文件就能看到里面每一个动作的名字、 骨骼数量、关键帧、数据大小和文件位置；改名字、复制动作、删除动作、改源名称， 点几下就能完成。

一、这是什么

IFP 是 GTA 系列存放人物/车辆动画的文件格式，罪恶都市把它打包在 gta3.img 里 （ped.ifp、各种武器和车辆动画都在这类文件里）。每个 IFP 里装着若干个 「动作」，每个动作有一个内部名称——游戏、CLEO 脚本、任务代码全部靠这个名字来找动画。

这个工具做的事情就是：把那些内部名称显示出来，并让你安全地改名、复制、删除。

它适合这些场景：

• 整理/汉化素材时，想把 abseil 这类名字改成自己能看懂的名字
• 做 MOD 时替换了动画，想给新动画起一个和脚本对得上的名字
• 想让同一个动画在文件里存在两份（分别改名后给不同场合用）
• 想删掉用不到的动画，给文件瘦身
• 排查「脚本调用动画没反应」的问题，先确认文件里到底有没有这个动作名
• 想看看某个 IFP 的骨骼结构和关键帧规模，作为制作参考

二、主要功能

三、运行环境

四、下载与启动

1. 下载 IFP动作名编辑器.exe
2. 放到任意目录（桌面、U 盘、移动硬盘都行），双击运行
3. 程序不会安装任何东西，也不写注册表；删除 exe 就等于卸载

小技巧：可以直接把 .ifp 文件拖到 exe 图标上，程序会自动打开该文件。

首次运行如果出现 Windows SmartScreen 的「已保护你的电脑」提示， 点「更多信息」→「仍要运行」即可。这是因为程序没有购买数字签名证书， 属于常见现象，不是文件损坏。

五、快速上手

1. 打开文件

点左上角 「打开 IFP」（或按 Ctrl+O），选择要修改的 .ifp。

2. 找到要改的动作

在左边列表里浏览，或者在上方的查找框输入关键字筛选。 点表头（序号/动作名/骨骼/最大帧/数据大小/文件偏移）可以排序，再点一次反向排序。

3. 改名

选中一行后，用下面任意一种方式打开改名对话框：

• 点工具栏 「修改动作名」
• 按 F2
• 双击这一行
• 右键 → 修改动作名

对话框会实时告诉你：名称是否合法、长度是多少字节、文件大小会变化多少、是否和已有动作重名。 确认后，这一行会变成橙色，标题栏出现 *——此时修改还只在内存里。

4. 复制动作（把一个动作变成两个）

选中要复制的动作，点 「复制动作」（或按 Ctrl+D、右键 → 复制这个动作）。

工具会自动填一个不重名的新名字（例如 batherscape_copy），确认后：

• 副本插在原动作后面，骨骼、关键帧与原动作完全一致
• 副本那一行显示为绿色，文件偏移显示「待写入」（保存后才有真实位置）

副本必须换一个名字：两个同名动作在游戏里通常只会被认到其中一个。

5. 删除动作

选中不要的动作，点 「删除动作」（或按 Delete、右键 → 删除这个动作）， 确认后该行消失，后面的动作会整体前移并重新编号。

删除只是从内存列表里拿掉，点「撤销」就能找回来；写进文件要等你保存。 至少要保留一个动作，不允许把文件删空。

6. 保存

点 「保存」（Ctrl+S）写回原文件，程序会先列出这次要写入的改动让你确认， 并在第一次覆盖前把原文件备份成 xxx.ifp.bak。

不想覆盖原文件就用 「另存为」（Ctrl+Shift+S）。

7. 让游戏用上新内容

改完只是文件里的内容变了，游戏和脚本都要按新名字来找这个动画：

• 把改好的 IFP 放回原来的位置（替换 gta3.img 里的同名文件，或用外部 IFP 加载方式）
• 脚本里调用动画的地方改用新名字
• 如果用了带缓存的插件/外挂，重启游戏或清掉它的缓存后再测试

六、界面说明

快捷键

七、使用须知

关于名字长度 游戏内部用 char[24] 保存动作名（含结尾 \0 共 24 字节），所以建议不超过 23 个字符。 超过时程序会给出橙色警告但仍然允许保存——文件本身是合法的，只是游戏内有被截断的风险。 超过 63 个字符会被直接拒绝。

关于字符 动作名只能使用西欧字符（latin-1），不能输入中文；名称不能为空，也不能包含空字节。

关于重名 程序允许改成和已有动作相同的名字，但会提醒你：游戏按名字查找时通常只会命中其中一个， 建议保持唯一。

关于文件安全 保存时只重写必要的内容：每个动作的名称块、因长度变化而需要更新的内部偏移， 以及你新增/删除的动作本身。骨骼名和全部关键帧数据都是从原文件整段原样搬运的， 不会被重新编码或压缩。程序在保存前后都会自动解析一遍文件做校验。

关于备份 在同一个文件上连续保存不会反复生成备份——.bak 只在第一次覆盖时创建， 以免把你最早的原始文件覆盖掉。想重新生成备份，先手动删掉旧的 .bak 即可。

八、常见问题

Q：改了名字、复制或删除动作，会不会把动画弄坏？

不会。动作名和动画数据是分开存放的，程序在保存时会重新计算所有内部偏移， 保存后还会自动重新解析一次文件做校验。这是内置的自检，不需要你手动验证。

Q：复制出来的动作和原来的一模一样吗？

骨骼、关键帧、帧数、播放数据完全相同，只有名字不同。代价是文件会变大—— 副本会实实在在地多占一份动画数据的体积（工具会告诉你大概多大）。

Q：删除动作会让游戏出问题吗？

游戏和脚本通常是按名字找动画的，所以删掉用不到的动作一般没问题。 但如果删掉了某个脚本还在调用的名字，那段脚本就会失效； 另外删除会让后面的动作序号整体前移，万一有依赖「第几个动作」的地方，需要你自己确认。

Q：支持圣安地列斯（SA）吗？

暂不支持。SA 用的是另一种 IFP 结构，本工具打开时会明确提示「检测到 SA 的 IFP 文件」， 不会误改你的文件。

Q：能改骨骼名吗？

目前只支持查看骨骼明细，不能修改。骨骼名改动会牵动多层结构大小字段，风险更高， 所以没有开放。

Q：能批量改名或批量删除吗？

可以先用关键字筛选出目标动作，再逐个操作；也可以把动作名列表导出成 CSV 对照。 程序暂不提供「一键批量替换」功能。

Q：源名称（ped 这种）改了会影响游戏吗？

源名称只是 IFP 的内部标识，一般不影响加载。不确定时不要改它即可。

Q：为什么我改完名游戏里没反应？

先确认三件事：① 改好的 IFP 是否已经放回游戏读取的位置；② 脚本里是否已经改成新名字； ③ 是否还有缓存（重启游戏，或清理相关插件的缓存目录）。

Q：杀毒软件报警怎么办？

这是没有数字签名的个人工具常见的误报。可以在杀软里把它加入信任列表， 或者直接用源码运行（python ifp_editor.py）。

Q：能在别的系统上用吗？

目前只提供 Windows 64 位版本。源码是纯 Python + tkinter 写的，理论上 Linux/macOS 装了 Python 也能运行，但没有做过测试。

九、更新日志

v1.2

• 新增复制动作：把一个动作复制成两份，副本内容与原动作完全一致，自动建议不重名的名称
• 新增删除动作：删掉不需要的动作，后面的动作自动前移补位并重新编号
• 撤销升级：改名、复制、删除、源名称全部可以逐步撤销
• 保存前的改动清单会逐条列出新增 / 删除 / 改名的内容

v1.1

• 主界面与「关于」加入 gtamodx logo 与作者信息
• 新增「查看在线说明」入口（https://gtamodx.com/mods/ifp-tools）
• 优化信息面板在高分屏下的排版，长数值不再挤压其它字段

v1.0

• 首个版本：打开/解析 IFP、动作总览与筛选排序、动作详情与骨骼明细、 原始字节查看、动作名与源名称修改、撤销与还原、保存备份、导出 CSV

十、关于与反馈

• 作者：deepseek、狂风晨
• 官网：https://gtamodx.com
• 在线说明：https://gtamodx.com/mods/ifp-tools

使用中遇到问题、发现改不动的文件、或者想要新功能，欢迎到官网留言反馈， 附上你用的 IFP（如果方便的话）会更好定位问题。

十一、免责声明

本工具只对你自己选择打开的文件进行读写，不会主动修改游戏目录下的任何内容。 修改游戏文件前请自行备份原文件；因使用本工具造成的存档、游戏或数据损失， 作者不承担责任。请勿将本工具及修改后的文件用于商业用途或侵犯他人版权的行为。