Plugins/fr: Difference between revisions

Latest revision as of 13:10, 9 June 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:

Si vous utilisez des plug-ins, vous ne pourrez pas rejoindre d'autres utilisateurs a moins qu'ils aient les mêmes plug-ins.
Il n'y a pas de système de distribution pour les plug-ins, vous êtes en charge de distribuer vos plug-ins.
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:

Téléchargez Visual Studio Community edition.
1. Durant l'installation, activer le kit de développement .NET Framework 4-4.6.
Créez un nouveau projet de Librairie
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
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!

@@ Line 3: / Line 3: @@
 <span style="font-size:2em;">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.</span>
-<span lang="en" dir="ltr" class="mw-content-ltr">Programming within / while playing Resonite right now requires [[ProtoFlux]], but that isn't the only option. Resonite has a Plugin system which you can use.</span>
+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.
-<span lang="en" dir="ltr" class="mw-content-ltr">A plugin is a compiled Assembly / DLL written in C# that can be loaded into Resonite at runtime.</span>
+Un plug-in est un fichier DLL compilé et écrit en C# qui peuvent être chargés dans Resonite au lancement.
-== <span lang="en" dir="ltr" class="mw-content-ltr">Plugin Guidelines</span> ==
+== Lignes directrices des plug-ins ==
-<span lang="en" dir="ltr" class="mw-content-ltr">When creating a Plugin please keep the following in mind:</span>
+A la création d'un plug-in, gardez a l'esprit:
-* <span lang="en" dir="ltr" class="mw-content-ltr">Plugins must not enable players, including yourself to bypass [[Guidelines]].</span>
+* Les plug-ins ne doivent pas permettre aux joueurs de contourner les [[Guidelines | lignes directrices]].
-** <span lang="en" dir="ltr" class="mw-content-ltr">This includes: Asset Theft, Harassment etc.</span>
+** Ceci inclus: vol d'asset, harcèlement etc.
-* <span lang="en" dir="ltr" class="mw-content-ltr">Plugins should follow the general principle of "Do No Harm"</span>
+* Les plug-ins doivent suivre la règle du "ne faites pas de mal"
-== <span lang="en" dir="ltr" class="mw-content-ltr">Plugin Limitations</span> ==
+== Limitations des plug-ins ==
-<span lang="en" dir="ltr" class="mw-content-ltr">Plugins are limited in several ways right now:</span>
+Les plug-ins ont certaines limitations:
-# <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>
+# '''Si vous utilisez des plug-ins, vous ne pourrez pas rejoindre d'autres utilisateurs a moins qu'ils aient les mêmes plug-ins.'''
-# <span lang="en" dir="ltr" class="mw-content-ltr">There is no built-in distribution system. You are in charge of distribution</span>
+# Il n'y a pas de système de distribution pour les plug-ins, vous êtes en charge de distribuer vos plug-ins.
-# <span lang="en" dir="ltr" class="mw-content-ltr">Plugins may break in between builds of Resonite and therefore require frequent updates.</span>
+# Les plug-ins peuvent casser entre les version de Resonite et demandes des mises à jour fréquentes.
-== <span lang="en" dir="ltr" class="mw-content-ltr">Writing a Plugin</span> ==
+== Créer un plug-in ==
-<span lang="en" dir="ltr" class="mw-content-ltr">To get started writing a plugin follow these steps:</span>
+Pour commencer a écrire un plug-in, suivez ces étapes:
-# <span lang="en" dir="ltr" class="mw-content-ltr">Download [https://visualstudio.microsoft.com/vs/community/ Visual Studio Community edition].</span>
+# Téléchargez [https://visualstudio.microsoft.com/vs/community/ Visual Studio Community edition].
-## <span lang="en" dir="ltr" class="mw-content-ltr">During installation, check of the .NET desktop development workload which will give you the >NET Framework 4-4.6 development tools</span>
+## Durant l'installation, activer le kit de développement .NET Framework 4-4.6.
-# <span lang="en" dir="ltr" class="mw-content-ltr">Create a new Library project</span>
+# Créez un nouveau projet de Librairie
-# <span lang="en" dir="ltr" class="mw-content-ltr">Add references to some Resonite libraries from the installation folder:</span>
+# Ajoutez quelques références a des librairies du dossier de Resonite:
-## <span lang="en" dir="ltr" class="mw-content-ltr">FrooxEngine.dll - Found in Resonite/Resonite_Data/Managed/FrooxEngine.dll</span>
+## FrooxEngine.dll - Trouvé dans Resonite/Resonite_Data/Managed/FrooxEngine.dll
-## <span lang="en" dir="ltr" class="mw-content-ltr">Elements.Core.dll - Found in Resonite/Resonite_Data/Managed/Elements.Core.dll</span>
+## 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>
+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:
-* <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>
+* Intégration de matériel tiers - Vous pouvez potentiellement utiliser des [[WebSocket]] ou HTTP pour cela.
-* <span lang="en" dir="ltr" class="mw-content-ltr">Research / Science Applications - If your scenario requires some advanced integration with a science/educational background one may be needed</span>
+* Recherche / Science - Si votre usage demande une intégration demandant de l’expérience dans un milieu d'éducation
-* <span lang="en" dir="ltr" class="mw-content-ltr">Automation - If you need to automate a process within Resonite such as batch processing of assets or data</span>
+* Automation - Si vous avez besoin d'automatiser un processus dans Resonite comme traiter des larges quantités d'assets ou de données
-== <span lang="en" dir="ltr" class="mw-content-ltr">Resources / Links</span> ==
+== Ressources / liens ==
-=== <span lang="en" dir="ltr" class="mw-content-ltr">Open Source Plugins</span> ===
+=== Plug-ins Open-Source ===
-<span lang="en" dir="ltr" class="mw-content-ltr">Feel free to add any open source Resonite plugins here!</span>
+Sentez-vous libres d'ajouter votre plug-in a la liste!
 * [https://github.com/Xlinka/Project-Obsidian Project Obsidian]
 * [https://github.com/resonite-modding-group/ResoniteModLoader ResoniteModLoader]
+[[Category:Features]]