Skip to main content

Resonite Plugins 插件介绍

Resonite 插件介绍

⚠️ 危险提示： 如果你使用了修改 数据模型（Data model） 的插件（例如添加了自定义组件的插件），其他玩家将无法加入你托管的会话（Sessions），除非他们安装了和你一样的插件。

目前，在 Resonite 内部（或游玩时）进行编程需要使用 ProtoFlux，但这不是唯一的选择。Resonite 拥有一个你可以利用的插件（Plugin）系统。

插件是一个使用 C# 编写的、已编译的程序集（Assembly）/ DLL 文件。通过使用启动参数（launch argument），可以在运行时将其加载到 Resonite 中。

插件开发指南（Plugin Guidelines）

在创建插件时，请牢记以下几点：

  • 插件绝不能让玩家（包括你自己）绕过社区准则（Guidelines）。
    • 这包括：盗窃资产、骚扰等行为。
  • 插件应遵循“不作恶（Do No Harm）”的一般原则。

插件的局限性（Plugin Limitations）

目前，插件在以下几个方面受到限制：

  1. 如果你使用的插件修改了数据模型（Data model），其他玩家将无法加入你启用了这些插件的会话，除非他们拥有每一个相关插件的相同版本。
  2. 游戏没有内置的分发系统。你需要自行负责插件的发布与分发。
  3. 插件可能会在 Resonite 的版本更新中失效，因此需要频繁地进行维护和更新。

编写插件（Writing a Plugin）

请参阅关于创建插件的文章，以获取深入指南。

请务必查看下方的“链接/资源”部分以获取更多资源。

使用 / 测试插件（Using / Testing a Plugin）

在带有插件运行 Resonite 时，你必须使用命令行参数（Command Line Arguments）。

使用命令行参数 -LoadAssembly <path> 启动 Resonite 时，将会加载额外的程序集（Assemblies）/ DLL。

插件使用建议（Plugin Recommendations）

首先，请仔细确认你是否真的 需要 一个插件。大多数常见场景都可以直接在 Resonite 内部使用 ProtoFlux 或组件（Components）来完成。对于新用户来说，这些内置工具可能看起来有些令人生畏，但它们的可能性几乎是无限的。通常真正需要插件的场景包括：

  • 集成第三方硬件或设备： 你其实也有可能使用 WebSockets 或 HTTP 来实现，但如果不行，可能就需要用到插件了。
  • 科研 / 科学应用： 如果你的使用场景需要与具有科学 / 教育背景的系统进行深度集成，可能会需要用到插件。
  • 自动化： 如果你需要自动化处理 Resonite 内部的流程，例如批量处理资源或数据。

资源 / 链接（Resources / Links）

开源插件

欢迎在此处添加任何开源的 Resonite 插件！

No comments to display

Back to top