Modules
Extension des fonctionnalités de l'API de scripting de nanos world
Les modules vous permettent d'étendre les fonctionnalités de l'API de scripting de nanos world côté serveur. Actuellement, seuls les modules C sont pris en charge.
Sachez que cette partie de l'API de scripting est actuellement en cours de réalisation et peut être modifiée à tout moment.
Créer votre propre module C
Il est également possible de créer votre propre module C/C++ et d'appeler ses fonctions depuis Nanos World.
Comme il s'agit d'une procédure avancée, des instabilités, voire des crashs, peuvent se produire.
Pour créer votre propre module, assurez-vous que vous avez Visual Studio installé avec Développement Desktop en C++ (et CMake) ou tout autre compilateur C sous Linux.
Premières étapes
- Ensuite, clonez notre module d'exemple dans votre ordinateur pour commencer à l'utiliser.
- Après le clonage, vous devrez télécharger ses submodules avec
git submodule update --init --recursive
- ceci téléchargera le sdk du module module-sdk comme un sous-module git dans le dossier deps/ automatiquement.
Comprendre l'exemple
Le fichier important se trouve dans src/example.cpp
:
loading...
Compilation de votre module C
Pour compiler l'exemple, suivez les étapes suivantes :
- Créez un dossier appelé :
build/
:mkdir build
. - Entrez le dossier du build:
cd build
. - Lancez
cmake ..
. - Faites un build avec
cmake --build . --config Release
Et maintenant vous aurez les dlls/libs dans le dossier build/Release
.
Utilisation de votre module C
Copiez votre fichier .dll
dans votre dossier Nanos World : Server/Modules
.
Et dans votre package, vous pouvez le charger et l'utiliser :
-- Loads the module 'example'
local example = require('example')
-- Calls the module function 'test'
-- Will print 'Hello World' on console
Console.Log(example.test())