Asset Browser Mod Integration – Arma Reforger
Introduction
Basic rules for adding assets is explained on following page - Editor: Editable Entities: Configuration which covers most of the basic information. Due to that, this tutorial focuses more on creating new register and adding to list used by in game Editor.
Preparing structure
At minimum, to add new asset to in game editor you need to create a new register & copy EditorModeEdit prefab. Folder wise, only structure for new config needs to be prepared since Override in function is taking care of it
Creating new register file
Assuming that structure was already prepared, there are two ways how to create a new register config and both of them are described below
Creating new config
New register can be easily created by new config file. Procedure for it same as for any other configs:
- In Resource Browser menu either click with Right Mouse Button on empty Resource Browser field (1a) or use Create button (2) in bottom right section of Resource Browser.
- From the context menu, select Config file option
- Type in new config name, i.e. SampleMod_NewCar_Vehicles.conf
- From Choose a class window, select SCR_PlaceableEntitiesRegistry option.
Duplicating existing config
Alternative method involves duplicating one of the existing register configs located in Configs\Editor\PlaceableEntities. To do so, click on i.e. Vehicle.conf with Right Mouse Button and select option Duplicate to "name of addon" from context menu that appeared. After typing in new name and confirming it, new config file will be created in target addon, keeping structure of original file.
Adding new register file to Editor
Once register file is created, it's time to actually link it with in game editor. To do so, EditorModeEdit prefab has to be modified and Registries array in SCR_PlacingEditorComponent needs to be expanded.
Using Override in functionality
First step, will be creating modified copy of EditorModeEdit prefab. This can be easily accomplished using Override in functionality available in Resource Browser context menu. In principle, this operation is performed in two steps:
- Navigate to Prefabs/Editor/Modes folder and locate EditorModeEdit prefab
- Click with Right Mouse Button on that prefab and select Override in "name of addon" option
Workbench will recreate structure of original file with only difference being file system - that means that
- $ArmaReforger:Prefabs/Editor/Modes/EditorModeEdit.et
will be copied to
- $NameOfAddon:Prefabs/Editor/Modes/EditorModeEdit.et
Overridden assets can be easily distinguished by puzzle icon visible in Resource Browser.
Expanding Registries array
With EditorModeEdit prefab being present in addon, it is time to make modification to it. Goal is to add new element to Registeries array located in SCR_PlacingEditorComponent.
EditorModeEdit prefab located in the addon can be edited in a same way as any other addon - it is possible to either place it directly in World Editor and then start editing parameters or Edit prefab can be used in Resource Manager.
To use Edit prefab option, double click with Left Mouse Button on EditorModeEdit.et file located in addon. This should open t.hat prefab as a new tab in Resource Manger. Now only thing left to do is to click on Edit prefab button on the right side of the Resource Manager - this will open World Editor in special, prefab editing mode which slightly differs from regular worlds created by that editor.
Main difference is fact that when you try to save "world", it doesn't create any new world files - it just saves changes in prefabs.
To add new config to Registries array simple drag and drop config file from Resource Browser on top of Registries property. A new element will be added on the bottom of the array with link to config file located in Configs→ Editor → PlaceableEntities.
Now only remaining thing to do is saving those changes to the prefab - to do so, either click on Save Button or press Left Ctrl + S shortcut.
Registering assets
New register can be populated with new assets in two ways - manually by adding placeable prefabs to Prefabs array or via Register Placeable Entities plugin. First method might is easier to use, especially if addon doesn't have that many placeable entities. However, when dealing with larger amounts of prefabs (or larger projects in general) it is recommended to use plugin instead.
Manual method
Adding placeable entities to register by hand is quite simple.
Open config file containing register (in this case its SampleMod_NewCar_Vehicles.conf) as a new tab and then navigate in Resource Browser to a location where are placeable prefabs which you want to expose. Then, only thing left to do is simply drag & dropping those prefabs on Prefabs array.
Of course, elements in that array can also be manually added or removed via plus & minus signs on the right side of the Prefabs array
Using plugin
Basics of using Register Placeable Entities can be found on following page - Editor: Editable Entities: Configuration - RegisterPlaceablePrefabs.
When dealing with addons, it is mandatory to change Addon parameter so it matches addon ID you are working on - in this example it is SampleMod_NewCar. Below you can take a look at fully filled register config.
Testing result in-game
If everything went good, then all assets added to new register file should be visible in game
