Home › Docs › Start here

The playtest and the tester program

How to join the Pixel Kingdom Wars playtest (invite codes, Seeker, referral codes) and how the tester program scores your play and feedback.

Pixel Kingdom Wars is invite-only right now. This page explains the three ways a wallet gets through the JOIN THE PLAYTEST gate, what the gate screen does, and how the tester program turns verified play and useful feedback into points on a public leaderboard. Everything in the playtest runs on Solana devnet: SOL and KEEP here are test-net tokens with no real value.

Quick facts

• Admission is tied to your wallet: once a wallet is admitted, it stays admitted (unless it is revoked).
• Three doors in: a one-time invite code from your approval email, automatic admission for a wallet holding a Seeker Genesis Token, or a friend's KEEP-XXXXX referral code or link.
• On Solana Seeker the game is on the Solana dApp Store; the installed app is the same game, and the Seeker door below admits you without a code.
• Each friend's referral code can admit at most 25 wallets.
• The gate has one code box: anything starting with KEEP- is treated as a referral code, everything else as an invite code.
• The tester program has 51 verified milestones in seven categories, plus points for feedback. The numbers below come from the game's shared constants and may be retuned during the playtest; points already awarded never change.
• Feedback pays 10 base points for your first 3 reports each UTC day; 8 reports per day is the hard cap; an admin importance rating can add up to 120.
• The public leaderboard shows the top 100 by points, names and shortened wallets only.

Who gets in

Signing in is not gated. Anyone can open the game, tap CONNECT WALLET, and sign the free sign-in message (see Wallets and sign-in). What the gate protects is everything after that: your base, building, raids and the rest. Until your wallet is on the admitted list, every game request is refused and the client shows the JOIN THE PLAYTEST screen.

Why: sign-in stays open on purpose. Redeeming a code needs a signed-in session, so an invited player has to be able to get that far before they have access to anything else.

1. Invite code from your approval email

• Apply at pixelkingdomwars.com/#apply (the gate screen links there too). The form needs only an email; handle, socials and the questions are optional.
• If approved, you receive a one-time code by email: 26 characters, shown in dash-separated groups of five. Rejections send no email.
• Paste the code into the gate's code box. Codes are single-use, and a used code and a wrong code give the same invalid or already-used invite code message, so if yours fails, check you are signed in with the wallet you meant to use.
• Redeeming costs nothing and needs no SOL; it happens before any land purchase.

2. Seeker auto-admission

If your wallet holds a Solana Mobile Seeker Genesis Token (checked on Solana mainnet, the one place the game reads mainnet), you are admitted automatically. The gate screen runs the check once when it opens; nothing you type can influence it. On success you see SEEKER VERIFIED — WELCOME TO THE PLAYTEST.

• One Seeker Genesis Token admits at most one game account, forever; unlinking does not free it for another account.
• If your token sits on a different wallet than the one you signed in with, the gate offers a way to link it.
• A negative check is cached for 24 hours before the game will look again, so a token that arrives in your wallet later may need a day to be noticed.
• A .skr domain on its own grants nothing; the token is what counts. Verified Seekers may later adopt their .skr name as their username.

3. A friend's referral code

Any admitted player can get a personal code (shown on the Profile screen) of the form KEEP-XXXXX (five characters after the dash). Friends can use it two ways:

• Open https://play.pixelkingdomwars.com/?ref=KEEP-XXXXX. The game remembers the code and redeems it at the gate right after you sign in.
• Or type the code into the gate's code box.

Rules that apply:

• One code admits at most 25 wallets. After that, the code answers the same invalid referral code message as an unknown code or a self-referral.
• Admission always works inside that cap. Separately, the referral relationship (the one that can give your friend a mining bonus later) is only recorded if your account is 14 days old or less. Outside that window you still get in; the referral just does not count for your friend.
• There is no bonus for the invited player; the inviter's benefit is covered in Quests, referrals, mail, chat and clans.

Tip: the gate box routes by prefix. KEEP-... goes to the referral path, anything else to the invite path. You cannot redeem an invite code by putting KEEP- in front of it.

What the gate screen shows

• The line Pixel Kingdom Wars is in Playtest. Enter the one-time invite code from your approval email to unlock this account.
• A SIGNED IN AS line with your session wallet, and if the wallet you currently have connected is a different one, a one-tap SIGN IN WITH button for it. (This part is in the codebase but, as of this writing, not yet confirmed deployed.)
• BACK — SWITCH ACCOUNT, which signs you out.
• A link to the application form and the Seeker linking door.

Code redemption is rate-limited to 10 attempts per minute per IP. If access is ever revoked, re-entering your old invite or a referral code does not restore it.

Why: the playtest gate is a switch the team controls, not a permanent rule. When the gate is off, every wallet can play. Treat everything on this page as "during the playtest."

The tester program

During the playtest, the game keeps score of what each tester has actually done. The program exists so the team can see who finished what, weight it by how important that path is to test, and reward top testers after the playtest through their wallet. The in-game copy says it plainly: Points reward real, verified actions during the playtest. Top testers are rewarded after the playtest — your wallet is your ticket.

Two things earn points:

1. Milestones — verified automatically from the game's own records (ledger, raids, deposits, and so on). You do not claim them; the server derives them, and once earned a milestone is never un-earned, even if you later reset the tutorial or unequip the gear.
2. Feedback — reports you submit from the in-game TESTER screen, with a base award on submit and a possible admin bonus afterwards.

Points are frozen when they are awarded. If the team retunes the weights later, only future awards change.

The TESTER screen

A TESTER pill in the HUD opens the TESTER PROGRAM screen with three tabs:

• MY PROGRESS — your points, your rank (or UNRANKED), and the full milestone checklist grouped by category. Opening this tab runs a recompute for your wallet (at most once a minute) and toasts anything new, for example +25 TESTER POINTS — ATTACK ANOTHER PLAYER. A background sweep also catches up everyone every 10 minutes.
• LEADERBOARD — the same public board the website shows.
• FEEDBACK — the report form and your past reports with their status and rating.

Milestones and points

All values below come from the game's shared constants. The weighting is deliberate: money and on-chain paths score highest, then combat and economy loops, then onboarding basics, then social. Tiered entries (10, 50) are separate milestones, so reaching the higher one also leaves the lower one earned.

First steps

Progression

Army and heroes

Combat

Economy

Land and money (web3) — all devnet; the SOL and KEEP involved have no real value.

Social

Tip: the two single biggest milestones are a withdrawal reaching SENT (120) and buying land (100). Both are exactly the paths the team most wants exercised on devnet. See Deposits, withdrawals and 2FA and Land deeds and the globe.

Feedback rules

From the FEEDBACK tab, pick a category — BUG, BALANCE, UX / CONFUSING, IDEA or OTHER — give a title (up to 80 characters) and details (at least 10, up to 2,000 characters), then SEND FEEDBACK. The game attaches the screen you were on, the build, and your platform so you do not have to.

• Base points: 10 for each of your first 3 reports in a UTC day. Later reports that day are recorded but earn no base points; the screen tells you TODAY'S PAID REPORTS ARE USED UP.
• Daily cap: 8 reports per UTC day. The ninth is refused until tomorrow.
• Admin importance bonus: when an admin rates your report, the rating replaces any earlier bonus rather than stacking: low 0, medium 20, high 50, critical 120.
• A report marked rejected or duplicate keeps its base points but earns no bonus, whatever its importance.
• Submissions are rate-limited to 10 per minute.

Why the split: base points reward the habit of reporting; the bonus rewards reports that matter. Capping paid submissions at 3 a day keeps the board from favoring volume over substance.

The public leaderboard

The board is meant to live at pixelkingdomwars.com/leaderboard (that page is not yet published as of this writing) and inside the game's LEADERBOARD tab. It shows the top 100 testers by total points, each row with a display name (or KEEPER if none is set), a shortened wallet like abcd…wxyz, and counts of milestones and reports. Full wallet addresses are never published; the team exports them privately when it is time to reward top testers. The website page is also designed to look up a single wallet's checklist if you type the address in.

• Ranking is by tester points only; trophies and leagues are a separate system.
• The board is cached for a short while (30 seconds), so a fresh milestone can take a moment to appear.
• Being on the board is not a promise of any specific reward; the landing page is explicit that playtest participation is about testing the game, and that the playtest runs on devnet where nothing is worth real money.

See also

• Getting started
• Wallets and sign-in
• Quests, referrals, mail, chat and clans
• Land deeds and the globe
• Deposits, withdrawals and 2FA
• Glossary and FAQ