Adding Locations and Structures with ArchiveXL

This guide demonstrates how to add new locations to the world by creating new .streamingsector files and adding them to the game world by merging them with the all.streamingblock via ArchiveXL

Valid as of March 21 2023



Adding a custom location to a new streaming sector and merging it with the game world

  • After following the previous guide to add and position the objects you want to add to the game, open the example mod project in Wolvenkit and open the file new_mod_sector.streamingsector

  • in the "Node Data" section, right click on the existing node and click "Import from JSON (no coords update)

    • This will open a window which allows you to browse to the export folder of Object Spawner. this will be something like Cyberpunk 2077\bin\x64\plugins\cyber_engine_tweaks\mods\entSpawner\export You will find a JSON file named after the main group you created and exported in this folder folder

    • Select that file and Wolvenkit will create the necessary nodes, in the streaming sector, adding them to the location you selected.

    • Delete the node which was included as an example and update the index of your node to 0 if it is not already.

    • Rename the file to something unique for your mod.

    • Open the new_mod.streamingblock file in the project

    • Under the "descriptors" tab, edit the 1st entry so that the depot path points to your .streamingsector file

    • Now you need to set the streaming box for your new sector. The easiest way to figure this out is to just take the coordinates from a central object in your mod (you can find these in your .streamingsector file on each node) and add 300 units to each number for the max, subtract 300 for the min. This will need to be adjusted based on how far away you want your objects to be visible in the world.

    • rename this streamingblock file to something unique to your mod

    • Now all that's left is to edit the .xl file included in the resources section of the example so that it points to your streamingblock file. All you need to do is replace "mod\new_mod.streamingblock" with the relative path to your streamingblock.

    Once you've done the above steps, install your new mod and launch the game, if you've completed all the steps, your new objects, structure or location will spawn just like the rest of the world

  • If you run into any troubles, double check the guides and then pop over to #world-editing on the cyberpunk discord server

Last updated