https://github.com/spearwolf/kiwotigo
a world map generation tool
https://github.com/spearwolf/kiwotigo
creative-coding gamedev generation generative-art javascript map-generator world-map
Last synced: about 1 year ago
JSON representation
a world map generation tool
- Host: GitHub
- URL: https://github.com/spearwolf/kiwotigo
- Owner: spearwolf
- License: gpl-3.0
- Created: 2014-03-17T18:22:45.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2023-10-17T13:11:52.000Z (over 2 years ago)
- Last Synced: 2025-03-24T10:11:48.755Z (about 1 year ago)
- Topics: creative-coding, gamedev, generation, generative-art, javascript, map-generator, world-map
- Language: Go
- Homepage: https://spearwolf.github.io/kiwotigo/
- Size: 5 MB
- Stars: 8
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# kiwotigo
 [](https://goreportcard.com/report/github.com/spearwolf/kiwotigo)
_kiwotigo_ is world map generation tool.
the world builder algorithm generates randomly generated 2D maps, on which _regions_ are distributed, with the following characteristics:
- each region has a base area that has a minimum size (can be configured)
- each region has at least one or more _connections_ to another nearby region
- each region is accessible from any region via these connections
A group of regions that are close together form a _continent_, there may (but need not) be several continents, and a continent can also consist of only one region (like islands).
Although the generation of regions is essentially based on randomness, it can be configured quite extensively.
As output, the world builder provides a json structure, the _intermediate continental format_.
_kiwotigo_ is written in javascript, whereas the core of the world map builder is developed in [go](https://golang.org/) and integrated via [webassembly](https://webassembly.org/).
→ [Just try it out for yourself!](https://spearwolf.github.io/kiwotigo/)
## Why?
_kiwotigo_ creates worlds, but doesn't tell you what to do with them.
that's up to you. you're a indie-gamedev and need a tool to create 2D or maybe 3D maps? or you just want to create a nice graphics demo and need random input? go ahead, let your inspiration run wild - and don't forget to drop me a message (or a PR) if you want to show something off :wink:
## Local Development
As a precondition a current nodejs v16+ and a go-lang (1.17+) sdk has to be installed.
Build the _kiwotigo_ library with:
```sh
$ npm run build # -> npx gulp buildAll
```
Start a http server for testing the kiwotigo.wasm module with:
```sh
$ npx serve
```
as an alternative you can use the gulp tasks:
```sh
$ npx gulp --tasks # show all tasks
```
or just start developing with:
```sh
$ npm start
```
have fun!
## LICENSE
the kiwotigo code is licensed under the GPLv3. see [LICENSE](./LICENSE.txt) for details.