Skip to content
View pokeislandfun's full-sized avatar

Block or report pokeislandfun

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
pokeislandfun/README.md

🏝️ POKEISLAND · $ISLAND

Your island in the sky. Your mons defend it.

Gacha 649 mons. Build a floating island they live on. Climb a daily-paid arena ladder. Collector RPG + async sky arena on Solana.

Play X Telegram Launch Chain


What is POKEISLAND

POKEISLAND is a browser-native collector RPG on Solana. You gacha 649 mons that spawn onto a floating sky island and walk around it, stake four as async arena defense, raid rivals ten times a day, and climb a ladder where the top 3 get paid $ISLAND every midnight from a public prize pool wallet anyone can audit on Solscan.

Gacha collections die inside sunset apps. Crypto games made everything cashable and dumped themselves to death in six weeks. POKEISLAND keeps the collection loop closed so the game stays healthy, opens only the arena faucet where real stakes belong, and puts the prize wallet on-chain.

  • Fun with zero wallet. Loads in a browser tab in seconds; the token gates the ladder, not the fun.
  • Collection never cashes out. Only ladder prizes leave. No farm-and-dump death spiral.
  • Provably fair. Odds printed on every banner, battles replay-verified from a seed, payouts from a public wallet.
  • $ISLAND buys access and supply, never win-rate. Odds are identical for everyone.

Core Mechanics

Pillar What happens Sells the next pillar by
COLLECT Gacha balls → 649-species dex → dupes deepen roster making the arena viable
BUILD Owned mons roam your floating island live flexing the collection to recruit players
COMPETE Defense team + 10 raids/day + daily payout sending losers back to the gacha

The Loop

        COLLECT ───────────► BUILD ───────────► COMPETE
           ▲                                       │
           └───────────────────────────────────────┘

  gacha 649 mons  →  they roam your island  →  arena pays top 3 at midnight
                                                 (public pool, on-chain)

Repository Layout

All documentation and code live under documents/, one folder per GitHub repo.

Repo Role Contents
documents/pokeisland-engine Engine / Core Deterministic seeded-RNG battle engine + $ISLAND fair-launch tokenomics scripts, C4 system design, CI
documents/pokeisland-codex Documentation Whitepaper + STRIDE threat model
documents/pokeisland-gateway API / SDK Game API reference (ENDPOINTS.md) + TypeScript SDK + example
documents/pokeisland-canvas Frontend Vite + TS browser client — island scene, gacha, arena
documents/pokeisland-bestiary Content / Lore 649-species catalog, dungeons, rank tiers, sample entries

Marketing Collateral

Folder Contents
Article/ Long-form X Articles (X-Article.md)
Caption/ 29-caption launch set (CAPTION.md)

Tech Stack

Layer Choice
Client Vite + TypeScript, DOM-rendered pixel world
Game API Edge functions over managed Postgres
Battle engine Deterministic TypeScript, seeded xorshift128 PRNG
Chain Solana · $ISLAND SPL token
Launch PumpFun (100% fair) → Raydium graduation
CI GitHub Actions

Token at a Glance

Property Value
Ticker $ISLAND
Total supply 1,000,000,000
Team allocation 0 (100% fair launch on PumpFun)
Presale None
Arena Pass 1000 $ISLAND / 30-day season → public prize pool
Holder tiers SPROUT 1M · BREEZE 10M · SKYLORD 100M (daily ball drops)
Sinks Pass fees → pool · banner tickets 100% burn · 30% coin revenue → buyback-burn
Daily payout Top 3 (1000/500/250), capped at min(table, 2% of pool)

Roadmap

Phase Milestone
1 — Foundation Full playable client, 649 dex, seeded-RNG engine, brand + assets
2 — Backend Accounts, server gacha, coin ledger, quests, replay verifier
3 — Arena Defense teams, matchmaking, rank math, ghost NPCs, season engine
4 — Token Launch $ISLAND on PumpFun, daily payouts live, pool wallet published, buyback-burn
5 — Seasons & Scale New banners/dungeons (data files), expansion tiers, community-voted ★5 mints

Quick Start

The workspace ships runnable code across the engine, SDK, and client repos.

# Clone the workspace
git clone https://github.com/pokeislandfun/pokeisland
cd pokeisland/documents

# Battle engine — verify a battle + model the prize pool
cd pokeisland-engine && npm install
npx tsx scripts/tokenomics_calc.ts --pool 412500 --passes-per-day 4

# Browser client — play the island locally
cd ../pokeisland-canvas && npm install && npm run dev

⚠️ Scam Warning

POKEISLAND launches $ISLAND 100% fair on PumpFun — zero team allocation, no presale, no whitelist, no allocations.

  • The only official contract address is the one posted on pokeisland.fun and @playpokeisland at launch.
  • Anyone DMing you about a presale, an allocation, an airdrop claim, or "early access" is a scammer.
  • We will never DM you first. Official announcements come only from the pinned channels above.
  • Verify the prize pool and payouts yourself on Solscan. "Don't trust us, Solscan it" is the whole pitch.

Reference Links

Resource URL
Play https://pokeisland.fun
X / Twitter https://x.com/playpokeisland
Telegram https://t.me/pokeisland
Telegram Bot @pokeisland_bot
GitHub https://github.com/pokeislandfun

`$ISLAND` is a utility token for the POKEISLAND game. It is not an investment contract, security, or claim on revenue. Arena prizes are skill-based competition rewards funded by season passes and protocol activity. In-game collectibles have no guaranteed monetary value and cannot be redeemed. POKEISLAND is a fan-built game using community data APIs and is not affiliated with, endorsed by, or sponsored by any third-party IP holder. Nothing here is financial advice. Play responsibly.

Popular repositories Loading

  1. pokeislandfun pokeislandfun Public

  2. pokeisland-gateway pokeisland-gateway Public

    POKEISLAND Game API and TypeScript SDK: server-authoritative gacha, arena matchmaking, coin ledger, and replay-verified battles.

    TypeScript

  3. pokeisland-engine pokeisland-engine Public

    Deterministic seeded-RNG battle engine and $ISLAND fair-launch tokenomics for POKEISLAND, the browser collector RPG on Solana.

    TypeScript

  4. pokeisland-codex pokeisland-codex Public

    Canonical POKEISLAND documentation: whitepaper, $ISLAND tokenomics, and a STRIDE threat model for the on-chain arena prize pool.

  5. pokeisland-canvas pokeisland-canvas Public

    POKEISLAND browser client: a DOM-rendered floating pixel island with gacha ceremony, ATB battles, and arena, built on Vite + TypeScript.

    TypeScript

  6. pokeisland-bestiary pokeisland-bestiary Public

    The POKEISLAND content layer: 649-species roster, summon odds, dungeon catalog, and sky-arena rank tiers as data files.