Plugins/fr: Difference between revisions

From Resonite Wiki
Created page with "Créez un nouveau projet de Librairie"
Created page with "Commencez a programmer!"
Line 27: Line 27:
## FrooxEngine.dll - Trouvé dans Resonite/Resonite_Data/Managed/FrooxEngine.dll
## FrooxEngine.dll - Trouvé dans Resonite/Resonite_Data/Managed/FrooxEngine.dll
## Elements.Core.dll - Trouvé dans Resonite/Resonite_Data/Managed/Elements.Core.dll
## Elements.Core.dll - Trouvé dans Resonite/Resonite_Data/Managed/Elements.Core.dll
# <span lang="en" dir="ltr" class="mw-content-ltr">Start writing!</span>
# Commencez a programmer!


<span lang="en" dir="ltr" class="mw-content-ltr">Double check the links/resources section below for additional resources.</span>
Il y a une section ci-dessous pour plus de ressources.


== <span lang="en" dir="ltr" class="mw-content-ltr">Using / Testing a Plugin</span> ==
== Utiliser / tester un plug-in ==
<span lang="en" dir="ltr" class="mw-content-ltr">When running Resonite with a plugin you must use [[Command Line Arguments]].</span>
Pour lancer Resonite avec un plug-in vous devez utiliser les [[Command Line Arguments | options de lancement]].


<span lang="en" dir="ltr" class="mw-content-ltr">The Command Line Argument <code>-LoadAssembly <path></code> will load additional Assemblies / DLLs when used to launch Resonite.</span>
L'option <code>-LoadAssembly <path></code> va charger des libraries additionnelles au lancement.


== <span lang="en" dir="ltr" class="mw-content-ltr">Plugin Recommendations</span> == <!--T:12-->
== Recommendations sur les plug-ins == <!--T:12-->
<span lang="en" dir="ltr" class="mw-content-ltr">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:</span>
<span lang="en" dir="ltr" class="mw-content-ltr">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:</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">Integration of Third Party Hardware or Devices - You can potentially use WebSockets or HTTP for this, but if not a plugin may be needed</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">Integration of Third Party Hardware or Devices - You can potentially use WebSockets or HTTP for this, but if not a plugin may be needed</span>

Revision as of 11:40, 25 January 2024

Si vous utilisez des plug-ins, vous ne pourrez pas rejoindre d'autres joueurs a moins que vous ayez les mêmes plugins que vous.

Programmer dans Resonite est fait avec ProtoFlux mais ce n'est pas la seule manière. Resonite a un système de plug-ins que vous pouvez utiliser.

Un plug-in est un fichier DLL compilé et écrit en C# qui peuvent être chargés dans Resonite au lancement.

Lignes directrices des plug-ins

A la création d'un plug-in, gardez a l'esprit:

  • Les plug-ins ne doivent pas permettre aux joueurs de contourner les lignes directrices.
    • Ceci inclus: vol d'asset, harcèlement etc.
  • Les plug-ins doivent suivre la règle du "ne faites pas de mal"

Limitations des plug-ins

Les plug-ins ont certaines limitations:

  1. Si vous utilisez des plug-ins, vous ne pourrez pas rejoindre d'autres utilisateurs a moins qu'ils aient les mêmes plug-ins.
  2. Il n'y a pas de système de distribution pour les plug-ins, vous êtes en charge de distribuer vos plug-ins.
  3. Les plug-ins peuvent casser entre les version de Resonite et demandes des mises à jour fréquentes.

Créer un plug-in

Pour commencer a écrire un plug-in, suivez ces étapes:

  1. Téléchargez Visual Studio Community edition.
    1. Durant l'installation, activer le kit de développement .NET Framework 4-4.6.
  2. Créez un nouveau projet de Librairie
  3. Ajoutez quelques références a des librairies du dossier de Resonite:
    1. FrooxEngine.dll - Trouvé dans Resonite/Resonite_Data/Managed/FrooxEngine.dll
    2. Elements.Core.dll - Trouvé dans Resonite/Resonite_Data/Managed/Elements.Core.dll
  4. Commencez a programmer!

Il y a une section ci-dessous pour plus de ressources.

Utiliser / tester un plug-in

Pour lancer Resonite avec un plug-in vous devez utiliser les options de lancement.

L'option -LoadAssembly <path> va charger des libraries additionnelles au lancement.

Recommendations sur les plug-ins

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!