Dalamud 插件开发指南：三步跑通你的第一个 FFXIV 插件

Dalamud 插件开发指南：三步跑通你的第一个 FFXIV 插件

【免费下载链接】Dalamud FFXIV plugin framework and API 项目地址: https://gitcode.com/GitHub_Trending/da/Dalamud

想给 FFXIV 做一套 Dalamud 插件，这周就能跑起来？从这里开始。Dalamud 是社区公认的 FFXIV 插件框架，把游戏数据和原生层暴露成 C# API。下面一次讲完：装好环境、写出第一个插件、绕开常见坑。

Dalamud 如何让 FFXIV 变成可拓展的游戏

原生客户端没有"查物价"或"实时看战斗日志"的入口。你需要的是能读游戏内存的东西，Dalamud 正是它：把数据结构、聊天、UI 这些内部机制暴露成 C# API，你用普通 .NET 技能就能开发插件。整条链路里，XIVLauncher（FFXIVQuickLauncher）负责启动和依赖管理，框架核心在 Dalamud/。

三步跑通你的第一个 Dalamud 插件

1. 装好 XIVLauncher，在设置里打开 Dalamud 开关，依赖全由它托管，不用手动折腾。
2. 执行 git clone https://gitcode.com/GitHub_Trending/da/Dalamud，用 Visual Studio 打开解决方案。
3. 新建 C# 类库，引用 Dalamud SDK，写一个实现 IDalamudPlugin 的类。

例子只有 9 行：声明插件名，初始化时打一条日志——任何 Dalamud 插件的骨架都长这样。

using Dalamud.Plugin;

namespace MyFirstPlugin;

public class MyFirstPlugin : IDalamudPlugin
{
    public string Name => "MyFirstPlugin";
    public void Initialize(DalamudClient client) => client.Log("Hello, Dalamud!");
}

编译，把生成的 DLL 丢进 %APPDATA%\XIVLauncher\devPlugins，重启游戏看到日志输出，就成功了。

拿 Dalamud 插件能做什么：四个高频场景

• 市场比价：读取市场板数据，实时看全服价格，搬砖党必备。
• 聊天快捷：常用回复绑成快捷指令，团本聊天不用手打。
• 数据面板：读状态、背包、掉落数据，做成自己想要的信息挂件。
• 轻量自动化：在安全范围内重复常规操作，把时间省下来。

成熟 FFXIV 插件怎么选

写自己的之前，先看看社区已经做好的：

• Universalis：实时市场价查询，行情数据标杆。
• PennyPincher：全服比价，自动找最低价入手。
• XIVpad：战斗日志统计加冷却计时，服务战斗细节党。

去哪拿？XIVLauncher 内置插件库一键安装；Dalamud 的 Discord 上还能翻到更多第三方插件。建议按使用频率挑，现有插件覆盖不了的需求，才值得自己动手。

FFXIV 插件开发避坑与常见问题

• ⚠️ 别手动注入：XIVLauncher 托管着多项必需依赖，手动跑是第一个坑。
• 跟着游戏同步更新：签名地址随版本变，插件要跟着 Dalamud 的发布节奏走。
• 保持轻量：插件跑在游戏主线程里，别做过度内存读取。
• 写清楚插件说明：README 胜过一千行注释，方便别人，也方便未来的你。

卡住了先翻 API 文档，其余问题去 Discord 社区，响应最快。

【免费下载链接】Dalamud FFXIV plugin framework and API 项目地址: https://gitcode.com/GitHub_Trending/da/Dalamud