First run and generation

🇷🇺 Русская версия

With the launcher: pick a size and a seed on the Generate tab and press Save & generate. The first run creates HarmonyConfig/CustomGenerator.json with the default settings: change them in the editor and generate again. Every run is a new map.

By hand:

1. Start the server with the +server.worldsize and +server.seed you want:

   RustDedicated.exe -batchmode -nographics +server.identity gen +server.worldsize 4000 +server.seed 12345 +server.level "Procedural Map"

2. The mod creates HarmonyConfig/CustomGenerator.json, generates a map with the default settings and shuts the server down.
3. Edit the config and start the server again. Every run generates a new map.

The map is saved to maps/CustomGenerator<size>_<seed>.map, the preview to mapimages/, and the generation report to maps/CustomGenerator<size>_<seed>.report.txt.

A 4000 map takes about 5–10 minutes to generate, plus about a minute to render the preview.

Size and seed aren't in the mod config: they're set on the Generate tab of the launcher, or as server launch parameters by hand.

Mod folder outside the server (-cgen.workspace)

By hand, the mod keeps its files (config, logs, maps, previews, your monuments) in the server folder. To keep them in another folder, as the launcher does, add -cgen.workspace <folder>:

RustDedicated.exe -batchmode -nographics -cgen.workspace "D:\CustomGenerator" +server.identity gen +server.worldsize 4000 +server.seed 12345 +server.level "Procedural Map"

• HarmonyMods/CustomGenerator.dll still has to be in the server's HarmonyMods: only the files go to the other folder.
• The folder must exist. If it doesn't, the log shows -cgen.workspace folder not found and the files go to the server folder.
• The launcher adds this parameter by itself, you don't need it there.

Generation report

At the end of every run the mod prints a summary to the log and saves it next to the map as <map name>.report.txt:

===== CustomGenerator report =====
Map:   C:\rust\maps\CustomGenerator2000_4242.map
Image: C:\rust\mapimages\CustomGenerator2000_4242.png
Size:  2000, seed 4242
Time:  3m 46s since server start

Monuments:
  Mountains             0
  Harbors               3  ferry_terminal_1, harbor_1, harbor_2
  Fishing Villages      3  fishing_village_a, fishing_village_c, fishing_village_b
  Desert Military       1  desert_military_base_c
  Main Monuments        5  bandit_town, mining_quarry_b, sphere_tank, radtown_small_3, mining_quarry_c
  Tunnel Entrances      1  entrance_bunker_c
  Road Monuments        0
  Caves                 2  cave_small_medium, cave_small_easy
  Underwater Labs       1  underwater_lab_c
  Lighthouses           2  lighthouse x2

Custom monuments:
  Cobalt Bunker      3/3
  Jungle Refinery    3/3

Swap:
  fishing_village_c.prefab.map    1 replaced
  gas_station_1.prefab.map        0 replaced  no such monument on the map
  nothing_here.prefab.map         0 replaced  no such monument on the map
  Saved to C:\rust\maps\CustomGenerator2000_4242.swapped.map

Warnings: 3, errors: 0 - see C:\rust\HarmonyConfig\logs\cgen_2026-09-27_01-35-08.log
==================================

• Monuments: what each generation step placed, with prefab names. 2/5 means 2 of the 5 set in the config; the target is shown only when it's exact (TargetCount with IgnoreWorldSizeMultiplier: true).
• Custom monuments and Swap appear when they're enabled, with the reason when something wasn't placed or replaced.
• Warnings / errors: if there are any, look them up in the log file named on that line.