运行作弊命令

《模拟人生4》运行作弊指令 MOD 使用指南
【核心介绍】
启动游戏时自动执行预设作弊指令（如 `testingcheats true`、`death.toggle false`），无需手动输入，支持多轮可靠加载。
【安装指南】
1. 必备前置依赖：本 MOD 安装前，需同步安装以下两个模组（缺一不可）：
• 「TS4-Library」（任选 NexusMods 或 GitHub 版本）
• 「Sims4CommunityLibrary（S4CL）」（任选 NexusMods 或 GitHub 版本）
2. 将下载的 ZIP 文件解压到《模拟人生4》根目录（即包含「Mods」文件夹的目录）；
3. 解压后将自动创建以下路径与文件：
• `/Mods/_o19_/run_cheat_commands.ts4script`
• `/Mods/_o19_/run_cheat_commands.package`
• `/mod_data/run_cheat_commands/commands.txt`
• `/mod_data/run_cheat_commands/commands.ini`
4. 确保《模拟人生4》启动器中已启用「脚本模组」和「自定义内容与模组」选项。
【功能详情】
✅ 已优化：
• 自动在加载屏幕出现时、家庭住户完全加载后各执行一次 `commands.txt` 中的指令，提升兼容性；
• 支持全部命令行类作弊指令（如 `s4clib.print_outfit`）；
• 通过 `commands.ini` 自动适配《模拟人生4》不同版本（含 TS4Lib/S4CL 双环境）。
❌ 未修改：
• 游戏内菜单中的作弊指令（如“开/关死亡”按钮）；
• 模拟人 ID 获取与跨模拟人遍历功能（如 `sims.get_sim_id_by_name` 的结果不可调用）。
✨ 额外调整：
• 日志文件 `/mod_logs/run_cheat_commands.txt` 仅在出错或警告时生成，不主动上传任何数据；
• 所有配置文件（`.txt`/`.ini`）均采用纯文本格式，可直接编辑。
【使用要求】
• 必须安装官方游戏《模拟人生4》；
• 必须安装「TS4-Library」与「Sims4CommunityLibrary（S4CL）」；
• 游戏版本需 ≥ 1.103.315（2023年12月版），推荐使用最新稳定版；
• 无需额外配置或注册，无硬件性能要求。
【兼容性说明】
• 兼容范围：所有启用 TS4Lib + S4CL 的《模拟人生4》正式版及后续更新（截至 2024 年主流版本）；
• 不兼容模组：无直接冲突模组；但若其他模组劫持或重写 `commands.txt` 加载逻辑，可能导致指令重复执行或失效；
• 兼容补丁：暂未推出专用补丁（当前机制已覆盖主流环境）。
【注意事项】
• 修改 `/mod_data/run_cheat_commands/commands.txt` 后，需重启游戏才能生效；
• 启用/禁用某条指令，请严格使用 “ 开头注释（如 ` death.toggle false` → 禁用；`death.toggle false` → 启用）；
• `toggle` 类指令（如 `death.toggle`）必须提供第二个参数（`true`/`false` 或 `on`/`off`），否则将被跳过；
• 日志文件中可能包含本地用户名（仅限 WARN/ERROR 场景），不涉及网络传输；
• 模组不支持模拟人 ID 的返回值调用，此为底层限制，非 BUG。
【更新日志】
2023 年 12 月 15 日首发正式版，适配《模拟人生4》1.103.315、S4CL 3.0、TS4Lib 0.1.8；
2024 年 3 月 10 日优化双阶段执行逻辑，提升 `s4clib.*` 类指令成功率。