Fallen God

A retro-style action game rewritten in Rust. This is a modern rewrite of the original C version created as a university project in 2019, now using Rust with macroquad for cross-platform deploying.

Play Demo · Original C Version · Report Bug

Table of Contents

1. About The Project
• Original Project
• Built With
2. Deployment
• Using Docker
• Using Docker Compose
3. Development
• Prerequisites
• Running Locally
4. Contributing
5. License
6. Contact

About The Project

Fallen God is a retro-style roguelike game where players battle through multiple levels against various enemies and bosses. This Rust rewrite maintains the spirit of the original 2019 university project with some minor improvements.

All game assets and design are preserved from the original version.

Original Project

Fallen God was originally developed as a university game project in 2019 at Mondragon Unibertsitatea. The original was created by:

• Unai Orive Mujika
• Daniel Luengo Echeverria
• Aitor Astorga Saez de Vicuña
• Danel Mazkiaran Hernandez

Note: The original code was written in Basque, but the GUI remains in English.

For a presentation about the original game (in Basque): Click here

(back to top)

Built With

(back to top)

Deployment

You have multiple options to deploy Fallen God:

Using Docker

Run the pre-built container:

docker run --rm -it \
  -p 8080:8080/tcp \
  git.prisma.moe/aichan/fallen_god:latest

Using Docker Compose

Create a docker-compose.yml file:

services:
  fallen_god:
    container_name: fallen_god
    image: git.prisma.moe/aichan/fallen_god:latest
    ports:
      - 8080:8080
    restart: unless-stopped

Then run:

docker-compose up -d

Access Point:

• Game will be served at http://localhost:8080/

(back to top)

Development

Prerequisites

• Rust installed (includes Cargo)
• macroquad dependencies (platform-specific, see below)

Linux:

# Arch Linux
sudo pacman -S libx11 libxi mesa alsa-lib

# Ubuntu/Debian
sudo apt install pkg-config libx11-dev libxi-dev libgl1-mesa-dev libasound2-dev

# Fedora
sudo dnf install libX11-devel libXi-devel mesa-libGL-devel alsa-lib-devel

Running Locally

1. Clone the repository:

   git clone https://git.prisma.moe/aichan/fallen_god.git
   cd fallen_god
   

2. Build and run the game:

   cargo run --release
   

3. Play the game!

Development Notes:

• Use cargo run for development builds (faster compilation)
• Use cargo run --release for optimized builds (better performance)
• Assets are loaded from the img/ directory
• Game configuration can be modified in the source code

(back to top)

Contributing

Contributions are welcome! Please fork the repository, make your changes, and open a pull request.

1. Fork the Project on Forgejo
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the European Union Public License v1.2. See LICENSE for more information.

(back to top)

Contact

Aitor Astorga Saez de Vicuña - a.astorga.sdv@protonmail.com

Project Link: https://git.prisma.moe/aichan/fallen_god

Original Project Authors:

• Unai Orive Mugika - unaiby18@gmail.com | LinkedIn
• Daniel Luengo Echeverria - danielluengoecheverria@gmail.com | LinkedIn
• Aitor Astorga Saez de Vicuña - a.astorga.sdv@gmail.com | LinkedIn
• Danel Mazkiaran Hernandez - danel.mazkiaran@gmail.com | LinkedIn

Original Project Link: https://github.com/UN41/FALLEN_GOD

(back to top)

Acknowledgments

Thanks to these amazing projects and technologies!

• macroquad - Simple and easy to use game library for Rust
• Rust - A language empowering everyone to build reliable and efficient software
• Original Fallen God team

Original Project Credits:

• Best-README-Template
• The original C version

(back to top)