Інтеграція NFT-активів у метавсесвіт

Інтеграція NFT-активів в метавселенну

NFT-активи в метавселенні — це не просто картинки, прив'язані до аккаунту. Це інтерактивні об'єкти з перевіреним правом власності: земля, яку можна забудувати; зброя з реальними ігровими характеристиками; аватар, що несе соціальний статус власника. Інтеграція вимагає вирішення кількох нетривіальних технічних задач.

Архітектура NFT-в-ігровому-світі

On-chain верифікація прав

Перед використанням NFT в метавселенні потрібно верифікувати право власності:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.19;

interface IMetaverseAssets {
    function canUseInWorld(
        address user,
        address nftContract,
        uint256 tokenId
    ) external view returns (bool);
}

contract MetaverseAssetRegistry is IMetaverseAssets {
    // Реєстр затвердених NFT колекцій
    mapping(address => bool) public approvedCollections;

    // Кастомні правила для колекцій
    mapping(address => address) public collectionAdapters;

    function canUseInWorld(
        address user,
        address nftContract,
        uint256 tokenId
    ) external view override returns (bool) {
        if (!approvedCollections[nftContract]) {
            return false;
        }

        // Перевіряємо ERC-721 або ERC-4907 (оренда)
        try IERC721(nftContract).ownerOf(tokenId) returns (address owner) {
            if (owner == user) return true;
        } catch {}

        // ERC-4907: перевіряємо user role (оренда)
        try IERC4907(nftContract).userOf(tokenId) returns (address renter) {
            if (renter == user && block.timestamp <= IERC4907(nftContract).userExpires(tokenId)) {
                return true;
            }
        } catch {}

        return false;
    }
}

Маппінг властивостей NFT до ігрових характеристик

interface NFTAttributeMapper {
  mapAttributes(
    nftContract: string,
    tokenId: number,
    metadata: NFTMetadata
  ): GameAssetProperties;
}

class WeaponNFTMapper implements NFTAttributeMapper {
  mapAttributes(nftContract, tokenId, metadata): GameAssetProperties {
    const attrs = metadata.attributes;
    const getAttr = (name: string) =>
      attrs.find(a => a.trait_type === name)?.value;

    return {
      assetType: 'weapon',
      mesh3dUrl: metadata.animation_url,  // GLB файл
      textures: this.extractTextures(metadata),
      gameStats: {
        damage: this.normalizeValue(getAttr('Power'), 1, 100, 10, 500),
        speed: this.normalizeValue(getAttr('Speed'), 1, 100, 0.5, 2.0),
        range: this.normalizeValue(getAttr('Range'), 1, 100, 1, 50),
        rarity: getAttr('Rarity') as RarityTier,
      },
      visualEffects: this.getEffectsForRarity(getAttr('Rarity')),
    };
  }
}

Cross-collection інтероперабельність

Різні NFT колекції мають різні формати метаданих. Adapter паттерн вирішує це:

class NFTAdapterFactory {
  private adapters: Map<string, NFTAttributeMapper> = new Map();

  register(contractAddress: string, adapter: NFTAttributeMapper) {
    this.adapters.set(contractAddress.toLowerCase(), adapter);
  }

  async getGameProperties(
    contractAddress: string,
    tokenId: number
  ): Promise<GameAssetProperties | null> {
    const metadata = await this.fetchMetadata(contractAddress, tokenId);
    const adapter = this.adapters.get(contractAddress.toLowerCase());

    if (!adapter) {
      // Fallback: пробуємо generic adapter по стандартних полях
      return this.genericAdapter.mapAttributes(contractAddress, tokenId, metadata);
    }

    return adapter.mapAttributes(contractAddress, tokenId, metadata);
  }
}

3D Рендеринг NFT-об'єктів

Більшість NFT — це 2D зображення. Для метавселенної потрібна 3D репрезентація:

Стратегії:

1. 3D Native NFT: колекція спочатку поставляє GLB/VRM файл у метаданих (animation_url)
2. 2D-to-3D billboard: 2D NFT відображається як текстура на 3D площині (для PFP колекцій)
3. Procedural generation: по traits NFT генерується 3D модель на льоту

class NFT3DRenderer {
  async renderAsset(
    asset: GameAssetProperties,
    scene: THREE.Scene
  ): Promise<THREE.Object3D> {
    if (asset.mesh3dUrl) {
      // Завантажуємо готову 3D модель
      const loader = new GLTFLoader();
      const gltf = await loader.loadAsync(asset.mesh3dUrl);
      return gltf.scene;
    }

    // Fallback: billboard з 2D зображення
    const texture = await new THREE.TextureLoader().loadAsync(asset.imageUrl);
    const geometry = new THREE.PlaneGeometry(1, 1);
    const material = new THREE.MeshStandardMaterial({
      map: texture,
      transparent: true,
      alphaTest: 0.5
    });
    return new THREE.Mesh(geometry, material);
  }
}

Сесійні права та обмеження передачі

NFT в метавселенні не завжди повинен бути transferable під час використання. Якщо гравець використовує меч — його не можна продати протягом бою:

contract InWorldLock {
    mapping(address => mapping(uint256 => bool)) public isLockedInWorld;
    mapping(address => mapping(uint256 => address)) public lockedBy;

    event AssetLocked(address nftContract, uint256 tokenId, address world);
    event AssetUnlocked(address nftContract, uint256 tokenId);

    function lockAsset(address nftContract, uint256 tokenId) external onlyRegisteredWorld {
        require(!isLockedInWorld[nftContract][tokenId], "Already locked");
        isLockedInWorld[nftContract][tokenId] = true;
        lockedBy[nftContract][tokenId] = msg.sender;
        emit AssetLocked(nftContract, tokenId, msg.sender);
    }

    function unlockAsset(address nftContract, uint256 tokenId) external {
        require(lockedBy[nftContract][tokenId] == msg.sender, "Not locker");
        isLockedInWorld[nftContract][tokenId] = false;
        delete lockedBy[nftContract][tokenId];
        emit AssetUnlocked(nftContract, tokenId);
    }
}

ERC-5192 (Soulbound Token) — стандарт для неперемістяємих NFT (досягнення, репутація). Корисний для внутріігрових нагород, які не повинні торгуватися.

Інтеграція маркетплейсу

NFT всередину метавселенної повинні продаватися прямо з ігрового інтерфейсу. Інтеграція з OpenSea SDK або власний marketplace контракт:

const buyNFTInWorld = async (
  nftContract: string,
  tokenId: number,
  listingId: string
) => {
  // Перевіряємо що є активний листинг
  const listing = await seaport.getListing(listingId);

  // Виконуємо покупку через Seaport
  const { executeAllActions } = await seaport.fulfillOrder({
    order: listing.order,
    accountAddress: userWallet
  });

  await executeAllActions();

  // Після покупки — миттєве з'явлення в інвентарі гравця
  await gameClient.refreshInventory(userWallet);
};

Хороша інтеграція NFT в метавселенну перетворює цифрові активи з спекулятивного інструменту в утилітарні об'єкти з реальним ігровим смислом. Це й є справжня utility NFT — основа для стійкої токеномики ігрового проекту.