🧬 Nerd Portal

Public technical documentation for Narrrf's World live systems, Reward Chamber architecture, Cheese Engine runtime, admin surfaces, staking, frontend loops, and the full live Lab ecosystem: Genesis progression, boosters, Genetic inventory, marketplace flow, and Discord-linked system design.

2026 Public Technical Portal: Season 10 live systems + Reward Chamber (3-box economy) + full Lab ecosystem (Genesis + Boosters + Genetic + Marketplace) + Admin Interface + Discord Bot + Database + Frontend + Cheese Engine 13.0 Agent System + DSPOINC Staking System

Reward Chamber Live Backend Authoritative Public Architecture View

🎁 Reward Chamber – Core Economy System

The Reward Chamber has moved beyond legacy chest behavior. It is now a backend-authoritative, admin-controlled, player-facing economy system that runs across profile UI, reward APIs, admin configuration, and Discord-connected premium claim flow.

Backend = Authority

Cooldowns, pricing, availability, weighted rewards, fallback logic, and claim creation are computed server-side.

Frontend = Display Only

Profile surfaces live box state, costs, cooldowns, and results, but it does not decide outcomes.

Admin = Config Layer

Operators manage box activation, pricing, reward pools, fallback behavior, and delivery readiness from the admin interface.

Box 1

🧀 Free DSPOINC Box

Free daily reward loop
Cooldown-based availability
Migrates legacy chest behavior into the new chamber
Stable entry point for the live reward economy

Box 2

🧀 Lucky Cheese Loot

Paid DSPOINC box with weighted reward pool logic
Can deliver store items, genetic items, or fallback DSPOINC
Live admin controls: weights, active rows, pricing, fallback roll behavior
Main production balancing surface for the chamber economy

Box 3

👑 Royal Cheese Mystery

Premium reward box
Creates pending admin claim requests instead of direct item delivery
Designed for moderator review and manual fulfillment
Connected to Discord notification and claim-status flow

System flow

Profile loads visible boxes from /api/user/get-reward-boxes.php.
Player opens a box through /api/user/open-reward-box.php.
Backend validates session, cooldowns, pricing, and available DSPOINC.
Backend resolves reward delivery, fallback, or premium claim creation.
Profile refreshes live chamber state and result messaging.

Connected files and APIs

Frontend

public/profile.html
public/admin-interface.html
public/nerd-lab.html
public/nerd-lab.html

Reward APIs

/api/user/get-reward-boxes.php
/api/user/open-reward-box.php
/api/admin/reward-chamber-config.php

Runtime + Bot

Discord bot / claim notifications
Admin moderation flow for premium claims
Profile-driven cooldown refresh loop

Core tables

tbl_reward_boxes
tbl_reward_box_reward_pool
tbl_reward_box_open_history
tbl_reward_claim_requests

Current production truth

What is live now

Reward Chamber is fully integrated across backend, profile, and admin surfaces.
Profile presents the chamber as a top-level player feature.
Admin now has a dedicated Reward Chamber tab and config fetch support.
The chamber is a core economy system, not just a visual chest widget.

Known open work

Box 3 claim management still needs deeper admin workflow completion.
Economy balancing remains active work: pricing, weights, and drop-rate tuning.
Operator safety improves when backend validation and admin warnings stay aligned.
Public docs can describe the architecture, but execution remains protected server-side.

Live Lab Ecosystem Season 10 Live Stable-First

🧬 Narrrf’s Lab – Full Ecosystem Command Chamber

The Lab is now the official progression command center. It merges player identity, verified Genesis NFT scans, DSPOINC economy context, staking summary, NFT-bound Genesis progression, Discord-bound Genetic progression, booster runtime, and marketplace visibility into one holder-facing system.

Identity Layer

Reads saved verified Genesis scans only. The Lab never live-rescans wallets for progression actions.

Progression Layer

Genesis trait upgrades are stored separately and bound to token_id + trait_type + trait_value, while Genetic items remain user-bound runtime inventory.

Live UX Loop

Track Genesis and Genetic timers, use boosters safely, claim levels, use DSPOINC where allowed, monitor marketplace state, and receive ready-to-claim Discord/runtime notifications.

What the live Lab now includes

Overview, My Genesis Lab, Research Queue, Genetic Shop, My Genetic Inventory, Marketplace, and Knowledge tabs
Featured Genesis viewer + verified collection slider
Trait Research Chamber with start / claim / instant finish actions for Genesis plus a separate Discord-bound Genetic lane
Holder-aware mint CTA for adding more Genesis mice plus identity/profile/stake utility routing
Research Queue navigation toward actionable mice
Cheese-gold / mint-cyan themed chamber styling plus active booster and marketplace command-center direction

Critical rules that must not break

Verified NFT scan = immutable identity layer
Trait upgrades = separate mutable progression layer
Only verified Genesis NFTs may upgrade in the Genesis lane
Genesis upgrades stay with the NFT if ownership changes
Genetic items are user-bound, tradable, and never mutate NFT identity
Marketplace transfers full Genetic runtime state only
Only one active upgrade per NFT
Backend remains authority for ownership, timing, and DSPOINC spend

April 8 update — Genesis Ability Matrix (new live feature)

Genesis Ability Matrix is now a working backend feature in the Lab flow (read + start + timer live). This is a Genesis lane feature and stays NFT-bound.

3 ability categories (9 total abilities)

Fitness: HP / SPEED / AIR
Weapons: ATK / DEF / SPECIAL
Education: SPELLS / CRAFTING / EXPANSION
Unlock source = highest single Genesis trait level on that NFT
One active ability upgrade per NFT
Level cap remains 100

Player steps available now

Open My Genesis Lab and select a verified Genesis mouse
Read matrix state via backend (current levels + unlock map + DSPOINC)
Choose an unlocked ability and start upgrade
System validates ownership, unlock rules, and DSPOINC
Upgrade enters active timer state (upgrading)
Read loop reflects progress until completion window is reached

Current phase: backend loop is confirmed live; full Lab UI/queue/admin/profile visibility polish is still in progress.

March 29 live Lab ecosystem sync

What is now live

Genesis NFT trait progression remains the immutable identity-bound lane
Lab boosters are live and reduce remaining time only
Genetic trait catalog purchase flow is active for holders
Genetic inventory progression is live as a Discord user-bound lane
Marketplace listing, cancel, render, and buy flow are connected into the Lab
Discord runtime already supports ready-claim and marketplace sale notifications

Current architecture rules

Genesis traits = NFT-bound identity and progression
Genetic items = Discord user-bound progression and tradable state
Marketplace transfers never mutate Genesis mice
Available DSPOINC must always subtract active frozen stakes
Backend stays authoritative for timers, balances, ownership, and transfer state
Discord should mirror status first, then later expose safe actions

Connected files and APIs

Frontend

public/lab.html
public/stake-lab.html
public/profile.html
public/admin-interface.html
public/nerd-lab.html

Lab APIs

/api/user/get-nft-ability-upgrades.php
/api/user/start-nft-ability-upgrade.php
/api/user/get-nft-trait-upgrades.php
/api/user/start-nft-trait-upgrade.php
/api/user/complete-nft-trait-upgrade.php
/api/user/instant-finish-nft-trait-upgrade.php
/api/user/get-verified-nft-scan.php
/api/user/get-player-lab.php
/api/user/get-reward-boxes.php
/api/user/open-reward-box.php
/api/user/get-player-lab.php
/api/user/get-user-genetic-items.php
/api/user/get-lab-booster-inventory.php
/api/store/purchase.php
/api/user/buy-genetic-marketplace-listing.php