[GS] Renewed Village Growth 12.0 (RVG)

[Firrel]

Renewed Village Growth (RVG)

RVG is a Game Script that manages towns growth in a new and balanced way, making growth depend on varied cargo delivery (passengers, food, goods, ...) and sustained transportation of passangers and mails. The script supports any Industry NewGRF set. It is born as a combination of keoz's Renewed City Growth GS and Sylf's City Growth Limiter GS.



How this works:
The script only triggers growth in the towns which are already exchanging passengers. Its growth rate is calculated (non linearly) on the basis of the degree of achievement for cargo requirements. If there is more cargo than necessary, it is stockpiled for later use. Cargo needs to be provided to a station near the town which accepts the required cargo type. If there are no nearby industry accepting that cargo type, it needs to be funded.

The growth will be completely stopped when insufficient amount of limited cargo types (usually passangers and mails) are transported from the city (generated by the city buildings), limiting its growth when the infrastructure is not maintained. For passangers and mails, the transportation fulfillment can be seen in the town box, for example Passangers last month: 173 max 371.

Cargo requirements are not defined for individual cargo types, but for cargo categories. Depending on the used industry set, there are 3 to 5 categories. It doesn't matter which type of cargo you deliver to achieve category goals. The cargo must be delivered to a station accepting that cargo which is also close to the town. The cargo categories are described in StoryBook, for example FIRS 3 Extreme is defined as below:



Each town decides monthly on a best contributor, who contributed the most to fulfilling the town categories. The contributor then receives points for the towns for growing them over their previous maximum population.



Additions:
The game script also contains other useful additions:
- Industry NewGRFs - explicit support for more than 30 different economies
- Randomization - chose between 13 types of cargo/industry randomization
- Subsidies - game script specific subsidies generation
- Eternal love - maintain good relations with town autorities even after committing atrocities
- Industry stabilizer - maintain a set amount of raw industries on the map, useful for creating maps with only raw industries
- ToyLib - allow toy AI to survive no matter what they do

For more information, read the readme file:
readme.txt


Translations:
If you are interested in providing a translation, you can do it by modifying this english translation and posting it to the forum topic, direct message or by creating a new issue/pull request in RVG github with the modified file included. All instances of {STRING[number]} need to be replaced by {STRING} in all other languages.
By sending the translation file you agree that the translation will be used for RVG game script and be released under GPLv2 license.

Currently available languages:
- English
- French (rmnvgr, Elarcis)
- Slovak
- Czech
- Simplified Chinese (SuperCirno, WenSimEHRP)
- Polish (qamil95)
- Galician (pvillaverde)
- German (pnkrtz)
- Japanese (fmang)
- Traditional Chinese (WenSimEHRP)
- Russian (Shkarlatov)

Requirements:
- OpenTTD, v. 14.x or newer or JGRPP v. 0.45.x or newer
- GS SuperLib, v. 40, ToyLib, v. 2, Script Communication for GS v. 45 (you can find it on BaNaNaS, also accessible through OTTD's "Online Content").
- Industry sets: you can use any industry NewGRF
- these are specifically supported industry NewGRFs: Baseset (all climates), FIRS 1.4, 2, 3, 4.3, 5 (all economies), ECS 1.2 (any combination), YETI 0.1.6 (all except Simplified), NAIS 1.0.6, ITI 1.6, 2.14, XIS 0.6, AXIS 2.2, IOTC 0.1, LJI 0.1, OTIS 03, WRBI 1200, Real Beta, Minimalist, PIRS 2022.
- using RVG with any other unsupported industry set will contain proceduraly generated categories, which may not be optimal


Download:
The latest version can be downloaded from BaNaNaS or from the changelog below.
The development with source codes can be found in github: https://github.com/F1rrel/RenewedVillageGrowth.


Changelogs and download links:
Version 12.0 (2025/03/31)
- download link
- new: AXIS Tropical Paradise support (skye0e)
- mod: ITI 2.14 waste town cargo (2TallTyler)
- fix: Simplified Chinese translation (WenSimEHRP)

Older:

[+] Spoiler

Version 11.0 (2024/10/06)
- download link
- new: AXIS 2.2 Steel City support with 6 categories (rhoun)
- new: 6 categories support for FIRS 4 and 5 Steeltown
- fix: Adding towns to a savegame via scenario editor
- fix: Updated GSToyLib

Version 10.1 (2024/07/06)
- download link
- new: FIRS 5 support (bigyihsuan)

Version 10.0 (2024/05/12)
- download link
- new: Russian translation (Shkarlatov)
- mod: Improve performance of GetNearbyIndustriesToTowns (JGRennison)
- mod: Growth label based on timekeeping
- mod: Optimized save/load functions, now 2000 towns can be on the map
- fix: Misspelling of "Passenger" in subsidy type setting (2TallTyler)

Version 9.3 (2023/12/03)
- download link
- new: Traditional Chinese translation (WenSimEHRP)
- new: OTIS 05 support (lezzano000)
- new: Minimalist Industries support (2TallTyler)
- new: Pikka's Industry Redux Set (PIRS 2022) support (2TallTyler)
- fix: Simplified Chinese translation (WenSimEHRP)
- fix: FIRS 3 Arctic Basic cargo categories (2TallTyler)
- fix: Crash in ECS Town vector discovery

Version 9.2 (2023/04/02)
- download link
- fix: Funding failed continuously when no industry could be funded

Version 9.1 (2023/04/02)
- download link
- new: Japanese translation (fmang)
- mod: Updated french translation (Elarcis)
- mod: Updated slovak and czech translations
- fix: STR_SB_WELCOME_LIMIT_GROWTH_DELAY substitution (fmang)
- fix: Is raw cargo categorization

Version 9.0 (2023/02/11)
- download link
- new: German translation (pnkrtz)
- new: Probability to use nearby cargo types
- new: Subsidies generation
- mod: Updated cargoes in XIS economy (qamil95)
- fix: Changing cargo categories after save/load in procedural generation
- fix: Corrected STRING parameters in translations

Version 8.2 (2022/08/06)
- download link
- new: Galician translation (pvillaverde)
- new: Real Industries Beta predefined cargo categories
- change: Adjusted limits of some GS settings to allow adjustments based on daylength
- fix: Handle commands that require specific command pause level

Version 8.1 (2022/05/08)
- download link
- new: ITI v2 support (2TallTyler)
- fix: ECS industries discovery causing procedural cargo generation to fail (2TallTyler)
- fix: Industry ascending randomization loading

Version 8.0 (2022/03/13)
- download link
- new: Welcome page with description of how the GS works and where to find information
- new: Options to change minimum population for unlocking categories. Sorts categories based on selected values
- new: Option to allow zero days growth rate
- new: Randomization ascending and descending
- new: WRBI 1200 predefined cargo categories
- new: Custom story page usefull for server rules and other
- new: Better handling of warnings that cause GS to stop by showing story page with the warning
- modified: OTIS 03 support (audunmaroey)
- modified: Minimum supply percentage option is now minimum fulfilled percentage (lower is easier)
- fix: FIRS4 Steeltown cargo categories (qamil95)
- fix: Global goal list not removing bankrupt/merged company growth points
- fix: Consider cargo list length to determine correct economy

Version 7.2 (2021/10/24)
- download link
- new: Lumberjack Industries 0.1.0 predefined cargo categories (2TallTyler)
- new: Polish translation (qamil95)
- fix: cargo hash overflow affecting economies with a lot of cargo types (XIS, FIRS 4 Steeltown)

Version 7.1 (2021/08/25)

[+] Spoiler

- download link
- new: OTIS 02 predefined cargo categories (audunmaroey)
- new: IOTC 0.1.4 predefined cargo categories
- fix: crash when game debugging was turned on
- fix: crash when last category was reached

Version 7.0 (2021/07/12)

[+] Spoiler

- download link
* Not compatible with previous versions
- modified: Updated FIRS to 4.3.0
- modified: Show available cargo in town info instead of supplied (combination of supplied and stockpiled)
- modified: New growth rate calculation with slower growth and bigger impact of missing cargo goals
- modified: Equalization of impact of each cargo category on missing percentage
- removed: Yeti workers and tired yeti workers as limiter cargos

Version 6.2 (2021/04/18)

[+] Spoiler

- download link
- new: Simplified Chinese translation (SuperCirno)

Version 6.1 (2021/03/07)

[+] Spoiler

- download link
- new: Slovak translation
- new: Czech translation
- fix: crash when a town stopped to be monitored

Version 6.0 (2021/02/22)

[+] Spoiler

* Not compatible with previous versions
- download link
- new: Growth statistics for each player based on most contributed towns
- new: Added FIRS 2.1.5 predefined cargo categories (pr0saic)
- new: Updated texts in story book to include randomization cases
- new: The supported economy is automatically detected from the cargo list
- new: Added industry randomization option based on number of inputs of an industry
- new: Added more cargo randomization options
- new: Raw industry stabilizer that prospects raw industries based on a setting
- new: Added warning for too many towns to save
- modified: Removed cargo stockpiled number from town info box
- modified: Reworked showing of limiter information to show only underperforming cargos with color indication
- modified: Reworked limiter, now limits growth based on average value of all limited cargos (supports more cargos than passangers and mails)
- modified: Changed all parameters to be changeable and handled edge cases
- modified: Added Waste for ITI and Yeti, Tired Yeti for YETI as additional limited cargos
- fix: Prevent showing all cargos when the randomization is none
- fix: Growth rate is limited to 1 day minimum
- fix: Ignore CZTR cargo LVPT when randomizing cargo categories

Version 5.0 (2020/11/24)

[+] Spoiler

* Not compatible with previous versions
- download link
- new: French translation (rmnvgr)
- new: Added ToyLib
- modified: Updated ITI to version 1.6
- modified: Updated FIRS to version 4 alpha 4
- fix: when playing with 64 cargo economy, the loading of cargo hash now should work properly
- fix: added initialization of random seed so restarting the game will lead to different cargos
- fix: unused cargos should be properly removed from category list

Version 4.3 (2020/09/14)

[+] Spoiler

- download link
- fix: reworked GS versioning system

Version 4.2 (2020/08/30)

[+] Spoiler

- download link
- new: added support for XIS 0.6: The Lot
- modified: updated ITI to 1.5 to allow recycling chain
- modified: all YETI game styles working except Simplified
- fix: randomization giving too few cargos when not all ECS vectors are enabled

Version 4.1 (2020/08/04)

[+] Spoiler

- download link
- fix: received cargo for first category is now working properly

Version 4.0 (2020/08/04)

[+] Spoiler

* Not compatible with other versions
- download link
- new: added randomization of cargos to fixed number or variable number per category
- new: added parameter to display all required cargo by towns from start - "Display immediately
cargos per town"
- new: added displaying of full cargo list in "Town info display mode" parameter
- new: added support for Improved Town Industries 1.3
- new: added support for FIRS 1.4 and FIRS 4 alpha
- new: added support for 64 cargo types
- new: added setting to delay limiter stopping town growth by set amount of months - "Limit
Growth: Stop growth after set amount of months"
- modified: added easy, medium and hard values to some parameters
- modified: completely reworked town texts
- modified: any supplied cargo from first category will start town monitoring
- modified: changed category names to better represent the cargo
- modified: town texts are redrawn when new month kicks in
- fix: funding towns is now working
- fix: the growth is now enabled properly for towns that were not growing when limiter got
disabled mid game
- fix: starting monitoring should be more reliable
- removed: options to merge categories
- removed: FIRS 1.3 no longer supported

Version 3 (2020/05/17)

[+] Spoiler

- download link
- modified: support for any combination of ECS 1.2 vectors
- modified: added parameter to game script settings "Town info display mode" to change the mode of
displaying town information (Automatic, Cargo information, Limiter information)
- modified: automatic town info mode is now switching pages every 3 seconds instead of scrolling
- modified: updated YETI to version 0.1.6
- fix: towns will now properly stop to be monitored after one year without passanger service

Version 2 (2020/05/13)

[+] Spoiler

- download link
- modified: "Expert: slowest TGR if requirements are not met" changed to max 880 as it is maximum
possible TGR
- modified: changed "Eternal love" default value to off
- modified: updated ECS vector to version 1.2
- fix: issue with scrambled story book text after loading game
- fix: display town growth is not limited by the script message when pax and mail requirements changed to
0 mid game
- fix: town categories in town info screen now scroll when there are more than can fit
- fix: removed duplicite cargo printing
- removed: french translation

Version 1 (2020/03/08)

[+] Spoiler

- download link
- combination of Renewed City Growth by Keoz, City Growth Limiter by Sylf
- new: added support for FIRS 3.0.12 economies
- new: added support for NAIS: North America economy
- new: eternal love from towns
- fix: towns under 100 population will always grow as normal

[Firrel]

Hi Firrel, I have a feature request. ... I would love to see an option where for each town it picks a random *specific* cargo from each cargo category to request.

I like the idea, it is a bit like TF2 works. I wanted to do something similar. It can be done by storing a uint32 number with one bit per cargo type, so it is not too demanding for saving and it is easily reconstructed. The cargo types selected for specific town can be displayed as third page of town info. There can be 1-3 cargos per category (limited by displayed parameters).
Will try to work on it for the next release, but don't expect it to be very soon.

[Boukev]

Sounds like great changes! Thanks a lot. Will try it out when I can.

[djsider]

I tried out the script with FIRS and food is not included in cat 2. I have no idea how to get the town to accept Fish, Fruit, Livestock, or Milk.

Should food be included in cat 2? and goods into cat 3?

[Boukev]

I tried out the script with FIRS and food is not included in cat 2. I have no idea how to get the town to accept Fish, Fruit, Livestock, or Milk.

Should food be included in cat 2? and goods into cat 3?

I think the current setup is nice with food being a second level as a processed form of a pure stock like fish, fruit, livestock or milk.

You need to have a factory (brewery, dairy or stovkyard etcetera) in or near the town (the factory starts with the towns name) that you can supply to make it count towards the growth goal. You do not need to bring the raw ingredients to the town buildings themselves.

[djsider]

I eventually did figure out it’s not just about the town buildings but it can be industry as well. I’m used to other city builders where you need to supply the town to count.

Having a raw material go into an industry that produces food in the same town area means I do not need to build a big network. I.e. a plantation to cider mill will provide two categories. Having the goals just be what you can deliver to the town or at least having options to configure the cargos would be nice.

Btw, the readme states food in cat 2, not in the later category.

Additional q: why are the requirements so low? I’m at 800 ppl and it says for general food 5/100/120 for the required/supplied/stocked. This means it only requires 5 units of general food per month? And it’s storing way more than 10x that amount

[djsider]

Just went through the old RCG posts and I see screenshots there indicating food is in cat 2. Just wondering if the change was intended for it to be not included in general food and being allowed later on. Also, does anyone know what the requirements per 1000 population are?

[LaChupacabra]

You need to have a factory (brewery, dairy or stovkyard etcetera) in or near the town (the factory starts with the towns name) that you can supply to make it count towards the growth goal. You do not need to bring the raw ingredients to the town buildings themselves.

It works a bit differently - in this script (similar to the base RCG), counted are delivery to stations assigned to a specific city, not to enterprises with the city's name.
Changing the station name will not change the city to which it is assigned. If the factory is located near two cities, you need note attention to which city the station will be assigned during construction.

[SHADOW-XIII]

I wanted to start a scenario with the script but it seems "Which industry set is being used" option is greyed out in the scenario editor and cannot be changed from "Baseset: Temperate" (even though the map is subarctic) and wanted to change to NAIS

and fix/help with that?

EDIT: I edited the script, changed option to CONFIG_INGAME, seems to have worked, started scenario, saved, restored the script from bananas and it looks ok

[Firrel]

Should food be included in cat 2? and goods into cat 3?

As Boukev said, I considered the food and goods as processed and I wanted to have enought diversity in each category.

Having the goals just be what you can deliver to the town or at least having options to configure the cargos would be nice.

You can change the categories yourself, it is easy:
1. Start game with the industry you want to modify and Debug log: Cargo. This will print you into AI/GS Debug all cargo types and their indexes.
2. Go to (on Windows) /Documents/OpenTTD\content_download\game and uzip the RVG game script.
3. Open cargo.nut, find the industry you want to modify in function DefineCargosBySettings().
::CargoCat - each array represents one cargo category and numbers represent cargo indexes.
::CargoCatList - names associated with the category
::CargoMinPopDemand - at which population a category will be enabled
::CargoPermille - cargo demand per thousand population
::CargoDecay - percentage of cargo to be decayed per month
4. Save file and create new game with these settings

Additional q: why are the requirements so low? I’m at 800 ppl and it says for general food 5/100/120 for the required/supplied/stocked. This means it only requires 5 units of general food per month? And it’s storing way more than 10x that amount

I will need to look into it. I changed the minimum TGR to 880 and as it seems it broke some calculations. You can adjust the required amount by adjusting the difficulty level. With the stockpiling, it seems that sometimes it will limit it to 10x and sometimes not.

I wanted to start a scenario with the script but it seems "Which industry set is being used" option is greyed out in the scenario editor and cannot be changed from "Baseset: Temperate" (even though the map is subarctic) and wanted to change to NAIS

Before creating scenario, you want to have game script active and setup correctly, because all game script parameters are saved with the scenario as well as information about the game script.

The parameter "Which industry set is being used" is supposed to be grayed out. As well as you cant change FIRS for NAIS GRF mid game, because it would break the game, you cant do it in a GS. The industry information is used during game script initialization. You may see correct categories in the story book, because that is rewritten on game load, but towns are not reinitialized, so might happen the categories inside the script are still of the old format or something is broken.

[SHADOW-XIII]

I loaded scenario that supports NAIS (NA Industry Set) from bananas.
The script showed "Baseline: Temperate" and it couldn't been changed there
and when starting the game script was complaining that industry set does not match Temperate when starting the game but it was not possible to change at any time.

Forcing it (through script editing) to "NARS 1.0.6: North America" in the Scenario Editor seems to have worked though,
playing the scenario now and so far not having any issues

[speeder]

Had to do same thing with my FIRS-based scenario.

Also I am heavily editing the script, for example make the passengers transported limiter to be a rolling average, instead of the last month, because my cities stopped growing because my transportation was mostly ship based, so a ship would come, carry off 100% of passengers, next month would be 0, then another arrive... the way the script worked was resulting in city never growing, because it would start growing some days before month end, but then stop because transported last month was 0 again.

[Firrel]

I am glad changing the industry type in scenario editor works fine. As I understand it, when the scenario is created in scenario editor without GS and then the GS is added in the scenario editor, the GS is not started yet. This means the parameters can be changed, like the industry type. When the scenario is started as a game, the GS is then initialized. But changing the parameter already in game would lead to unpredictable results. So I cant enable changing the parameter in game. It is possible to change the industry, although it is not straightforward. I am fine with that.

Also I am heavily editing the script, for example make the passengers transported limiter to be a rolling average, instead of the last month, because my cities stopped growing because my transportation was mostly ship based, so a ship would come, carry off 100% of passengers, next month would be 0, then another arrive... the way the script worked was resulting in city never growing, because it would start growing some days before month end, but then stop because transported last month was 0 again.

I understand what you did there and you are free to modify the script. I gave it a thought and I will not change it to moving average or to have a grace period, because it would almost remove its meaning. If you want to have the city growing, you have to provide regular service. If you achieve at least 1 ship per month, which should not be that difficult, the citizens will be happy with your service and the city will grow.

If you feel like the town is too small for that many ships, you can always increase the number for "Minimum size of town before the limit rules kicks in" parameter.

[speeder]

I did it that way because map is huge. If you add vehicles to transport everyone regularly, you hit the vehicle limits... (for example: one part of my map there was a route that took a year on each direction, thus only way to ensure 1 transportation per month would be build 24 vehicles... if you have 20 routes like that, you would need 480 vehicles, only 20 short of the 500 vehicle limit)

[a7m2]

Hi, I'm really loving the GS so far. Making sure the coverage is good and everything is smooth to transport enough mail and passengers to make a place grow is really fun!
I'm not sure how the cargo distribution works, though.

I've been supplying food to this city but for some reason it's always saying 43/0/0. Is there a specific place within the city I need to supply? I'm just dropping it off at the train station in the city - which accepts it.
Here's the other view in case it matters:

(I decreased the passenger and mail requirements to 55% while I learn how to play with this GS).

Edit:
It seems like the town nearby is stealing the food... I think.

I'm not supplying food to this town.


It's also quite far and it's not receiving the passengers from the same train station.

[Firrel]

Hi a7m2, I am glad you like the script.

I've been supplying food to this city but for some reason it's always saying 43/0/0. Is there a specific place within the city I need to supply? I'm just dropping it off at the train station in the city - which accepts it.

For FIRS 3, I put food and goods in Transformed industrial goods category to make it more interesting. So supplying food will not make it grow but for example livestock will. You can find the required cargo types for each category in the Story Book. Here is FIRS 3 Extreme as an example.

img4.PNG (22.01 KiB) Viewed 70741 times

For the town to receive the cargo that the town houses do not accept, like the livestock, you need to supply a factory that is close to that town and accepts the cargo type. That is why the other town receives some cargo in food category, it is supplied by a cargo from that category.

For more information on how the script works please read the supplied README file. You can find it on first post of this thread or in game where you select game scripts.

[a7m2]

Thanks that explains it! I did read the README but I must have missed it. My bad

[DrCplKlinger]

This is really good! I like the changes from older city growth scripts and am happy new forks of city growth are being maintained.

The only thing that's missing is the competitive mode that City Builder script had. With that, this would be perfect.

[Firrel]

This is really good! I like the changes from older city growth scripts and am happy new forks of city growth are being maintained.

The only thing that's missing is the competitive mode that City Builder script had. With that, this would be perfect.

This script is about building all cities on the map, not only one selected city as the city builders work. So the competitive style of city builder is not suitable for this script. This script is more suited for cooperative gameplay, you can set a goal for example to reach million population on a map and try to achieve it together.

If you have an idea on how to implement the competitive aspect, you are free to suggest it or fork it.

[d0mi3l]

When I build new city on map, GS stop work.

What about industry spawn? Could you adds it to your script. Like in Villages is Villages.