Space Race: a simple Rust game built on the Bevy framework

-
When I saw a post announcing the release of the Bevy framework (an open source game engine written in Rust), I thought it'd be a fun way to learn Rust. 

So I made Space Race, a 2 player game on top of the Bevy framework.

How to Play

The Astronaut moves around collecting jewels (using WASD keys). The Alien moves around trying to catch the Astronaut (using arrow keys). 


The Astronaut wins if they collect at least 5 jewels and make it back to home base before the Alien catches them. 


The Alien wins otherwise. 


Things I learned about Rust 

I had a lot of fun making & playing this game, and also got some hands on experience with Rust like working with
  • structs
  • enums
  • vectors
  • iterators
  • traits
    • dyn trait vs impl trait 
      • dyn trait is used for trait objects, which are fat pointers made up of 1) a pointer to the value 2) a pointer to a vtable. A vtable is a table of methods, where each method points to its implementation, generated once at compile time. Each instance of a type that implements a trait uses the same vtable. Then, Rust uses dynamic dispatch, selecting the right implementation of a method at runtime.
      • When a function takes in an `impl trait`, Rust generates a different version of the function for each type that implements the trait.   
      • Use trait objects if you create a collection of instances of mixed types that implement the same trait or want to reduce the size of your compiled code.
      • Use `impl` trait when you need speed (and want to avoid dynamic dispatch). 
  • the rand crate (the positions of the walls and the jewels in the game are generated randomly)
  • ownership and passing references 
  • atomics 
    • Space Race needed a static mutable bool variable, so I used an AtomicBool. 

Developing on Bevy 

Bevy was simple and intuitive to use. However, the documentation was lacking and there were bugs I ran into (e.g. when trying to combine a SpriteSheet and TextComponent). These are of course expected, since this framework is new. Developing on Bevy was a positive experience overall, and Bevy has a lot of potential. 

Space Race Code

Resources

Popular posts from this blog

Building a Toy Language Compiler in Go

-
Image
A follow-up to my previous post about building a toy language interpreter in Go. Throughout this post, I'll be referencing my repo . We'll go over a compiler which translates source code to machine code, and then a VM to execute this machine code. What is a compiler?  A compiler takes source code and translates it to executable machine code . (See my previous post for more details.) The figure below shows the high-level architecture of a simple compiler. Like the interpreter we built previously, our compiler has a lexer and a parser which turn our source code into an AST . This is our compiler's frontend . However, that's where a compiler diverges.  The compiler may translate the AST into at least one internal representation (IR) . The IR(s) may be represented using any data structure (even another AST!), but they should follow two rules: (1) be easy to produce, (2) be easy to translate into the target machine code. The IR can also be optimized...
Read more

tldr: Raft + Implementation Tips

-
Image
Part of the tldr series , which summarizes papers I'm currently reading. Inspired by the morning paper . Raft (Extended Version) + Implementation Tips [2014] Ongaro et al. Note: For implementation tips, see the end of this blog post.  Introduction Consensus algorithms The r eplicated state machine approach  is useful for providing fault-tolerance in distributed systems. It lets a cluster of unreliable machines continue operating even when some of its members fail. In this approach, machines   usually use a replicated log to stay in sync. As shown in the figure below, each server's log stores the same commands in the same order. Every state machine executes commands from its own log in order. State machines are deterministic, so each produces the same order of outputs. Once the majority of machines have responded, the command is done executing. Consensus algorithms ensure that the replicated log stays consistent. In the figure above, clients s...
Read more