Design Principles

The Akashic Record

Every karma event is recorded in the avatar's Akashic Record — an immutable, append-only log of every positive and negative karma event, including source OApp, event type, timestamp, and amount. This makes karma auditable and resistant to retroactive manipulation.

OApp Integration Pattern

A good OApp karma integration follows these rules:

  1. Award on meaningful events only — quest completion, helping another player, creative contribution. Not for clicking buttons or logging in daily.
  2. Use specific karma typesCompletedQuest rather than JoinedOAPP for quest events. Specific types make the Akashic Record useful.
  3. Gate content on karma thresholds — use GetAvatarsWithKarmaGreaterThan to unlock hard content for high-karma players.
  4. Deduct sparingly — negative karma should reflect genuine antisocial behaviour, not minor mistakes.

Suggested Karma Tiers

These tiers are a starting point — tune them to your OApp's economy:

TierKarma RangeSuggested unlocks
Initiate0 – 99Basic OApp access
Apprentice100 – 499Social features, clan membership
Adept500 – 1 999Advanced quests, item crafting
Master2 000 – 9 999Rare NFT drops, leadership roles
Grandmaster10 000+Governance participation, exclusive zones