Skip to Content
ContractsContract ReferencePersonal World

Personal World

Draft. The contract for creating and managing your own private Realm.

Purpose

Personal Worlds (also called Realms) let players create their own spaces in Akkadia. Unlike system world chunks which are shared, a personal world is entirely yours - you choose the biome, control who can enter, and decide who can build. Your first world of the default biome is free.

Key Concepts

Biomes

Each world is created with a biome that defines its visual theme and terrain:

  • Everdawn Plains (default) - Peaceful grassland, free for your first world
  • Additional biomes have creation costs and unique aesthetics

Biomes have a price multiplier that affects expansion costs, allowing premium biomes to scale differently.

World Creation

When creating a personal world, you specify:

  • Biome - The visual theme
  • Name - Display name (unique, up to 100 characters)
  • Slug - URL-friendly identifier (unique, lowercase alphanumeric)
  • Seed - Random seed for procedural generation
  • Visibility - Whether the world appears in public listings

Your first world with the default biome is free. Additional worlds require payment.

Expansion

Worlds start small and can be expanded:

  • Each expansion increases the world size
  • Cost increases with size level
  • Biome price multiplier affects expansion cost
  • Funds are distributed to Fee Collector and Protocol

Visibility & Sharing

Control who sees and interacts with your world:

  • isVisible - Toggle public listing visibility
  • Private worlds are still accessible if you share the link
  • Random world discovery only shows visible worlds

Role-Based Permissions

The permission system has three layers:

Permissions - Defined globally by admin:

  • block:install - Install blocks in world
  • block:uninstall - Uninstall blocks from world
  • world:update - Update world properties
  • world:expand - Expand world size
  • world:delete - Delete world
  • role:grant, role:revoke - Manage role assignments

Roles - Defined globally with assigned permissions:

  • editor (default) - Has block:install and block:uninstall permissions (max 5 per world)
  • Custom roles can be created by admin with specific permissions

Role Assignments - Per-world:

  • World owner can grant any role to users
  • Admin can grant any role to users
  • Users with grantable permissions can grant specific roles to others

Permission Check Order (for actions like block install/uninstall):

  1. World owner - has all permissions
  2. Users with assigned roles - checked against role’s permissions

Note: Admin is NOT in the permission check. However, admin can grant/revoke roles and delete worlds.

What’s On-Chain

  • World definitions (owner, biome, seed, size, visibility)
  • Name and slug indexes (uniqueness enforcement)
  • Owner index (which worlds you own)
  • Permission and role definitions
  • Role assignments per world
  • Biome configurations (cost, price multiplier)
  • Size tier configurations

Capabilities

For World Owners

  • Update world name, slug, and visibility
  • Expand world to larger size
  • Grant and revoke roles to other players
  • Full build permissions in your world

For Role Holders

  • Build in worlds where you have permissions
  • Grant roles to others (if your role has grantable permissions)

For Admin/Operator

  • Configure biomes and their costs
  • Configure size tiers and expansion costs
  • Create/update permissions and roles
  • Delete worlds (emergency admin function)

For Anyone

  • Create your own personal world
  • Query public worlds and their info
  • Check name/slug availability
  • Discover random visible worlds

Economics

Creating and expanding worlds generates protocol revenue:

  • Paid in GNOT (native currency)
  • Split between Fee Collector (5%) and Protocol (95%) addresses
  • Excess payment automatically refunded
  • First default-biome world is free per user
Last updated on
AdminChunk
Docsv1.0.10