Skip to content

ONOFFERDEV/tikron-platform

Repository files navigation

Tikron

Source-available, server-authoritative multiplayer SDK for web games (FSL-1.1 — free for any use except competing with Tikron, converts to Apache-2.0 after two years) — the "Supabase for game netcode", but you self-host. You deploy game rooms to your own Cloudflare account (Workers + Durable Objects) with a drop-in TypeScript SDK — your infrastructure, your bill, no lock-in. Anti-cheat by construction (server authority + AOI information hiding). Optional hosted services (leaderboards + a usage dashboard, keyed by API key) are the only managed part — everything else runs on your account.

Live at tikron.dev — landing, playable .io demo, developer dashboard. Building a game with an AI agent? Start at AGENTS.md. Measured performance: docs/PERF.md.

Monorepo layout

packages/
  protocol/   @tikron/protocol — shared wire protocol (message tags, codec)
  client/     @tikron/client   — browser SDK (wraps PartySocket)
  server/     @tikron/server   — authoritative room framework (M1+)
  schema/     @tikron/schema   — binary delta state-sync (M2+)
  react/      @tikron/react    — React hooks (M2+)
  matchmaker/ registry + seat reservation (M4+)
apps/
  gateway/    Cloudflare Worker + GameRoom Durable Object (partyserver)
  demos/      reference games (flagship: realtime .io) (M3+)
examples/
  starter/    "clone -> deploy in 5 min" template (see its README)

Foundation

  • Runtime: Cloudflare Workers + Durable Objects via partyserver (ISC).
  • Language: TypeScript everywhere. Package manager: pnpm workspaces + Turborepo.
  • Tick model: 20–30 Hz setInterval authoritative loop; 20 Hz state broadcast.

Development

pnpm install
pnpm typecheck      # tsc across the workspace
pnpm test           # vitest (incl. workerd integration tests)
pnpm build          # turbo build

# run the edge gateway locally (workerd via wrangler)
pnpm --filter @tikron/gateway dev

Node / toolchain

Node >= 22, pnpm 10.x, wrangler 4.x. See .nvmrc.

Licensed under the Functional Source License 1.1 — free for any purpose except offering a competing multiplayer-SDK/BaaS; each release converts to Apache-2.0 after two years. Different terms (competing use, earlier Apache rights)? Open an issue or contact the maintainers.

About

PlayEdge - realtime multiplayer BaaS for web games (Cloudflare Workers + Durable Objects, server-authoritative)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors