⚙ Grid Owner Resources

DLL Module

The ZoneCoin DLL is a .NET module for OpenSimulator that connects your virtual world economy directly to the ZoneCoin platform via REST API.

📦 Overview

ZoneCoin.dll integrates with OpenSimulator as an economy module, replacing the default currency system with the ZoneCoin platform.

  • ✓ Real-time balance synchronisation
  • ✓ Peer-to-peer avatar transfers
  • ✓ In-world currency purchase
  • ✓ Automatic heartbeat monitoring
  • ✓ Land purchase support
  • ✓ ZoneCoin Native Module Integration

🔧 Requirements

DLL Version
vauto
Minimum OpenSim
OpenSimulator ≥ 0.9.2
Framework
.NET 6.0+
Compatibility
ZoneCoin Native Module

📝 Installation Guide

1 Download the DLL package for your grid

Download the ZoneCoin.dll and ZoneCoin.ini files and place them in your OpenSimulator addon-modules directory. 

opensim/
├── bin/
│   └── addon-modules/
│       └── ZoneCoin/
│           ├── ZoneCoin.dll
│           └── ZoneCoin.ini
2 Copy ZoneCoin.dll to your OpenSim bin/ folder

Edit ZoneCoin.ini with your credentials (API Key, Shared Secret, Instance UUID). These are shown above after registration. 

[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 Copy ZoneCoin.ini to your OpenSim bin/config/ folder

Add the ZoneCoin economy module to your OpenSim.ini [Economy] and [Startup] sections as shown below. 

[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 Restart your OpenSim instance

For Grid mode, add the CurrencyService connector to your Robust.ini or Robust.HG.ini configuration. 

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

[CurrencyService]
CurrencyModule     = ZoneCoin
5 Restart & Verify

Restart your OpenSimulator instance and verify the module loads correctly by checking the console output. 

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

Download DLL Package

Version auto — includes ZoneCoin.dll and configuration template.

Register as a Grid Owner to download the DLL package with your API credentials pre-configured.

🌐 Go to Grid Owner Dashboard

🚀 Quick Links