A spaceship simulator for LARPs
git clone https://github.com/starwards/starwards ~/.claude/skills/starwards<h1 align="center"> <br> <img src="static/images/starwards-logo.webp" alt="logo" width="200"> <br> Starwards <br> <br> </h1> <p align="center"> <a href="https://discord.gg/p56nSVEjdb"><img alt="Discord Chat" src="https://img.shields.io/discord/843041591772971028?color=5865F2&label=discord&style=flat-square"></a> <a href="https://circleci.com/gh/starwards/starwards/tree/master"><img alt="CircleCI" src="https://circleci.com/gh/starwards/starwards/tree/master.svg?style=svg"></a> <video src='https://user-images.githubusercontent.com/6019373/178277941-01a61ddb-c6cb-4620-b5aa-966291710d69.mp4' width=180/> </p> # Background Starwards emerged from years of extending EmptyEpsilon for space LARPs (2016-2021). After extensive modifications and a productive fork, we hit fundamental limitations - EmptyEpsilon was designed for short sessions, not the lengthy LARP events we run. We decided to build Starwards from scratch as a platform designed specifically for LARP needs. # What is this? Starwards is a space and starship simulator designed specifically for LARPs (Live Action Role-Playing games). Derived from the "Starship Bridge Simulator" genre, Starwards is designed to support long games where the players interact with the ship's system throughout the ship, not just in the bridge. # how to run and use it Currently executables are being built after every change. click on [this link](https://app.circleci.com/pipelines/github/starwards/starwards?branch=master&filter=build&status=none&status=success), click on the top-most "build" workflow, then on the "build executables" job, then on the "artifacts" tab, and choose the executable that fits your computer. download and run it, and open [this link](http://localhost/) in your browser. This is not a solution we like. We are [open to improvements and suggestions](https://github.com/starwards/starwards/issues/832). ### the game is running! now what? Missing documentation. contributions are welcomed! In the "GM" and "empty" screen, the list to the left represents UI widgets that can be *dragged into the main screen*. so you build your own screen. this way each game can have their stations set up the way they want to. later we will support saving the screen presets. https://blog.starwards.space/2021-03-06-modular-peek/ # how do I get involved Starwards is a labour of love built by enthusiastic volunteers. We eagerly welcome anyone who would like to join us, so long as they adhere to our [code of conduct](CODE_OF_CONDUCT.md). Please report any code of conduct violations to [greenshade@gmail.com](mailto:greenshade@gmail.com) To get started, you can: 1. Take a look at the "Issues" in this repository - especially those marked "Good first issue". Those with the "Help Wanted" tag probably don't have anyone else working on them. 2. Drop by our [chat](https://discord.gg/p56nSVEjdb) and ask what you can work on, or how to get started. 3. Open an issue with your idea(s) for the project or tell us about them in our chat. 4. Read our [developers blog](https://blog.starwards.space/) ## How do I contribute? Please read [Contributing to Starwards](CONTRIBUTING.md) for more details. ## License `SPDX-License-Identifier: AGPL-3.0-or-later` For more details on license and copyright see [the license file](LICENSE.md) The current license was chosen because we feel it best represents the ethics of knowledge sharing in the LARP community. If you feel that we should consider changing the license, please contact us on our [chat](https://discord.gg/p56nSVEjdb).