Passer au contenu principal
Version: bleeding-edge 🩸

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.

attention

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.

attention

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

  1. Ensuite, clonez notre module d'exemple dans votre ordinateur pour commencer à l'utiliser.
  2. 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 :

src/example.cpp
loading...

Compilation de votre module C

Pour compiler l'exemple, suivez les étapes suivantes :

  1. Créez un dossier appelé : build/: mkdir build.
  2. Entrez le dossier du build: cd build.
  3. Lancez cmake ...
  4. 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())