Plug-ins

From Resonite Wiki
This page is a translated version of the page Plugins and the translation is 100% complete.

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

En premier, vérifiez bien que vous avez besoin d'un plugin. Dans la plupart des cas, les outils sont déjà présents dans Resonite avec ProtoFlux. Ces outils peuvent être terrifiants pour les nouveaux joueurs mais sont très puissants. Des raisons communes pour avoir besoin de plug-ins sont:

  • Intégration de matériel tiers - Vous pouvez potentiellement utiliser des WebSocket ou HTTP pour cela.
  • Recherche / Science - Si votre usage demande une intégration demandant de l’expérience dans un milieu d'éducation
  • Automation - Si vous avez besoin d'automatiser un processus dans Resonite comme traiter des larges quantités d'assets ou de données

Ressources / liens

Plug-ins Open-Source

Sentez-vous libres d'ajouter votre plug-in a la liste!