Productivity · Retrospective
Writing tutorials for players who have never used a wallet

On 14 June we published five tutorials on the Playermon blog: how a battle works, how PvE works, what to do in SpaceDen, how to hunt for hidden SGEM, and how to buy energy. They sit beside two older guides from November last year on getting MATIC and USDT into a Polygon wallet. Together they are most of what a new player reads before a first battle, and this month I have been treating them as part of the product rather than as marketing that follows it.
Two sets of rules
A new player of a blockchain game learns two things at once. One is the game: a team of up to three Playermon, a deck of 24 skill cards, and action points that carry over between rounds up to a limit of ten. The other is the wallet: an extension or app, a network, a token for fees, and a recovery phrase that is the account itself.
The first set of rules is ours. We designed it, we can change it, and if a player misreads it the cost is a lost battle. The second set is not ours. MetaMask, Polygon and the exchanges each have their own screens and their own failure modes, and a mistake there can cost money that nobody can return. A tutorial has to keep the two apart, because the tone that suits one is wrong for the other. Game rules can be learned by trying. Wallet steps should be followed exactly, once, and slowly.
What a game guide can assume
The battle tutorial assumes nothing about crypto at all. It explains strength, intelligence, agility and luck, the six phases of a round, and how a Playermon targets the nearest enemy by column and row. The PvE guide covers the Anchorland map, a star for every Playermon that survives a stage, and a leaderboard score that adds up each stage's best result. Someone who has played a card game can follow both without knowing what a token is.
That is the right standard for the game half: assume the reader plays games, and explain only what is particular to ours.
What a wallet guide must spell out
The wallet guides cannot work that way. The MATIC guide walks through buying on an exchange, copying the address from MetaMask, choosing the MATIC network on the exchange's withdrawal screen, and keeping 0.1 MATIC back for gas when swapping on Quickswap. Every one of those steps leans on an idea the reader may never have met: that an address is not a username, that the same address exists on several networks, and that the fee is paid in a different token from the one being moved.
What I would have a wallet guide assume is only this: the reader has a phone or a computer, can install software from an official source, and will do what the screen in front of them says. Everything else has to be written down.
Three things it must never assume:
- That the reader knows which network they are on. Choosing the wrong network on a withdrawal screen is an easy way to send tokens somewhere the wallet will not show them. The guide should name the network at the exact step where it is chosen, not once at the top.
- That a screenshot will stay accurate. Exchanges and wallets redesign their screens on their own schedule. A step that says what it does lasts longer than one that says which button to press.
- That the reader knows a recovery phrase is never needed to play. No step in our game asks for it. Saying so in every wallet guide costs one line and closes off the scam where someone posing as support asks for it.
Keeping the wallet out of the game client
One design choice makes the game tutorials shorter. The SGEM treasure-hunt guide has the player log in on the Playermon website with MetaMask, then sign in to the downloaded game with a QR code or an access token from their profile page. The game client on Windows or Android never asks for the wallet.
That keeps the part of onboarding that can lose money in one place, a browser where the player already has the extension, and keeps the game itself about the game. It also means the wallet guides and the game guides can be written and corrected separately.
Telling players why, not only how
The energy guide carries a point the others leave out. Energy can only be bought with SGEM, and buying it lets a player keep playing instead of waiting for points to recharge. That tells a new player what SGEM is for inside the game. A guide that explains why a step exists is easier to follow than one that only lists the steps.
Reading the set together, the gap I see is the path between them: one page that starts from nothing and ends at a first battle, in order, with every step that moves money clearly marked as such.
Voting on our first DAO proposal closed on 8 June, and that vote depended on people knowing how to connect a wallet and sign a message. The tutorials are where that knowledge starts.