Skip to content

开发插件 ​

Empostor 插件是挂载到服务器事件的 .NET 类库。本部分涵盖编写、编译与发布插件所需的一切。

从这里开始 ​

编写插件 是完整的分步教程:

  1. 安装 .NET SDK
  2. 创建 C# 类库项目
  3. 添加 Empostor.Api NuGet 包
  4. 编写插件类(继承 PluginBase)
  5. 添加事件监听器(实现 IEventListener 并标注 [EventListener])
  6. 在 IPluginStartup 中注册监听器
  7. 编译后放入 plugins/ 目录,重启服务器

示例插件 是该教程的配套参考——随源码一同发布的极简实现。建议两者对照阅读。

专题 ​

主题文档
依赖注入与宿主配置编写插件
事件监听器参考编写插件 · 示例插件
国际化 (i18n)编写插件
基于文本文件的消息HelloWorld.txt
提供自定义网页Hello 页面

初次接触代码库?

直接复制 Empostor.Plugins.Example 并改名。插件总览中的所有官方插件结构一致,都可以当作参考资料。

分发方式 ​

编译产物就是一个 .dll,可通过两种途径发布:

  • 放入服务器的 plugins/ 目录并重启。
  • 发布到插件市场目录,服务器管理员即可在管理面板中一键安装。

下一步 ​

翻阅插件总览,查看配置、持久化与本地化的完整实现范例。