{"id":17431966,"url":"https://github.com/lloydlobo/tinycreatures","last_synced_at":"2025-03-28T01:15:33.713Z","repository":{"id":257932235,"uuid":"868338405","full_name":"lloydlobo/tinycreatures","owner":"lloydlobo","description":"A [WIP] game experiment for Ludum Dare 56's `Tiny creatures` theme.","archived":false,"fork":false,"pushed_at":"2024-10-24T13:30:42.000Z","size":74232,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-24T22:10:51.176Z","etag":null,"topics":["love2d","lua","luajit","ludum-dare","ludum-dare-56","topdownshooter"],"latest_commit_sha":null,"homepage":"https://ldjam.com/events/ludum-dare/56/$403597","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lloydlobo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-06T05:44:10.000Z","updated_at":"2024-10-24T06:55:07.000Z","dependencies_parsed_at":"2024-10-28T07:34:59.785Z","dependency_job_id":null,"html_url":"https://github.com/lloydlobo/tinycreatures","commit_stats":{"total_commits":105,"total_committers":1,"mean_commits":105.0,"dds":0.0,"last_synced_commit":"ae8ee3b4e2eb854ee39cb1f98cb8259f8ec2ee65"},"previous_names":["lloydlobo/tinycreatures"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lloydlobo%2Ftinycreatures","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lloydlobo%2Ftinycreatures/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lloydlobo%2Ftinycreatures/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lloydlobo%2Ftinycreatures/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lloydlobo","download_url":"https://codeload.github.com/lloydlobo/tinycreatures/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245949657,"owners_count":20698925,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["love2d","lua","luajit","ludum-dare","ludum-dare-56","topdownshooter"],"created_at":"2024-10-17T08:09:25.535Z","updated_at":"2025-03-28T01:15:28.697Z","avatar_url":"https://github.com/lloydlobo.png","language":"Lua","readme":"# Tiny Blood Cells\n\nYou 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\n\n![tinycreatures_202410141048](static/screenshots/tinycreatures_202410141048.gif)\n\n\u003e A game jam for Ludum Dare 56's Tiny Creatures theme.\n\nIn **Tiny Blood Cells**, you take on the role of a healer, tasked with saving small cell-like creatures scattered across different levels.\nBeware, though, as the creatures are infected and can damage you if you're not careful.\nBalance your movement, heal the creatures, and survive the challenges ahead!\n\nVisit the official Ludum Dare 56 page for this game: [Ludum Dare 56 Entry](https://ldjam.com/events/ludum-dare/56/$403597) or try [an older link](https://ldjam.com/events/ludum-dare/56/cells-united-tbd)\n\n## Installation\n\n### Requirements\n\n- **LÖVE 11.5 (Mysterious Mysteries)** or higher. You can download it from the official site at [love2d.org](https://love2d.org/).\n\n### Setup Instructions\n\n1. **Clone the Repository or Download ZIP**\n   Clone the repository or [download the ZIP](https://github.com/lloydlobo/tinycreatures/archive/refs/heads/main.zip) file containing the game source code.\n\n2. **Ensure LÖVE is Installed**\n   If you don't already have LÖVE installed, you can download and install it from [love2d.org](https://love2d.org/) or install it via Homebrew by running:\n\n   ```bash\n   brew install love\n   ```\n\n### Running the Game\n\nYou have two options to run the game:\n\n1. **Using the Terminal:**\n\n   - Open a terminal window.\n   - Navigate to the project directory where the game files (including `main.lua` and `conf.lua`) are located:\n\n     ```bash\n     cd /path/to/project-directory\n     ```\n\n   - Run the game with:\n\n     ```bash\n     love .\n     ```\n\n   Alternatively, if you have a `.love` file (e.g., `tinybloodcells.love`), you can run:\n\n   ```bash\n   love /path/to/tinybloodcells.love\n   ```\n\n2. **Drag and Drop:**\n   - Drag the project folder or the `.love` file onto the LÖVE executable. This will automatically launch the game.\n\n### Web Build Option\n\n\u003e If you're looking for a way to play the game in a browser, LÖVE doesn't natively support web\n\u003e builds. However, you can convert your game using **love.js**, which allows LÖVE games to run in\n\u003e browsers. Check with the developer if there's an existing web version of the game or use love.js to\n\u003e export it yourself.\n\n---\n\n![image](https://github.com/user-attachments/assets/d419291c-f63c-4084-aac3-4b4b687929c5)\n\n## Game Controls\n\n- **Arrow Keys/WASD**: Move the player entity.\n- **Spacebar**: Fire projectiles.\n- **X**: Dash forward.\n- **Shift (Left/Right)**: Enhance attributes and increase turning speed.\n- **Escape**: ~~Pause~~ or ~~exit~~ force quit.\n- **Q**: Force quit.\n- **N**: Next level.\n- **P**: Previous level.\n- **R**: Reset current level.\n- **H**: Toggle debug HUD.\n\n## Develop\n\nThis game was based on a starter template ported from an Asteroids tutorial at [berbasoft.com](https://berbasoft.com/simplegametutorials/love/asteroids/). During development, we used the following command to reload the game on file changes:\n\n```bash\nfind -name '*.lua' | entr -crs 'date; love .; echo exit status $?'\n```\n\n## Architecture\n\n\u003cdetails\u003e\n\n\u003csummary\u003eExpand\u003c/summary\u003e\n\n### Technology Used\n\n#### Core\n\n- [LÖVE─Source Code](https://github.com/love2d/love)\n  - [love2d.org](https://love2d.org/)\n\n#### Libraries\n\n- [moonshine─Postprocessing effect repository for LÖVE](https://github.com/vrld/moonshine)\n\n#### Other\n\n- [REAPER](https://www.reaper.fm/) DAW\n- [ezgif](https://ezgif.com) GIF optimizer and compressor\n\n### Key Enumerations\n\n- **ControlKey**: Defines the key bindings for various actions like shooting,\n  movement, and game controls.\n- **Status**: Manages the activity status of the creatures.\n- **HealthTransitions**: Tracks the healing state of creatures (none, healing, healthy).\n- **CreatureStageColor**: Color scheme for different stages of creature evolution.\n- **ScreenFlashAlphaLevel**: Defines screen flash transparency for different effects.\n\n\u003c/details\u003e\n\n---\n\n## Credits\n\n### Testers\n\n- **Seon**\n\n### Resources\n\nGrateful to the following creators for their amazing sound and music contributions:\n\n#### Sound Effects\n\n- DASK: Retro sounds [itch.io link](https://dagurasusk.itch.io/retrosounds)\n\n#### Music\n\n- **Lupus Nocte Arcadewave (background)**\n  - [Epidemic Sound link](http://link.epidemicsound.com/LUPUS)\n  - [YouTube](https://youtu.be/NwyDMDlZrMg?si=oaFxm0LHqGCiUGEC)\n\n### Special thanks\n\n- Twitch Streamer [Tkap1](https://m.twitch.tv/tkap1/home) aka Javier Palacios\n  for gifting a last minute invite code!!!\n- This game was based on a starter template ported from an Asteroids tutorial at [berbasoft.com](https://berbasoft.com/simplegametutorials/love/asteroids/).\n\n## License\n\nThis project is open source under the MIT License. See the LICENSE file for more details.\n\n---\n\n\u003cdetails\u003e\n\n\u003csummary\u003eProgress so far...\u003c/summary\u003e\n\n\u003csection\u003e\n\u003cdetails\u003e\n        \n\u003csummary\u003eExpand Screencasts\u003c/summary\u003e\n\n![tinycreatures_202410141048](static/screenshots/tinycreatures_202410141048.gif)\n![tinycreatures_202410121749](static/screenshots/tinycreatures_202410121749.gif)\n![tinycreatures_20241012](static/screenshots/tinycreatures_20241012.gif)\n![tinycreatures_20241011](static/screenshots/tinycreatures_20241011.gif)\n![tinycreatures_20241008](static/screenshots/tinycreatures_20241008.gif)\n\n\u003c/details\u003e\n\u003c/section\u003e\n\n\u003csection\u003e\n\u003cdetails\u003e\n        \n\u003csummary\u003eExpand Screenshots\u003c/summary\u003e\n\n![image](https://github.com/user-attachments/assets/d419291c-f63c-4084-aac3-4b4b687929c5)\n![image](https://github.com/user-attachments/assets/58a160d2-aaa5-4ac8-aba9-2d1c502bb29f)\n\n\u003c/details\u003e\n\u003c/section\u003e\n\n\u003c/details\u003e\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flloydlobo%2Ftinycreatures","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flloydlobo%2Ftinycreatures","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flloydlobo%2Ftinycreatures/lists"}