⚙ Grid Owner Resources

DLL-Modul

Die ZoneCoin DLL ist ein .NET-Modul für OpenSimulator, das Ihre Wirtschaft der virtuellen Welt direkt über REST API mit der ZoneCoin-Plattform verbindet.

📦 Übersicht

ZoneCoin.dll integriert sich als Wirtschaftsmodul in OpenSimulator und ersetzt das Standard-Währungssystem durch die ZoneCoin-Plattform.

  • ✓ Echtzeit-Saldo-Synchronisierung
  • ✓ Peer-to-Peer-Avatar-Überweisungen
  • ✓ Währungskauf in der virtuellen Welt
  • ✓ Automatische Heartbeat-Überwachung
  • ✓ Unterstützung für Landkäufe
  • ✓ ZoneCoin Natives Modul Integration

🔧 Anforderungen

DLL-Version
vauto
Mindest-OpenSim
OpenSimulator ≥ 0.9.2
Framework
.NET 6.0+
Kompatibilität
ZoneCoin Native Module

📝 Installationsanleitung

1 Laden Sie das DLL-Paket für Ihr Grid herunter

Laden Sie die ZoneCoin.dll und ZoneCoin.ini herunter und platzieren Sie sie im addon-modules Verzeichnis Ihres OpenSimulators. 

opensim/
├── bin/
│   └── addon-modules/
│       └── ZoneCoin/
│           ├── ZoneCoin.dll
│           └── ZoneCoin.ini
2 Kopieren Sie ZoneCoin.dll in Ihren OpenSim bin/-Ordner

Bearbeiten Sie ZoneCoin.ini mit Ihren Zugangsdaten (API-Schlüssel, Shared Secret, Instance UUID). Diese werden nach der Registrierung oben angezeigt. 

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

Fügen Sie das ZoneCoin-Wirtschaftsmodul zu den Abschnitten [Economy] und [Startup] Ihrer OpenSim.ini hinzu. 

[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 Starten Sie Ihre OpenSim-Instanz neu

Fügen Sie im Grid-Modus den CurrencyService-Connector zu Ihrer Robust.ini oder Robust.HG.ini hinzu. 

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

[CurrencyService]
CurrencyModule     = ZoneCoin
5 Neustart & Überprüfung

Starten Sie Ihre OpenSimulator-Instanz neu und überprüfen Sie, ob das Modul korrekt geladen wird. 

# 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

📈 Architektur

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

DLL-Paket herunterladen

Version auto — enthält ZoneCoin.dll und Konfigurationsvorlage.

Registrieren Sie sich als Grid-Betreiber, um das DLL-Paket mit vorkonfigurierten API-Zugangsdaten herunterzuladen.

🌐 Zum Grid-Betreiber-Dashboard

🚀 Schnelllinks