{"id":20647173,"url":"https://github.com/bbbbbr/gimp-tilemap-gb","last_synced_at":"2025-06-13T09:34:48.646Z","repository":{"id":65479110,"uuid":"177902597","full_name":"bbbbbr/gimp-tilemap-gb","owner":"bbbbbr","description":"Tilemap GB - Console App - AND - GIMP plugin for importing \u0026 exporting Game Boy game tilemaps and tilesets (as bitmap images or .GBM/.GBR files. Related tools: GBTD, GBMB, GBDK, Zal0-ZGB)","archived":false,"fork":false,"pushed_at":"2024-04-16T06:49:15.000Z","size":3747,"stargazers_count":65,"open_issues_count":1,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-16T02:53:27.032Z","etag":null,"topics":["game-tools","gameboy","gbmb","gbtd","gimp","gimp-plugin","tiled-map-editor","tilemap","tilesets"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bbbbbr.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":"2019-03-27T02:19:58.000Z","updated_at":"2025-03-05T05:34:54.000Z","dependencies_parsed_at":"2024-04-19T02:00:25.234Z","dependency_job_id":null,"html_url":"https://github.com/bbbbbr/gimp-tilemap-gb","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/bbbbbr/gimp-tilemap-gb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbbbbr%2Fgimp-tilemap-gb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbbbbr%2Fgimp-tilemap-gb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbbbbr%2Fgimp-tilemap-gb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbbbbr%2Fgimp-tilemap-gb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bbbbbr","download_url":"https://codeload.github.com/bbbbbr/gimp-tilemap-gb/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bbbbbr%2Fgimp-tilemap-gb/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259619468,"owners_count":22885527,"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":["game-tools","gameboy","gbmb","gbtd","gimp","gimp-plugin","tiled-map-editor","tilemap","tilesets"],"created_at":"2024-11-16T16:29:25.879Z","updated_at":"2025-06-13T09:34:48.607Z","avatar_url":"https://github.com/bbbbbr.png","language":"C","readme":"Tilemap GB (Gimp Plugin and command line tool): tilemap generator and exporter for Game Boy / Game Boy Color / GBDK \u0026 ZGB\n===========\n\nThere are two versions of the tool:\n\n## Standalone, command line version: [png2gbtiles](/console)\n\n## GIMP plugin for importing \u0026 exporting Game Boy game tilemaps and tilesets.\n\nYou can create a level map in Gimp (or other image editors) then export it to either C Source files for the GBDK, or export as .gbr / .gbm for editing and further work in either GBTD or GBMB. You can also import from .gbr and .gbm files, and re-export to them (tile order may change and not all app prefs may survive the import/re-export trip).\n\n(Also see Zal0's command line [converters from GBR/GBM -\u003e .c/.h.](https://github.com/Zal0/ZGB/tree/master/tools)) \n\n*This plugin is functional, but not polished. Don't be surprised to find some rough edges or annoyances.\n\nDownload compiled GIMP Plugin executables here:\n * [Linux GIMP 2.8+](/bin/linux)\n * [Windows GIMP 2.10.12+](/bin/windows)\n\nDownload compiled Console executables here:\n * [Linux](/console/bin/linux)\n * [Windows](/console/bin/windows)\n\nOr check [Releases](https://github.com/bbbbbr/gimp-tilemap-gb/releases)\n\n![Opening a Game Boy Map Builder map as an image in GIMP](https://raw.githubusercontent.com/bbbbbr/gimp-tilemap/master/info/gimp-tilemap-plugin-screenshot.png)\n\n\nFeatures (DMG \u0026 CGB)\n * Tile deduplication (same colors/same pattern)\n * Optional remapping of colors to a specific palette (user supplied palette or to repair per-tile color limit errors with the images current palette)\n\nCGB only features\n * Flipped X/Y tile deduplication\n * Alternate Palette tile deduplication\n\nTile Map export formats:\n* GBM (Game Boy Map Builder https://github.com/gbdk-2020/GBTD_GBMB )\n* C Source (GBDK / ZGB)\n\nTile Set export formats:\n * C (GBDK / ZGB)\n * GBR (Game Boy Tile Designer https://github.com/gbdk-2020/GBTD_GBMB )\n\nTile Set \u0026 Map import formats:\n * GBR\n * GBM\n\nColor Gameboy Support (CGB):\n * Import \u0026 Export\n\nSupported formats:\n * GB 2bpp\n * CGB Color mode\n\nSettings:\n * The plug-in will attempt to preserve Tile \u0026 Map Export settings across import and later export (they get attached to the native GIMP XCF image as a Parasite that persists accross save/load).\n * Option to ignore CGB per-tile palette violation errors. The tile will still be forced to 4 colors and it will use the first palette found in the tile.\n\n\n## Usage / Cautions:\n * Work on an 8x8 grid. It will save you time, trouble and ROM size later on.\n * Available tile sizes are: 8x8, 8x16, 16x16, 32x32\n * The source image should be an even multiple of the tile size.\n * While C Source / GBM Maps can export to all tile sizes, working with 8x8 is sometimes most practical for hardware (unless set up for meta-tiles).\n * Exported GBR should have no more than 4 colors (DMG) or 32 colors (CGB)\n * In CGB mode the 32 color palette is broken up into 8 separate, consecutive sub-palettes of 4 colors each\n * When exporting in CGB mode, tiles *should not* use colors from more than one sub-palette at a time. Export will fail if they do, unless one of the following is enabled:\n   * \"Ignore CGB Palette Errors\"\n   * \"Try to Repair Palette Errors\" are enabled.\n * The only metadata preserved across import and later re-export for GBR / GBM files are the Tile/Map Export Settings. Other data such as recently used files, etc are not currently preserved when exporting back out. (Maybe later).\n * If you export using this path: GIMP -\u003e GBTD or GBMB -\u003e C source, then you'll need to set up the export options for GBTD (path, tiles to export, etc) and GBMB (path, location format, etc). Some, but not all, of them will be pre-populated.\n\n## Quick instructions:\n\nNative compile/install on Linux using below.\n\n```\nIf GIMP \u0026 build tools not yet installed:\n(example for debian/ubuntu/mint)\n * sudo apt install gimp\n * sudo apt install build-essential\n * sudo apt install libgimp2.0-dev\n\nThen:\n* cd gimp-rom-bin\n* make\n\nThen copy the resulting \"file-tilemap\" to your GIMP plugin folder, depends on version\n\nPlug-in folder locations:\n Linux: ~/.gimp-2.8/plug-ins  , or ~/.config/GIMP/2.10/plug-ins\n Windows: C:\\Program Files\\GIMP 2\\lib\\gimp\\2.0\\plug-ins\n\n```\nGuide for [Cross-compiling to Windows on Linux](https://github.com/bbbbbr/gimp-rom-bin/blob/master/doc/GIMP%20jhbuild%20for%20Windows%20on%20Linux.md)\n\n\n## Requirements:\n* Image must be indexed color and not have more colors than output format supports, unless one of the following is enabled:\n   * \"Ignore CGB Palette Errors\"\n   * \"Remap/Repair Palette Errors\" and \"Remap using a Palette File\".\n\n## Known limitations \u0026 Issues:\n* GBMB Export only populates the Export Location Format if it was present on a preceding Import. Otherwise it must be done manually.\n* When a GBMB Map is imported (along with matching GBTD Tileset), any tiles not used on the map will get discarded on re-export.\n* Tile set ordering may change on export if the GBMB Map changes (tile set order is based on the when a given tiles is first encountered while scanning left -\u003e right, top -\u003e bottom)\n\n\n","funding_links":[],"categories":["Software Development","软件开发"],"sub_categories":["Tools","工具"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbbbbr%2Fgimp-tilemap-gb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbbbbbr%2Fgimp-tilemap-gb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbbbbbr%2Fgimp-tilemap-gb/lists"}