Modding Guidelines

Modding Guidelines

From BeamNG
Language: English

Please read this guidelines carefully before uploading your resource to the repository and check if your content respects this rules.

General guidelines

These are the general guidelines and pertain to every kind of mod.


  • Your mod must work without the need of any additional step, just by dragging and dropping the zip into the mods folder or by clicking the install button.
  • You are not allowed to use copyrighted content in your mods.
  • You have to be the author of the mod and/or have permission if you want to use content from another user.
  • You must not overwrite any default game data. This is also valid for parts within jbeam files, mesh names within .dae files or objects within your materials.cs files.
  • You have to use unique zip filenames for your mods to prevent problems with other mods. Using your username as a filename extension is a good solution for that (e.g. "pickupengine_username").
  • In general, use unique file/part names to prevent overwriting original game files or other modders content - this will also prohibit that your files will be overwritten one day.
  • Do not include unused files in your mod. Do not include readme files - use the overview instead. Reduce your file size to a minimum.
  • The mod has to respect the correct folder structure and therefore should work by simply dropping it into the mods folder.
  • Your mod must not contain inappropriate content.
  • Please describe your mod in the overview and include at least two images of your mod (of course just for those which are taking advantage of adding pictures). If necessary please also add a brief 'how to use your mod'.
  • Merely use the 'Upload Images' button to upload your pictures.
  • Mod filenames are allowed to contain the following characters: A-Z, a-z, 0-9, -, _ (do not add a version number as a file name extension)
  • Do not upload multiple simple mods - please summarize them in a decent way. Try to balance the amount of mods and the file size.
  • Check beforehand if your mod is dropping error messages in the console.
  • Please do not copy a whole map/car to simply add a single detail. To not have a simply increased file size, try to add your modification to existing content.


Additional guidelines

Guidelines for special kinds of a mod.


  • Configuration Mods:
    • A configuration mod must contain at least 3 files : info_uniquename.json, uniquename.pc and uniquename.png (at 400px x 192px)


  • Skins:
    • The skin textures and materials.cs file must be in a subfolder.
    • Use the correct file format for your textures -> Exporting Textures - DDS Files
    • Give a unique name to your skin for the subfolder and on "Global Skin" to prevent issue and conflict with other mods.


Check this link to see how to upload mods.





Mod Update

These are the main guidelines for mods update on the repository.


  • Use the blue "Post resource update" button on your mods page to update your mod
871af9f062faa53e2831da66d5bbbfe7.png
  • Use the exact same zip filename to update your mod, this facilitates updating your mod for other users
  • Increment your mod version (e.g.:0.1 to 0.2)

Version string guidelines.png

  • Summarize the changes you made in your update

Mod guideline update list.png