必须借助crossover创建专用容器并部署bepinex框架，再将汉化包放根目录、ui类mod放plugins子目录，配置version.dll为原生函数库，启动taiwu.exe -console验证加载日志及bepinex图标。
要在Mac上运行《太吾绘卷》并成功加载汉化、UI优化、存档管理等各类辅助Mod，必须借助CrossOver创建兼容Windows的运行环境，并正确部署BepInEx框架与Mod文件结构。直接双击游戏exe会闪退，不配置函数库会导致MelonLoader或BepInEx无法注入，所有Mod都处于静默失效状态。
安装CrossOver并创建专用容器
前往CrossOver中文官网下载v26.3.0正式版（支持macOS 12～15，含M系列芯片原生适配）。安装完成后启动CrossOver，点击左下角“安装 Windows 软件”，在搜索框输入“Steam”，选择官方Steam安装包执行安装流程。这一步不能跳过——用CrossOver直接装Steam，比手动拖入已有的Steam.exe更稳定，能自动处理.NET依赖和注册表钩子。
安装完毕后，双击打开Steam客户端，在库中添加《太吾绘卷》（需提前在Steam购买）。右键游戏→属性→本地文件→浏览本地文件，记下游戏根目录路径，形如：drive_c/Program Files (x86)/Steam/steamapps/common/TAIWU。
【关键前提】务必为《太吾绘卷》单独新建一个容器，不要复用其他游戏的容器。CrossOver容器之间互不干扰，混用可能导致dll冲突或函数库覆盖，后续Mod加载失败时难以排查。
部署BepInEx前置框架
访问Thunderstore.io的太吾绘卷专区（https://www.php.cn/link/9d0b0e0078685fb5243931357f9a8774），搜索并下载最新版BepInExPack（注意选标有“for Taiwu”的版本，非通用版）。解压后进入BepInExPack文件夹，只复制以下4个内容：BepInEx、doorstop_config.ini、doorstop_version.dll、winhttp.dll。
打开CrossOver→选中你的TAIWU容器→点击“打开C盘”→导航至游戏根目录（即上面记下的TAIWU文件夹）→将刚复制的4个文件全部粘贴进去。此时根目录下应出现BepInEx文件夹及两个dll文件。
这一步完成后，游戏启动时会自动加载BepInEx控制台。如果没看到黑窗弹出，说明路径错误或容器未指向该目录。
安装辅助Mod（以汉化+UI优化为例）
方法一：汉化Mod（必须放根目录）
在Thunderstore下载“Taiwu Chinese Localization”汉化包，解压后得到BepInEx、CHANGELOG.md、icon.png、manifest.json、README.md共5个文件/文件夹。全部复制→粘贴进TAIWU游戏根目录，**选择“合并”而非“替换”**。若系统提示“是否替换BepInEx文件夹”，点“合并”——因为汉化包里的BepInEx是精简版，覆盖会破坏前置框架。
方法二：UI优化类Mod（放plugins子目录）
下载“Taiwu UI Resizer”或“Quick Save Manager”等插件，解压后通常是一个独立文件夹（如TaiwuUIResizer）。将其整个文件夹拖入：TAIWU/BepInEx/plugins/。注意路径必须是plugins下的一级子文件夹，不能嵌套进二级目录，否则BepInEx扫描不到。
方法三：存档工具类Mod（部分需额外注册）
如“Taiwu Save Editor”，除放入plugins外，还需确认其依赖项是否已安装。常见依赖包括HarmonyX、UnityEngine.UI等，这些需从Thunderstore单独下载并同样放入plugins。缺失依赖会导致游戏启动卡在Logo界面，日志里报错“Could not resolve type”。
启用Mod并验证加载状态
第一步：配置Wine函数库
CrossOver中选中TAIWU容器→点击“Wine配置”→切换到“函数库”标签页→在空白处点击“添加”→输入version.dll→点击右侧下拉菜单选择“原生（内置）”→确定保存。这一步是让MelonLoader能正确挂钩Windows版本API，否则Mod入口函数无法被识别。
第二步：启动游戏并检查控制台输出
回到CrossOver主界面，右键TAIWU容器→“运行命令”→输入：TAIWU.exe -console→回车。游戏启动后会弹出黑色控制台窗口，滚动日志中若出现[BepInEx] Loading plugins...及后续列出各Mod名称（如“TaiwuUIResizer v1.2.0 loaded”），说明加载成功。
第三步：进游戏界面验证
进入游戏主界面，左上角应出现BepInEx图标（齿轮状），按Ctrl+Shift+Alt+P可呼出Mod管理面板，已启用的辅助Mod会显示绿色对勾。若汉化未生效，检查根目录下是否有Localization文件夹且内部语言文件未被误删；若UI缩放无效，确认plugins内Mod文件夹名不含空格或中文字符。
第四步：快速定位错误日志
若控制台报错Failed to load plugin: xxx.dll，立即前往TAIWU/BepInEx/LogOutput.log末尾查看详细堆栈。90%的情况是dll依赖缺失或.NET版本不匹配，此时需回到Thunderstore下载对应Runtime包补全。
