Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tw-tooling/tw-simple-mapgen

Simple Map-generator for Teewords
https://github.com/tw-tooling/tw-simple-mapgen

teeworlds

Last synced: 16 days ago
JSON representation

Simple Map-generator for Teewords

Host: GitHub
URL: https://github.com/tw-tooling/tw-simple-mapgen
Owner: tw-tooling
License: mit
Created: 2021-03-07T22:23:16.000Z (over 3 years ago)
Default Branch: main
Last Pushed: 2023-12-02T02:28:59.000Z (11 months ago)
Last Synced: 2024-07-30T20:51:18.673Z (3 months ago)
Topics: teeworlds
Language: Python
Homepage:
Size: 84 KB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # Simple Map-generator for Teeworlds

This Repository contains python scripts including a gores map generator for teeworlds.

You can download the map generator application for windows [here](https://github.com/tw-tooling/tw-simple-mapgen/releases/download/v0.1/tw-mapgen-windows.exe) (no installation required).

layered | spiral

--- | ---

![Map 1](https://user-images.githubusercontent.com/33965649/113918790-22136980-97e3-11eb-92ba-0c47300ed3e8.png) | ![Map 2](https://user-images.githubusercontent.com/33965649/113918826-2a6ba480-97e3-11eb-8a58-32b703fe92c6.png)

All results are saved to the current working directory if no other path is specified.

## Requirements

The scripts require Python 3 and `numpy`. You can install `numpy` with `pip install numpy`.

## start gui (from source)

```sh

python src/tw-mapgen.py

```

## create map

Generate a teeworlds map (the filename argument is optional):

```sh

python src/create_random_blocks.py [FILENAME]

python src/create_spiral.py [FILENAME]

python src/create_layered.py [FILENAME]

# if you want to set custom directions and config, change `create_something.py` and run

python src/create_something.py

```

Those scripts utilize `create_map.py` to build and save the map file. The map is saved as `FILENAME`, with the default FILENAME being `newmap.map`.

## save images

Extract all images saved in a teeworlds map to the working directory (doesn't include referenced external images):

```sh

python src/save_images.py PATH_TO_MAP

```

## generate gui application with pyinstaller

```sh

pyinstaller tw-mapgen.py --onefile

```

## helpful teeworlds map-/datafile documentation:

* german map explanation: https://teeworlds-friends.de/thread/7563-roh-aufbau-einer-teeworlds-map/

* ddnet map documentation: https://ddnet.tw/libtw2-doc/map/

* teeworlds mapitem source: https://github.com/teeworlds/teeworlds/blob/master/src/game/mapitems.h

* twl datafile items source: https://github.com/Malekblubb/twl/blob/master/include/twl/files/map/map_datafile_items.hpp

* libtw2 datafile documentation: https://github.com/heinrich5991/libtw2/blob/master/doc/datafile.md