⚙ Grid Owner Resources

Modulo DLL

La DLL ZoneCoin è un modulo .NET per OpenSimulator che collega l'economia del tuo mondo virtuale direttamente alla piattaforma ZoneCoin tramite REST API.

📦 Panoramica

ZoneCoin.dll si integra con OpenSimulator come modulo economico, sostituendo il sistema valutario predefinito con la piattaforma ZoneCoin.

  • ✓ Sincronizzazione saldi in tempo reale
  • ✓ Trasferimenti peer-to-peer tra avatar
  • ✓ Acquisto valuta nel mondo virtuale
  • ✓ Monitoraggio heartbeat automatico
  • ✓ Supporto acquisto terreni
  • ✓ Integrazione Modulo Nativo ZoneCoin

🔧 Requisiti

Versione DLL
vauto
OpenSim minimo
OpenSimulator ≥ 0.9.2
Framework
.NET 6.0+
Compatibilità
ZoneCoin Native Module

📝 Guida all'installazione

1 Scarica il pacchetto DLL per la tua grid

Scarica i file ZoneCoin.dll e ZoneCoin.ini e posizionali nella directory addon-modules del tuo OpenSimulator. 

opensim/
├── bin/
│   └── addon-modules/
│       └── ZoneCoin/
│           ├── ZoneCoin.dll
│           └── ZoneCoin.ini
2 Copia ZoneCoin.dll nella cartella bin/ di OpenSim

Modifica ZoneCoin.ini con le tue credenziali (API Key, Shared Secret, Instance UUID). Sono mostrate sopra dopo la registrazione. 

[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 Copia ZoneCoin.ini nella cartella bin/config/ di OpenSim

Aggiungi il modulo economy ZoneCoin alle sezioni [Economy] e [Startup] del tuo OpenSim.ini come mostrato sotto. 

[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 Riavvia la tua istanza OpenSim

Per la modalità Grid, aggiungi il connettore CurrencyService al tuo Robust.ini o Robust.HG.ini. 

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

[CurrencyService]
CurrencyModule     = ZoneCoin
5 Riavvia e Verifica

Riavvia la tua istanza OpenSimulator e verifica che il modulo si carichi correttamente controllando l'output della 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

📈 Architettura

┌──────────────────────┐       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   │  │
│  └────────────────┘  │ ─────────────────►    │  └─────────────────┘  │
└──────────────────────┘                       └───────────────────────┘
📦

Scarica il pacchetto DLL

Versione auto - include ZoneCoin.dll e modello di configurazione.

Registrati come proprietario di Grid per scaricare il pacchetto DLL con le tue credenziali API pre-configurate.

🌐 Vai al pannello proprietario Grid

🚀 Link rapidi