Skip to documentation
pocketpool
PROJECT DOCUMENTATION · ENGLISH

Pocket Pool,
explained.

A free browser pool game with quick solo rounds, private matches and optional PPL cosmetics. Here is how it works, what is available and what comes next.

Game version 2.0.2Last reviewed
01 / THE PROJECT

A game you can play today.

Pocket Pool is an arcade pool game that runs in your browser on desktop and mobile. Aim, set your power and build a high score in short rounds, or invite a friend to a private table.

All core game modes are free. You do not need an account, wallet or token to play. Optional cosmetics change how the game looks; every cue has the same physics, power and aim assistance.

AVAILABLE

Solo play & Pool Club

Rush 90, daily and friend challenges, free practice, Shot Academy, local progress and earnable cosmetics.

AVAILABLE

PPL holder cosmetics

An optional pack for a connected, verified Solana wallet holding at least 100,000 PPL. Verification does not spend PPL.

BETA

Private 1v1

Invite a friend, take turns and play rematches. Scores and match results are calculated by the server. Connection and service interruptions can end a room.

PLANNED

Paid cosmetic shop

In preparation. Purchases are not live. Do not send PPL manually to reserve or unlock an item.

Availability shown here was reviewed on the date above. Online features depend on the game service and, for holder checks, the Solana RPC provider.

02 / TAKE THE TABLE

Your first round.

  1. Choose a mode

    Try Rush 90 for a timed round, Daily challenge for the day's shared layout, or Free practice for an untimed table. The daily layout resets at midnight UTC.

  2. Find your angle

    Touch or drag on the table to aim. Use the fine-aim arrows for small adjustments, and lock your aim when you want to keep it in place.

  3. Set power and shoot

    Adjust the power slider, then choose Shoot. In timed solo play, the clock starts with your first shot. Consecutive scoring shots build your combo.

Arcade scoring

Each object ball scores 100 points × your combo, up to ×5. Clearing a table adds 500 points. A miss resets the combo; pocketing the cue ball deducts up to 100 points and resets it too. The 8 ball has the same base value as the other object balls.

Solo keyboard controls: left/right arrows aim, up/down arrows adjust power, Shift + arrow fine-tunes aim, Space shoots and P or Escape pauses.

Bring a friend

Open Private 1v1, create a free room and share the invite or room code. Pocketing without a scratch keeps your turn; a miss or scratch passes play. The highest score wins when the table is cleared, after 40 shots or after 10 minutes. Ties are draws.

Turn clocks keep running while you open menus or leave the page. Two missed turns or an expired reconnect window can forfeit a match. Rooms are temporary and a server restart ends them. Private 1v1 remains Beta.

Make it comfortable

Settings offers 10 interface languages and six graphics levels, from Very Low to Extreme. Graphics settings affect visual detail only. Use a lower level if your device needs it. Left-handed controls, fine aim and optional vibration are also available.

03 / OPTIONAL TOKEN UTILITY

What PPL does today.

PPL is the Pocket Pool project's token on Solana. Its current in-game utility is optional holder cosmetics. Holding PPL is never required for the free game.

POCKET POOL · PPL · SOLANA

Check the full mint address, not only the token name or ticker. This identifies the token; it is not a payment destination. The external token page is separate from the game.

The 100,000 PPL holder pack

Connect a compatible Solana wallet, then choose the separate holder-verification action. The game asks you to sign a wallet-ownership message and checks the wallet's public PPL balance. Holding at least 100,000 PPL can unlock the holder badge, Aurora cue and table, victory styling and a preset emote.

  • No PPL is spent, deposited or staked for this check.
  • Access is temporary and depends on a verified balance. Disconnecting, expiration or a failed check removes access until verification succeeds again.
  • The pack gives no extra power, accuracy, scoring bonus or competitive advantage.
  • These are in-game visual features, not tradable NFTs or cash rewards.
Playing does not earn PPL.

XP, club points, free tickets and trophies are game progress. They cannot be exchanged for PPL or withdrawn as money. There are no paid-entry matches, deposits, cash prizes or withdrawals.

04 / KNOW WHAT YOU APPROVE

Wallets & safety.

A normal wallet connection requests your public address. Holder verification is a separate, optional message-signing step. Read the message in your wallet before approving it. The holder check does not request a token transfer.

Compatible browser wallets may appear in the Wallet menu. Wallet support depends on the provider and device. On mobile, you may need to open the game inside your wallet's browser. Opening a wallet app alone does not connect it. QR pairing is not currently enabled.

  • Use the official pocketpool.fun domain and verify the full token address.
  • Never share your recovery phrase or private key in the game, a chat, a support message or a website form.
  • Decline unexpected transfers or permissions. No transfer is needed to play or verify holder access.
  • The paid shop is not live. Do not send funds to a person or address claiming to sell the planned items.
  • Disconnect in the game to remove the current connection. Manage or revoke site permissions in your wallet's own settings.
Understand the risks.

Cryptoassets can be highly volatile, difficult to sell and lose all their value. Cosmetic utility does not guarantee a token price, liquidity or a financial return. Wallet mistakes and malicious approvals can cause loss. Read the FCA's general crypto risk guide (opens in a new tab) for more background.

This page explains the game and its current features. It makes no claim of an independent security audit or guaranteed protection from bugs or losses.

05 / YOUR GAME DATA

Progress stays in your browser.

Solo progress, records, settings and earned Pool Club cosmetics are saved locally. Clearing browser data can remove them. Export a backup in Settings to keep a copy or move progress to another browser; backups do not resume an active match.

Connecting a wallet does not create a cloud account or automatically sync local progress. Practice and private 1v1 do not grant the local rewards earned from completed timed solo rounds.

Solo saves
Stored in this browser. Local scores and friend-challenge results are player-controlled, not a verified global ranking.
Private rooms
Your nickname, shots, preset emotes and temporary room series are sent to the game service and your opponent. Rooms are held temporarily in server memory.
Online indicator
An approximate count of recently active browser sessions, using an anonymous browser identifier. It is not a verified count of unique people.
Holder verification
Your public address and signed ownership proof are sent to the game API. The API checks the public balance through its Solana RPC provider. The selected badge and pack can be shown in private matches.

The game includes no advertising or third-party analytics. Hosting providers may keep technical access logs. For the in-game explanation, open Privacy & saves on the home page.

06 / DEVELOPMENT DIRECTION

Available now. Planned next.

These labels separate released features from work still in preparation. Planned features can change, and no release date is promised.

  1. AVAILABLE

    The browser game

    Solo modes, practice, Pool Club, local backups, 10 languages and six graphics presets.

  2. BETA

    Private multiplayer

    Invite-only 1v1 rooms, server-calculated results and rematches. Connection reliability and device compatibility remain areas for testing.

  3. AVAILABLE

    Holder cosmetics

    The optional, balance-verified pack for wallets holding at least 100,000 PPL. No tokens are spent.

  4. PLANNED · NOT LIVE

    PPL cosmetic shop

    Wallet-bound cosmetic unlocks are being prepared. Payment verification and item delivery must be validated before purchases are enabled.

    • Stardust pocket effect300,000 PPL
    • Neon Ember cue600,000 PPL
    • Obsidian table felt1,000,000 PPL

    Planned prices and designs. Intended as permanent in-game unlocks tied to the purchasing wallet, with identical gameplay physics. They are not available to buy, reserve or unlock by manual transfer.

  5. UNDER CONSIDERATION

    Community theme votes

    Community input on future table themes is being considered. Voting is not active.

See the changelog for features that have actually shipped.

07 / QUICK ANSWERS

Before your next shot.

Do I need PPL or a wallet to play?

No. Solo modes, Pool Club and private 1v1 are free to play without a token or wallet. The wallet is optional for holder cosmetics.

Does holding PPL make my cue stronger?

No. Every cue has identical physics, power and aim assistance. Holder benefits are visual only.

Why did my holder pack disappear?

Holder access is temporary. Disconnecting, an expired verification, a balance below 100,000 PPL or a failed balance check removes access. Reconnect and verify again when the service is available.

Can I buy the planned shop items now?

No. The paid shop is in preparation. Do not send PPL manually or pay anyone claiming they can reserve an item for you.

Why is my progress different on another device?

Progress is saved in each browser. Export a backup from the original browser in Settings, then restore that file in the other browser. A wallet connection does not sync it.

Are scores, tickets or cosmetics cash rewards?

No. Local game rewards have no cash value, cannot be traded and cannot be withdrawn. Playing does not earn PPL. Private matches have no entry fee or cash prize.