# Witchspace

> Witchspace is an open-source, browser-based space trading game and a tribute to Elite (1984). It renders glowing "neo-vector" wireframe ships with three.js, has a switchable authentic 1984 mode, and is built so fans, and their AI assistants, can contribute ships, worlds and missions as validated JSON content files.

Play it: https://witchspace.org.uk/play/
Money and markets: https://witchspace.org.uk/economy/ (markets, limit orders, real-time Bitcoin, a currency per system, company stablecoins, liquidity pools; full record at https://witchspace.org.uk/design/economy/)
Multiplayer: https://witchspace.org.uk/shared-space/ (shared space, in beta: other commanders in the same star system, live, refereed by a server per system)
Shared flights: a commander's shared clip has its own page, https://witchspace.org.uk/clip/<id>, playing the video they chose, with the fight rebuilt a tap away
Website and design documents: https://witchspace.org.uk/design/

Code is GPL-3.0. Content is CC BY-SA 4.0. Witchspace is not affiliated with Frontier Developments.

## Start here

- [README](https://github.com/witchspace-game/witchspace/blob/main/README.md): what the project is and how to run it
- [AGENTS.md](https://github.com/witchspace-game/witchspace/blob/main/AGENTS.md): rules and workflow for AI assistants creating content or code
- [CONTRIBUTING](https://github.com/witchspace-game/witchspace/blob/main/CONTRIBUTING.md): how to add a ship in five minutes

## MCP server

- [Witchspace MCP server](https://witchspace.org.uk/design/mcp-server/): connect to https://space.witchspace.org.uk/mcp (streamable HTTP, read-only, no sign-in) for validate_ship, preview_ship, balance_check, list_ships, get_ship, designs, get_design, help_wanted and galaxy_system

## Content formats

- [Ship schema](https://github.com/witchspace-game/witchspace/blob/main/schemas/ship.schema.json): JSON Schema for ships and stations
- [Example ship: Cobra Mk III](https://github.com/witchspace-game/witchspace/blob/main/content/ships/cobra-mk3.json)
- [Example station: Coriolis](https://github.com/witchspace-game/witchspace/blob/main/content/ships/coriolis.json)

## Setting

- [Worldbuilding bible](https://github.com/witchspace-game/witchspace/blob/main/docs/worldbuilding.md): tone, setting and naming conventions

## Optional

- [Credits](https://github.com/witchspace-game/witchspace/blob/main/CREDITS.md): tribute to Ian Bell and David Braben, and related projects