Get involved

Build it with us

Witchspace is built in the open by the people who love it, and most of what it needs isn't code: ships, characters, stories, playtesting and good arguments about design.

Design a ship

Every ship is a small file of points, faces and a glow colour. Browse the fleet and improve one, or draw your own.

Write the galaxy

Saloon regulars, company people, trail stories, rumours. Dry, wry and a little lawless.

Build a Legend

Rare ships that tip their hat to great science fiction. Evoke the idea, never copy the design.

Playtest

Fly it, break it, tell us how it feels. Good bug reports are gold.

Shape the design

Suggest ideas and vote on what comes next. Every feature is designed in the open first.

Code

TypeScript and three.js: flight, combat, the economy, the shared galaxy. Start with a good first issue.

How to start

PlayFly a few runs, so you know what it feels like.
Pick somethingFrom help wanted below, or something you'd love to see.
Say helloEmail hello@witchspace.org.uk or post on the ideas board, and we'll help you get going. No GitHub needed.
Hand it inMade a ship or a Titanoboa module? Hand it in here: it's checked as you go and credited to your callsign. No GitHub needed. Or shape a ship from scratch in the ship editor.

Help wanted

Pick something up

Every design lists what it needs. Open what you're good at; most of it needs no code.

Ships and design9 tasks

Sketch moving cranes and worker craft for the TitanoboaCompanies and contracts
Design a Legend of your own (a homage, never a copy)The Falcons, a Legend
Sketch a long-haul hunter within the blueprint's limits, at most 16 facesMark Moxon's ship
Draw the Shrike's clamp working: how it holds a ship and drains its driveThe Shrike
Design a module to the standard - a greenhouse, a shipyard cradle, an ice refinery, anything you can imagineThe Titanoboa, a modular factory
Design the detention module - cells for the Marshals' captures, one clear shapeThe Titanoboa, a modular factory
Pitch a hull for a maker's line-up, in its design languageThe shipbuilders
Pick a class with no ship and pitch one for it, with its maker and its peopleShips, classes and makers
Design a new station class (a homage is fine, a copy isn't)Stations and worlds

Writing22 tasks

Write a combat mission briefing, with its peopleCombat rating and missions
Write a help-wanted task for a design you know wellThe community platform
Write a special assignment that goes wrong, with its peopleCompanies and contracts
Write what a development means for the people already living thereFrom discovery to development
Write a trail: clues across several systems, with their peopleExploration
Write a beacon log or a derelict's last entryExploration
Write the newsroom's voice: what it says when it buys your footage of the FalconThe flight recorder
Invent a rare sight worth photographing: what it is, where, and who'd pay for proofThe flight recorder
Write the insurers' voice for a reconstruction - the assessors' note is built; more lines for other endings (a collision, a missile, the station's guns)The kill cam
Write a loan shark: their terms, and what happens if you miss a paymentLaw, travel, debt and capture
Write a world event: what happens, who it hurts, the headlineMarkets and trade
Write the prompts that make a good first ship with it, as a guide for newcomersThe Witchspace MCP server
Write radio chatter for a busy systemThe radio and comms
Describe a breakdown the way a pilot would notice itShip condition and servicing
Write Nell and Ide Halloran's yard: the place, the peopleThe Dragonfly
Write Bram Solo's voice on the radio, as he takes a Wexley-Yorozu haulerThe Shrike
Write the yard's radio when a reactor section is being changed outThe Titanoboa, a modular factory
Name the module types as Wexley-Yorozu's catalogue would (dry, corporate, a little sinister)The Titanoboa, a modular factory
Write a maker's yard and its people, the way a pilot would describe themThe shipbuilders
Write a maker's character in a paragraph, the way a pilot would describe themShips, classes and makers
Write a saloon regular: who they are, how they feel, what they knowTrading
Write a person inside one of the companies, and what they wantThe trading companies

Art and interface2 tasks

Mock up the chart's key: every symbol, at phone sizeThe galaxy chart
Sketch or mock up the radio panel's cards, colours and motionThe radio and comms

Playtesting8 tasks

Fly on a phone and tell us what your thumbs hatedFlight HUD and touch
Playtest the death replay and tell us if it made you want to share it, or just stungThe flight recorder
Playtest the replay - did it show you what killed you, and did you learn anything from it?The kill cam
Playtest getting caught and tell us if it felt fairLaw, travel, debt and capture
Balance-check prices on a run you fly oftenMarkets and trade
Try it with your own assistant and tell us what it got wrongThe Witchspace MCP server
Fly shared space with a friend and report what brokeServers and hosting
Playtest the trader's screen and tell us what confused youTrading

Game design10 tasks

Tell us what put you off contributing, or what would have helped you startThe community platform
Argue for (or against) station scrip in the open questionsEconomy and exchanges
Design the station board as it appears in the game, dockedThe flight recorder
Design the replay cameras - the two-shot and the hold on the explosion are built; which other angles make a fight read in a few seconds?The kill cam
Suggest a tool you'd want your assistant to haveThe Witchspace MCP server
Argue how running a station should be earnedPlayer-run stations
Redesign the radio panel so a glance says whether anything needs you (see "The wall of text")The radio and comms
Critique the core modules - does each one read as what it is, and is anything in the wrong place?The Titanoboa, a modular factory
Argue the balance in the class table: what should each class be best and worst at?Ships, classes and makers
Model a currency crisis for one government typeSystem currencies

Codegood first issues

Prototype a better radio panel in HTML and CSSThe radio and comms

TypeScript and three.js: flight, combat, the economy, the shared galaxy. Start with an issue labelled good first issue (ask in it, and we'll help you get going), and read how to contribute.

Bring your own AI

Witchspace is built to work with AI assistants such as Claude, ChatGPT and Cursor. Ask yours to "design a pirate gunship for Witchspace" and it will check its work against the game's own rules. You're still the author: play-test what you submit, and say it was AI-assisted.

Add Witchspace to your assistant

There are two addresses. Add the one you need, or both.

To read and check, with no sign-in: check a ship against the rules, draw it beside a Cobra for scale, read every design and help-wanted task, and look up any system. Nothing you do with it changes anything.

https://space.witchspace.org.uk/mcp

To hand work in: the same tools, plus handing in ships and Titanoboa modules as you, and following their review. Adding it sends you to a page on this site to sign in and say yes; nothing goes public until a maintainer accepts it.

https://space.witchspace.org.uk/mcp/build

Claude: Settings, Connectors, Add custom connector, and paste an address.
ChatGPT: Settings, Connectors (developer mode), Create, and paste an address.
Claude Code: claude mcp add --transport http witchspace https://space.witchspace.org.uk/mcp/build (or /mcp to only read)
Cursor and others: add it as a remote MCP server (streamable HTTP).

How it works, and what's next. A plain summary of the project for any AI lives at /llms.txt.

Comfortable with GitHub? The contributing guide GitHub ↗ and Discussions GitHub ↗ are there too. Everyone taking part agrees to the code of conduct; problems can be reported privately to conduct@witchspace.org.uk.