RTB-TimberbornTerrainGenerator icon

TimberbornTerrainGenerator

This mod allows you to generate modern procedural Timerborn style maps with a configurable settings file. For more information visit github page

Last updated 2 months ago
Total downloads 3669
Total rating 2 
Categories Mods Maps
Dependency string RTB-TimberbornTerrainGenerator-1.4.2
Dependants 1 other mod depends on this mod

This mod requires the following mods to function

BepInEx-BepInExPack_Timberborn-5.4.19 icon
BepInEx-BepInExPack_Timberborn

BepInEx pack for Timberborn. Preconfigured and ready to use.

Preferred version: 5.4.19
Timberborn_Central-TimberAPI-0.5.0 icon
Timberborn_Central-TimberAPI

Unofficial API to enable easier Timberborn modding

Preferred version: 0.5.0

README

Random map generator

A work in progress project for generating random maps for the game video game Timberborn. Minimum supported map size is 32x32, maximum is 384x384. All maps are squares and the Y parameter on "new map" is used as a seed. If the Y parameter is the same as x, it is completely random and unseeded from the user. It once used several open source projects, including the works of Caps_Errors (initial python code), reddit user u/savanik (updated with river handling), MSterczewski (some plugin modeling), but as of the C# rewrite (version 0.9.0 release) the plugin is completely comprised of independent code, other than the use of one OSS C# noise library, known as FastNoiseLite. FastNoise is very fast at producing noise, and well, it was helpful.

It used to be that if you were on a Mac, Python was needed for this thing to work. That is no longer the case. This is now a pure C# plugin with the only dependencies being it, the game, Bepinex, and TimberAPI.

Generating a map

Generating a map is simple! Install the plugin, and generate a new map! Be aware all maps will be square due a (hopefully temporary) limitation of the generator, and all maps generated will by default use the settings profile in settings.ini, codenamed "PlentifulPlains." They are a good starting point but other map types and presets are possible with all the options. Please look in the included ini files for examples (such as HardyHills, our other "hard mode" preset), and if you want to use them, just copy and paste the values into the actual settings.ini. You can also edit the values individually. If you want to do that, you'll probably want to look at the settings readme here: https://github.com/R-T-B/TimberbornTerrainGenerator/blob/main/SettingsReadme.md

Once the map is generated, feel free to run the water sim, drop a starting location somewhere nice, and load in. That's really all there is to it, and most of the maps it makes are playable (at least on the presets, especially on PlentifulPlains). though you may want to generate a few times to "optimze" your start. I won't judge you... heh.

Performance

A word about performance... The C# version we just realeased as of version 0.9.0 is both massively more powerful and more flexible... and massively slower than the python script version that preceeded it. This isn't due to the language. Frankly, python is slow, and the script had no business being that fast. The reason it was that fast was only because it was a list of hardcoded assumptions and as such, did almost no thinking. This obviously made customizing map parameters hard however, and the C# version is the infinitely better way forward. But yes, when you click to generate your map, be advised it MAY APPEAR FROZEN for a bit. This is normal! Some numbers on expected load times, on PCs ranging from Supreme to Potato, is available here: https://github.com/R-T-B/TimberbornTerrainGenerator/blob/main/timings.md

That said yes we consider performance a priority issue. See this ticket: https://github.com/R-T-B/TimberbornTerrainGenerator/issues/3

Installation

In order to install the mod follow the instructions from BepInEx website: https://docs.bepinex.dev/articles/user_guide/installation/index.html

As of 08/24/2022, we no longer track releases beyond two major subversions back in the main readme. See the elder release notes here: https://github.com/R-T-B/TimberbornTerrainGenerator/blob/main/HistoricalReleases.md

Changelog:

v1.3.0: A new release that adds a two settings related to riverbed sloping, feel free to check them out in the GUI! Presets have also been updated to use these new settings, where applicable. The river sloping logic is on by default, so this is technically seedbreaking, but you can get the old flat beds by simply setting RiverSlopeEnabled=False.

v1.3.1: Fixed a bug in entity placement that was making entities (trees, ruins etc) not as dense as they should be. This is not seedbreaking, except of course for entities, which are now more dense than before. Also updated PlentifulPlains preset to take advantage of river sloping.

v1.4.0: Just TimberAPI 0.5.x support. Big things are still planned (tm), but I just got a puppy so it may be a few weeks until they are done, just FYI. :)

v1.4.1: Just some annoying GUI fixes.

Feedback

If you have any feedback, please reach out to me at github or on Timberborn Discord in the modding channel.

Authors

R-T-B

Available versions

Please note that the install buttons only work if you have compatible client software installed, such as the Thunderstore Mod Manager. Otherwise use the zip download links instead.

Upload date Version number Downloads Download link  
2022-10-17 1.4.2 878 Version 1.4.2 Install
2022-9-27 1.4.1 858 Version 1.4.1 Install
2022-9-23 1.4.0 449 Version 1.4.0 Install
2022-9-5 1.3.1 392 Version 1.3.1 Install
2022-9-4 1.3.0 72 Version 1.3.0 Install
2022-9-1 1.2.0 90 Version 1.2.0 Install
2022-8-29 1.1.3 103 Version 1.1.3 Install
2022-8-29 1.1.2 15 Version 1.1.2 Install
2022-8-29 1.1.1 22 Version 1.1.1 Install
2022-8-27 1.1.0 72 Version 1.1.0 Install
2022-8-27 1.0.6 20 Version 1.0.6 Install
2022-8-27 1.0.5 25 Version 1.0.5 Install
2022-8-27 1.0.4 17 Version 1.0.4 Install
2022-8-27 1.0.3 16 Version 1.0.3 Install
2022-8-27 1.0.2 17 Version 1.0.2 Install
2022-8-27 1.0.1 17 Version 1.0.1 Install
2022-8-27 1.0.0 17 Version 1.0.0 Install
2022-8-24 0.10.0 74 Version 0.10.0 Install
2022-8-24 0.9.5 19 Version 0.9.5 Install
2022-8-23 0.9.4 36 Version 0.9.4 Install
2022-8-22 0.9.3 31 Version 0.9.3 Install
2022-8-22 0.9.2 21 Version 0.9.2 Install
2022-8-22 0.9.1 16 Version 0.9.1 Install
2022-8-22 0.9.0 23 Version 0.9.0 Install
2022-8-17 0.3.5 84 Version 0.3.5 Install
2022-8-16 0.3.4 36 Version 0.3.4 Install
2022-8-15 0.3.3 25 Version 0.3.3 Install
2022-8-15 0.3.2 14 Version 0.3.2 Install
2022-8-15 0.3.1 13 Version 0.3.1 Install
2022-8-15 0.3.0 13 Version 0.3.0 Install
2022-8-15 0.2.3 16 Version 0.2.3 Install
2022-8-15 0.2.2 12 Version 0.2.2 Install
2022-8-15 0.2.1 14 Version 0.2.1 Install
2022-8-14 0.2.0 25 Version 0.2.0 Install
2022-8-14 0.1.4 32 Version 0.1.4 Install
2022-8-13 0.1.3 25 Version 0.1.3 Install
2022-8-13 0.1.2 17 Version 0.1.2 Install
2022-8-13 0.1.1 15 Version 0.1.1 Install
2022-8-13 0.1.0 28 Version 0.1.0 Install