⚙ Grid Owner Resources

Module DLL

La DLL ZoneCoin est un module .NET pour OpenSimulator qui connecte l'économie de votre monde virtuel directement à la plateforme ZoneCoin via l'API REST.

📦 Vue d'ensemble

ZoneCoin.dll s'intègre à OpenSimulator en tant que module économique, remplaçant le système monétaire par défaut par la plateforme ZoneCoin.

  • ✓ Synchronisation des soldes en temps réel
  • ✓ Transferts peer-to-peer entre avatars
  • ✓ Achat de monnaie dans le monde virtuel
  • ✓ Surveillance automatique du heartbeat
  • ✓ Prise en charge de l'achat de terrain
  • ✓ Intégration Module Natif ZoneCoin

🔧 Prérequis

Version DLL
vauto
OpenSim minimum
OpenSimulator ≥ 0.9.2
Framework
.NET 6.0+
Compatibilité
ZoneCoin Native Module

📝 Guide d'installation

1 Téléchargez le package DLL pour votre grille

Téléchargez les fichiers ZoneCoin.dll et ZoneCoin.ini et placez-les dans le répertoire addon-modules de votre OpenSimulator. 

opensim/
├── bin/
│   └── addon-modules/
│       └── ZoneCoin/
│           ├── ZoneCoin.dll
│           └── ZoneCoin.ini
2 Copiez ZoneCoin.dll dans votre dossier OpenSim bin/

Modifiez ZoneCoin.ini avec vos identifiants (Clé API, Secret Partagé, UUID Instance). Ils sont affichés ci-dessus après l'inscription. 

[ZoneCoin]
Enabled          = true
JoomlaUrl        = https://your-joomla-site.com
ApiKey           = <your_api_key>
SharedSecret     = <your_shared_secret>
InstanceUUID     = <your_instance_uuid>
GridName         = MyGrid
GridUri          = http://grid.myserver.com:8002
HeartbeatInterval = 60

[ZoneCoinEconomy]
StartingBalance  = 1000
CurrencyName     = ZoneCoin
CurrencySymbol   = ZC
MinTransfer      = 1
MaxTransfer      = 1000000

[ZoneCoinRegions]
Enabled                = true
NotifyOnStatusChange   = true

[ZoneCoinUsers]
Enabled                = true
NotifyOnConnect        = true
NotifyOnDisconnect     = false
3 Configurer OpenSim.ini

Ajoutez le module économique ZoneCoin aux sections [Economy] et [Startup] de votre OpenSim.ini. 

[Economy]
economymodule      = ZoneCoin
economy            = https://your-joomla-site.com/index.php?option=com_zonecoin&view=topup
SellEnabled        = true

[Startup]
AddonModule        = addon-modules/ZoneCoin/ZoneCoin.dll
4 Redémarrez votre instance OpenSim

En mode Grid, ajoutez le connecteur CurrencyService à votre Robust.ini ou Robust.HG.ini. 

[ServiceList]
CurrencyServiceConnector = "8002/OpenSim.Server.Handlers.dll:CurrencyServiceConnector"

[CurrencyService]
CurrencyModule     = ZoneCoin
5 Redémarrer et Vérifier

Redémarrez votre instance OpenSimulator et vérifiez que le module se charge correctement en consultant la sortie console. 

# Restart steps:
1. Stop Robust.exe (if grid mode)
2. Stop OpenSim.exe
3. Start Robust.exe  → wait for "READY"
4. Start OpenSim.exe → check for:
   [ZONECOIN] Module loaded successfully
   [ZONECOIN] Connected to Joomla: OK
   [ZONECOIN] Heartbeat interval: 60s

📈 Architecture

┌──────────────────────┐       REST API        ┌───────────────────────┐
│   OpenSim Server      │ ◄──────────────────► │  Joomla + ZoneCoin    │
│                      │                       │                       │
│  ┌────────────────┐  │   /api/v1/zonecoin    │  ┌─────────────────┐  │
│  │ ZoneCoin.dll   │──┼──────────────────────┼──│ DLLHelperCtrl   │  │
│  └────────────────┘  │                       │  └─────────────────┘  │
│                      │   Heartbeat (60s)     │                       │
│  ┌────────────────┐  │ ─────────────────►    │  ┌─────────────────┐  │
│  │ Economy Module │  │                       │  │ Database (MySQL)│  │
│  └────────────────┘  │   Balance/Transfer    │  └─────────────────┘  │
│                      │ ◄────────────────►    │                       │
│  ┌────────────────┐  │                       │  ┌─────────────────┐  │
│  │ Region Module  │  │   Land Buy/Sell       │  │ Wallet Engine   │  │
│  └────────────────┘  │ ─────────────────►    │  └─────────────────┘  │
└──────────────────────┘                       └───────────────────────┘
📦

Télécharger le package DLL

Version auto — inclut ZoneCoin.dll et le modèle de configuration.

Inscrivez-vous en tant que propriétaire de grille pour télécharger le package DLL avec vos identifiants API préconfigurés.

🌐 Aller au tableau de bord Grid Owner

🚀 Liens rapides