⚙ Grid Owner Resources

Модуль DLL

ZoneCoin DLL — это .NET-модуль для OpenSimulator, который подключает экономику вашего виртуального мира напрямую к платформе ZoneCoin через REST API.

📦 Обзор

ZoneCoin.dll интегрируется с OpenSimulator как экономический модуль, заменяя стандартную валютную систему платформой ZoneCoin.

  • ✓ Синхронизация баланса в реальном времени
  • ✓ Одноранговые переводы между аватарами
  • ✓ Покупка валюты в виртуальном мире
  • ✓ Автоматический мониторинг heartbeat
  • ✓ Поддержка покупки земли
  • ✓ Интеграция нативного модуля ZoneCoin

🔧 Требования

Версия DLL
vauto
Минимальный OpenSim
OpenSimulator ≥ 0.9.2
Фреймворк
.NET 6.0+
Совместимость
ZoneCoin Native Module

📝 Руководство по установке

1 Загрузите пакет DLL для вашего грида

Скачайте файлы ZoneCoin.dll и ZoneCoin.ini и поместите их в каталог addon-modules вашего OpenSimulator. 

opensim/
├── bin/
│   └── addon-modules/
│       └── ZoneCoin/
│           ├── ZoneCoin.dll
│           └── ZoneCoin.ini
2 Скопируйте ZoneCoin.dll в папку bin/ OpenSim

Отредактируйте ZoneCoin.ini, указав свои учётные данные (API-ключ, общий секрет, UUID экземпляра). Они отображаются выше после регистрации. 

[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 Скопируйте ZoneCoin.ini в папку bin/config/ вашего OpenSim

Добавьте модуль экономики ZoneCoin в разделы [Economy] и [Startup] вашего 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 Перезапустите экземпляр OpenSim

Для режима Grid добавьте коннектор CurrencyService в ваш Robust.ini или Robust.HG.ini. 

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

[CurrencyService]
CurrencyModule     = ZoneCoin
5 Перезапуск и проверка

Перезапустите экземпляр OpenSimulator и убедитесь, что модуль загружен корректно, проверив вывод консоли. 

# 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

📈 Архитектура

┌──────────────────────┐       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

Версия auto — включает ZoneCoin.dll и шаблон конфигурации.

Зарегистрируйтесь как владелец сетки, чтобы скачать пакет DLL с предварительно настроенными учётными данными API.

🌐 Перейти на панель владельца грида

🚀 Быстрые ссылки