开发插件
Empostor 插件是挂载到服务器事件的 .NET 类库。本部分涵盖编写、编译与发布插件所需的一切。
从这里开始
编写插件 是完整的分步教程:
- 安装 .NET SDK
- 创建 C# 类库项目
- 添加
Empostor.ApiNuGet 包 - 编写插件类(继承
PluginBase) - 添加事件监听器(实现
IEventListener并标注[EventListener]) - 在
IPluginStartup中注册监听器 - 编译后放入
plugins/目录,重启服务器
示例插件 是该教程的配套参考——随源码一同发布的极简实现。建议两者对照阅读。
专题
| 主题 | 文档 |
|---|---|
| 依赖注入与宿主配置 | 编写插件 |
| 事件监听器参考 | 编写插件 · 示例插件 |
| 国际化 (i18n) | 编写插件 |
| 基于文本文件的消息 | HelloWorld.txt |
| 提供自定义网页 | Hello 页面 |
初次接触代码库?
直接复制 Empostor.Plugins.Example 并改名。插件总览中的所有官方插件结构一致,都可以当作参考资料。
分发方式
编译产物就是一个 .dll,可通过两种途径发布:
- 放入服务器的
plugins/目录并重启。 - 发布到插件市场目录,服务器管理员即可在管理面板中一键安装。
下一步
翻阅插件总览,查看配置、持久化与本地化的完整实现范例。