Your Scenario Template Mod - Create Your Own Custom Scenario!

Discussion in 'Scenarios' started by Jack The Fox, Feb 9, 2025.

  1. Jack The Fox

    Jack The Fox
    Expand Collapse

    Joined:
    Jan 22, 2025
    Messages:
    22
    Description:
    Welcome to the Your Scenario Template Mod, a fully customizable scenario template for BeamNG.drive! This mod is designed to help players, both beginners and experienced modders, easily create and modify their own custom scenarios without starting from scratch. Note that this requires a ton of patience and time. It is very important to make sure the mod is unpacked when you make changes.

    Why Use This Template?
    This mod provides a pre-built foundation that includes the essential files and structure required for a working scenario in BeamNG.drive. Instead of figuring out the setup from scratch, you can simply edit the files to fit your own custom scenario ideas. Whether you want a race, time trial, stunt challenge, or even an AI pursuit, this template makes it easy to get started.

    Features of This Scenario Template:
    Pre-configured JSON file (your_scenario_name.json) – Defines all scenario settings, including vehicles, difficulty, and objectives.
    Prefab file (your_scenario_name.prefab) – Spawns the player's vehicle correctly at a set location and includes a waypoint as an example.
    Proper file structure – All folders and paths are already set up to work with BeamNG.drive.
    Easy-to-edit format – Just replace placeholder text with your own scenario name, description, and settings!
    Beginner-friendly – No advanced knowledge required.

    How to Modify and Use This Template
    1️⃣ Rename the Files
    First, rename the mod files to match your scenario's theme:

    • Rename the your_scenario_name.json file to your actual scenario name (e.g., crazy_race.json).
    • Rename the your_scenario_name.prefab file to match (e.g., crazy_race.prefab).
    • Update all file references inside the .json file to reflect the new name.
    2️⃣ Modify the Scenario JSON File
    The JSON file (your_scenario_name.json) defines the scenario settings. Open it in a text editor (such as Notepad++ or Visual Studio Code) and modify the following:

    • "name" – Replace "Your Scenario Name" with your actual scenario title.
    • "description" – Write a detailed description of your scenario so players know what to expect.
    • "vehicles" – Change the default "pickup" vehicle to any car you want by editing the "JBeam" name.
    • "prefabs" – Ensure the correct file path is used after renaming the prefab file.
    3️⃣ Modify the Prefab File
    The Prefab file (your_scenario_name.prefab) controls where the player vehicle spawns. Open it in a text editor and:

    • Find the JBeam = "pickup" line and change "pickup" to your desired vehicle (e.g., "sunburst").
    • Adjust the position and rotation values if needed to ensure the player spawns correctly.
    • If you want additional objects, AI vehicles, or obstacles, you can manually add them to this file.
    4️⃣ Replace the Preview Image
    The included your_scenario_name.jpg serves as a placeholder for the scenario’s thumbnail.

    • Replace this with your own custom 512x256px JPG image that represents your scenario.
    • Make sure the filename matches the "previews" value in the JSON file.
    5️⃣ Package and Install the Mod
    Once you've made your changes:

    1. Zip the levels folder into a .zip file (e.g., MyCustomScenario.zip).
    2. Move it to your BeamNG.drive mods folder:
      • Location: Documents/BeamNG.drive/mods/
    3. Start the game and check if your scenario appears in the Scenarios menu.
    Additional Customization Ideas
    Here are some ways to expand your scenario this would require some scripting knowledge:

    • Add AI Vehicles – Modify the prefab to include AI-controlled opponents or traffic.
    • Set Up Checkpoints – Define waypoints and laps for a race-style event.
    • Create Time Challenges – Adjust the JSON file to impose a time limit.
    • Add Props & Obstacles – Place barriers, ramps, cones, or roadblocks in the prefab.
    • If you want to have custom vehicle configurations – you can create a folder titled vehicles and then a folder titled the_vehicle_name and then have the pc file inside there.
    Final Notes
    This is my first mod, and I created it to help new modders easily set up and customize their own scenarios in BeamNG.drive. If you find this helpful, feel free to modify and share your own creations using this template! Please note that this is for version 0.34 and might be outdated in the future, but I will try to keep this updated. If you want advanced scenario logic you can add a lua file, just put it inside the scenarios folder this would require some basic scripting knowledge. If you are using this in something like a YouTube video or you are going to publish a mod using this please give credit to me Jack The Fox.

    If you have any questions, feedback, or need help troubleshooting, feel free to reach out to the BeamNG.drive modding community!

    Happy modding, and enjoy creating your own custom scenarios! Download the zip file and then get started with making your scenario! If you do not know how to get coordinates in game click on the area in the world editor that you want to get the coordinates for and then in the Inspector menu you can see the rotation scale and position for the object if you do not know how to open the world editor, you can open it with F11 on a windows computer and if you don't know how to get the inspector menu in the world editor you go to "Window" and then "Inspector" and it will open the inspector menu.
     

    Attached Files:

    #1 Jack The Fox, Feb 9, 2025
    Last edited: Feb 9, 2025
    • Like Like x 1
  2. jamessimo

    jamessimo
    Expand Collapse

    Joined:
    Nov 28, 2018
    Messages:
    105
    Hi, I wanted to ask if you know about the Mission Editor and if you used that or wrote the JSON yourself?
     
  3. Jack The Fox

    Jack The Fox
    Expand Collapse

    Joined:
    Jan 22, 2025
    Messages:
    22
    I just recently learned about the mission editor but for this mod I wrote the JSON file myself.
     
  1. This site uses cookies to help personalise content, tailor your experience and to keep you logged in if you register.
    By continuing to use this site, you are consenting to our use of cookies.
    Dismiss Notice