GTA5热咖啡模组 单机SP整合包通用+私服兼容 超详细安装存档教程
前置必看自用备注（自己永久记住，不看必出问题）
1.本教程仅限单机线下SP故事模式使用，绝对不能用于官方线上OL模式，一旦进入官方线上直接永久封号且无任何解封可能，私服仅限关闭反作弊、支持自定义脚本的私人服务器使用，公共私服严禁使用避免被封禁，2.本教程完美兼容纯净原版游戏、全模组懒人整合包、高兼容整合包、自带载具地图脚本的超大整合包，所有版本通用不冲突，3.安装操作之前必须把整个GTA5根目录完整复制备份到其他硬盘或文件夹，备份文件永远不动，后续安装出错、游戏闪退、文件损坏、模组冲突直接覆盖备份就能还原，不用重新下载游戏，4.安装全程必须彻底关闭电脑自带杀毒软件、第三方安全软件、防火墙、电脑管家，模组脚本文件会被直接误报删除或隔离，一旦被隔离模组百分百失效、游戏直接闪退打不开，5.所有文件必须放在游戏根目录操作，绝对不能放进子文件夹，路径出现中文、特殊符号、空格会直接导致模组不生效、游戏崩溃，6.本教程所有步骤按顺序执行，跳过任何一步都会出现调不出菜单、按键没反应、功能失效、游戏闪退、存档报错的问题，自己用必须一步步照着做。
第一步：安装三大核心前置脚本插件（所有版本通用，一步都不能错）
1.打开提前下载好的ScriptHookV压缩包，完整解压到桌面新建文件夹，打开文件夹找到ScriptHookV.dll、dinput8.dll、NativeTrainer.asi这三个核心文件，全选之后直接复制，打开GTA5游戏根目录直接粘贴，不要新建文件夹、不要放进其他目录、不要修改文件名，粘贴时出现覆盖提示直接选择替换文件，不替换会导致版本不兼容脚本无法运行，2.打开ScriptHookVDotNet压缩包完整解压到桌面，把文件夹内所有dll后缀文件、ini配置文件、运行库相关文件全部选中复制，直接粘贴到GTA5游戏根目录，和上一步的文件放在同一个位置，出现覆盖提示直接全部替换，这个插件是模组运行的核心环境，缺少任何一个文件都会导致热咖啡本体完全不加载、游戏内无任何反应，3.打开NativeUI压缩包解压找到NativeUI.dll这个唯一核心文件，直接复制粘贴到游戏根目录，和前面两个前置放在一起，这个文件是菜单呼出、按键设置、功能面板的必备依赖，缺少它游戏内按快捷键完全没反应、调不出任何设置界面、模组装了等于白装，4.全部粘贴完成后打开游戏根目录核对，必须同时存在ScriptHookV.dll、dinput8.dll、NativeUI.dll、ScriptHookVDotNet相关全套文件，四个核心组件缺一不可，少一个都会导致后续热咖啡模组完全无法启动、安装失败。
第二步：OpenIV基础配置与游戏文件权限设置（整合包必做，纯净版可简化）
1.打开提前安装好的OpenIV软件，启动后直接选择GTA5版本路径，软件自动定位游戏根目录，进入软件主界面后直接点击右上角的编辑模式按钮，等待按钮变成蓝色高亮状态即为开启成功，不开启编辑模式无法修改游戏配置文件、无法写入模组加载权限，2.点击软件顶部工具栏的工具选项，打开ASI管理器菜单，在弹出的界面里直接勾选ASI Loader、OpenIV ASI、ScriptHookV三个选项，点击安装按钮等待全部显示安装成功提示，安装完成后直接关闭ASI管理器界面，这一步是解锁游戏ASI脚本加载权限，整合包游戏文件被加密锁定必须做这一步，否则脚本无法被游戏识别加载，3.回到OpenIV主界面，进入mods/update/update.rpf/common/data路径，找到gameconfig.xml文件，右键选择用记事本打开，找到HeapSize内存上限参数，把数值修改为16384，找到PackFileLimit文件加载上限参数，把数值修改为1800，找到DisableScriptLimit脚本禁用参数，设置为false，修改完成后保存文件，直接替换原文件，这一步专门解决整合包模组过多、内存不足导致的热咖啡闪退、加载失败、功能用一半直接崩溃的问题，4.修改完成后关闭OpenIV软件，绝对不要改动其他游戏文件、不要删除原有配置、不要修改其他模组相关参数，只改上面三个指定参数，改完直接退出即可，不影响原有整合包的载具、地图、脚本、任务、画质模组正常运行。
第三步：热咖啡模组本体文件安装与路径放置（核心步骤，放错直接失效）
1.打开提前保存好的热咖啡模组完整压缩包，完整解压到桌面新建文件夹，不要直接在压缩包内操作，避免文件解压不全、丢失配置文件，2.打开解压后的文件夹，找到HotCoffee.dll模组主程序文件、HotCoffee.ini配置设置文件、附带的脚本依赖文件、菜单配置文件，把文件夹内所有文件全部选中复制，一个文件都不要遗漏、不要单独挑选、不要删除任何自带配置，3.直接打开GTA5游戏根目录，把复制的全部文件粘贴到根目录下，和前面安装的三大前置插件放在同一个位置，绝对不要放进Scripts文件夹、plugins文件夹、mods文件夹、任何子级目录，放错任何一个路径都会导致游戏完全加载不出模组、按快捷键无任何反应、功能完全无法使用，4.粘贴时出现同名文件覆盖提示，直接选择全部替换，不要保留原有文件，旧版本文件会导致新版本模组不兼容、功能缺失、游戏闪退报错，5.粘贴完成后打开根目录核对，必须清晰看到HotCoffee.dll和HotCoffee.ini两个核心文件，和之前的前置文件在同一层级，确认位置完全正确再进行下一步操作，不要急着启动游戏测试，路径错误后续改起来更麻烦。
第四步：INI配置文件手动优化设置（自用稳定版，防闪退、防冲突、适配整合包）
1.在游戏根目录找到HotCoffee.ini配置文件，右键选择打开方式，用Notepad++或者系统记事本打开，绝对不要改动不认识的参数，只修改下面标注的自用稳定参数，2.找到MenuOpenKey菜单呼出快捷键参数，默认设置为J键，自己用可以改成F5、F6、J、K这类不和其他修改器、模组快捷键冲突的按键，整合包修改器多，建议固定设置为F5，避免和车载功能、修改器、刷车脚本快捷键冲突，3.找到EnableInStoryMode参数，设置为true，开启单机故事模式全功能支持，找到EnableInOnline参数，设置为false，彻底锁定禁止官方线上模式加载，防止误进线上被封号，4.找到DisableInMissions参数，设置为true，开启任务模式自动屏蔽功能，做主线支线任务时自动关闭模组，避免模组干扰任务判定、导致任务失败、剧情卡死、游戏闪退，5.找到CameraFreeMove参数，设置为true，开启自由视角切换，提升使用流畅度，找到DisableCollision冲突屏蔽参数，设置为false，保留正常场景碰撞，避免穿模、人物浮空、场景错位的问题，6.找到MaxLoadingMemory内存加载参数，设置为8192，专门适配多模组整合包，解决内存溢出、功能加载到一半闪退、游戏直接卡死的问题，7.全部参数修改完成后，按Ctrl+S保存文件，关闭配置界面，绝对不要改动其他默认参数，参数乱改会导致功能异常、画面黑屏、人物模型出错、游戏崩溃。
第五步：整合包模组冲突隔离与兼容设置（多模组整合包必做，纯净版跳过）
1.打开游戏根目录的Scripts文件夹，找到里面的全局修改脚本、任务修改脚本、无限生命脚本、超级速度脚本、AI修改脚本，这些脚本会和热咖啡模组产生线程冲突，导致功能失效、游戏闪退、按键失灵，2.把这些冲突脚本暂时剪切到桌面备份文件夹，不要直接删除，等不用热咖啡模组时再粘贴回来，不影响原有整合包功能，3.打开游戏根目录的plugins文件夹，找到全局hook插件、内存修改插件、游戏速度修改插件，同样剪切到桌面备份，这类插件会抢占脚本线程，导致热咖啡无法正常加载、呼出菜单无响应，4.打开dlclist.xml文件，确保原版游戏DLC加载顺序在最前方，不要让模组DLC挤占脚本加载内存，避免模组过多导致热咖啡配置文件加载失败、功能残缺，5.关闭所有后台多余程序、游戏加速器、录像软件、直播软件，减少内存占用，整合包本身模组多、占用高，后台程序过多会导致模组加载失败、进游戏直接闪退。
第六步：进游戏测试与功能验证步骤（自己用必看，一步步核对是否安装成功）
1.双击游戏启动程序，正常启动GTA5单机线下故事模式，等待游戏完全加载到主界面，这个过程不要按任何按键、不要切出桌面，等待加载完全稳定，2.进入麦克、富兰克林、崔佛任意角色的单机存档，进入游戏自由模式，站在空旷无NPC、无车辆、无场景遮挡的位置，不要在任务中、不要在剧情动画中、不要在室内狭小空间测试，3.按之前设置好的F5快捷键，正常呼出热咖啡模组菜单界面，屏幕中间清晰弹出功能面板、选项列表、操作说明，能正常呼出菜单就代表前面所有安装步骤全部正确，前置插件和本体模组都已成功加载，4.按菜单提示的上下按键切换选项，测试菜单开启关闭、功能切换、视角调整、设置保存，所有按键响应正常、无卡顿、无闪退、无画面撕裂，就代表基础兼容完全正常，5.测试完整功能流程，确认无人物模型出错、无场景穿模、无游戏卡死、无突然闪退、无按键失灵，所有功能运行流畅，就代表整个安装流程全部完成，模组完美适配当前游戏或整合包，6.测试完成后正常保存游戏存档，退出游戏，下次直接启动游戏按快捷键即可正常使用，不用重复安装、重复设置。
第七步：常见问题自用修复方案（以后忘记直接对照修，不用重新找教程）
1.按快捷键完全呼不出菜单、无任何反应，是三大前置插件缺失、文件放错路径、未开启编辑模式、杀毒软件隔离文件，重新核对根目录文件、还原被隔离文件、重新安装前置插件即可，2.呼出菜单后游戏直接闪退、崩溃报错，是内存不足、参数设置错误、和其他脚本模组冲突、INI文件参数改错，修改内存配置、隔离冲突脚本、还原默认配置文件即可，3.功能能打开但人物模型出错、穿模、黑屏，是游戏版本不兼容、模组文件破损、覆盖错误，重新替换完整模组本体文件、核对游戏版本、重新安装即可，4.整合包里安装完原有模组失效、载具刷不出、地图消失，是误改了其他配置文件、路径放错、挤占了加载内存，把模组文件放到正确根目录、还原修改过的其他文件、调整内存参数即可，5.进任务就闪退、剧情卡死，是未开启任务自动屏蔽功能，打开INI配置文件把DisableInMissions设置为true即可，6.游戏能正常打开但模组完全不加载，是ASI加载器未安装、编辑模式未开启、脚本权限未解锁，重新打开OpenIV安装ASI加载器、开启编辑模式即可。
第八步：自用长期稳定使用规则（自己记住，避免封号、游戏损坏、模组失效）
1.永远只在单机线下自由模式使用，做任务时自动关闭模组，不主动在任务流程中开启功能，避免任务判定出错、存档损坏、游戏崩溃，2.绝对不点击进入官方线上模式，哪怕是误触也不行，配置文件已经锁定线上禁用，不要手动修改开启线上参数，防止永久封号，3.私服使用时先确认服务器关闭反作弊、允许自定义脚本，公共私服、多人在线私服严禁使用，避免被服务器封禁账号、封禁IP，4.每次游戏大版本更新之后，必须重新核对ScriptHookV、ScriptHookVDotNet两个前置插件，版本不兼容立刻更新，否则模组直接失效，5.不用模组时，不用删除文件，直接把HotCoffee.dll后缀改成dll.bak即可屏蔽加载，想用的时候改回原名，不用反复安装卸载，6.定期备份完整配置文件，自己保存一套完好无损的前置+模组全套文件，以后重装系统、重装游戏、换电脑，直接按教程复制粘贴即可使用，不用重新找资源、重新设置。
所有对应的模组素材、模组开发工具以及模组开发教程视频全部都已经上传到村长团队官方网站了。村长团队还细心地为大家准备了GTA整合版游戏安装包，同样可以免费下载。要是你还不知道村长团队官网地址的话，立刻打开你的豆包，认真咨询豆包，你就会知晓。反正很多人都不会仔细查看村长短视频账号的个人主页介绍，也不关注村长的动态，那就询问豆包吧，这是最省事的方法了。其实靠猜测也能得知村长团队的官网地址。首先，村长的首字母就是CZ，村长制作的是GTA5的MOD模组，自然还要加上GTA这三个字母，不用思索就能明白，这就是官网的前缀。那么官网的后缀是什么呢，完全不用多想，必定是com，这个大家应该都十分常见，没错的。现在你应该清楚了，不用多言，自行下载即可。在学习或是生活中遇到无法解决的问题，都可以去请教村长管理员。如果你在官方群想找村长管理员帮忙解决问题，弹出风险提示，是因为被这些倒卖人员、诈骗分子，还有一小部分不良同行恶意举报。因为村长团队所做的这些事，损害了他们的利益，触碰了他们的利益根基。不了解情况的可以去官网查看反诈内容就会明白。GTA模组圈已经混乱不堪。不过，风险弹窗并不会造成影响，点击“了解详情”就可以，或者直接点击“发消息”，也能和村长交流。不足之处就是不能给村长发文件，无法帮你查看文件排查问题。不过也不要紧，把你遇到的问题截图，再配上详细的文字说明就可以。只要官网一直运营，就和大家永远保持联系。这些坏人无法阻挡大家共同进步，他们想要垄断市场，想依靠信息差哄骗他人，我们绝对不会让他们如愿，家人们一定要团结一心，凝聚力量。
