Mod Project Setup – Arma Reforger
Line 109: | Line 109: | ||
{{GameCategory|armaR|Modding|Tutorials}} | {{GameCategory|armaR|Modding|Tutorials}} | ||
=== Arma Reforger Workbench loads without selected mod === | |||
Make sure that all dependencies of your mod are visible in the Workbench project list. This also includes dependencies of dependencies! | |||
Usually you will find following error in '''Log Console'''<enforce> | |||
INIT : Workbench startup | |||
INIT : Workbench Init Engine | |||
ENGINE (E): Addon 'SampleMod' dependency '5614E48126E3ADF2' can't be added | |||
</enforce> | |||
This means, that addon ''5614E48126E3ADF2'' was not found and due to that, '''SampleMod''' cannot be loaded. Workbench will still launch but it will skip all mods which couldn't be loaded and quite often only ArmaReforger addon will be loaded. To find name of that name, you can for instance try to find it on workshop, by adding GUID to the end of link https://reforger.armaplatform.com/workshop/ (f.e. https://reforger.armaplatform.com/workshop/5614E48126E3ADF2 ). If this is a local mod, then search for that specific GUID in local addons that you have created. | |||
Instruction how to add mod to Enfusion Workbench Launcher project list can be [[Arma Reforger:Mod Project Setup#Adding Other Existing Projects|found above]]. | |||
===== Empty dependency ===== | |||
In some cases, you might end up with dependency with empty dependency (<nowiki>''</nowiki>) which most likely was done by trying to remove dependency in incorrect way.<enforce> | |||
INIT : Workbench startup | |||
INIT : Workbench Init Engine | |||
ENGINE (E): Addon 'SampleMod' dependency '' can't be added | |||
</enforce> | |||
In such scenario it might be necessary to open mentioned mod .gproj file in text editor (like notepad) and manually remove <nowiki>''</nowiki> dependency from '''Dependencies''' array. |
Latest revision as of 10:08, 30 July 2024
Prerequisites
- Arma Reforger installed
- Workbench installed
Workbench Launcher Setup
Before creating a new project, it is necessary to set Enfusion Workbench Launcher so it knows where Reforger data is located. Reforger data is essential for Workbench to function correctly so its important
There are two ways how to prepare Workbench for creation of the addon - automatic & manual - which are described below
Preparing Data
By default, every time Arma Reforger (game) is launched, executable will automatically add hidden link to the data ArmaReforger.gproj in Windows Register.
It might happen though, that automatic detection is not working (f.e. installation dir was moved) and because of that, it is recommended to manually add ArmaReforger.gproj to Project list
Adding Arma Reforger Project
- Start the Workbench either through Steam (Tools > Arma Reforger Tools > START) or by double-clicking ArmaReforgerWorkbenchSteam.exe located in the Workbench installation directory.
The following screen will appear: - Click "Add Existing" button
- Browse to ArmaReforger.gproj (located in <Arma Reforger installation directory>\addons\data\ArmaReforger.gproj) and select it
- Arma Reforger project is now listed in the Projects window.
Adding Other Existing Projects
Other projects, like dependencies, can be added one by one via Add Existing Project as described above or by using Scan for Projects button.
- Click on + Add Project button
- Select Scan for Projects from the list
- Select folder where you have addons located, which you want to use as dependencies
- Confirm selection
Now you can either try to launch one of those mods or use them as dependencies
Project Creation
- Open Enfusion Workbench Launcher if you don't have it already open.
This interface displays existing projects known to Workbench and will later display the current creation; an existing project is openable by selecting it and clicking Open to edit it. - Click "Create New" to open the project creation interface
- Enter the project's name
- the project's name can only contain letters, numbers, spaces and the following symbols: - (dash) _ (underscore) and . (dot).
- Confirm or edit the project's location
- Pick the project's dependencies:
- dependencies are other projects (and/or mods) on which the current project relies to work
- a project cannot be loaded if a dependency is missing
- the dependency link is one-way: a dependency does not need the current project in order to be loaded
- Arma Reforger is a default dependency: an Arma Reforger mod needs Arma Reforger data to run properly
- Click "OK" to create the project.
Et voilà ! The project is created and the Workbench Resource Manager is waiting for input.
Managing Projects
Launching Project
When launching Enfusion Workbench Launcher second and after projects were added to the list, launching of mods can be done in following ways:
- By double clicking with
on mod (either tile or element in list view)
- By clicking on it with with
and selecting option "Open" (1) from context menu
With Mods
Launching your project with other addons, which are not dependencies, can be done via Open with Addons (2 on picture above) option which is available in context menu visible after pressing on mod in list with . After selecting this option, a new menu - Open project with additional addons (similar to one, used for setting dependencies) - will show up and you will be able to select your dependencies.
Presets
List of additionally launched mods in Open project with additional addons menu is saved and restored when using this option. Additionally, selections of those addons is stored in Presets, which you can use to switch between specific mod sets. Presets are shared for all addons listed in Enfusion Workbench Launcher.
You can select one of the 8 presets by clicking on Preset x list box in top right corner of the window.
Removing Projects
Projects can be removed by Enfusion Project List by clicking on them with and then selecting Remove from List option. This will remove project only from the list and data itself will remain intact.
Projects View
It is possible to switch between List & Grid view. To do so, click on cog icon in top right corner and select one of the views from the context menu.
Experimental Branch
It is also possible to create and publish projects using Experimental Branch of the tools. For more info, head out to Experimental Branch page.
Troubleshooting
Arma Reforger project is not found in the Projects window
- You need to add Arma Reforger game project (not your project!) to the list. See instructions listed in Adding Arma Reforger Project section
Arma Reforger Workbench loads without selected mod
Make sure that all dependencies of your mod are visible in the Workbench project list. This also includes dependencies of dependencies!
Usually you will find following error in Log Console
This means, that addon 5614E48126E3ADF2 was not found and due to that, SampleMod cannot be loaded. Workbench will still launch but it will skip all mods which couldn't be loaded and quite often only ArmaReforger addon will be loaded. To find name of that name, you can for instance try to find it on workshop, by adding GUID to the end of link https://reforger.armaplatform.com/workshop/ (f.e. https://reforger.armaplatform.com/workshop/5614E48126E3ADF2 ). If this is a local mod, then search for that specific GUID in local addons that you have created.
Instruction how to add mod to Enfusion Workbench Launcher project list can be found above.
Empty dependency
In some cases, you might end up with dependency with empty dependency ('') which most likely was done by trying to remove dependency in incorrect way.
In such scenario it might be necessary to open mentioned mod .gproj file in text editor (like notepad) and manually remove '' dependency from Dependencies array.