Skip to main content

Welcome to Vidya SDK

Build Web3 games without the hassle. Vidya SDK provides everything you need to integrate blockchain functionality into your games with minimal friction.

SDK Status

The Vidya SDK is currently under development and has not been released yet. This documentation serves as a specification and preview of the upcoming SDK features and APIs. The actual implementation may differ from what is described here. Stay tuned for the official release announcement!

What is Vidya?​

Vidya is a comprehensive Web3 gaming ecosystem that enables developers to create blockchain-integrated games without extensive crypto knowledge. Our SDK handles the complex blockchain interactions, letting you focus on building great games.

Player-Centric Architecture​

The Vidya SDK uses a Player object as the central hub for all interactions. This design provides:

  • Type Safety: No more string IDs or wallet addresses scattered throughout your code
  • Permission Management: Built-in read/write access control
  • Unified Interface: All modules accessed through the Player object
  • Cross-Platform Consistency: Same architecture across TypeScript, Unity, Godot, and Unreal

Key Features​

🎮 Game-First Approach​

  • Browser-based gaming for universal access
  • No downloads required
  • Seamless Web3 integration

🔗 Cross-Game Interoperability​

  • Items work across multiple games
  • Shared inventory system
  • True digital ownership

🛠️ Developer Friendly​

  • Player object architecture for clean code
  • Modular Item class with built-in methods
  • Comprehensive documentation with examples
  • Active developer community

💎 Complete Feature Set​

  • Inventory System: Item management with transfer, equip, and consume methods
  • Marketplace: List, buy, and trade items between players
  • Crafting System: Recipe-based item creation
  • Gacha System: Loot boxes with configurable rates
  • Leaderboards: Global and friend rankings
  • Social Features: Friends, guilds, and messaging
  • AI NPCs: Intelligent non-player characters

Supported Platforms​

Vidya SDK provides consistent APIs across all major game development platforms:

  • TypeScript: Web applications with React, Vue, or vanilla JS
  • Unity: 3D and 2D games with C# support
  • Godot: Open-source development with GDScript
  • Unreal Engine: AAA games with Blueprint and C++

Quick Example​

import { VidyaSDK, Player } from '@vidya/sdk';

// Initialize SDK with your project ID
const vidya = new VidyaSDK({ projectId: 'your-project-id' });

// Authenticate and create Player object
const session = await vidya.auth.login({ provider: 'google' });
const player = Player.fromSession(session);

// Use Player object throughout your game
const inventory = await vidya.inventory.getItems(player);
const sword = await vidya.inventory.getItem(player, item => item.name === 'Legendary Sword');

// Items have built-in methods
await sword.equip();
await sword.transfer(otherPlayer, 1);

The VIDYA Token​

The VIDYA token is the primary utility token for the entire ecosystem:

  • Ethereum: 0x3D3D35bb9bEC23b06Ca00fe472b50E7A4c692C30
  • Arbitrum: 0x3d48ae69a2F35D02d6F0c5E84CFE66bE885f3963
  • Base: 0x46c8651dDedD50CBDF71de85D3de9AaC80247B62
  • Solana: FQiRecHZJysup1Cv6TQsQCiTk3DcAJK5C5Xu67j4N6Bq

Games in the Ecosystem​

Aimbots​

Fast-paced crypto first-person shooter bringing blockchain gaming to the FPS genre.

Agnosia​

Fully on-chain strategic card game where players brew, sacrifice, and ascend through dark fantasy rituals.

Next Steps​

Join our community: