1
Fork 0
mirror of https://github.com/Steffo99/flyingsnake.git synced 2024-10-15 22:17:34 +00:00
Find a file
2024-09-09 18:16:04 +02:00
flyingsnake Update to Terraria 1.4.4.9 2023-03-07 01:35:12 +01:00
.gitattributes Add integration test 2019-09-28 22:32:02 +02:00
.gitignore Don't draw missing colors 2020-06-28 17:51:25 +02:00
flyingsnake-completion.bash Add Bash completion 2019-10-05 18:56:03 +02:00
LICENSE.txt Update and port to Uv 2024-09-09 15:18:11 +02:00
pyproject.toml Update and port to Uv 2024-09-09 15:18:11 +02:00
README.md Update and port to Uv 2024-09-09 15:18:11 +02:00
uv.lock Update and port to Uv 2024-09-09 15:18:11 +02:00

Flyingsnake

CLI Terraria world map renderer

Available on PyPI

Screenshots

flyingsnake Small_Example.wld Output.png

Requirements

To use flyingsnake, you need Python 3.7 or higher installed on your machine and inside your PATH.

Installing

Windows

Open either Windows PowerShell (Windows 10) or the Command Prompt (other Windows versions) and enter:

pip install flyingsnake --upgrade

Linux

Enter this in your terminal:

python3.7 -m pip install flyingsnake --upgrade

Usage

Warning

Loading maliciously designed Terraria worlds can drain system resources, crash the interpreter, or possibly do more evil things!

Make sure you trust the worlds you are rendering!

To create a world map image named Output.png from the Small_Example.wld file present in your current working directory, run in your terminal:

flyingsnake Small_Example.wld Output.png

Layers

The world map is generated by merging together multiple layers that can be enabled/disabled through flags.

In order, those are:

  • Background
  • Walls
  • Liquids
  • Blocks
  • Wires

Background

The background layer is made by coloring the Overworld, the Underground and the Caverns their respective background color.

It can be selected exclusively with the --background flag, or turned off with the --no-background flag.

flyingsnake Small_Example.wld Output.png --background

Walls

The walls layer contains the colors of the walls present in the world.

It can be selected exclusively with the --walls flag, or turned off with the --no-walls flag.

If the walls are painted, they will be colored with the paint color. You can turn off paint colors with the --no-paints option.

flyingsnake Small_Example.wld Output.png --walls

Liquids

The liquids layer contains the colors of the liquids present in the world (water, lava, honey...)

It can be selected exclusively with the --liquids flag, or turned off with the --no-liquids flag.

flyingsnake Small_Example.wld Output.png --liquids

Blocks

The blocks layer contains the colors of the blocks present in the world.

It can be selected exclusively with the --blocks flag, or turned off with the --no-blocks flag.

If the blocks are painted, they will be colored with the paint color. You can turn off paint colors with the --no-paints option.

flyingsnake Small_Example.wld Output.png --blocks

Wires

The wires layer is a semi-transparent overlay of the wires present in the world.

It can be selected exclusively with the --wires flag, or turned off with the --no-wires flag.

flyingsnake Small_Example.wld Output.png --wires

Custom colors

By default, flyingsnake uses the colors defined in the TEdit settings file.

However, you can use different colors by passing the --colors colors.json option to the command.

You can see an example colors file here; the colors are in RGBA format, and go from 0 to 255.

License

flyingsnake is licensed under the AGPL 3.0. Basically, 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.

See also

If you are interested in flyingsnake, you might be interested in these other programs too:

  • lihzahrd, the package used to make this generator
  • TEdit, the Terraria map editor from which this package gets its default colors