{"id":25722674,"url":"https://github.com/Leinnan/rpack","last_synced_at":"2025-02-25T19:39:38.678Z","repository":{"id":211316182,"uuid":"728541594","full_name":"Leinnan/rpack","owner":"Leinnan","description":"Create tilemaps in seconds!","archived":false,"fork":false,"pushed_at":"2025-01-27T18:03:44.000Z","size":2870,"stargazers_count":9,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-09T14:01:46.351Z","etag":null,"topics":["egui","game-development","tool"],"latest_commit_sha":null,"homepage":"http://rpack.mevlyshkin.com/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Leinnan.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,"publiccode":null,"codemeta":null}},"created_at":"2023-12-07T06:52:51.000Z","updated_at":"2025-02-04T14:33:49.000Z","dependencies_parsed_at":"2025-01-13T21:23:15.412Z","dependency_job_id":"6fbacac3-bdcb-4ed7-b8e8-84fd7259eacf","html_url":"https://github.com/Leinnan/rpack","commit_stats":null,"previous_names":["leinnan/rpack"],"tags_count":0,"template":false,"template_full_name":"emilk/eframe_template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Leinnan%2Frpack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Leinnan%2Frpack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Leinnan%2Frpack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Leinnan%2Frpack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Leinnan","download_url":"https://codeload.github.com/Leinnan/rpack/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240737019,"owners_count":19849539,"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":["egui","game-development","tool"],"created_at":"2025-02-25T19:39:35.029Z","updated_at":"2025-02-25T19:39:38.663Z","avatar_url":"https://github.com/Leinnan.png","language":"Rust","funding_links":[],"categories":["Assets"],"sub_categories":[],"readme":"# rpack [![Build Status](https://github.com/Leinnan/rpack/workflows/CI/badge.svg)](https://github.com/Leinnan/rpack/actions?workflow=CI)\n\n\nCreate tilemaps in seconds!\n\nThis repository contains few projects that together make a fully functional solution for generating tilemaps alongside integration to the Bevy game engine.\n\n## Bevy rPack\n\n[![Crates.io](https://img.shields.io/crates/v/bevy_rpack)](https://crates.io/crates/bevy_rpack)\n[![Documentation](https://docs.rs/bevy_rpack/badge.svg)](https://docs.rs/bevy_rpack)\n\nA Bevy plugin with support for the `rpack.json` atlases.\n\nMore info available at [crates/bevy_rpack](https://github.com/Leinnan/rpack/tree/master/crates/bevy_rpack).\n\nRepository contains example how to use plugin in Bevy.\n\n## rPack CLI\n\n[![Crates.io](https://img.shields.io/crates/v/rpack_cli)](https://crates.io/crates/rpack_cli)\n[![Documentation](https://docs.rs/rpack_cli/badge.svg)](https://docs.rs/rpack_cli)\n\nCommand line interface for generating tilemaps. \n\n```sh\nBuild rpack tilemaps with ease\n\nUsage: rpack_cli \u003cCOMMAND\u003e\n\nCommands:\n  generate              Generates a tilemap\n  config-create         Creates a tilemap generation config\n  generate-from-config  Generates a tilemap from config\n  help                  Print this message or the help of the given subcommand(s)\n\nOptions:\n  -h, --help\n          Print help (see a summary with '-h')\n\n  -V, --version\n          Print version\n```\n\nAvailable at [crates/rpack_cli](https://github.com/Leinnan/rpack/tree/master/crates/rpack_cli).\n\n### Installation\n\nOnly with Cargo (Rust package manager) at the moment:\n\n```sh\ncargo install rpack_cli\n```\n\n## rPack egui\n\n[![Crates.io](https://img.shields.io/crates/v/rpack_egui)](https://crates.io/crates/rpack_egui)\n\nA both desktop and web frontend for generating tilemaps. Just drag and drop images into the program and generate tilemaps.\n\nTo open it in browser click one of the icons below:\n\n[![Itch.io](https://img.shields.io/badge/Itch-%23FF0B34.svg?style=for-the-badge\u0026logo=Itch.io\u0026logoColor=white)](https://mevlyshkin.itch.io/rpack)\n[![Github Pages](https://img.shields.io/badge/github%20pages-121013?style=for-the-badge\u0026logo=github\u0026logoColor=white)](http://rpack.mevlyshkin.com/)\n\n![rpack_ebVVrMf3wm](https://github.com/user-attachments/assets/bb015348-3c1f-46be-9312-963b4f39f9c0)\n\nAvailable at [crates/rpack_egui](https://github.com/Leinnan/rpack/tree/master/crates/rpack_egui).\n\n\n## Used formats\n\nrpack tools provides and work with two json based files.\n\n### Atlas files\n\nTilemaps are using `.rpack.json` extension. \n\nFields:\n\n- `size`: two element array- width and height of the tilemap\n- `filename`: string- path to the atlas image file, relative to the config file\n- `frames`: array- contain info about each frame in tilemap, contains `key` string field and `frame` field that is made up from fields:\n  - `h`- image height \n  - `w`- image width\n  - `x`- x start pos of the image in the tilemap \n  - `y`- y start pos of the image in the tilemap \n\nExample:\n\n```json\n{\n  \"filename\": \"tilemap.png\",\n  \"frames\": [\n    {\n      \"frame\": {\n        \"h\": 42,\n        \"w\": 42,\n        \"x\": 418,\n        \"y\": 66\n      },\n      \"key\": \"tiles/ship/spaceBuilding_001\"\n    },\n    {\n      \"frame\": {\n        \"h\": 44,\n        \"w\": 34,\n        \"x\": 2,\n        \"y\": 2\n      },\n      \"key\": \"tiles/agents/spaceAstronauts_004\"\n    },\n  ],\n  \"size\": [\n    512,\n    512\n  ]\n}\n```\n\n### Generation config files\n\nConfig files are using `.rpack_gen.json` extension. \n\nFields:\n\n- `output_path`: string- path relative to the config, without extension, this is where tilemap image and `.rpack.json` config file are going to be saved\n- `asset_patterns`: array of strings- search patterns for images to be included, relative paths to the config\n- `format`: optional(defaults to `Png`), format of the tilemap image, currently supported values: `Png`, `Dds`\n- `size`: optional(defaults to `2048`), size of the tilemap image\n- `texture_padding`: optional(defaults to `2`), size of the padding between frames in pixel\n- `border_padding`: optional(defaults to `0`), size of the padding on the outer edge of the packed image in pixel\n\n\nExample:\n\n```json\n{\n  \"asset_patterns\": [\n    \"tiles/agents/*\",\n    \"tiles/effects/*\",\n    \"tiles/missiles/*\",\n    \"tiles/ship/spaceBuilding_00*\",\n    \"tiles/ship/spaceBuilding_01*\"\n  ],\n  \"output_path\": \"assets/tilemap\",\n  \"format\": \"Png\",\n  \"size\": 512,\n  \"texture_padding\": 2,\n  \"border_padding\": 2\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLeinnan%2Frpack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FLeinnan%2Frpack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FLeinnan%2Frpack/lists"}