Dalamud 完全指南:FFXIV 插件框架如何打通游戏数据、界面覆盖与原生 Hook

发布时间:2026/10/24 2:14:39
Dalamud 完全指南:FFXIV 插件框架如何打通游戏数据、界面覆盖与原生 Hook Dalamud 完全指南FFXIV 插件框架如何打通游戏数据、界面覆盖与原生 Hook【免费下载链接】DalamudFFXIV plugin framework and API项目地址: https://gitcode.com/GitHub_Trending/da/DalamudDalamud 是《最终幻想XIV》FFXIV的插件开发框架核心能力是让第三方插件读游戏数据、Hook 游戏原生函数、在游戏画面上叠加自定义界面。如果你是想找插件用的玩家或是想给 FFXIV 写第一个插件的开发者这一篇就是入口。Dalamud 是什么FFXIV 插件框架的定位一句话输入是一个实现了IDalamudPlugin接口的 C# 插件程序集输出是在游戏进程内运行的代码可以访问游戏内数据、注册/控制台命令、绘制悬浮层。与只做界面美化的工具不同它提供的是完整的游戏互操作层Excel 表格数据、内存签名扫描、函数 Hook、聊天与事件流插件拿到的不只是画布而是游戏本身。README.md 里对它的定义是“提供游戏数据访问与原生互操作的插件开发框架”。四个核心能力从数据访问到插件管理直接读取游戏 Excel 数据插件通过IDataManager拿到 Lumina 的ExcelModule按行类型读取游戏内任意数据表不解析内存、不改文件。接口定义见 IDataManager.cs注释里明确写着插件可以按需使用。用内存签名扫描定位游戏函数SigScanner.cs 按字节签名在游戏主模块里搜索函数地址并把结果缓存到cachedSigs目录二次启动直接读缓存。这是框架跟游戏版本“赛跑”的机制客户端更新后签名失效重新扫描即可。在游戏画面上绘制覆盖层与完整窗口界面层基于 ImGui绑定代码在 imgui/Dalamud.Bindings.ImGui/ 目录包含两百多个生成的绑定文件。框架自身的窗口也是用同一套画的比如插件安装器、控制台、性能分析窗口都在 Dalamud/Interface/Internal/Windows/ 下可以直接当用法参考。插件生态加载、进程内通信与自动更新统一的能力出口是 Dalamud/Plugin/Services/ 下的四十多个服务接口客户端状态、物品栏、小地图、通知等插件之间调用走 Dalamud/Plugin/Ipc/ 的进程内 IPC互不直接引用程序集。PluginListInvalidationKind.cs 把列表变更分成加载、卸载、手动更新、自动更新四种更新逻辑是框架内建而不是插件各管各的。它怎么跑起来从注入到插件框架的三层按 README.md 里的组件表启动是一条固定流水线Dalamud.InjectorC#对目标进程做 DLL 注入 →Dalamud.BootC把 .NET 运行时加载进游戏进程或者改写进程入口点来完成同样的事 →DalamudC#核心框架接管逐个加载已安装插件。另外还有一个独立的 DalamudCrashHandler/ 崩溃处理进程负责异常时的信息收集。玩家不需要关心这条链它由启动器统一驱动。一个完整场景把游戏数据做成画面上的悬浮层背景你在副本里想实时看某项数据比如队伍成员状态不想反复打开系统界面。操作新建插件实现IAsyncDalamudPlugin在LoadAsync里从IDalamudPluginInterface取到IDataManager读目标 Excel 表再用UiBuilder注册每帧绘制回调在画面上画一个小窗口。结果悬浮层随游戏帧同频刷新数据直接来自游戏本地文件客户端更新后内容自然同步不需要插件自己去抓内存。上手指南从零到第一个插件的 4 步普通玩家路线安装 XIVLauncher官方推荐的唯一入口它负责 Dalamud 的依赖管理与加载进游戏后打开插件安装器框架内置窗口搜索并安装目标插件启动游戏插件自动加载无需手动干预开发者路线git clone https://gitcode.com/GitHub_Trending/da/Dalamud之后在 Windows 下运行仓库根目录的generate.cmd生成 CMake/Visual Studio 工程SDK 版本由 global.json 锁定为 .NET 10.0.0允许小版本向上滚动。文档入口README.md 的“Plugin development”一节、docs/index.html指向官方 API 文档站、index.md 的 API 说明索引。开始之前要知道的边界仅支持 Windows 上的 FFXIV核心项目标记了EnableWindowsTargeting框架版本跟随游戏客户端签名与地址解析依赖具体版本号当前核心版本见 Dalamud/Dalamud.csproj 中的DalamudVersion许可证为 AGPL-3.0-or-later闭源分发受限官方 README 建议不要脱离 XIVLauncher 手动运行框架依赖管理容易出坑仓库声明不接受生成式 AI 撰写的贡献提 PR 前注意下一步做什么玩家装好 XIVLauncher进游戏打开插件安装器按需求搜索安装。开发者克隆仓库、读一遍官方 API 文档然后用IAsyncDalamudPluginIDataManager写出第一个最小插件从只读一张 Excel 表开始。【免费下载链接】DalamudFFXIV plugin framework and API项目地址: https://gitcode.com/GitHub_Trending/da/Dalamud创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

关于本文作者

来自尧图内容编辑团队

尧图内容编辑团队 内容团队

尧图内容编辑团队

本文由尧图网络内容编辑团队执笔。团队由资深项目经理、前端工程师与设计师组成,所有内容均来自亲手交付的真实项目,先讲清问题、再给出可落地的解法。尧图深耕北京网站建设十年,服务过京华建材集团、智造科技等各行业客户,把一线经验沉淀为可复用的行业观察。

  • 十年建站经验,覆盖建材、制造、服务、文创等
  • 项目经理把关选题与事实准确性
  • 工程师与设计师联合撰写专业细节
  • 统一编辑规范,保证文风与排版一致
  • 每月复盘转化数据,迭代选题方向

延伸阅读

相关资讯与近期热门内容

深度阅读推荐

建站决策前值得细读的三篇

网站改版的5个关键决策
2024-08-12

网站改版的5个关键决策

什么时候该改版、改到什么程度、如何避免流量掉光,京华建材集团改版复盘给出答案。

获取专属建站方案

看完文章,把您的行业与预算告诉我们,免费获取一份量身定制的官网建设方案与报价。

立即免费咨询