Harmony Custom Generator 0.2.0

Custom Generator allows you to generate semi-custom maps on default Rust generator.

For support, report issues, suggest functions - join our discord!

- Features -

QoL (Quality of Life)

• Skip Asset Warmup on start

Map Settings

• Generate map over default limits
• Generate new map every time
• Save map in specific folder
• Save map with specific name

Generator

• Try to generate Road Ring on any map
• Enable/Disable roadside monuments
• Enable/Disable roadside objects
• Try to generate Rail Ring on any map
• Enable/Disable railside monuments
• Enable/Disable railside objects
• Remove car wrecks near roads
• Remove rivers
• Remove tunnel entrances
• Configure tier percentages (Tier0, Tier1, Tier2)
• Configure biome percentages (Arid, Temperate, Tundra, Arctic)
• Generate unique environment (oasis, canyons, lakes)

Monuments

• [WIP] Full monument placement configuration
• Configure distances between monuments
• Configure specific monument counts
• Monument placement filters (biome, splat, topology)

Map Image Generator

• Generate splat/height map
• Generate monument names
• Generate map grid

Additional Features

• Monument Swapping
  Replace vanilla monuments with custom ones
  Swap specific monument types (e.g., replace Outpost with custom version)
  Keep original monument positions and connections
  Save both map versions (with and without swaps)
• Russian and English language support in configuration

- Installation and Usage -
= Installation =

1. Make sure your server have Harmony 2.3 installed (default installed)
2. Copy the generator dll file to the HarmonyMods/CustomGenerator.dll
3. Configure settings in HarmonyConfig/CustomGenerator.json
   Logs will be available in HarmonyConfig/logs
   Generated map images in mapimages/

= Map Generation =

1. Run the server with the installed generator at least once
2. Configure desired parameters in the configuration file HarmonyConfig/CustomGenerator.json
3. Run the server again
4. The generated map will be saved in the <server root>/maps/ folder or default folder with the chosen name

= Monument Swapping =

Monument Swapping allows you to replace vanilla monuments with custom ones while maintaining the original map layout and connections.

This feature enables:

1. Direct replacement of vanilla monuments with custom versions
2. Preservation of original monument positions and road/rail connections
3. Multiple monument replacements in a single generation
4. Automatic generation of two map versions (with and without custom monuments)

Custom Monument Preparation

1. Enable "Swap Monuments" => "Enabled": true
2. Place your custom monument prefabs in the maps/prefabs folder
   - Prefab requirements:
   File format: .map (see examples in the CustomPrefabs folder on github)
   Name format: monument_original_path.prefab (example: fishing_village_c.prefab)
   Monument size must match the original
   Proper terrain alignment in the prefab