tmodloader是mac上运行泰拉瑞亚灾厄模组的唯一官方认证方案，需macos≥10.13、内存≥8gb、steam版泰拉瑞亚已安装并启动过；安装后启用opengl后端，再通过模组浏览器一键安装calamity mod及其依赖thorium mod和magic storage，新建专家/大师模式世界即可验证生效。
想在Mac上玩泰拉瑞亚并加载灾厄模组（Calamity Mod）这类大型扩展模组，必须先让游戏支持模组——原版泰拉瑞亚macOS版本默认不兼容任何第三方模组，【tModLoader是唯一官方认证且稳定运行的解决方案】。它不是补丁也不是破解工具，而是独立构建的模组专用运行环境，能完整保留你的原版存档，同时支持多模组协同加载。
确认基础环境是否达标
打开“关于本机”→“系统报告”，核对以下三项：
① macOS版本 ≥ 10.13（High Sierra）；
② 内存 ≥ 8GB（灾厄模组单独占用约1.2GB内存，叠加其他模组极易触发崩溃）；
③ 泰拉瑞亚已通过Steam或GOG安装并至少成功启动过一次——这步不可跳过，否则tModLoader无法识别游戏路径。
若未安装泰拉瑞亚，请先从Steam库中安装，不要使用App Store版本，【App Store版与tModLoader完全不兼容】。
下载并安装tModLoader
打开终端（Finder→应用程序→实用工具→终端），逐行执行：
git clone https://gitcode.com/gh_mirrors/tm/tModLoader
cd tModLoader
chmod +x setup-cli.sh
./setup-cli.sh
脚本运行时会自动检测.NET SDK、Git和Steam路径。如果提示“dotnet command not found”，说明缺少运行时——访问https://dotnet.microsoft.com/download/dotnet/6.0 下载并安装“macOS x64 Runtime”。安装完成后关闭终端重新打开再执行最后一步。
配置模组运行环境
启动泰拉瑞亚（不是原版图标，而是新出现的“tModLoader”独立应用图标）→ 首次运行会弹出向导：
第一步：语言选“简体中文”；
第二步：路径设置保持默认，即指向Steam中的泰拉瑞亚安装目录（通常为 ~/Library/Application Support/Steam/steamapps/common/Terraria）；
第三步：勾选“启用实验性OpenGL后端”——【这是macOS上避免黑屏的关键选项，不勾选可能导致主菜单无法渲染】；
点击“完成”，等待组件下载完毕，自动退出。
安装灾厄模组（Calamity Mod）及依赖
方法一：模组浏览器一键安装（推荐新手）
启动tModLoader → 主菜单点“模组” → “浏览模组” → 搜索栏输入“Calamity” → 找到官方发布条目（作者名显示“CalamityMod”）→ 点击“安装” → 安装完成后回到“已安装”页，勾选启用 → 重启游戏。
方法二：手动安装（适合网络不稳定或需指定版本）
访问 calamitymod.net → 下载最新.tmod文件（注意选macOS兼容版，文件名含“macos”或“universal”）→ 打开访达，按Cmd+Shift+G，输入 ~/Library/Application Support/Terraria/Mods → 将下载的.tmod文件拖入该文件夹 → 启动tModLoader，在模组管理界面启用它。
注意：灾厄模组强制依赖“Thorium Mod”（钍模组）和“Magic Storage”（魔法存储），浏览器安装会自动补全，但手动安装时必须先放入这两个依赖模组文件，否则游戏启动直接报错退出。
启动并验证大型模组运行
启动tModLoader → 新建一个世界（务必选“专家模式”或“大师模式”，灾厄内容在普通难度下几乎不生成）→ 进入世界后按Esc打开菜单 → 点击“模组”→“已启用模组”，确认Calamity Mod、Thorium Mod、Magic Storage三者状态均为绿色“已启用”；
此时打开背包，应能看到灾厄专属物品栏（右下角新增紫色标签）；
挖穿地下丛林后，地面会出现发光的“深渊裂隙”，这就是灾厄模组激活成功的视觉标志——不需要打BOSS，裂隙本身即证明大型模组已正确注入并实时生效。
