README.md

Tiny Blood Cells

You play as the Observer in this asteroidlike top down shooter, but wait you are also the medic i.e. the protector cell that is healing unhealthy cells

Initially built during a game jam for Ludum Dare 56's Tiny Creatures theme.

In Tiny Blood Cells, you take on the role of a healer, tasked with saving small cell-like creatures scattered across different levels. Beware, though, as the creatures are infected and can damage you if you're not careful. Balance your movement, heal the creatures, and survive the challenges ahead!

Visit the official Ludum Dare 56 page for this game: Ludum Dare 56 Entry or try an older link

Table of Contents

• Tiny Blood Cells
  • Table of Contents
  • Installation
    • Requirements
    • Setup Instructions
    • Running the Game
    • Web Build Option
  • Game Controls
  • Develop
  • Architecture
    • Technology Used
      • Core
      • Libraries
      • Other
    • Key Enumerations
  • Credits
    • Inspirations
    • Testers
    • Resources
      • Sound Effects
      • Music
    • Special thanks
  • License
  • Progress so far‥

Installation

Requirements

• LÖVE 11.5 (Mysterious Mysteries) or higher. You can download it from the official site at love2d.org.

Setup Instructions

1. Clone the Repository or Download ZIP Clone the repository or download the ZIP file containing the game source code.

2. Ensure LÖVE is Installed If you don't already have LÖVE installed, you can download and install it from love2d.org or install it via Homebrew by running:

   brew install love

Running the Game

You have two options to run the game:

1. Using the Terminal:

   • Open a terminal window.

   • Navigate to the project directory where the game files (including main.lua and conf.lua) are located:

     cd /path/to/project-directory/src

   • Run the game with:

     love .

   Alternatively, if you have a .love file (e.g., tinybloodcells.love), you can run:

   love /path/to/tinybloodcells.love

2. Drag and Drop:

   • Drag the project folder or the .love file onto the LÖVE executable. This will automatically launch the game.

Web Build Option

If you're looking for a way to play the game in a browser, LÖVE doesn't natively support web builds. However, you can convert your game using love.js, which allows LÖVE games to run in browsers. Check with the developer if there's an existing web version of the game or use love.js to export it yourself.

---

Game Controls

• Arrow Keys/WASD: Move the player entity.
• Spacebar: Fire projectiles.
• Z: Beserk─Enhance attributes and increase turning speed.
• X: Boost.
• C: Spawn companions.
• Escape: Pause or exit force quit.
• H: Toggle debug HUD.
• N: Next level.
• P: Previous level.
• Q: Force quit.
• R: Reset current level.

Develop

This game evolved from the starter template ported from an Asteroids tutorial at berbasoft.com.

NOTE: See Makefile for quick commands.

Architecture

Technology Used

Core

• LÖVE Source Code • love2d.org

Libraries

• moonshine ─ A postprocessing effect repository for LÖVE

Other

• REAPER ─ Digital Audio Workstation
• sfxr.me ─ Jsfxr is an online 8 bit sound maker and sfx generator.
• ezgif ─ GIF optimizer and compressor

Learn more

Key Enumerations

• ControlKey: Defines the key bindings for various actions like shooting, movement, and game controls.
• Status: Manages the activity status of the creatures.
• HealthTransitions: Tracks the healing state of creatures (none, healing, healthy).
• CreatureStageColor: Color scheme for different stages of creature evolution.
• ScreenFlashAlphaLevel: Defines screen flash transparency for different effects.

---

Credits

Inspirations

• PewPew
• Orbia
• Ordia
• ...

Testers

• Seon

Resources

Grateful to the following creators for their amazing sound and music contributions:

Sound Effects

• DASK: Retro sounds • itch.io link
• akemov: underwater ambience By akemov | License: Attribution 4.0

Music

• Ross Bugden:

  • Chime Chase By Ross Bugden is licensed under a Creative Commons License.
  • Silver Seven Step By Ross Bugden is licensed under a Creative Commons Attribution 4.0 International License.

• Lupus Nocte:

  • Arcadewave (background) • Epidemic Sound link • YouTube

Special thanks

• Twitch Streamer Tkap1 aka Javier Palacios for gifting a last minute invite code!!!
• This game was based on a starter template ported from an Asteroids tutorial at berbasoft.com.

License

This project is open source under the MIT License. See the LICENSE file for more details.

---

Progress so far‥

Expand Screencasts

Expand Screenshots