{"id":19883377,"url":"https://github.com/steffo99/flyingsnake","last_synced_at":"2026-03-03T14:32:37.249Z","repository":{"id":57431571,"uuid":"203212088","full_name":"Steffo99/flyingsnake","owner":"Steffo99","description":"CLI Terraria world map renderer","archived":false,"fork":false,"pushed_at":"2024-09-09T16:16:04.000Z","size":113,"stargazers_count":10,"open_issues_count":4,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-01T00:08:09.298Z","etag":null,"topics":["lihzahrd","pillow","python37","terraria"],"latest_commit_sha":null,"homepage":"https://forums.terraria.org/index.php?threads/flyingsnake-a-world-map-renderer.82400/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"eupl-1.2","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Steffo99.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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},"funding":{"ko_fi":"steffo"}},"created_at":"2019-08-19T16:43:10.000Z","updated_at":"2024-09-10T21:02:25.000Z","dependencies_parsed_at":"2024-11-12T17:33:31.535Z","dependency_job_id":null,"html_url":"https://github.com/Steffo99/flyingsnake","commit_stats":{"total_commits":52,"total_committers":4,"mean_commits":13.0,"dds":"0.17307692307692313","last_synced_commit":"9252ca4565a04770ca88b24499052bb480ec1b07"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Steffo99%2Fflyingsnake","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Steffo99%2Fflyingsnake/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Steffo99%2Fflyingsnake/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Steffo99%2Fflyingsnake/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Steffo99","download_url":"https://codeload.github.com/Steffo99/flyingsnake/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252053936,"owners_count":21687196,"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":["lihzahrd","pillow","python37","terraria"],"created_at":"2024-11-12T17:20:04.278Z","updated_at":"2026-03-03T14:32:37.186Z","avatar_url":"https://github.com/Steffo99.png","language":"Python","funding_links":["https://ko-fi.com/steffo"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n![](.media/icon-128x128_round.png)\n\n# Flyingsnake\n\nCLI Terraria world map renderer\n\n\u003c/div\u003e\n\n## Links\n\n[![Available on PyPI](https://img.shields.io/pypi/v/flyingsnake)](https://pypi.org/project/flyingsnake/)\n\n## Screenshots\n\n![flyingsnake Small_Example.wld Output.png](https://i.imgur.com/HtNEIKw.png)\n\n## Requirements\n\nTo use `flyingsnake`, you need [Python 3.7 or higher](https://www.python.org/downloads/) installed on your machine and inside your PATH.\n\n## Installing\n\n### Windows\n\nOpen either **Windows PowerShell** (Windows 10) or the **Command Prompt** (other Windows versions) and enter:\n\n```batch\npip install flyingsnake --upgrade\n```\n\n### Linux\n\nEnter this in your terminal:\n\n```bash\npython3.7 -m pip install flyingsnake --upgrade\n```\n\n## Usage\n\n\u003e **Warning**\n\u003e \n\u003e Loading maliciously designed Terraria worlds can drain system resources, crash the interpreter, or possibly do more evil things!\n\u003e \n\u003e **Make sure you trust the worlds you are rendering!**\n\nTo create a world map image named `Output.png` from the `Small_Example.wld` file present in your current working directory, run in your terminal:\n\n```bash\nflyingsnake Small_Example.wld Output.png\n```\n\n### Layers\n\nThe world map is generated by merging together multiple layers that can be enabled/disabled through flags.\n\nIn order, those are:\n- Background\n- Walls\n- Liquids\n- Blocks\n- Wires\n\n#### Background\n\nThe background layer is made by coloring the Overworld, the Underground and the Caverns their respective background color.\n\nIt can be selected exclusively with the `--background` flag, or turned off with the `--no-background` flag.\n\n![flyingsnake Small_Example.wld Output.png --background](https://i.imgur.com/69qRLZX.png)\n\n#### Walls\n\nThe walls layer contains the colors of the walls present in the world.\n\nIt can be selected exclusively with the `--walls` flag, or turned off with the `--no-walls` flag.\n\nIf the walls are painted, they will be colored with the paint color.\nYou can turn off paint colors with the `--no-paints` option.\n\n![flyingsnake Small_Example.wld Output.png --walls](https://i.imgur.com/Grkq5PQ.png)\n\n#### Liquids\n\nThe liquids layer contains the colors of the liquids present in the world (water, lava, honey...)\n\nIt can be selected exclusively with the `--liquids` flag, or turned off with the `--no-liquids` flag.\n\n![flyingsnake Small_Example.wld Output.png --liquids](https://i.imgur.com/Pifjb4D.png)\n\n#### Blocks\n\nThe blocks layer contains the colors of the blocks present in the world.\n\nIt can be selected exclusively with the `--blocks` flag, or turned off with the `--no-blocks` flag.\n\nIf the blocks are painted, they will be colored with the paint color.\nYou can turn off paint colors with the `--no-paints` option.\n\n![flyingsnake Small_Example.wld Output.png --blocks](https://i.imgur.com/E05kgOA.png)\n\n#### Wires\n\nThe wires layer is a semi-transparent overlay of the wires present in the world.\n\nIt can be selected exclusively with the `--wires` flag, or turned off with the `--no-wires` flag.\n\n![flyingsnake Small_Example.wld Output.png --wires](https://i.imgur.com/XDLRCAE.png)\n\n### Custom colors\n\nBy default, `flyingsnake` uses the colors defined in the [TEdit settings file](https://github.com/TEdit/Terraria-Map-Editor/blob/master/TEditXna/settings.xml).\n\nHowever, you can use different colors by passing the `--colors colors.json` option to the command.\n\nYou can see an example colors file [here](https://github.com/Steffo99/flyingsnake/tree/master/flyingsnake/example_colors.json); the colors are in RGBA format, and go from 0 to 255.\n\n## License\n\n`flyingsnake` is licensed under the [AGPL 3.0](/LICENSE.txt).\nBasically, you're allowed to do whatever you want with this program, but you have to publish all modified code, and it has to be published under the same license.\n\n## See also\n\nIf you are interested in `flyingsnake`, you might be interested in these other programs too:\n\n- [lihzahrd](https://github.com/Steffo99/lihzahrd), the package used to make this generator\n- [TEdit](https://github.com/TEdit/Terraria-Map-Editor), the Terraria map editor from which this package gets its default colors\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteffo99%2Fflyingsnake","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsteffo99%2Fflyingsnake","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsteffo99%2Fflyingsnake/lists"}