⚙ Grid Owner Resources

DLLモジュール

ZoneCoin DLLは、REST APIを介して仮想世界の経済をZoneCoinプラットフォームに直接接続するOpenSimulator用の.NETモジュールです。

📦 概要

ZoneCoin.dllはOpenSimulatorの経済モジュールとして統合され、デフォルトの通貨システムをZoneCoinプラットフォームに置き換えます。

  • ✓ リアルタイム残高同期
  • ✓ ピアツーピアアバター送金
  • ✓ インワールド通貨購入
  • ✓ 自動ハートビート監視
  • ✓ 土地購入サポート
  • ✓ ZoneCoinネイティブモジュール統合

🔧 要件

DLLバージョン
vauto
最小OpenSim
OpenSimulator ≥ 0.9.2
フレームワーク
.NET 6.0+
互換性
ZoneCoin Native Module

📝 インストールガイド

1 グリッド用の DLL パッケージをダウンロードします

ZoneCoin.dllとZoneCoin.iniファイルをダウンロードし、OpenSimulatorのaddon-modulesディレクトリに配置してください。 

opensim/
├── bin/
│   └── addon-modules/
│       └── ZoneCoin/
│           ├── ZoneCoin.dll
│           └── ZoneCoin.ini
2 ZoneCoin.dll を OpenSim の bin/ フォルダにコピーします

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 OpenSim.ini???

OpenSim.iniの[Economy]および[Startup]セクションに、以下に示すようにZoneCoin経済モジュールを追加してください。 

[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 インスタンスを再起動します

グリッドモードの場合、Robust.iniまたはRobust.HG.iniの設定にCurrencyServiceコネクタを追加してください。 

[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と設定テンプレートを含みます。

グリッドオーナーとして登録すると、API認証情報が事前設定されたDLLパッケージをダウンロードできます。

🌐 グリッドオーナーダッシュボードへ

🚀 クイックリンク