{"id":13571899,"url":"https://github.com/Thorium-Sim/thorium-nova","last_synced_at":"2025-04-04T09:30:39.355Z","repository":{"id":37088130,"uuid":"281223373","full_name":"Thorium-Sim/thorium-nova","owner":"Thorium-Sim","description":"Next-generation Spaceship Controls","archived":false,"fork":false,"pushed_at":"2024-05-18T00:38:01.000Z","size":65856,"stargazers_count":336,"open_issues_count":47,"forks_count":13,"subscribers_count":15,"default_branch":"develop","last_synced_at":"2024-05-22T18:21:24.307Z","etag":null,"topics":["hacktoberfest","simulation"],"latest_commit_sha":null,"homepage":"https://thoriumsim.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Thorium-Sim.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":"GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":"thorium-sim","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2020-07-20T20:52:24.000Z","updated_at":"2024-05-28T18:23:13.586Z","dependencies_parsed_at":"2022-06-24T15:10:13.381Z","dependency_job_id":"68e6ccce-95db-4e71-afa4-2615a21a8405","html_url":"https://github.com/Thorium-Sim/thorium-nova","commit_stats":{"total_commits":663,"total_committers":8,"mean_commits":82.875,"dds":0.196078431372549,"last_synced_commit":"04cba8c8b61fd18089dbfc38fe2333966e6290ff"},"previous_names":[],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thorium-Sim%2Fthorium-nova","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thorium-Sim%2Fthorium-nova/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thorium-Sim%2Fthorium-nova/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Thorium-Sim%2Fthorium-nova/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Thorium-Sim","download_url":"https://codeload.github.com/Thorium-Sim/thorium-nova/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247152769,"owners_count":20892552,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","simulation"],"created_at":"2024-08-01T14:01:08.025Z","updated_at":"2025-04-04T09:30:34.341Z","avatar_url":"https://github.com/Thorium-Sim.png","language":"TypeScript","funding_links":["https://opencollective.com/thorium-sim"],"categories":["TypeScript"],"sub_categories":[],"readme":"[![Discord](https://img.shields.io/discord/390968011605147648.svg)](https://discord.gg/UvxTQZz)\n[![All Contributors](https://img.shields.io/badge/all_contributors-0-orange.svg?style=flat-square)](#contributors)\n![Version](https://img.shields.io/github/package-json/v/thorium-sim/thorium-nova)\n![GitHub last commit](https://img.shields.io/github/last-commit/thorium-sim/thorium-nova/develop)\n\n# Thorium Nova\n\n## The Future of Bridge Simulation\n\n_Want to help contribute? Check out the\n**[contributing document](CONTRIBUTING.md)**._\n\nThis is the main repository for Thorium Nova, a multiplayer real-time bridge\nsimulator game. To learn more about what Thorium Nova is, check out\nhttps://thoriumsim.com.\n\n![Statistics about this repo](https://repobeats.axiom.co/api/embed/f960db96438e7daa257bdeb628c97c3be694fbec.svg \"Repobeats analytics image\")\n\n## Development Quick Start\n\nCheck out the [project roadmap](https://github.com/orgs/Thorium-Sim/projects/2)\nfor tasks that are planned, but not yet assigned to anyone. Add a comment to an\nissue to ask to have that issue assigned to you.\n\nI recommend using [Volta](https://volta.sh) to manage your Node and NPM\nversions, since it will automatically install the correct version when you work\non Thorium Nova. If you're on Windows, I also recommend\n[using WSL](https://docs.microsoft.com/en-us/windows/wsl/install), although\nothers have had success in Windows.\n\nFirst\n[install git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) and\nrun this command to download the code:\n\n```bash\ngit clone https://github.com/Thorium-Sim/thorium-nova.git\n```\n\nOnce the project has been cloned, you can install dependencies using NPM. You\nwill also want to install the default plugin, which has the configuration and\nassets for the game itself. Once you've done these two things, you can start the\nproject.\n\n```bash\nnpm install\nnpm run dev\n```\n\nThis will automatically start the client and development servers and open up the\nUI in your web browser. If it doesn't automatically open, you can open it\nyourself by going to http://localhost:3000.\n\n\u003e Note: Running `npm install` will automatically update the default plugin with\n\u003e the latest assets and configuration. If you want to manually pull the latest\n\u003e default plugin from Github, you can run `npm run init:plugin`.\n\n## Project Vision\n\nThorium Nova is a platform for creating powerful narrative experiences in a\nstarship bridge simulator. In these bridge simulations, crew members are given a\nspecific mission and must work together, using their different roles and\nfunctions to accomplish their goals. Thorium Nova prioritizes story over\naction - the crew should feel like they are actors on the set of a science\nfiction show. The crew might have a Flight Director, orchestrating their mission\nbehind the scenes.\n\nThe purpose of Thorium Nova is to facilitate these experiences. This includes a\nsimulated universe for the stories to take place in, controls for the crew\nmembers and flight director, a viewscreen and other methods for the crew to\ninteract with the universe, a way to write and run mission storylines, show\ncontrols like lights, sound effects, music, and video to help the crew become\nimmersed, automation to help the flight director, training and documentation for\nboth the crew and flight director, and ways to customize the experience for any\naudience.\n\nThorium Nova is also an open source project that depends on volunteer\ncontributions. Since this project would die without the help and support of the\ncommunity, every effort should be made to welcome and encourage contributions\nfrom anyone willing to help. Since Thorium Nova is a code-heavy project, this\nespecially includes making the codebase as approachable as possible for\ndevelopers.\n\nThorium Nova's primary audience is casual gamers and hobbyists who want to run\nsimulations for their friends and families. Thorium Nova might also be useful\nfor brick-and-mortar space centers and simulators set up at conventions, but it\nmust first be fun and usable for living room play.\n\nThorium Nova has a few guiding principles and values to follow as we work on the\nproject:\n\n- **Collaboration** - Whether that means collaboration between the flight\n  director and crew to tell a great story, between the different crew members'\n  stations, or between developers and other contributors.\n- **Simplicity** - By including 3D universe and internal crew simulations,\n  Thorium Nova is inherently a complex project. However, every effort should be\n  made to keep each of the smaller parts simple. The complexity should emerge\n  from interactions between simple parts. One example of this in action is the\n  [Entity Component System simulation](https://en.wikipedia.org/wiki/Entity_component_system),\n  where simple systems create complex interactions between components. This\n  principle also means saying no to well meaning features that add undue\n  complexity.\n- **Beginner Friendly** - The controls should be simple and intuitive for both\n  the flight director and the crew, with appropriate documentation and tutorials\n  for each of them. It should be easy to get started. An experienced D\u0026D Dungeon\n  Master should easily learn how to be a flight director. Likewise, it should be\n  easy for a new contributor or developer to become familiar with the Thorium\n  Nova project and codebase.\n- **Configurable** - Thorium Nova is going to ship with it's own stories, lore,\n  universe, and mechanics. That doesn't mean it can't be used to tell stories in\n  other universes. The controls should consider those possibilities, and make it\n  possible to configure the experience to suit whatever stories the flight\n  directors and mission writers want to tell.\n- **Fun** - Crews, flight directors, and contributors should enjoy working with\n  Thorium Nova. It should spark creativity, excitement, and wonder. Being Flight\n  Director should be just as much fun as being a crew member; likewise, people\n  should want to contribute to Thorium Nova because they enjoy doing it.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FThorium-Sim%2Fthorium-nova","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FThorium-Sim%2Fthorium-nova","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FThorium-Sim%2Fthorium-nova/lists"}