⚙ Grid Owner Resources

Módulo DLL

El DLL de ZoneCoin es un módulo .NET para OpenSimulator que conecta la economía de su mundo virtual directamente con la plataforma ZoneCoin a través de la API REST.

📦 Visión general

ZoneCoin.dll se integra con OpenSimulator como módulo económico, sustituyendo el sistema de moneda predeterminado por la plataforma ZoneCoin.

  • ✓ Sincronización de saldos en tiempo real
  • ✓ Transferencias peer-to-peer entre avatares
  • ✓ Compra de moneda en el mundo virtual
  • ✓ Monitorización automática de latido
  • ✓ Soporte para compra de terrenos
  • ✓ Integración de Módulo Nativo ZoneCoin

🔧 Requisitos

Versión de DLL
vauto
OpenSim mínimo
OpenSimulator ≥ 0.9.2
Framework
.NET 6.0+
Compatibilidad
ZoneCoin Native Module

📝 Guía de instalación

1 Descargue el paquete DLL para su grid

Descarga los archivos ZoneCoin.dll y ZoneCoin.ini y colócalos en el directorio addon-modules de tu OpenSimulator. 

opensim/
├── bin/
│   └── addon-modules/
│       └── ZoneCoin/
│           ├── ZoneCoin.dll
│           └── ZoneCoin.ini
2 Copie ZoneCoin.dll en su carpeta OpenSim bin/

Edita ZoneCoin.ini con tus credenciales (Clave API, Secreto Compartido, UUID de Instancia). Se muestran arriba después del registro. 

[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 Configurar OpenSim.ini

Agrega el módulo de economía ZoneCoin a las secciones [Economy] y [Startup] de tu 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 Reinicie su instancia de OpenSim

En modo Grid, agrega el conector CurrencyService a tu Robust.ini o Robust.HG.ini. 

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

[CurrencyService]
CurrencyModule     = ZoneCoin
5 Reiniciar y Verificar

Reinicia tu instancia de OpenSimulator y verifica que el módulo se cargue correctamente revisando la salida de consola. 

# 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

📈 Arquitectura

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

Descargar paquete DLL

Versión auto — incluye ZoneCoin.dll y plantilla de configuración.

Regístrese como propietario de grid para descargar el paquete DLL con sus credenciales API preconfiguradas.

🌐 Ir al panel de propietario de Grid

🚀 Enlaces rápidos