[圣安地列斯CLEO]建筑破坏ASI

# SA Destruction v3.6.2 适用于《侠盗猎车手：圣安地列斯》
这是一款给圣安地列斯制作的可破坏环境模组，效果风格参考《红色派系》的Geo-Mod地形破坏系统。
游戏内所有爆炸——手雷、火箭、遥控炸药、载具爆炸，都会在原版地图上炸出真实的弹坑。薄屋顶、墙体、桥面板都可以被炸开，多个弹坑相连能形成地道，树木与路灯也可以被炸倒。画面模型和碰撞体积会同步改动，你可以穿过被炸毁的区域，在里面行走、开车、射击。

重要前置要求：**美版1.0版GTA圣安地列斯**（Steam版、R星平台版、1.01、3.0版本都需要降级），并且需要ASI加载器，例如 Silent’s ASI Loader 或者 Ultimate ASI Loader；ModLoader为可选。

## 功能特性
– 任何爆炸都会生成弹坑，同一位置多次爆炸会越炸越深
– 可炸毁屋顶、墙体、桥面板
– 弹坑连通后可以形成地道
– 树木、路灯能够被炸倒
– 模型与碰撞体同步修改
– 不会替换、修改任何原版游戏文件

## 按键操作
– F8：重置所有破坏效果；弹坑、深坑、地道全部复原，损毁物体、树木、路灯恢复原状；如果你正站在弹坑内，会被传送到复原后的地面上
– F7：树木、路灯倒塌效果 开启/关闭

## 注意事项
– 仅室外场景支持破坏，室内场景无法破坏
– 弹坑不会保存到存档；你远离的区域，在游戏重新加载时会恢复原样
– 空心外壳类建筑无法炸开，墙体后方没有可通行空间
– 同一个物体反复爆破会达到模型尺寸上限，之后的爆炸不再产生破坏（详情查看日志），按F8即可解除该限制
– F8最多复原512个被改动的物体，超出数量的部分需要游戏重新加载区域才会复原
– 处在弹坑内的其他载具、行人，按下F8重置地形时不会自动移位

[https://libertycity.net/pro/?from=adslot](https://libertycity.net/pro/?from=adslot)

## 兼容性
– 原版地图可正常使用；使用常规静态场景模型的地图模组理论兼容，但未经过测试
– **不支持SA-MP、MTA联机**：破坏效果仅在本机生效
– 其他在游戏主循环同一位置挂载钩子的ASI模组，可以和本模组共存运行

## 安装方法
– 使用ModLoader（推荐）：把 `SADestruction.asi` 复制到 `modloader\SA Destruction` 文件夹内
– 不使用ModLoader：把 `SADestruction.asi` 放到游戏根目录或者 scripts 文件夹

卸载：直接删除 `SADestruction.asi` 和同目录下的 `SADestruction.log` 即可。游玩不需要 source 源码文件夹。

如果模组无法正常工作，请查看asi同目录下的 `SADestruction.log`：
没有日志文件 = 缺少ASI加载器，或者文件放错目录；
日志出现 `HOOK FAILED` = `gta_sa.exe` 不是美版1.0；
某个位置炸不出弹坑，日志会记录每一次爆炸失败的原因。反馈问题时，请附上日志文件和截图。

## 更新内容
3.6.2：F8现在重置全部破坏效果，不再生成测试弹坑
3.6.1：修复载具爆炸时反而凸起土堆、无法生成弹坑的bug
3.6：新增功能：可炸穿屋顶、墙体、桥面板，支持地道效果，树木路灯可被炸倒

完整的C语言源码放在source文件夹，test文件夹内是模组逻辑的测试程序。
在甘特桥旁引爆遥控炸药，亲眼见证圣安地列斯的世界里留下真实的弹坑！

# SA DESTRUCTION v3.6.2
=====================
《圣安地列斯》可破坏地形模组，风格参考《红色派系》的Geo-Mod地形破坏系统。

游戏里所有爆炸效果——手雷、火箭、遥控炸药、载具爆炸——都会在原生地图上炸出真实弹坑。薄屋顶、墙体、桥面板都可以被炸开；多个弹坑相连还能形成地道；树木、路灯可以被炸倒。**可视地形和碰撞体都会同步改动**，炸开的缺口你可以直接步行、开车、穿过去射击。

## 运行要求
————
– PC版《GTA圣安地列斯》，`gta_sa.exe` 为美版1.0版本
（Steam版、R星启动器版、1.01版、3.0版都需要降级到美版1.0。如果exe版本不符，模组会自动关闭，并在日志里提示。）
– ASI加载器（例如 Silent ASI Loader 或者 Ultimate ASI Loader）
– 可选：Mod Loader模组加载器

## 安装
————
### 使用Mod Loader（推荐）
将 `SADestruction.asi` 复制到：`<游戏目录>\modloader\SA Destruction\`

### 不使用Mod Loader
将 `SADestruction.asi` 复制到：`<游戏目录>\` 或者 `<游戏目录>\scripts\`

安装到此完成，不会替换、修改任何原版游戏文件。
`source` 源码文件夹**游玩不需要**。

## 卸载
———
删除 `SADestruction.asi` 以及同目录下生成的 `SADestruction.log` 文件即可，不会残留其他改动。

## 快捷键
—-
**F8** 重置：清除全部弹坑、破洞、地道；被摧毁的物体、被炸倒的树木/路灯全部复原。如果你站在弹坑里，会被传送回复原后的地面上方。
**F7** 树木、路灯倒塌效果 开启/关闭

## 注意事项
————
– 仅室外地图支持破坏，室内场景（Interior）无法破坏。
– 破坏效果**不是永久保存**：弹坑不会写入存档；你离开很远的区域后，该区域重新加载时会恢复原样。
– 第一次爆炸会炸出浅坑；同一位置多次爆炸会越炸越深；薄壁、屋顶、桥板这类薄结构可以直接炸穿。
– 空心壳子类建筑无法炸开：墙体背后没有可通行空间。
– 同一个位置反复爆破会达到游戏模型上限，之后再爆炸不会继续破坏（日志会记录提示），按F8重置即可解除限制。
– F8最多复原512个改动对象；超过数量上限后，超出部分只能等待区域重新加载才会复原。
– 站在弹坑内的行人、载具，按下F8重置地形时**不会自动抬起来**。

## 兼容性
————-
– 原生地图完全可用；地图MOD只要使用常规静态世界模型理论上可以兼容，但没有经过测试。
– **不支持SA-MP / MTA联机**：地形破坏效果只在你本机生效，其他玩家看不到。
– 和其他钩子游戏主循环的ASI模组为链式调用，不会互相覆盖。

## 故障排查
—————
模组会在asi同目录生成 `SADestruction.log` 日志文件。
– 完全没有日志文件：缺少ASI加载器，或者asi放错文件夹
– 日志里出现 `HOOK FAILED`：`gta_sa.exe` 不是美版1.0
– 某个位置炸不出弹坑：日志会写明这次爆炸无法生成坑洞的具体原因

反馈问题时，请附上 `SADestruction.log` 和截图。

## 更新日志
———
3.6.2：F8现在可以重置全部内容（弹坑、破洞、地道、损毁/倒塌物体），旧版本只是生成测试坑
3.6.1：修复BUG：载具爆炸偶尔会凸起土堆，而不是炸出坑（反向弹坑问题）
3.6：新增：可炸穿屋顶、墙体、桥面板，支持连通地道；树木、路灯可被炸倒

## 源代码
———–
完整源码放在 `source` 文件夹（纯C语言，不依赖运行库）
编译命令：`sh build.sh`（clang + lld，LLVM18，编译输出 SADestruction.asi）
`test` 文件夹是离线测试程序，在模拟游戏内存环境下测试模组逻辑。