Plugins/pl: Difference between revisions

From Resonite Wiki
Created page with "Zacznij pisać!"
Created page with "Wtyczki mają obecnie kilka ograniczeń:"
Line 10: Line 10:
Podczas tworzenia Wtyczki należy pamiętać o następujących kwestiach:
Podczas tworzenia Wtyczki należy pamiętać o następujących kwestiach:
* Wtyczki nie mogą umożliwiać graczom, w tym tobie, omijania [[Guidelines|Wytyczne]].  
* Wtyczki nie mogą umożliwiać graczom, w tym tobie, omijania [[Guidelines|Wytyczne]].  
** <span lang="en" dir="ltr" class="mw-content-ltr">This includes: Asset Theft, Harassment etc.</span>
** Obejmuje to: kradzież zasobów, nękanie itp.
* <span lang="en" dir="ltr" class="mw-content-ltr">Plugins should follow the general principle of "Do No Harm"</span>
* Wtyczki powinny działać zgodnie z ogólną zasadą „Nie Szkodzić”.


== <span lang="en" dir="ltr" class="mw-content-ltr">Plugin Limitations</span> ==
== Ograniczenia Wtyczek ==
<span lang="en" dir="ltr" class="mw-content-ltr">Plugins are limited in several ways right now:</span>
Wtyczki mają obecnie kilka ograniczeń:
# <span lang="en" dir="ltr" class="mw-content-ltr">'''If you use plugins you will not be able to join other players, unless they have the same plugins.'''</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">'''If you use plugins you will not be able to join other players, unless they have the same plugins.'''</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">There is no built-in distribution system. You are in charge of distribution</span>
# <span lang="en" dir="ltr" class="mw-content-ltr">There is no built-in distribution system. You are in charge of distribution</span>

Revision as of 18:00, 28 August 2025

Jeśli korzystasz z wtyczek, nie będziesz mógł dołączyć do innych graczy, chyba że mają takie same wtyczki jak ty.

Programowanie wewnątrz / podczas gry w Resonite wymaga obecnie ProtoFlux, ale nie jest to jedyna opcja. Resonite posiada system wtyczek, z którego można korzystać.

Wtyczka to skompilowany Assembly / DLL napisany w języku C#, który można załadować do Resonite w czasie wykonywania.

Wytyczne dotyczące Wtyczek

Podczas tworzenia Wtyczki należy pamiętać o następujących kwestiach:

  • Wtyczki nie mogą umożliwiać graczom, w tym tobie, omijania Wytyczne.
    • Obejmuje to: kradzież zasobów, nękanie itp.
  • Wtyczki powinny działać zgodnie z ogólną zasadą „Nie Szkodzić”.

Ograniczenia Wtyczek

Wtyczki mają obecnie kilka ograniczeń:

  1. If you use plugins you will not be able to join other players, unless they have the same plugins.
  2. There is no built-in distribution system. You are in charge of distribution
  3. Plugins may break in between builds of Resonite and therefore require frequent updates.

Writing a Plugin

To get started writing a plugin follow these steps:

  1. Download Visual Studio Community edition.
    1. During installation, check of the .NET desktop development workload which will give you the >NET Framework 4-4.6 development tools
  2. Create a new Library project
  3. Add references to some Resonite libraries from the installation folder:
    1. FrooxEngine.dll - Found in Resonite/Resonite_Data/Managed/FrooxEngine.dll
    2. Elements.Core.dll - Found in Resonite/Resonite_Data/Managed/Elements.Core.dll
  4. Zacznij pisać!

Double check the links/resources section below for additional resources.

Using / Testing a Plugin

When running Resonite with a plugin you must use Command Line Arguments.

The Command Line Argument -LoadAssembly <path> will load additional Assemblies / DLLs when used to launch Resonite.

Plugin Recommendations

Firstly, double check, if you need a plugin. Most common scenarios can be done within Resonite using ProtoFlux or Components. These items might seem scary for newer users but their possibilities are quite endless. Common things that might need plugins include:

  • Integration of Third Party Hardware or Devices - You can potentially use WebSockets or HTTP for this, but if not a plugin may be needed
  • Research / Science Applications - If your scenario requires some advanced integration with a science/educational background one may be needed
  • Automation - If you need to automate a process within Resonite such as batch processing of assets or data

Resources / Links

Open Source Plugins

Feel free to add any open source Resonite plugins here!