OASIS Learn/Case Studies/Our World
Advanced ⏱ 90 min WEB4 WEB5 Unity

🌍 Case Study: Our World

Our World is a Pokémon-GO-style AR geolocation game built in Unity on OASIS WEB4 and WEB5. Players explore the real world to discover GeoNFTs, complete location-based missions, battle creatures at AR hotspots, and share cross-game inventory with ODOOM and OQuake. Earth itself is registered as an OASIS CelestialBody — every GPS coordinate maps into the Omniverse.

Tech stack

  • Engine: Unity 2022+ (C#), ARFoundation, GPS/location services
  • OASIS WEB4: Avatar SSO, cross-game Inventory, Karma, HyperDrive player data, ONET multiplayer
  • OASIS WEB5: GeoNFTs, GeoHotSpots, Missions, Quests, CelestialBodies (Earth as planet), WEB5 STAR API
  • Unity SDK: NextGenSoftware.OASIS.API.OASISUnitySDK (NuGet)

Architecture

Our World integration architecture
Unity App (C#)
  │
  ├─ OASISAvatarManager  ──► WEB4 Avatar SSO + Karma
  ├─ OASISGeoManager     ──► WEB5 GeoNFTs + GeoHotSpots (GPS → AR spawn)
  ├─ OASISMissionManager ──► WEB5 Missions + Quests (objectives + rewards)
  ├─ OASISInventory      ──► WEB5 Cross-game inventory (shared with ODOOM/OQuake)
  ├─ OASISMultiplayer    ──► WEB4 ONET P2P (real-time player positions)
  └─ OASISHyperDrive     ──► WEB4 Player save data (persistent across devices)

Step 1 — Avatar Login (Unity)

csharp
using NextGenSoftware.OASIS.API.OASISUnitySDK;
using NextGenSoftware.OASIS.API.OASISUnitySDK.Avatar;

public class OurWorldAuthManager : MonoBehaviour
{
    async void Start()
    {
        var result = await OASISDNA.Managers.Avatar
            .AuthenticateAsync(email, password);

        if (result.IsError)
        {
            Debug.LogError($"Login failed: {result.Message}");
            return;
        }

        OASISDNA.CurrentAvatar = result.Result;
        Debug.Log($"Logged in as {result.Result.Username}, karma={result.Result.Karma}");
        LoadGame();
    }
}

Step 2 — Earth as a CelestialBody

Earth is registered as an OASIS CelestialBody. Real GPS coordinates map to positions on the Earth body — GeoNFTs dropped at a GPS location appear in AR at exactly that spot.

csharp
// On startup — ensure Earth is registered and warp avatar to it
var earthBody = await OASISDNA.Managers.Star
    .GetCelestialBodyByNameAsync("Earth");

await OASISDNA.Managers.Star.Avatar
    .WarpToAsync(OASISDNA.CurrentAvatar.Id, earthBody.Id);

Step 3 — Spawning GeoNFTs in AR

csharp
public class OASISGeoManager : MonoBehaviour
{
    async void Update()
    {
        var loc = Input.location.lastData;

        // Poll nearby GeoNFTs every 10 seconds
        if (Time.time - lastPoll > 10f)
        {
            lastPoll = Time.time;
            var nearby = await OASISDNA.Managers.Star.GeoNFTs
                .GetNearbyAsync(loc.latitude, loc.longitude, radiusMetres: 500);

            foreach (var geoNft in nearby)
                SpawnARObject(geoNft);
        }
    }

    void SpawnARObject(GeoNFT geoNft)
    {
        var arPos = GpsToARPosition(geoNft.Latitude, geoNft.Longitude);
        var go    = Instantiate(geoNftPrefab, arPos, Quaternion.identity);
        go.GetComponent<GeoNFTDisplay>().SetData(geoNft);
    }

    public async void OnPlayerTapGeoNFT(GeoNFT geoNft)
    {
        var result = await OASISDNA.Managers.Star.GeoNFTs
            .CollectAsync(geoNft.Id, OASISDNA.CurrentAvatar.Id);

        if (!result.IsError)
            UIManager.ShowReward($"Collected! +{result.Result.KarmaAwarded} karma");
    }
}

Step 4 — Missions & Objectives

csharp
// Called when player enters a GeoHotSpot radius
async void OnHotSpotEntered(GeoHotSpot hotSpot)
{
    if (hotSpot.HotSpotType == "MissionCheckpoint")
    {
        await OASISDNA.Managers.Star.Missions
            .CompleteObjectiveAsync(hotSpot.MissionId, hotSpot.ObjectiveIndex,
                                   OASISDNA.CurrentAvatar.Id);

        UIManager.ShowObjectiveComplete(hotSpot.ObjectiveIndex);
    }
}

Step 5 — Cross-Game Inventory

Items collected in Our World appear in the player's inventory in ODOOM and OQuake — the inventory is stored in WEB5 and is game-agnostic.

csharp
// Load cross-game inventory (shared with ODOOM/OQuake)
var inventory = await OASISDNA.Managers.Star.Inventory
    .GetItemsAsync(OASISDNA.CurrentAvatar.Id);

// Check if player has the Crimson Key (found in ODOOM)
bool hasCrimsonKey = inventory.Items
    .Any(i => i.Name == "Crimson Key");

if (hasCrimsonKey)
    UnlockSecretArea(); // A door in Our World that only ODOOM players can open
💡
Source code

Browse the Our World Unity project at github.com/NextGenSoftwareUK/OASIS/tree/master/ARWorld ↗

Related case studies