{"id":13418428,"url":"https://github.com/LucvandenBrand/Tiled2GBA","last_synced_at":"2025-03-15T03:31:11.038Z","repository":{"id":81611055,"uuid":"138404070","full_name":"LucvandenBrand/Tiled2GBA","owner":"LucvandenBrand","description":"Simple CLI for converting Tiled maps to data the Game Boy Advance (GBA) understands.","archived":false,"fork":false,"pushed_at":"2019-01-26T21:45:26.000Z","size":551,"stargazers_count":19,"open_issues_count":9,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-07-31T22:42:56.635Z","etag":null,"topics":["converter","game-development","gba","tiled-map-editor","tool"],"latest_commit_sha":null,"homepage":null,"language":"C++","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/LucvandenBrand.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2018-06-23T13:39:58.000Z","updated_at":"2023-02-25T21:11:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"2dd215fc-7f53-4178-bd77-5c18cbfd1f48","html_url":"https://github.com/LucvandenBrand/Tiled2GBA","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucvandenBrand%2FTiled2GBA","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucvandenBrand%2FTiled2GBA/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucvandenBrand%2FTiled2GBA/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LucvandenBrand%2FTiled2GBA/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LucvandenBrand","download_url":"https://codeload.github.com/LucvandenBrand/Tiled2GBA/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243681024,"owners_count":20330152,"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":["converter","game-development","gba","tiled-map-editor","tool"],"created_at":"2024-07-30T22:01:02.196Z","updated_at":"2025-03-15T03:31:09.213Z","avatar_url":"https://github.com/LucvandenBrand.png","language":"C++","funding_links":[],"categories":["C++"],"sub_categories":[],"readme":"# Tiled2GBA\n\nSimple CLI for converting [Tiled](https://www.mapeditor.org) maps to data the **G**ame **B**oy **A**dvance understands.\nSpecial thanks to [Jasper Vijn](https://www.coranac.com) for providing a great tutorial on GBA development!\n\n## Releases\nYou can download binary releases [here](https://github.com/LucvandenBrand/Tiled2GBA/releases).\n\n## Usage\nTiled2GBA can generate both compilable C code and appendable binary data. \nThe latter is recommended (no need to recompile your project for changes in assets), \nand can be used with [GBFS](http://www.pineight.com/gba/#gbfs) in order to access it.\n\n### Generating C code\nSimply call `Tiled2GBA` from your command prompt, and provide a `map.tmx` and `map.c map.h` as\ninput and output parameters respectively. \nFor example, `Tiled2GBA assets/map.tmx src/map.c src/map.h` would output compilable C code\ninto the `src` folder.\n\n### Generating binary data\nCall `Tiled2GBA` from your command prompt with the `--binary` option, and provide a `map.tmx` and `map.bin` as\ninput and output parameters respectively. \nFor example, `Tiled2GBA assets/map.tmx assets/map.bin --binary` would output appendable binary data\ninto the `assets` folder.\n\nYou can use the `--help` command for more information.\n\n## Development\nThis project is divided in two subfolders: `converter` for converting Tiled files, and `player` for playing the converted maps on the GBA.\n\n### Converter\nThe converter comes with a handy `CMake` file. Building the converter is done by going into the `converter` folder and executing the following commands:\n\n1. `mkdir build`\n2. `cd build`\n3. `cmake ..`\n4. `make`\n\nThis should result in a cute little `Tiled2GBA` binary.\n\n### Player\nThe player contains a `gbaMap` library in its `lib` folder, **which you can use for your own gba projects**. Both the player as the library come with a handy `make` file. Builing the player and its libraries is done by going into the `player` folder and executing **one** of the two commands:\n\n- `make no-content` to make the player without any map data.\n- `make` to make the player with map data in the `data` folder appended.\n\nYou should have a GBA rom now.\n\n### Contributing\nContributions are always welcome! You can make a contribution by:\n\n1. Creating an issue, be sure your contribution has not been claimed by somebody else!\n2. Forking the project.\n3. Creating a pull-request to merge your solution back into the **develop** branch of this repository.\n\nThe **develop** branch is meant for in-development unstable releases, \nwhilst the **master** branch is meant for stable production-ready releases.\n\n### Licence\nAll source files are protected under the MIT Licence, except for the included external libraries. The used libraries are open-source, but please read their included licenses for\ntheir specific terms and conditions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLucvandenBrand%2FTiled2GBA","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FLucvandenBrand%2FTiled2GBA","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLucvandenBrand%2FTiled2GBA/lists"}