- World Builder is a modding tool for Cyberpunk 2077, which is focused on allowing for additions to the game-world, in a native way that is as close as possible to the game.
- By default World Builder has access to all game-resources (E.g. Entities, Meshes, Decals, Sounds...), additionally any custom resources can be made available for spawning.
- World Builder's also allows for more "Meta" type additions, such as reflection probes, area nodes (E.g. for interior audio muffling), community nodes (NPC groups that can be configured based on time of day) and much more.
- World Builder tries to stay as close as possible to the way the engine handles the game world, thus each type of object (Mesh, entity, light, etc.) directly corresponds to a type of
worldNode
This tool is open source, is made during free time and contains experimental features. So yes, it may contain bugs. Use it at your own risk, and remember to make regular backups.
- A wide range of guides, explaining everything from installation, over basic usage, to specific features can be found on the modding Wiki:
- Open the world builder tool.
- Select the appropriate category (Such as entity, mesh, collision, deco).
- Select the specific type of object E.g. for the
Meshcategory you can select between normal mesh, rotating mesh, cloth mesh and dynamic mesh - Spawn the object using the interface.
- Group your objects in the interface,
Spawnedtab. - Save the group to a file. This will prepare the objects for export into an AXL mod.
- Hint: Each saved group will later correspond to one individual streamingsector
- See the Guide on the wiki
- Wiki Guide
- Generally, you can make any type of custom resource (Like material files for decals, or particle files) available by creating a
.txtfile in the correspondingentSpawner\\data\\spawnables\\...folder - In the following the exact steps for meshes and entities will be explained
- Navigate to the following directory:
entSpawner\\data\\spawnables\\entity\\templates - Create a new
.txtfile with your custom entity paths and save it in this folder.
- Navigate to the following directory:
entSpawner\\data\\spawnables\\mesh\\all - Create a new
.txtfile with your custom mesh paths and save it in this folder.
- Ensure you have the latest version of the tool, as well as the latest version of all the requirements
- In case of issues with the UI, deleting
Cyberpunk 2077\bin\x64\plugins\cyber_engine_tweaks\mods\entSpawner\data\config.jsonmight help - Custom entity or mesh is lacking appearances? Read up on cache exclusions
- For feature requests / questions and troubleshooting, either use:
- GitHub issues
- Ask on the Cyberpunk 2077 Modding Community discord server, in the
#world-editingchannel - DM
keanuwheezevia discord
- For troubleshooting, provide the following:
- What is not working
- What would you expect to happen
- When does the bug occur (Ideally step by step on how you can recreate the bug)
Cyberpunk 2077\bin\x64\plugins\cyber_engine_tweaks\mods\entSpawner\entSpawner.logfile- Build file, if bug is related to specifc build (Found in
Cyberpunk 2077\bin\x64\plugins\cyber_engine_tweaks\mods\entSpawner\data\objects) - Game version, tool version, requirements versions
- Any images or videos of the bug