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 types — CompletedQuest 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