https://github.com/anthonytornetta/cosmos
A multiplayer block-based space exporation game in active development
https://github.com/anthonytornetta/cosmos
3d bevy cosmos ecs game game-development multiplayer rust space
Last synced: 3 months ago
JSON representation
A multiplayer block-based space exporation game in active development
- Host: GitHub
- URL: https://github.com/anthonytornetta/cosmos
- Owner: AnthonyTornetta
- License: gpl-3.0
- Created: 2022-08-26T03:40:41.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-06-16T01:17:07.000Z (about 1 year ago)
- Last Synced: 2025-06-16T02:25:58.431Z (about 1 year ago)
- Topics: 3d, bevy, cosmos, ecs, game, game-development, multiplayer, rust, space
- Language: Rust
- Homepage:
- Size: 83.1 MB
- Stars: 68
- Watchers: 2
- Forks: 7
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Cosmos
A multiplayer block-based space exploration game, written in rust using the [Bevy](https://www.bevyengine.org/) engine.
If you're interested in playing the game, helping out, pitching ideas, or just hanging out, join our discord server!
[](https://discord.gg/VeuqvnxsZb)
## Player Guide
Check the  to see how to play!
## Playing
Cosmos is a game where you can create your dream spaceship that you can pilot through space.
Build your own ship block by block and cruise through space with friends.
Fly by huge, fully-interactable, planets.
Beware! In the depths of space, there's always someone that wants you dead. Watch out for pirates! They spawn in packs and, once they detect you, will hunt you mercilessly.
## We are on Steam!
Request an early access key in our discord server.
## Building Locally
To get started, install your OS dependencies [here](https://bevyengine.org/learn/book/getting-started/setup/#install-os-dependencies). The dependencies section is all you need to do.
You need to be running [Steam](https://store.steampowered.com/about/) in the background to launch the server and client.
To run the client, navigate to the cosmos_client directory and run
`cargo run`
For the server, navigate to the cosmos_server directory and run
`cargo run`
For release builds, append the `--release` flag to the build/run commands.
## Controls
There is no option to modify controls yet, so for now check out `cosmos_client/src/input/inputs.rs` to see a list of all controls currently implemented.
## Documentation
The first time you view the cosmos documentation, make sure you have mdbook **and** mdbook-mermaid installed. If you don't you can install them by running the following commands:
```console
cargo install mdbook
cargo install mdbook-mermaid
```
Every time you want to view the documentation, navigate to the `docs/` directory. To have it update as you modify it, run `mdbook serve` and navigate to the URL it provides, or to just build it run `mdbook build`.
#### System ordering
If you want to view the ordering of the systems, run (on linux) `cargo run --features print-schedule | dot -Tsvg > ./debug.svg` for either the cosmos_client or cosmos_server projects. If the `print-schedule` feature is enabled, these are setup to use bevy_mod_debugdump to create graphs of the `Update` schedule. If you need a different schedule, you'll have to change the `main.rs` file for either project to specify the correct schedule. Note, you'll need [graphviz](https://graphviz.org/download/) for the dot cmomand to work.
# Cosmos Roadmap
See [the issues page](https://github.com/AnthonyTornetta/Cosmos/issues) for the list of current features/bugs in development.
## Release 0.0.10a (In Progress)
- [x] Invite to game via Steam UI
- [x] Join restrictions for singleplayer worlds
- [ ] Shop owner NPCs
- [ ] Varied shop structures
- [ ] Bounty Board
- [ ] Player can get bounties if do evil stuff
- [ ] Pirates have bounties
- [ ] Faction-Specific Bounty hunters
- [ ] Fixed Factions
- [ ] Faction-specific structures
- [ ] Rework hailing
- [ ] Collect scraps when harvesting melting down ships
- [ ] Automatically extract inventory contents when drilling
- [ ] Purchase blueprints
- [ ] Upload blueprints for sale
- [x] Server management commands
## Release 0.0.9a
- [x] Performance fixes
- [x] Rework systems to use FixedUpdate
- [x] Physics
- [x] Networking
- [x] Reduce amount of packets server sends per second
- [x] Increase maximum networking limits
- [x] Singleplayer + Multiplayer menu
- [x] Headless server
- [x] Update to Bevy 0.16
- [x] Update to Bevy 0.17
- [x] Steam Integration
- [x] Steam playtest listing
- [x] Blueprint ship/station in-game
- [x] Create ships via shipyard
- [x] Faction Management
- [x] Ship System Management
- [x] Short-range warp drive
- [x] Automated builds (for easy download)
- [x] Better crafting
## Release 0.0.8a
- [x] Player Guide
- [x] Better Creative Mode
- [x] More asteroid types
- [x] Balance and improve weapons
- [x] Fuel for reactor
- [x] Ores
- [x] Customizable block drops
- [x] Better creative mode
- [x] In-game commands
- [x] Graceful server stop command
- [x] Ship focus camera
- [x] Rebalance shop prices
- [x] Add ability for player to die
- [x] Playtest and implement changes
- [x] Flying asteroids
- [x] NPCs
- [x] Factions
- [x] Faction Stations
- [x] Basic quest NPCs
- [x] Coms System
- [x] Quest system
- [x] Networking systems improvements
- [x] Location physics systems improvements
## Release 0.0.7a
- [x] Music
- [x] Chat
- [x] Galaxy map
- [x] Able to view stars
- [x] Zoom in to view planets
- [x] Set waypoint
- [x] Better galaxy generation
- [x] Spawn player near shop & asteroids
- [x] Add basic fabricator
- [x] Creative mode
- [x] Create survival mode
- [x] Save player data
- [x] Create world backups system
- [x] LOD performance improvements
- [x] Rotating planet
- [x] On-planet skybox
- [x] Dropped item entity
- [x] When storage is broken, drop items on ground
- [x] If not enough inventory room when player is mining something, drop item
- [x] Fix missing chunks on planets
- [x] Update to Bevy 0.15
- [x] Add recipes
- [x] Add intermediate blocks + items
- [x] Rework item rendering to be more consistent
## Release 0.0.6a
- [x] Place rotated blocks
- [x] Add main menu
- [x] Customizable settings
- [x] Specify connection target
- [x] Missiles
- [x] Auto targetting
- [x] Explosion logic
- [x] Shields
- [x] Emit a spherical shield
- [x] Shield size based on multiblock structure
- [x] Absorb incoming damage
- [x] Inventory UI improvements
- [x] Scrollable inventory
- [x] Escape functionality
- [x] Escape can now be used to close the foremost open UI menus
- [x] If no such menus are available, it will instead open the pause menu
- [x] Pause menu
- [x] Resume
- [x] Change Settings
- [x] Disconnect
- [x] Quit Game
- [x] LOD Fixes
- [x] Consolidate LOD + Normal chunk rendering into one source of truth
- [x] LOD performance improvements via combining meshes + culling sides
- [x] Block data
- [x] Storable fluids
- [x] Item data
- [x] Money
- [x] In-flight UI
- [x] Weapons selection hotbar
- [x] Speed display
- [x] Energy display
- [x] A way of selecting which systems to use preventing use of systems that are not meant to be actively used
- [x] Wires
- [x] Logic
- [x] Logic blocks
- [x] Wiring system
- [x] Logic receivers
- [x] Planet generation & LOD overhaul
- [x] Performance improvements
- [x] GPU-based generation
- [x] Remove bevy system ambiguities
- [x] Support NxN texture loading (where n is power of 2)
- [x] Update to bevy 0.14
## Release 0.0.5a
- [x] Add a gravity well block
- [x] Remove snapping to structures on collision
- [x] Camera system
- [x] Camera block
- [x] Use left/right to switch between ship cameras
- [x] Changes where your view is
- [x] Shops
- [x] Sell blocks/items
- [x] Buy blocks/items
- [x] Generates randomly
- [x] Implement random structure Generation
- [x] Implement currency system for player
- [x] Money GUI
- [x] Shop GUI
- [x] Mining beam system
- [x] Mining beam block
- [x] Can be placed in line to create more powerful miners
- [x] Mines the first block hit by the beam after a given time
- [x] Inserts the item into the ship's inventory
- [x] Hold lmb to continually fire the laser
- [x] Pirates
- [x] Create a number of pirate ships
- [x] Each ship has a difficulty
- [x] Difficulty of spawns scales off player's money & ship's number of blocks
- [x] Basic AI
- [x] Spawn within 2 sectors of player
- [x] Spawn in fleets based on player's difficulty
- [x] If within ~1 sector of player, fly towards player
- [x] Shoot towards player, trying to predict their position based off distance & velocity
- [x] Shop
- [x] Buy from shop
- [x] Sell to shop
- [x] Players have money
- [x] For now shops have unlimited stock & funds
- [x] Shop block
- [x] Animated textures
- [x] Block data system
- [x] Support for blocks that store their own data
- [x] Storage block
- [x] A block that stores an amount of items
- [x] Can be interacted with to view the items
- [x] A GUI to view items
- [x] Sounds
- [x] Laser cannon fire
- [x] Block take damage
- [x] Thrusters moving
- [x] Space ship idle
- [x] Background space music
- [x] Block place/break
- [x] Multiblock machines
- [x] Revamp power generation to use reactor multiblock structure
- [x] Colored laser
- [x] Colored glass placed in front of laser
- [x] Inventory GUI
- [x] Able to open inventory
- [x] Abstract the 3d block GUI camera
- [x] Fix the 3d block GUI camera to not render anything except GUI blocks
- [x] Fix seeing through cracks in blocks
- [x] Lods
- [x] Reduced detail rendering of far away chunks to see the entire planet
- [x] Update to bevy 0.11
- [x] Update physics
- [x] Update bevy
- [x] Update to bevy 0.12
- [x] Update physics
- [x] Update bevy
- [x] Update to bevy 0.13
- [x] Update physics
- [x] Update bevy
- [x] Update asteroid generation to make it decent
- [x] Add ores to mine on them
- [x] GUI to interact with inventory
- [x] Easier way of adding 3d blocks to GUI
- [x] Move items around in inventory via mouse
- [x] Structure build mode
- [x] Interact with build block to enter build mode
- [x] Build mode
- [x] Camera becomes a noclip free cam and goes outside of player's body.
- [x] Player no longer piloting ship, & is able to create + destroy blocks on the ship but ONLY the ship
- [x] Symmetry modes are added that will mirror blocks on user-defined axis
## Release 0.0.4a
- [x] Galaxy Generation
- [x] Stars procedurally generated in spiral-like pattern based on seed
- [x] Create star
- [x] Light emits from star
- [x] Load star within system
- [x] Planets generate around stars
- [x] Biospheres depend on how close they are to the sun
- [x] Dynamic biospheres based off temperature
- [x] Only generate if planet is close enough to player
- [x] Cube planets
- [x] Planets will now be cubes instead of flat planes, and will be about the size of the sector
- [x] Redo saving/loading of planets
- [x] Dynamically generate chunks & unload them based on players' positions close to planet
- [x] Make generation work on all faces of planet
- [x] Block orientation for every block
- [x] Biospheres
- [x] Speed up terrain generation
- [x] Make molten biosphere
- [x] Enhance grass biosphere
- [x] Create icy biosphere
- [x] Asteroids
- [x] For now just floating rocks in space
- [x] Save generated universe
- [x] Save planet locations
- [x] Fix broken ship functionality
- [x] Make entities no longer pass through loading structures.
- [x] Align body with structure
- [x] Switches to FPS Camera
- [x] Aligns the player to that structure
- [x] Fix child locations being not updated based on transform relative to parent
- [x] Add button to align to structure facing
- [x] De-align, switch back to free camera
- [x] Create free camera
## Release 0.0.3a
- [x] Infinite universe
- [x] (**Client**) Player can travel any distance from 0,0,0 with no noticable issues, and everything moves relaitve to player
- [x] (**Server**)
- [x] Objects move relative to player world they are a part of
- [x] Player world moves relative to its player
- [x] Players can be a part of the same world if they are close enough
- [x] Requires rewrite of bevy_rapier to support multiple physics worlds
- [x] Merge PR https://github.com/dimforge/bevy_rapier/pull/328
- [x] Update to bevy 0.10.0
- [x] Performant ships
- [x] Ability to have 50 small-sized ships loaded with minimal performance impact
- [x] Dynamic object loading
- [x] (**Client**)
- [x] Unload objects that are too far away
- [x] Request entities that server sends if they don't have the entity for them
- [x] (**Server**)
- [x] Unload objects that are too far from any player
- [x] Load objects that are close to a player & send that info to client
- [x] Only send information about objects to clients that are close enough to have them loaded
- [x] Display coordinates in top left (sector, local)
- [x] Revamp rendering to allow for more than cubes
- [x] Display hotbar items
- [x] 3d models for blocks
## Release 0.0.2a
- [x] Improved state management
- [x] Client state management
- [x] Server state management
- [x] Core able to utilize both states
- [x] Block resource loaded in PreLoading state
- [x] Blocks loaded in Loading state
- [x] Systems loaded in PostLoading state
- [x] Ability to pilot Ship
- [x] Mouse movements steer ship around ship core
- [x] Standard movement controls mapped to ship acceleration
- [x] Interact with ship core to enter piloting mode, press interact button again to exit
- [x] Create max ship speed
- [x] Ship core
- [x] Interact with this block to pilot the ship
- [x] Cannot be mined while other blocks are present on the ship
- [x] Create block
- [x] Localized planetary gravity
- [x] All entities near planet's radius are subject to its gravity towards its relative downward vector
- [x] The gravitational pull should scale inversely exponentially the farther the distance from a certain threshold (most likely the highest chunk) then remain constant past that point
- [x] Ship systems
- [x] Energy system
- [x] Energy producer block
- [x] Energy storage block
- [x] Energy storage system
- [x] Energy generation system
- [x] Thruster system
- [x] Thruster block
- [x] Allows the ship to move + rotate
- [x] Faster movement based on # of thrusters
- [x] Faster rotation based on # of thrusters
- [x] More energy consumption per thruster
- [x] Laser cannon system
- [x] Laser cannon block
- [x] Can be placed in lines to create more powerful lasers
- [x] Click lmb/hold to fire the laser
- [x] The laser is on a cooldown
- [x] Ship hull block
- [x] Ability to place more than one block
- [x] Hotbar
- [x] Rendering of hotbar
- [x] Reads items from inventory
- [x] Inventory
- [x] Items
- [x] Item stacks
- [x] Way of select which item
- [x] Store block damage
- [x] Ability to save ships to disk + load them
- [x] Implement console commands
## Release 0.0.1a
- [x] Player Movement
- [x] FPS Camera
- [x] Dynamic Input system
- [x] Structure
- [x] Planet
- [x] Ship
- [x] Asset Loading
- [x] Fix UV mapping floating point errors
- [x] Planet Generation
- [x] Grass planet generator
- [x] Server/Client
- [x] Server controls planet
- [x] Each player controls its own movement (100% trusted)
- [x] Ship creation
- [x] Block registration
- [x] Block registry with numeric + fixed string IDs
- [x] Player entity
- [x] Game State
- [x] Network communication
- [x] Sync bodies from server to client
- [x] Ability to break/replace block
- [x] Dynamic meshing
- [x] Dynamic physics bodies
- [x] Block break events sent to server, server sends back block changed event
- [x] Selects nearest structure
- [x] Integrate physics system
- [x] Physics generator for structures
- [x] Chunk-based physics
- [x] Player collider
- [x] Integrate bevy engine
- [x] Rendering method for structures
- [x] Chunk-based rendering
- [x] Add Crosshair
- [x] Support re-sizable window
## Everything that will likely be done in the future
- Shops
- Peace zone?
- Prices based on supply + rarity
- Keep supply relatively equal between nearby shops
- Each shop has its own supply of money that it cannot go below
- Biosphere Improvements
- Ice biosphere glaciers
- Structures
- Rocks spawning
- Undergrowth
- 1 More tree type
- Groundwork for biomes
- Planes
- Redwood forest
- 1 Additional forest
- Ocean
- Wires
- Electrical
## NPCs
### Factions
NPC controlled factions store reputation of other factions + players
Factions have different attributes
- One may steal your ship blueprints
- To balance this:
- scrap is collected when you mine melting down ships instead of the actual blocks
- Different scrap types
- Substitute expensive blocks for less expensive ones if needed
- If ship is below 50% success rate, don't produce it again
- Dynamic faction expansion
- Bounty board
- Take down X ship
- Selling the ship
- Selling ship designs
- Buying ship designs