WIP Beta released BeamNG Tool for map creators (updated 2025-03-29)

Willfa · Apr 22, 2025

AlexKidd71 said: ↑

Latest Update: Version 1.1.7 (2025-01-17)

Download: https://github.com/alexkleinwaechter/BeamNG_LevelCleanUp

"Even if you don't want to use any functionality of that tool it makes really sense to go to the Map Shrinker and start analyzing your level. A lot of stuff is logged and helps you to make your map better!"

Hi map builders,
I created a tool that shrinks the deployment file for a map level, renames a map or copy assets between maps.

The idea of the map shrinker is that a map developer can leave the development project as is although there are tons of copied assets from other maps or colladas for testing.

The Tool also helps you finding errors in your map project like corrupted json or xml files and wrong paths in your material files. If the tool wants to delete a file you need then read the generated logfiles.

Extreme Example:
East Coast Reworked | v2.5
The tool shrinks out almost 4.7 GB of uncompressed data
Zipsize before: 3.1 GB
Zipsize after: 1.1 GB

The tool checks the used assets by scanning the info.json, missiongroups, prefabs, forest, decals, terrain.json. Then it scans all available managed materials by materials.json, materials.cs and reads all available dae files, scenarios, races. All not used assests are deleted from the managed assets. Corrupted json files are repaired for reading and a warning log is written, so that you can repair syntax and duplicate keys. Duplicate materials are written to a logfile.

In a last step all (unmanaged) files are checked against the used assets and deleted if not used.

but there is more…

Feature Description:

Map Shrinker
You can load a zipped map and let the tool search for orphaned files and assets which are not needed in the map. This can save a lot of space. All files and configurations will be checked against your scene tree with all of its dependencies and a proposal for file deletion is shown. Please check the list. It is always possible that the tool deletes too much. So always use a copy of your project! This tool is made for deleting things The good thing: You still have all your crap in the project and can use it for further ideas while having a lean deployment file.

Rename Map
You can load a zipped map and then change the name in the file system. This is important if you want to see this map beside the original one. If you customized the industrial level for example and want to have your own customized level beside industrial, you could rename it with industrial_larry You can change the shown name in the map overview, too. After renaming you can build a new zipfile with the tool and you are ready to go.

Copy Assets (Experimental)
You can load a zipped map you want to copy assets from and a zipped map you want to have the assets. At the moment the tool allows to copy decalroads, decals and collada assets (dae files). You get a list of all the assets and can select the ones you want to copy. No need anymore for copying the whole folders from the desired maps. The tool copies only the needed materials and places them in a dedicated folder per assettype starting with a "MT_" for Mapping-tools.

This functionality is not well tested yet. Therefore the experimantal state. Very old maps with a lot of cs files are likely not working with this functionality.

Convert TSStatic Assets to forest items
You can load a zipped map and then convert your static assets placed in the scene tree to forest items. After selecting a level your scene tree is shown in the tool to select the items or folders you want to convert. Only assets with an identical scale on all axis and an existing rotation matrix will be converted.
During the process the tool asks if you want to delete the assets out of the scene tree. If you don't delete them you will have duplicate assets. One in the tree and one in the forest items. This only makes sense to check if the tool does it right
A discussion if it generally makes sense to convert static assets to forest items can be found here: https://www.beamng.com/threads/converting-placed-meshes-to-forest-items.86837

Utilities -> move the whole map
You can change x, y, z-axis position values for all objects at once by entering offset values in this tool. Experimental. I hope I got all the objects.

Before you start
It's a good idea to copy the maps you want to work with to a dedicated folder. The tool does a lot of unzipping, zipping and logfiles. You don't want to have that in your vanilla maps folder

Troubleshooting
If you get the error: System.IO.FileNotFoundException: Cannot locate the file, you need to install the Microsoft WebView2 Runtime. The tool needs the Microsoft WebView2 Runtime to run properly. Its already installed on Windows 11 and newer versions of Windows 10.
You can Download and install the Runtime from this Website:
https://developer.microsoft.com/en-us/microsoft-edge/webview2/
Direct link to the installer:
https://go.microsoft.com/fwlink/p/?LinkId=2124703

Have fun!
Alex

Tutorial video:

Best! Alex

Version 1.1.9 (2025-03-29)
- Changed behaviour of copy assets selection. Selection is now retained when using search filter. Fix vulnerability of imagesharp library
Version 1.1.8 (2025-03-21)
- Feature: Experimental You can now change the position (x, y, z-axis) of the whole map. All objects within the missiongroups, decals and the forest are affected. TSStatic and Prefab Items without position property now get one in order to be moved correctly.
Version 1.1.7 (2025-01-17)
- Fix: handling of Persistent ID if not a valid guid
- Fix: paths which are not starting with "levels" are now not renamed anymore. Sky Gradients would not be found then in some levels.
- Feature: Experimental You can change the height position (z-axis) of the whole map. All objects within the missiongroups and the forest are affected.
Version 1.1.2 (2024-06-02)
- Copy Assets: You can now choose a folder for your target map (makes the process quicker)
- Fix: Update Imagesharp dependency because of vulnerabilty
Version 1.1.0 (2024-02-25)
- Fix: sometimes needed cubemaps have been deleted which causes BeamNG to crash. repaired now.
- Fix error resolving texture files with missing file extension
Version 1.0.8 (2024-01-06)
- Check if material files linked to vanilla map files exist in vanilla map (MaterialFilesNotFound.txt)
Version 1.0.7 (2024-01-06)
- Parse json with two commas (empty property) -> west_coast_usa\facilities\dealerships.facilities.json
- Write dedicated logfiles for errors and warnings
- Vanilla level selector in mapshrinker (for easier testing on my side)
Version 1.0.6 (2023-12-01)
- Small Bugfix: Rename Map. Delete mod_info folder to prevent duplicate mod error.
Version 1.0.5 (2023-11-26)
- Small Bugfix: Don't delete source zip files when tidy up working folder on application close
Version 1.0.4 (2023-10-13)
- Scanning of facilities
- Scanning of Minimap in info.json
- Exclude files like depthmap and heightmap from root
- Repair of corrupted jsonfiles or jsonfiles with duplicate keys
- Seperate logging of warnings which help you to repair your jsonfiles.
- optional Cleanup of working directory when closing the Application.
Version 1.0.0 (2023-10-12)
Delete duplicate materials from material.json files
Version 0.9.8 (2023-10-08)
Show Asset Counter in Convert to ForestItems
Version 0.9.7 (2023-10-07)
Convert Scene Tree Assets to ForestItems
Version 0.9.6 (2023-10-02)
Copy and rename vanilla map in on go and some bugfixes.
Version 0.9.5 (2023-04-16)
App uses full width for content now.
Version 0.9.4 (2023-04-16)
App handles duplicate property keys in json and json comments now, asset copy now copies assets linked to third vanilla levels even if image extension differs, UI is more responsive now.
Version 0.9.3 (2023-04-15)
Bugfix: Some processes didn't stop after quitting the app, Use same level for renaming if copied or shrinked before renaming instead of unzipping it again
Version 0.9.2 (2023-04-01)
Added check if material name is not set. Use internal name instead (Discovered in Polish Roads)
Version 0.9.1 (2023-04-01)
copy assets lets you select vanilla levels from the game install folder and copies it
Version 0.9.0 (2023-03-29)
new UI Interface, Experimental feature for copying assets from one map to another
Version 0.8.9 (2022-12-14):
Adjustments for BeamNG 0.27, Decal and forest scanner now scans json files and cs files
Version 0.8.8 (2022-11-21):
Scan Prefab files nested in prefab files (Discovered in Westcoast USA)
Version 0.8.7 (2022-11-21):
AutoUpdater added, compression level for zipfile generation added, discard water ripple and foam files

Click to expand...

If I make a build of this that is compatible with ubuntu, can I send it over?

AlexKidd71 · May 2, 2025 at 1:57 PM

Willfa said: ↑

If I make a build of this that is compatible with ubuntu, can I send it over?
Click to expand...

Hi! Sorry for the late answer. I was on holiday. I can check if it can be deployed for Linux. But there are some things to consider. I make use of windows web view. I don’t know if there is a simple solution to exchange it. Then I pretty sure have to change code for all path related parts. At the moment I expect windows paths.
If the changes are going to be big I stay with windows only. If you did some research already I’m happy if you share it with me.
Best!
Alex
--- Post updated ---

BadmanTru 2 said: ↑

Hello! as of .35 everything works expect it doesn't bring textures over when copying assetts, it does the material just not the texture.
Click to expand...

Thanks! I will check it soon.

BadmanTru 2 · May 2, 2025 at 2:53 PM

Thanks alex

Willfa · May 2, 2025 at 6:08 PM

AlexKidd71 said: ↑

Hi! Sorry for the late answer. I was on holiday. I can check if it can be deployed for Linux. But there are some things to consider. I make use of windows web view. I don’t know if there is a simple solution to exchange it. Then I pretty sure have to change code for all path related parts. At the moment I expect windows paths.
If the changes are going to be big I stay with windows only. If you did some research already I’m happy if you share it with me.
Best!
Alex
--- Post updated ---

Thanks! I will check it soon.
Click to expand...

For the issue with paths, you could have a system where it scans system files for the dedicated folder. Or maybe have a settings system. I could try check its wine compatibility. I assume this is open source?

Forums

Mods

WIP Beta released BeamNG Tool for map creators (updated 2025-03-29)

Willfa
Expand Collapse

AlexKidd71
Expand Collapse

BadmanTru 2
Expand Collapse

Willfa
Expand Collapse

Useful Searches

WIP Beta released BeamNG Tool for map creators (updated 2025-03-29)

Willfa Expand Collapse

AlexKidd71 Expand Collapse

BadmanTru 2 Expand Collapse

Willfa Expand Collapse

Willfa
Expand Collapse

AlexKidd71
Expand Collapse

BadmanTru 2
Expand Collapse

Willfa
Expand Collapse