Skip to content

Top-down arcade made for the 72 hours Ludum Dare 56's `Tiny creatures` theme game jam.

License

Notifications You must be signed in to change notification settings

lloydlobo/tinycreatures

Repository files navigation

Tiny Blood Cells

Lua Tests

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

tinycreatures_20241106165246

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

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.


image

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

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

Music

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

tinycreatures_20241008 tinycreatures_20241011 tinycreatures_202410121749 tinycreatures_20241012 tinycreatures_202410141048 tinycreatures_20241017121242 tinycreatures_20241023184744 tinycreatures_20241025180525 tinycreatures_20241102145514 tinycreatures_20241104125912 tinycreatures_20241106165246

Expand Screenshots

tinycreatures_20241007185850 tinycreatures_20241007185903 tinycreatures_20241008001624 tinycreatures_20241015134217 tinycreatures_20241015192821

About

Top-down arcade made for the 72 hours Ludum Dare 56's `Tiny creatures` theme game jam.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages