Skip to content

ael-dev3/Warpkeep

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

168 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Warpkeep

Warpkeep turns a Farcaster identity into a permanent castle in a shared strategy world that remembers you.

What is this?

Genesis 001 is a persistent, invite-only 10,000-cell Lowlands realm with 100 permanent castle sites kept close to its founding district. Each founder signs in with a verified Farcaster identity, receives one durable keep, and privately holds Food / Wood / Stone / Gold. Alpha 0.3.22: The Gate Holds is live: the violet passage stays centered beneath the keeper's chosen point, resting wagons wait unseen inside their keeps until deployed, and all four Workers, their journeys, balances, and recall controls remain coherent through reloads and reconnects—without moving authority out of the Realm. Each founded keep has four permanent workers that can be sent from resource sites on the map, gather all four resources, settle production automatically, and return home on command. Founders can explore the coast, twelve rivers, biome-shaped forests, resource sites, active wagons, and public keeper portraits, then return to a world that remembers them, while the intended core strategy loop is not playable yet. Warpkeep is a one-person experiment—not a finished MMO or financial product; there are no token rewards, no financial promises, and joining does not earn an airdrop or financial return or guarantee a reward or future value.

Development preview of Genesis 001 showing the Lowlands and an open Wheat Farm inspection panel.

Development preview of the Realm Wheat Farm inspection flow; this documentation image does not itself activate or authorize gameplay.

Quick start

Prerequisites: Git, Node.js 22, and npm 10.

git clone https://github.com/ael-dev3/Warpkeep.git
cd Warpkeep
npm ci
npm run dev

Open the local URL Vite prints; shared Alpha access stays off by default. Contributor checks live in CONTRIBUTING.md, authentication setup lives in the Farcaster integration guide, and deeper setup lives in reconstruction and recovery. Asset reconstruction is explicit and not part of a normal build; read asset provenance before working with protected source packages.

Current status

State Today
✅ Live Alpha 0.3.22: The Gate Holds is live and invite-only.
✅ World Genesis 001 persists 10,000 cells, a coastline, twelve one-cell rivers, and 100 permanent castle sites near the founding district. Founders return to one durable keep, explore the Lowlands up to its fog, and inspect nearby founders through their public username / portrait / castle. The same authoritative world waits across sessions.
✅ Authority FID is the durable identity; handles and portraits are bounded presentation metadata. Farcaster sign-in uses a browser-bound, least-privilege bridge. The browser presents. The server decides admission and ownership. It also owns resources, timers, and saved state.
✅ Resources Each keep privately holds Food / Wood / Stone / Gold. Food, Wood, and Stone come from authoritative terrain yield and can also be gathered at Wheat Farms, Logging Camps, and Stone Quarries; Gold comes from Gold Mines. Completed yield settles without a Claim step, and occupied sites keep their gathering story in one record. The browser never invents balances.
✅ Marks Community Marks are separate private accounting and start at zero. They cannot be spent, converted, or transferred. They have no cash value, promised utility, or reward loop. The world, rules, and direction will evolve.
🚧 In progress Worker journeys now begin on the map, but the larger construction, strategy, and social loops are still being built.
📋 Planned Construction and upgrades; units / scouting / travel / combat; alliances / trading / chat; seasons / governance. Design notes are experiments, not promises that these features will ship unchanged.

Tech stack

  • React — Keeps interactive interface components manageable.
  • TypeScript — Makes shared data contracts explicit.
  • Vite — Builds the browser client quickly.
  • Three.js / WebGL — Renders the Lowlands in browsers.
  • Responsive CSS — Supports phones, keyboards, and fallbacks.
  • Farcaster Auth — Connects castles to verified identities.
  • Cloudflare Workers — Verifies sign-in with least privilege.
  • SpacetimeDB — Owns Realm and player state.
  • Vitest — Catches regressions across critical boundaries.

Links

License

Warpkeep software uses Apache-2.0; authorized project-owned creative work follows the recorded CC-BY terms, while some GameReady runtime assets have narrower permissions and no general open-content or derivative license—read LICENSING.md and ASSETS-LICENSE.md before reuse.

About

A persistent Farcaster strategy world where every admitted founder has a castle in Genesis 001.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages