{"id":25869438,"url":"https://github.com/mariomarton/little-big-engine","last_synced_at":"2026-05-14T20:33:18.376Z","repository":{"id":279854288,"uuid":"940099946","full_name":"mariomarton/little-big-engine","owner":"mariomarton","description":"A 2D game engine built with Java and JavaFX, where players collect sticks, battle enemies, and unlock chests to progress. Easily create custom levels by editing  text file.","archived":false,"fork":false,"pushed_at":"2025-02-27T20:05:44.000Z","size":1833,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-03T20:54:18.049Z","etag":null,"topics":["2d-game","2d-game-engine","combat-system","java","javafx","javafx-game","level-editor"],"latest_commit_sha":null,"homepage":"","language":"Java","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/mariomarton.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":"2025-02-27T16:04:26.000Z","updated_at":"2025-02-27T20:19:11.000Z","dependencies_parsed_at":"2025-02-28T04:47:34.102Z","dependency_job_id":"d82ee0eb-1a6f-459f-8e05-c3d70b1f9ffd","html_url":"https://github.com/mariomarton/little-big-engine","commit_stats":null,"previous_names":["mariomarton/little-big-engine"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/mariomarton/little-big-engine","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mariomarton%2Flittle-big-engine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mariomarton%2Flittle-big-engine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mariomarton%2Flittle-big-engine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mariomarton%2Flittle-big-engine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mariomarton","download_url":"https://codeload.github.com/mariomarton/little-big-engine/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mariomarton%2Flittle-big-engine/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33042210,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"online","status_checked_at":"2026-05-14T02:00:06.663Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["2d-game","2d-game-engine","combat-system","java","javafx","javafx-game","level-editor"],"created_at":"2025-03-02T05:17:26.069Z","updated_at":"2026-05-14T20:33:18.360Z","avatar_url":"https://github.com/mariomarton.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n\n\n# little-big-engine\n\n**little-big-engine** is a 2D game engine built with Java and JavaFX. (Though, in its current state, it's more of a 2D game with a level editor.) Players can collect sticks, battle enemies, and unlock chests to progress. Custom levels can be easily created by modifying a text file.\n\n\u003cimg src=\"readme-assets/hero.jpg\" width=100% height=\"auto\" style=\"border-radius: 0px;\" /\u003e\n\n\n\n### A Note on Its History\nThis project was originally built in 2019, still during my first year of university. It's therefore rough around the edges. For a better representation of my actual skills, I recommend checking out my more recent projects, such as [scala-image-transformer](https://github.com/mariomarton/scala-image-transformer).\n\n### Running little-big-engine\nI recommend loading the project as a Maven project in an IDE such as InteliJ, while specifying OpenJDK 1.8 as the project SDK. Run the Maven `package` phase and finally run the `.jar` file to open **little-big-engine**.\n\n---\n\n## The Game\n\n### Controls:\n- **Arrow Keys or WASD** to move.\n- **Spacebar** = **ATTACK!**\n  - Also used to collect sticks and open chests.\n\n### Gameplay:\n- **You need a stick for each hit!**\n  - Each attack consumes one stick.\n- **Objective:**\n  - Open all chests and eliminate all enemies.\n\n\u003cimg src=\"readme-assets/screen.jpg\" width=\"450\" height=\"auto\" style=\"border-radius: 9px;\" /\u003e\n\n---\n\n## The Engine / Level Maker\n\n### How to Create a Custom Level\n\n#### Step 1:\n- Navigate to the [levels](src/main/java/com/mario/LittleBigEngine/levels) directory and open the [custom_level.txt](src/main/java/com/mario/LittleBigEngine/levels/custom_level.txt) file.\n\n#### Step 2:\n- Modify the **BASICS** section:\n  - Only change the numbers.\n  - Maximum size is **50x50** cells.\n  - The **starting position** goes from `0,0` to `size-1, size-1`.\n\n#### Step 3:\n- Define the **positions of STONES and STICKS**:\n  - Format: `[position X/position Y, X/Y, X/Y ...]`\n\n- Adjust the **number of sticks** the player starts with.\n\n#### Step 4:\n- Set up **chests and enemies**:\n  - **Chests Format:**\n    - `[amount-of-money/posX-posY, money/posX-posY ...]`\n  - **Enemies Format:**\n    - `[enemy-power/posX-posY, power/posX-posY ...]`\n\n#### Step 5:\n- Save the text file and enjoy your game!\n\n### About _Enemy Power_\n- **Enemy power values range from `1` to `5`.**\n- This number represents the hits required to defeat the enemy.\n- **Enemy Skins:**\n  - **Powers 1, 2** → Yellow Skin\n  - **Powers 3, 4** → Orange Skin\n  - **Power 5** → Red Skin (**Superpower!**)\n\n---\n\nEnjoy building and playing in **little-big-engine**, contributions to the project are always welcome, too!\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmariomarton%2Flittle-big-engine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmariomarton%2Flittle-big-engine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmariomarton%2Flittle-big-engine/lists"}