Reyhard/Sandbox – User

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{TOC|side}}
* [[Arma Reforger:2D Map Creation|2D Map Creation]]
= Goals of this tutorial =
* [[Arma Reforger:AI Debug Panel Tutorial|AI Debug Panel Tutorial]]
 
* [[Arma Reforger:Action Context Setup|Action Context Setup]]
In this tutorial you will learn about:
* [[Arma Reforger:Animation Editor|Animation Editor]]
 
* [[Arma Reforger:Animation Editor: Buffer Node Tutorial|Animation Editor: Buffer Node Tutorial]]
* How to prepare prop in FBX format for Enfusion
* [[Arma Reforger:Animation Editor: Character Action Commands|Animation Editor: Character Action Commands]]
* How to import FBX into Workbench
* [[Arma Reforger:Animation Editor: Custom Properties|Animation Editor: Custom Properties]]
* How to configure new prop in Workbench
* [[Arma Reforger:Animation Editor: Human Variables|Animation Editor: Human Variables]]
* How to add procedural animation with sound & custom action to prop prefab
* [[Arma Reforger:Animation Editor: Live Debug Tutorial|Animation Editor: Live Debug Tutorial]]
 
* [[Arma Reforger:Animation Editor: Nodes|Animation Editor: Nodes]]
{{Feature|informative|If you '''don't have any experience with Workbench''' yet, it is recommended to '''go through [[Arma_Reforger:Weapon_Modding|modded weapon tutorial]]''' to familiarize with some of the concepts present in the '''Workbench'''}}
* [[Arma Reforger:Animation Editor: Pose 2D Node Tutorial|Animation Editor: Pose 2D Node Tutorial]]
{{Messagebox|Sources files for this tutorial can be found on
* [[Arma Reforger:Animation Editor: State Machine|Animation Editor: State Machine]]
[https://github.com/BohemiaInteractive/Arma-Reforger-Samples/tree/main/SampleMod_NewProp '''Arma Reforger Samples Github repository''']|📥|orange}}
* [[Arma Reforger:Animation Editor: Sync Tutorial|Animation Editor: Sync Tutorial]]
 
* [[Arma Reforger:Animation Editor: Templates and Instances Tutorial|Animation Editor: Templates and Instances Tutorial]]
=== Setting skeleton & rigging mesh ===
* [[Arma Reforger:Animation Editor: Vehicle Action Commands|Animation Editor: Vehicle Action Commands]]
 
* [[Arma Reforger:Animation Export Profiles|Animation Export Profiles]]
This asset has six drawers which can be animated. In order to make those drawers animated, it is necessary to add proper skeleton to the model and then skin those movable selections to newly created bones.
* [[Arma Reforger:Animation Instances Reference Table|Animation Instances Reference Table]]
 
* [[Arma Reforger:Arland|Arland]]
[[Image:armareforger-new-prop-blender-add-bone.png|left]]
* [[Arma Reforger:Armavision|Armavision]]
 
* [[Arma Reforger:Asset Browser Mod Integration|Asset Browser Mod Integration]]
In Blender, new armature can be easily created by adding new '''Single Bone''' in ''Add → Armature '' menu when in '''Object Mode'''. This new bone can be called '''root''' and it will be serving as main bone of this skeleton.
* [[Arma Reforger:Assets|Assets]]
 
* [[Arma Reforger:Audio: Building Doors|Audio: Building Doors]]
Similar to sockets, orientation of bones is quite important for animation. Unlike in RV engine, animations are '''no longer using two vertices to create axis of transformation''' but instead '''rotation & position of bone''' is used to determine origin of animation.
* [[Arma Reforger:Audio: Collision|Audio: Collision]]
 
* [[Arma Reforger:Audio: Multiphase Destruction|Audio: Multiphase Destruction]]
Once root '''bone''' was created, it is possible to add bone for each of the drawers like on picture below.
* [[Arma Reforger:Audio: Occlusion|Audio: Occlusion]]
{{Clear}}
* [[Arma Reforger:Audio: Radio Broadcast Manager|Audio: Radio Broadcast Manager]]
 
* [[Arma Reforger:Audio: SCR SoundManagerEntity|Audio: SCR SoundManagerEntity]]
[[Image:armareforger-new-prop-blender-full-skeleton.png]]
* [[Arma Reforger:Audio: Sound Components|Audio: Sound Components]]
 
* [[Arma Reforger:Audio: Sound Events|Audio: Sound Events]]
=== Colliders & material names ===
* [[Arma Reforger:Audio: Tree Destruction|Audio: Tree Destruction]]
 
* [[Arma Reforger:Audio: Vehicle Damage|Audio: Vehicle Damage]]
[[Image:armareforger-new-prop-blender-scene-colection.png|right]]
* [[Arma Reforger:Audio: Voice over Network|Audio: Voice over Network]]
Colliders are special type of objects which are used to calculate various kinds of collisions - be it physic simulation or tracing of bullet penetration. There are few rules regarding those colliders and most of them listed on [[Arma_Reforger:FBX_Import#Collider_usage|'''collider related segment of FBX Import page''']].
* [[Arma Reforger:Audio Editor|Audio Editor]]
 
* [[Arma Reforger:Audio Editor: Audio Variables|Audio Editor: Audio Variables]]
When importing asset from previous Arma game - like in this example - you are most likely going to have already convex components ready from '''Geometry''', '''Fire Geometry''', '''View Geometry''' or '''Geometry Physx''' LODs. If you are using [[Arma_Reforger:Enfusion_Blender_Tools:_P3D_Conversion|P3D importer]] which is part of [[Arma_Reforger:Enfusion_Blender_Tools|Enfusion Blender Tools]], then those components will be automatically converted to trimesh colliders ( ''UTM_ prefix''). Since trimesh colliders are not recommended for general collision, it might be wise to verify if object can be converted to trimesh.
* [[Arma Reforger:Audio Editor: DSP Nodes|Audio Editor: DSP Nodes]]
 
* [[Arma Reforger:Audio Editor: Directivity|Audio Editor: Directivity]]
If you are using Blender, there is small handy tool to assist you with assigning correct game materials & layer presets on colliders - more details about can be found on [[Arma_Reforger:Enfusion_Blender_Tools:_Objects_Tools]].
* [[Arma Reforger:Audio Editor: Getting Started Tutorial|Audio Editor: Getting Started Tutorial]]
 
* [[Arma Reforger:Audio Editor: Nodes|Audio Editor: Nodes]]
In this sample, rugged desk uses simple box mesh, so usage of '''UBX_ prefix is recommended'''.
* [[Arma Reforger:Audio Editor: Signal Editor|Audio Editor: Signal Editor]]
 
* [[Arma Reforger:Audio Editor: Signal Editor: Nodes|Audio Editor: Signal Editor: Nodes]]
Next thing when it comes to configuration of colliders is '''configuration of Layer Preset'''. This is done through '''usage''' custom property (''details about adding that property can be found on following [[Arma_Reforger:FBX_Import#Setting_Layer_Preset_on_colliders_.28usage_parameter.29|'''FBX Import page''']]). For simple prop like this one, layer preset should be set to '''PropFireView'''. If you have multiple colliders, you have to add that property to each of them!
* [[Arma Reforger:Behavior Editor|Behavior Editor]]
 
* [[Arma Reforger:Behavior Editor: Nodes|Behavior Editor: Nodes]]
After layer preset is set, it is time for setting [[Arma_Reforger:FBX_Import#Physical_material_.28Game_material.29|'''Game Material''']]. This is done by assigning to collider a material with specific name and again, details of naming are described on FBX Import page. For this example prop, '''Plastic_6mm''' game materials is used, since it is assumed that single wall is 3mm thick and due to to geometry is a simple box, those walls are counted twice.
* [[Arma Reforger:Capture & Hold Setup|Capture & Hold Setup]]
 
* [[Arma Reforger:Car Creation|Car Creation]]
Below is screen showing [[Arma_Reforger:Enfusion_Blender_Tools:_Objects_Tools#Colliders_.26_Layer_Presets_setup|'''Game Materials''' & '''Layer Presets''' selection menu]] from '''Enfusion Blender Tools'''. Using this simple tool it is possible to easily select desired game material and layer preset, which will be automatically. Please note that before using that feature it is necessary to [[Arma_Reforger:Enfusion_Blender_Tools:_Objects_Tools#Automatic_sorting_of_objects|sort objects]] and [[Arma_Reforger:Enfusion_Blender_Tools#Installation|setup plugin]] correctly.
* [[Arma Reforger:Car Creation/Asset Preparation|Car Creation/Asset Preparation]]
 
* [[Arma Reforger:Car Creation/Prefab Configuration|Car Creation/Prefab Configuration]]
[[Image:armareforger-new-prop-blender-game-materials.png]]
* [[Arma Reforger:Car Creation/Simulation Configuration|Car Creation/Simulation Configuration]]
 
* [[Arma Reforger:Car Modding|Car Modding]]
 
* [[Arma Reforger:Character Gear Creation|Character Gear Creation]]
{{Clear}}
* [[Arma Reforger:Character Gear Creation/Headgear|Character Gear Creation/Headgear]]
== FBX export settings ==
* [[Arma Reforger:Character Gear Creation/Headgear/Asset Preparation|Character Gear Creation/Headgear/Asset Preparation]]
 
* [[Arma Reforger:Character Gear Creation/Headgear/Prefab Configuration|Character Gear Creation/Headgear/Prefab Configuration]]
Most of the general rules can be found on [[Arma_Reforger:FBX_Import#FBX_Export|'''FBX Import page''']] . In principle, when exporting from i.e. 3DS Max, you have to make sure that you are exporting in '''binary format in version 2014/2015'''. Furthermore, '''Triangulation''' & '''Preserve Edge Orientation should be turned off.'''
* [[Arma Reforger:Character Gear Creation/Vest|Character Gear Creation/Vest]]
 
* [[Arma Reforger:Character Gear Creation/Vest/Asset Preparation|Character Gear Creation/Vest/Asset Preparation]]
'''Blender''' wise, there are 3 most important things to keep in mind when exporting FBX
* [[Arma Reforger:Character Gear Creation/Vest/Prefab Configuration|Character Gear Creation/Vest/Prefab Configuration]]
{| class="wikitable"
* [[Arma Reforger:Character SoundInfo Signals Reference|Character SoundInfo Signals Reference]]
| '''1. Object Types''':
* [[Arma Reforger:Class Template Example|Class Template Example]]
For animated object like this prop, you need to have '''checked on''' at least:
* [[Arma Reforger:Collision Layer|Collision Layer]]
 
* [[Arma Reforger:Commanding Menu Modding|Commanding Menu Modding]]
'''Empty -''' handles all snap points
* [[Arma Reforger:Conflict|Conflict]]
 
* [[Arma Reforger:Crash Report|Crash Report]]
'''Armature''' '''-''' exports skeleton of your weapon
* [[Arma Reforger:Create a Component|Create a Component]]
 
* [[Arma Reforger:Create a Config Class|Create a Config Class]]
'''Mesh -''' self explanatory
* [[Arma Reforger:Create an Entity|Create an Entity]]
| rowspan="3" | [[Image:armareforger-new-weapon-export-blender2.png|200px]]
* [[Arma Reforger:Damage Effects|Damage Effects]]
|-
* [[Arma Reforger:Damage System|Damage System]]
| '''2. Custom Properties''':
* [[Arma Reforger:Data Modding Basics|Data Modding Basics]]
Without this option all custom properties like '''LayerPresets''' would be lost!
* [[Arma Reforger:Development Executables|Development Executables]]
|-
* [[Arma Reforger:Diag Menu|Diag Menu]]
| '''3. Leaf bones''':
* [[Arma Reforger:Dialog Configuration Tutorial|Dialog Configuration Tutorial]]
Leaf bones are completely unnecessary in Enfusion and it's better to have that option '''turned off'''
* [[Arma Reforger:Dictionary|Dictionary]]
|}
* [[Arma Reforger:Directory Structure|Directory Structure]]
 
* [[Arma Reforger:Editor Entity Naming Conventions|Editor Entity Naming Conventions]]
 
* [[Arma Reforger:End Screen Creation|End Screen Creation]]
== Preparing textures ==
* [[Arma Reforger:Enfusion Blender Tools|Enfusion Blender Tools]]
 
* [[Arma Reforger:Enfusion Blender Tools: Batch FBX Export|Enfusion Blender Tools: Batch FBX Export]]
When importing textures of weapon from previous Real Virtuality games like Arma 3 there is no real automated or simple method of conversion spec-gloss textures to PBR (''Physicial Based Rendering'') Metal Rough ones - current industry standard. Therefore in most cases it's much easier to do textures from scratch in i.e. Substance Painter.
* [[Arma Reforger:Enfusion Blender Tools: Import/Export ASC Elevation|Enfusion Blender Tools: Import/Export ASC Elevation]]
 
* [[Arma Reforger:Enfusion Blender Tools: Import/Export Animation|Enfusion Blender Tools: Import/Export Animation]]
There are tons of materials on the internet how to create proper PBR texture and it's highly recommend to search for it via some popular search engines. More information about maps and textures used by Reforger can be found on [[Arma_Reforger:Textures]] page
* [[Arma Reforger:Enfusion Blender Tools: MLOD Baking Tutorial|Enfusion Blender Tools: MLOD Baking Tutorial]]
 
* [[Arma Reforger:Enfusion Blender Tools: Materials Library|Enfusion Blender Tools: Materials Library]]
For this asset, assuming that Substance Painter is used, it is recommended to use one of the shared export profiles - Arma Reforger - BCR + NMO, which should create textures compatible with Reforger.
* [[Arma Reforger:Enfusion Blender Tools: Materials Preview|Enfusion Blender Tools: Materials Preview]]
 
* [[Arma Reforger:Enfusion Blender Tools: Model Quality Assurance|Enfusion Blender Tools: Model Quality Assurance]]
 
* [[Arma Reforger:Enfusion Blender Tools: NLA Strips Baking Tool|Enfusion Blender Tools: NLA Strips Baking Tool]]
== Importing & registering new model ==
* [[Arma Reforger:Enfusion Blender Tools: Objects Tools|Enfusion Blender Tools: Objects Tools]]
 
* [[Arma Reforger:Enfusion Blender Tools: P3D Conversion|Enfusion Blender Tools: P3D Conversion]]
Importing and registering of new model is quite simple and this involves following steps:
* [[Arma Reforger:Enfusion Blender Tools: Portal Tools|Enfusion Blender Tools: Portal Tools]]
 
* [[Arma Reforger:Enfusion Blender Tools: Rig Updater|Enfusion Blender Tools: Rig Updater]]
* Locating FBX file that you wish to convert in '''Resource Browser'''
* [[Arma Reforger:Enfusion Blender Tools: Skeleton Updater|Enfusion Blender Tools: Skeleton Updater]]
* Clicking on that FBX with RMB and then selecting "'''Register and Import'''" option from the context menu
* [[Arma Reforger:Entity Activeness|Entity Activeness]]
* From pop up menu with title '''Register Resource (File(s)''', select  "'''as Model'''" option
* [[Arma Reforger:Entity Catalog|Entity Catalog]]
 
* [[Arma Reforger:Entity Lifecycle|Entity Lifecycle]]
After that, conversion of FBX into XOB will begin and depending on complexity of the model it might take some time. In case of that simple prop.
* [[Arma Reforger:Environment Metrics|Environment Metrics]]
 
* [[Arma Reforger:Event Handlers|Event Handlers]]
Once model is imported, a '''new XOB''' should appear in '''Resource Browser -''' this file can be now opened in new '''Resource Manager''' tab for '''preview''' and '''game related parameters tweaking''' by double clicking with {{Controls|LMB}} on it.
* [[Arma Reforger:Everon|Everon]]
 
* [[Arma Reforger:Experimental Branch|Experimental Branch]]
[[Image:armareforger-new-prop-register-fbx.gif]]
* [[Arma Reforger:FBX Import|FBX Import]]
 
* [[Arma Reforger:Faction Creation|Faction Creation]]
{{Feature|warning|While Workbench still supports relative paths for materials, this method is discouraged and should not be used.}}
* [[Arma Reforger:Field Manual|Field Manual]]
 
* [[Arma Reforger:Field Manual Modding|Field Manual Modding]]
{{Feature|important|Both Layer Preset and Game Material can be changed in Import Settings window, although it is recommended to have that stored in model itself. Otherwise you might loose your data if colliders are changed (by f.e. renaming of objects).}}
* [[Arma Reforger:File Types|File Types]]
 
* [[Arma Reforger:Floaters Finder Plugin|Floaters Finder Plugin]]
 
* [[Arma Reforger:From Arma 3 Tools to Workbench|From Arma 3 Tools to Workbench]]
While Workbench still supports relative paths for materials, this method is discouraged and should not be used.
* [[Arma Reforger:From SQF to Enforce Script|From SQF to Enforce Script]]
 
* [[Arma Reforger:Game Identity|Game Identity]]
=== Import settings ===
* [[Arma Reforger:Game Master|Game Master]]
 
* [[Arma Reforger:Game Master: Composition Configuration Tutorial|Game Master: Composition Configuration Tutorial]]
If everything went fine, main '''Resource Manager''' window should look like that:
* [[Arma Reforger:Game Master: Context Action Creation|Game Master: Context Action Creation]]
 
* [[Arma Reforger:Game Master: Editable Entities Configuration|Game Master: Editable Entities Configuration]]
[[Image:armareforger-new-prop-imported-model-xob.png]]
* [[Arma Reforger:Game Master: Entity Property Creation|Game Master: Entity Property Creation]]
 
* [[Arma Reforger:Game Master: Entity Tooltip Creation|Game Master: Entity Tooltip Creation]]
On the right side of the viewport, there is a panel where you can select between two tabs:
* [[Arma Reforger:Game Master: Image Generation Tutorial|Game Master: Image Generation Tutorial]]
 
* [[Arma Reforger:Game Master: Toolbar Action Creation|Game Master: Toolbar Action Creation]]
* [[Arma_Reforger:Resource_Manager:_Model_Editor#Details_Tab|'''Details''']] - shows various statistics (i.e. vertex, face or face count) and informations about  materials, colliders, skeleton or LODs present in the imported model. This tab is by '''default selected''' when opening new model.
* [[Arma Reforger:Game Master Tutorial|Game Master Tutorial]]
* [[Arma_Reforger:Resource_Manager:_Model_Editor#Import_Settings_Tab|'''Import Settings''']] - in this tab it is possible to modify how FBX is imported to the game and it is possible to modify '''transformation, materials, physics or other misc parameters''' here.
* [[Arma Reforger:General Game Mode Setup|General Game Mode Setup]]
 
* [[Arma Reforger:Getting Started|Getting Started]]
After briefly checking if model has correct number of [[Arma_Reforger:Resource_Manager:_Model_Editor#LODs|LOD (''levels of details'')]] and it looks visually fine, it's time to move to '''Import Settings''' tab, where there are couple important things to set.
* [[Arma Reforger:Hint Usage|Hint Usage]]
 
* [[Arma Reforger:Input Manager|Input Manager]]
=== Physics setup ===
* [[Arma Reforger:JsonApiStruct Usage|JsonApiStruct Usage]]
 
* [[Arma Reforger:Known Issues|Known Issues]]
After initial import was done it's time to make sure that materials & colliders are using proper materials & colliders.  If it fails to find such texture, new dummy material (see area marked in orange on screen below) will be created in '''data''' folder next to the FBX model.
* [[Arma Reforger:Layout Creation|Layout Creation]]
 
* [[Arma Reforger:Level Of Detail|Level Of Detail]]
If everything was setup correctly in Blender, imported model should already have one collider imported with correctly assigned '''Layer Preset''' ''(PropFireView)'' and '''Surface Properties''' (''plastic_3mm.gamemat''). Otherwise, here is the list of some common issues:
* [[Arma Reforger:Mod Localisation|Mod Localisation]]
 
* [[Arma Reforger:Mod Project Setup|Mod Project Setup]]
==== Geometry Params list is empty ====
* [[Arma Reforger:Mod Publishing Process|Mod Publishing Process]]
If both '''Colliders''' array in '''Details''' and '''Geometry Params''' array in '''Import Settings''' are empty, check for following errors:
* [[Arma Reforger:Modular Button Component Tutorial|Modular Button Component Tutorial]]
 
* [[Arma Reforger:Multiplayer Scripting|Multiplayer Scripting]]
# Check if objects which are supposed to be colliders have '''correct prefix''' - i.e. UBX, UCX, etc. See [[Arma_Reforger:FBX_Import#Collider_shape|FBX Import]] page for more information
* [[Arma Reforger:Navmesh Tutorial|Navmesh Tutorial]]
# Check '''Console Log''' if there are no errors regarding convexity or shape of the collider. See [[Arma_Reforger:FBX_Import#Collider_shape|FBX Import]] page for more information
* [[Arma Reforger:New Terrain Setup|New Terrain Setup]]
 
* [[Arma Reforger:Notification Creation|Notification Creation]]
==== Wrong Game Material ====
* [[Arma Reforger:Object Oriented Programming Advanced Usage|Object Oriented Programming Advanced Usage]]
If impact effect on the asset are using default dirt impact effects or following error appears in console
* [[Arma Reforger:Object Oriented Programming Basics|Object Oriented Programming Basics]]
<syntaxhighlight lang="erlang">
* [[Arma Reforger:Particle Editor|Particle Editor]]
RESOURCES : GetResourceObject @"{411A617924FC3D61}Assets/Props/Military/Camps/PortableDesk_01/PortableDesk_01.xob"
* [[Arma Reforger:Prefab Data|Prefab Data]]
RESOURCES (E): Wrong&patched resource GUID in @"Assets/Props/Military/Camps/PortableDesk_01/PortableDesk_01.xob" for property UBX_Component01 resource name @"Plastic_6m.gamemat"
* [[Arma Reforger:Prefabs Basics|Prefabs Basics]]
RESOURCES : GetResourceObject @"{D4D49F200A5937E1}Plastic_6m.gamemat"
* [[Arma Reforger:Procedural Animation Editor|Procedural Animation Editor]]
RESOURCES (E): Failed to open
* [[Arma Reforger:Procedural Animation Editor: Nodes|Procedural Animation Editor: Nodes]]
</syntaxhighlight>
* [[Arma Reforger:Procedural Animation Editor Basics Tutorial|Procedural Animation Editor Basics Tutorial]]
then check for following errors:
* [[Arma Reforger:Prop Creation|Prop Creation]]
 
* [[Arma Reforger:REST API Usage|REST API Usage]]
# Make sure in 3D software of your choice that material assigned to collider is correctly named, i.e. ''Plastic_6mm_6A7CBD6BBCFC5148 - see [[Arma_Reforger:FBX_Import#Physical_material_.28Game_material.29|Game Material section of FBX Import page]].''
* [[Arma Reforger:Resource Manager|Resource Manager]]
 
* [[Arma Reforger:Resource Manager: Batch Resource Processor Plugin|Resource Manager: Batch Resource Processor Plugin]]
{{Feature|warning|Keep in mind that '''changes to materials or layer presets in FBX''' are only imported if '''Geometry Params list is empty'''. See [[Arma_Reforger:FBX_Import#Physical_material_.28Game_material.29|'''FBX Import - Game Materials''']] pagefor more information}}
* [[Arma Reforger:Resource Manager: Batch Texture Processor Plugin|Resource Manager: Batch Texture Processor Plugin]]
 
* [[Arma Reforger:Resource Manager: Config Editor|Resource Manager: Config Editor]]
==== Wrong Layer Preset ====
* [[Arma Reforger:Resource Manager: Find Linked Resources Plugin|Resource Manager: Find Linked Resources Plugin]]
If you see warning triangle '''Colliders''' section of '''Details''' tab or ''All interaction layers used'' error, then check for following things:
* [[Arma Reforger:Resource Manager: Generate Class From Layout Plugin|Resource Manager: Generate Class From Layout Plugin]]
 
* [[Arma Reforger:Resource Manager: Getting Started Tutorial|Resource Manager: Getting Started Tutorial]]
# Make sure that collider has correct Layer Preset assigned
* [[Arma Reforger:Resource Manager: Imageset Editor|Resource Manager: Imageset Editor]]
# Make sure that '''Custom Properties''' option is checked in FBX export settings
* [[Arma Reforger:Resource Manager: Layout Editor|Resource Manager: Layout Editor]]
 
* [[Arma Reforger:Resource Manager: Material Editor|Resource Manager: Material Editor]]
[[Image:armareforger-new-weapon-collider-errors.png]]
* [[Arma Reforger:Resource Manager: Model Editor|Resource Manager: Model Editor]]
 
* [[Arma Reforger:Resource Manager: Options|Resource Manager: Options]]
==== Changing parameters ====
* [[Arma Reforger:Resource Manager: Resave Plugins|Resource Manager: Resave Plugins]]
If for some reason you don't want to touch FBX and want to change Layer Preset or assigned game materials in Workbench itself, then it is possible to do that by manipulating '''Layer Preset & Surface Properties''' parameters in '''Physics''' section of '''Import Settings''' tab. Changes to those parameters require usage of '''Reimport resource''' button - otherwise information stored in XOB would not be updated. This method is '''not recommended though.'''
* [[Arma Reforger:Resource Manager: Texture Editor|Resource Manager: Texture Editor]]
 
* [[Arma Reforger:Resource Manager Plugin|Resource Manager Plugin]]
[[Image:armareforger-new-prop-import-change-params.gif]]
* [[Arma Reforger:Resource Usage|Resource Usage]]
 
* [[Arma Reforger:Respawn Setup|Respawn Setup]]
=== Skeleton & Hierarchy ===
* [[Arma Reforger:RichText Format|RichText Format]]
 
* [[Arma Reforger:Roadmap|Roadmap]]
In case of models with skeleton (''Armature)'' it is quite important to check '''Export''' '''Skinning''' option in '''Miscellaneous''' section of '''Import Settings.'''
* [[Arma Reforger:Scenario Framework|Scenario Framework]]
 
* [[Arma Reforger:Scenario Framework Setup Tutorial|Scenario Framework Setup Tutorial]]
Since Rugged Desk is supposed to have six animated drawers, it is important to '''enable''' that option and then '''reimport''' the model via '''Reimport resource (PC)''' button.
* [[Arma Reforger:Scenario Framework Update Plugin|Scenario Framework Update Plugin]]
 
* [[Arma Reforger:ScriptInvoker Usage|ScriptInvoker Usage]]
[[Image:armareforger-new-prop-export-skinning.png]]
* [[Arma Reforger:Script Editor|Script Editor]]
 
* [[Arma Reforger:Script Editor: Basic Code Formatter Plugin|Script Editor: Basic Code Formatter Plugin]]
If skeleton was imported correctly'''''', '''Details tab''' in right section of the Resource Manger view port should show some '''non zero number''' in [[Arma_Reforger:Resource_Manager:_Model_Editor#Bones|'''Bones section''']]. In case of '''Rugged Desk''', this object should have '''6''' '''skinned bones, 4 sockets''' and '''one dummy hierarchy element (root), which should be visible as Bones (6 + 5)'''. First number in the bracket indicates number of skinned bones and 2nd one indicates of empty bones (''either bones which are not skinned to anything or empty objects'')
* [[Arma Reforger:Script Editor: Class Renaming Plugin|Script Editor: Class Renaming Plugin]]
 
* [[Arma Reforger:Script Editor: Create New Script Plugin|Script Editor: Create New Script Plugin]]
[[Image:armareforger-new-prop-skeleton-full-imported.png]]
* [[Arma Reforger:Script Editor: Doxygen Filler Plugin|Script Editor: Doxygen Filler Plugin]]
 
* [[Arma Reforger:Script Editor: Fill From Template Plugin|Script Editor: Fill From Template Plugin]]
For Rugged Desk '''wing''' & '''lid''' it is possible to just use '''Export Scene Hierarchy''' - this should allow to use empty objects created before for snapping purposes.
* [[Arma Reforger:Script Editor: SVN Plugins|Script Editor: SVN Plugins]]
 
* [[Arma Reforger:Script Editor Plugin|Script Editor Plugin]]
== Importing textures ==
* [[Arma Reforger:Script Profiling|Script Profiling]]
 
* [[Arma Reforger:Scripting: Automatic Reference Counting|Scripting: Automatic Reference Counting]]
By default, '''Workbench''' importer will create '''new materials''' (emats) using '''MatPBRBasic''' shader in '''Data''' folder next to the imported model, based on material names located in FBX. If material suitable for the mesh already exist somewhere in available projects, it is possible to change linked material by changing elements in [[Arma_Reforger:Resource_Manager:_Model_Editor#Material_Assigns|'''Material Assigns''']] located in '''Visual''' section of [[Arma_Reforger:Resource_Manager:_Model_Editor#Import_Settings_Tab|'''Import Settings -''']] this option will be later used for '''Portable Desk''' lid & wing, which share same materials.
* [[Arma Reforger:Scripting: Best Practices|Scripting: Best Practices]]
 
* [[Arma Reforger:Scripting: Config Object|Scripting: Config Object]]
Once those materials are ready, you can use same procedures as the ones described on Sample Modded Weapon - Documentation - Creating New Materials page.
* [[Arma Reforger:Scripting: Conventions|Scripting: Conventions]]
 
* [[Arma Reforger:Scripting: Do's and Don'ts|Scripting: Do's and Don'ts]]
= Adding basic configuration =
* [[Arma Reforger:Scripting: JSON|Scripting: JSON]]
 
* [[Arma Reforger:Scripting: Keywords|Scripting: Keywords]]
{{Messagebox|'''Overview'''
* [[Arma Reforger:Scripting: Operators|Scripting: Operators]]
Following topics will be covered in this paragraph
* [[Arma Reforger:Scripting: Performance|Scripting: Performance]]
 
* [[Arma Reforger:Scripting: Preprocessor Directives|Scripting: Preprocessor Directives]]
* Creating prefab
* [[Arma Reforger:Scripting: Preprocessor Macros|Scripting: Preprocessor Macros]]
* Basic asset configuration|💬|#CDF}}
* [[Arma Reforger:Scripting: Values|Scripting: Values]]
 
* [[Arma Reforger:Scripting Conf File Usage|Scripting Conf File Usage]]
== Creating prefab ==
* [[Arma Reforger:Scripting Example|Scripting Example]]
 
* [[Arma Reforger:Scripting Modding|Scripting Modding]]
Prefabs for props can be prepared in multiple ways and it also depends on amount of functions that are planned to be added to such asset.
* [[Arma Reforger:Scripting Temporary Feature|Scripting Temporary Feature]]
 
* [[Arma Reforger:Serialisation|Serialisation]]
In general, it is recommend to use one of those two prefabs as a base:
* [[Arma Reforger:Server Config|Server Config]]
 
* [[Arma Reforger:Server Hosting|Server Hosting]]
* [enfusion://ResourceManager/~ArmaReforger:Prefabs/Props/Core/Props_Base.et|'''Props_Base.et'''] - prefab for simple, '''non destructible''' assets
* [[Arma Reforger:Server Management|Server Management]]
* [enfusion://ResourceManager/~ArmaReforger:Prefabs/Props/Core/Destructible_Props_Base.et|'''Destructible_Props_Base.et'''] - prefab dedicated for assets which '''can be destroyed'''
* [[Arma Reforger:Snap And Orient Entities To Terrain Plugin|Snap And Orient Entities To Terrain Plugin]]
 
* [[Arma Reforger:Startup Parameters|Startup Parameters]]
Since this sample is planned to have destruction, [enfusion://ResourceManager/~ArmaReforger:Prefabs/Props/Core/Destructible_Props_Base.et|'''Destructible_Props_Base.et'''] prefab can be used as a base.
* [[Arma Reforger:String Editor|String Editor]]
 
* [[Arma Reforger:String Editor Plugin|String Editor Plugin]]
{{Feature|informative|In this article, [[Arma_Reforger:Resource_Manager:_Options#Register_.22enfusion:.2F.2F.22_protocol|'''Enfusion links''']] are used. With those links it is possible to open specific resource just by simply clicking on that link. Enfusion links '''has to be manually activated in Workbench options''' (Workbench -> Options -> Workbench -> Register "enfusion://" protocol) before it can be used]}}
* [[Arma Reforger:Systems|Systems]]
 
* [[Arma Reforger:Terrain: Terrain Entity|Terrain: Terrain Entity]]
In general, it is possible to create new inherited prefab in two ways:
* [[Arma Reforger:Textures|Textures]]
* [[Arma_Reforger:Prefabs_Basics#Drag_and_drop_method|By dropping parent prefab in World Editor and drag and dropping that entity into Resource Browser field]]
* [[Arma Reforger:Update History|Update History]]
* By using [[Arma_Reforger:Data_Modding_Basics#Using_.22Inherit_Prefab_in_Addon.22_function|'''Inherit Prefab in Addon''']] on prefab selected in '''Resource Browser''' attached to '''World Editor'''
* [[Arma Reforger:Vehicle: Wheeled Simulation|Vehicle: Wheeled Simulation]]
 
* [[Arma Reforger:Video Settings|Video Settings]]
No matter what method was picked, it is recommended to create base prefab for props, which might have some variants. In this tutorial '''Portable Desk''' have 3 texture variants prepared, so such base class will be more than welcome.
* [[Arma Reforger:Weapon Animation|Weapon Animation]]
 
* [[Arma Reforger:Weapon Animation/Advanced Tutorial|Weapon Animation/Advanced Tutorial]]
In this case, new prefab, which inherits from [enfusion://ResourceManager/~ArmaReforger:Prefabs/Props/Core/Destructible_Props_Base.et|'''Destructible_Props_Base.et'''] , should be called '''PortableDesk_01_Base.et'''
* [[Arma Reforger:Weapon Animation/Basic Tutorial|Weapon Animation/Basic Tutorial]]
 
* [[Arma Reforger:Weapon Animation/Setup|Weapon Animation/Setup]]
Final step in initial configuration  will be assigning previously imported mesh. This can be done by simply assigning '''Rugged Desk XOB''' into '''Object''' property of '''MeshObject''' component in '''PortableDesk_01_Base.et''' prefab.
* [[Arma Reforger:Weapon Collimator Creation|Weapon Collimator Creation]]
 
* [[Arma Reforger:Weapon Components|Weapon Components]]
[[Image:armareforger-new-prop-desk-prefab.png]]
* [[Arma Reforger:Weapon Creation|Weapon Creation]]
 
* [[Arma Reforger:Weapon Creation/Asset Preparation|Weapon Creation/Asset Preparation]]
If change was applied to '''MeshObject''' component of '''prefab instance''', don't forget to press '''Apply to prefab''' button and then save currently loaded world!
* [[Arma Reforger:Weapon Creation/Prefab Configuration|Weapon Creation/Prefab Configuration]]
 
* [[Arma Reforger:Weapon Modding|Weapon Modding]]
'''Creating texture variants'''
* [[Arma Reforger:Weapon Optic Creation|Weapon Optic Creation]]
 
* [[Arma Reforger:Weapon Slots And Bones|Weapon Slots And Bones]]
[[Image:armareforger-new-prop-prefab-material-assign.png|right]]
* [[Arma Reforger:Weapon Stats-Modifing Attachments|Weapon Stats-Modifing Attachments]]
Since this assets is supposed to have three color variants, new prefab variants have to be prepared
* [[Arma Reforger:Weapon Suppressor Creation|Weapon Suppressor Creation]]
 
* [[Arma Reforger:Widget Tooltip Setup|Widget Tooltip Setup]]
# Create new prefabs, inheriting from '''PortableDesk_01_Base.et''',  either via '''World Editor''' viewport '''drag and drop''' method or via '''Inherit Prefab''' action available in '''Resource Browser''' attached to '''World Editor'''
* [[Arma Reforger:Workbench Links|Workbench Links]]
# Once new prefabs are created, open them and one by one, change assigned materials in '''Materials''' array inside '''MeshObject''' component to appropriate material created before.
* [[Arma Reforger:Workbench Metadata|Workbench Metadata]]
# '''Apply changes to the prefabs''' if changes were applied to entity instance, otherwise (''if hierarchy tree was used'') this step can be skipped
* [[Arma Reforger:Workbench Plugin|Workbench Plugin]]
# '''Permanently save changes''' to the prefabs by either '''saving current world''' or, if in '''prefab edit mode''', '''save the prefab''' directly.
* [[Arma Reforger:Workbench Plugin Tutorial|Workbench Plugin Tutorial]]
 
* [[Arma Reforger:Workshop|Workshop]]
In the end, following files should be present in next to the '''PortableDesk_01_Base.et'''
* [[Arma Reforger:WorldEditorAPI Usage|WorldEditorAPI Usage]]
 
* [[Arma Reforger:World Editor|World Editor]]
* '''PortableDesk_01_Black.et'''
* [[Arma Reforger:World Editor: Forest Generator|World Editor: Forest Generator]]
* '''PortableDesk_01_Olive.et'''
* [[Arma Reforger:World Editor: Ground Manipulation Tool|World Editor: Ground Manipulation Tool]]
* '''PortableDesk_01_Sand.et'''
* [[Arma Reforger:World Editor: Lake Generator|World Editor: Lake Generator]]
{{Clear}}
* [[Arma Reforger:World Editor: Navmesh Tool|World Editor: Navmesh Tool]]
 
* [[Arma Reforger:World Editor: Navmesh Tool Tutorial|World Editor: Navmesh Tool Tutorial]]
 
* [[Arma Reforger:World Editor: Object Brush Scripted Tool|World Editor: Object Brush Scripted Tool]]
== Creating prefabs for smaller parts ==
* [[Arma Reforger:World Editor: Power Line Generator|World Editor: Power Line Generator]]
 
* [[Arma Reforger:World Editor: Powerline Generator Tutorial|World Editor: Powerline Generator Tutorial]]
[[Image:armareforger-new-prop-prefab-variants-list.png|right]]
* [[Arma Reforger:World Editor: Prefab Generator|World Editor: Prefab Generator]]
Procedure described above should be also applied to '''lid''' and '''wing prefabs''' so they have base prefab (inheriting from [enfusion://ResourceManager/~ArmaReforger:Prefabs/Props/Core/Destructible_Props_Base.et|'''Destructible_Props_Base.et'''] ) and color variants. Those prefabs should be really simple at this stage so '''MeshObject''' and '''RigidBody''' components which they inheriting from [enfusion://ResourceManager/~ArmaReforger:Prefabs/Props/Core/Destructible_Props_Base.et|'''Destructible_Props_Base'''] should be enough.
* [[Arma Reforger:World Editor: Prefab Management Tool|World Editor: Prefab Management Tool]]
 
* [[Arma Reforger:World Editor: River Generator|World Editor: River Generator]]
In the end, following set of prefabs should be created
* [[Arma Reforger:World Editor: Road Generator|World Editor: Road Generator]]
 
* [[Arma Reforger:World Editor: Rotate Tool|World Editor: Rotate Tool]]
* '''PortableDesk_01_wing_base.et'''
* [[Arma Reforger:World Editor: Terrain Creation Tool|World Editor: Terrain Creation Tool]]
** '''PortableDesk_01_wing_Black.et'''
* [[Arma Reforger:World Editor: Terrain Preparation Tutorial|World Editor: Terrain Preparation Tutorial]]
** '''PortableDesk_01_wing_Olive.et'''
* [[Arma Reforger:World Editor: Vector Tool|World Editor: Vector Tool]]
** '''PortableDesk_01_wing_Sand.et'''
* [[Arma Reforger:World Editor: Wall Generator|World Editor: Wall Generator]]
* '''PortableDesk_01_lid_base.et'''
* [[Arma Reforger:World Editor Plugin|World Editor Plugin]]
** '''PortableDesk_01_lid_Black.et'''
* [[Arma Reforger:World Editor Tool|World Editor Tool]]
** '''PortableDesk_01_lid_Olive.et'''
** '''PortableDesk_01_lid_Sand.et'''
 
 
{{Clear}}
== Creating prop variants ==
 
In order to create a variant of Portable Rugged Desk with for instance both wings and lids attached, it is possible to utilize '''SlotManagerComponent''' to attach additional elements. Before going any further though, it is recommend to start with creating a new base prefab - '''PortableDesk_01_Base_Full.et''' - which will serve as a base asset  with all additions attached. Since the core of the desk remains the same, this new base prefab should inherit from '''PortableDesk_01_Base.et'''
 
Once base prefab is there, follow below steps to :
 
* Add new '''SlotManagerComponent''' via '''[[Arma_Reforger:Prefabs_Basics#Adding_new_components_to_entity_instance|+ Add Component]]''' button
* Select '''SlotManagerComponent''' and add new element to '''Slots''' array by clicking on plus sign on the right side of that property
** Select '''EntitySlotInfo''' from the list that appeared
** Type new name of that slot. For instance slot for wing can be called '''Wing_L'''
** In '''Wing_L''' element, locate '''Pivot ID''' property and select '''socket_wing_01''' from the list
** In '''Child Pivot ID''' type name of the snap point which is located in the mesh - in this case it is called '''snap_wing'''
** In '''Prefab''' property, assign prefab which you want to use - in this case it will be '''PortableDesk_01_Base_Wing.et'''
 
This procedure should be repeated for the rest of the slots - '''Wing_R, Lid_1''' & '''Lid2'''. In case the prefabs from the slots are incorrectly attached, please make sure that orientation of sockets and snap points is correct. Otherwise, the new '''PortableDesk_01_Base_Full.et''' should look like that:
 
[[Image:armareforger-new-prop-prefab-slot-manager.png]]
 
Beside using '''SlotManagerComponent''', it is also possible to utilize hierarchy. This is especially useful when you for instance want to create a mini composition out of prefab, like add a telephone, some notebooks or ashtrays to it. After adding '''Hierarchy''' component to both parent and children prefab, it is even possible to utilize '''Pivot ID''' to snap prefabs to desired place. There is no way to define '''Child Pivot ID''' using that method though and thats why '''SlotManagerComponent''' was used here.
 
Principles of adding entity to prefab are described on [[Arma_Reforger:Prefabs_Basics#Adding_entities_to_prefab|Prefabs Basics page]]
 
[[Image:armareforger-new-prop-prefab-add-hierarchy.gif]]
 
 
= Adding procedural animation =
 
{{Messagebox|'''Overview'''
Following topics will be covered in this paragraph
 
* Creating basic procedural animation
* Applying animation to the asset|💬|#CDF}}
 
{{Feature|informative|Before proceeding further it is recommend to make yourself familiar with [[Arma_Reforger:Procedural_Animation_Editor|Procedural Animation Editor documentation]] & [[Arma_Reforger:Procedural_Animation_Editor_Basics_Tutorial|Procedural Animation Editor tutorial]].}}
 
== Creating new procedural animation project ==
 
[[Image:armareforger-new-prop-procedural-animation-new-project.png]]
[[Image:armareforger-new-prop-procedural-animation-create-project.png|left]]
First step in creation of new procedural animation project would be launching of '''Procedural Animation Editor'''. After that, new project can be created by navigating to '''File → New → Project..'''. ( ''alternatively, {{Controls|Ctrl|Shift|N}} shortcut can be used'') in order to create new '''Procedural Animation Project'''. '''Procedural Animation Project''' is quite similar in purpose to animation definitions in '''Real Virtuality''' '''Model Config''' but with '''much better signal processing''' ''(more about it next chapter)''.
 
Once that step is completed, a new pop up window will appear asking for save location. In '''Arma Reforger''', asset specific procedural animations are stored next to the model somewhere in inside '''Asset''' folder structure. Common animations, like turrets or wheel animations which are used by multiple vehicles, are located in '''Anims/Proc''' folder.
 
Here, situation is quite simplified and '''Rugged Desk''' animations are assumed to be specific to this asset and are placed in '''Assets/Props/Military/Camps/PortableDesk_01/Anims/''' folder.
 
 
{{Clear}}
== Creating new procedural animation signal ==
 
Once new '''Procedural Animation Project''' is created, it is possible to populate it with actual data. First step towards this goal would be creating new '''signal'''. To differentiate it from '''Audio Editor''' signals, '''Procedural Animation Editor signals have .siga''' extension.
 
Signals are quite essential part of procedural animation since they are controlling how signals from scripted or engine events are processed. For those familiar with '''Real Virtuality Engine''', '''signals''' are somewhat similar in their purpose to '''source''' parameter in '''Model Config -''' this time though it is possible to do much more complex processing of signals like mixing values, non linear movement and mixing two or more '''signals''' together.
 
 
== Setting  up signal ==
 
=== Aligning and grouping nodes ===
 
= Adding scripted action =
 
{{Feature|informative|Please note that it might be necessary to '''save & close project after selecting model''' in order to have those changes being correctly applied.}}
 
With that knowledge, previewing animations in '''View''' window should not longer be a problem
 
[[Image:armareforger-new-prop-procedural-animation-preview.gif|center]]
 
== Applying procedural animation to prefab ==
 
At this stage, it is finally possible to plug in animation to rugged desk prefab. It will be still not possible to animate it in game via some user action but it will be good  base for further endeavors.
 
First step towards it would be adding two new components to '''Rugged Desk''' base prefab
 
* '''ProcAnimComponent -''' links Procedural Animation Projects to prefab and defines which bones are linked to PAP file
* '''SignalsManagerComponent -''' enables usage of signals which are either provided by game code or scripts
 
Those components can be added via '''Add Component +''' button located in bottom section of '''Object Properties''' window - whole process of adding new components is described in detail on [[Arma_Reforger:Prefabs_Basics#Adding_new_components_to_entity_instance|'''Prefabs Basics''']] page.
 
[[Image:armareforger-new-prop-procedural-adding-component.gif|center]]
 
While '''SignalsManagerComponent''' basically doesn't need any further tweaking, '''ProcAnimComponent''' needs some configuration. In this component, locate '''Parameters''' array and add new element by clicking on '''plus symbol''' on the right side of that parameter. This should add new element to the array of  '''ProcAnimParams''' type. Over there, there are two new parameters available:
 
* '''Resource Name''' - this parameter is used to link '''Procedural Animation Project (.pap)''' to the prefab. In this case '''drawer_move.pap''' should be selected.
* '''Bone Names''' - array of bones (list is filled automatically if '''MeshObject''' has bones/pivots available) which should be animated. This list should match bones order (the stored in .pap file itself!) and sometimes it might be necessary to verify in game which entry in array corresponds to '''Bone''' node in '''Procedural Animation Project.'''
 
If components were added to entity instance of '''Rugged Desk base prefab''', then don't forget to use '''Apply to prefab''' button and then remember to '''save current world''' to store previously made changes '''permanently on the drive'''. After that, initial implementation of procedural animations should be completed.
 
 
 
{{Messagebox|'''Overview'''
Following topics will be covered in this paragraph
 
* Creating user action for drawer
* Adding new user action to prefab|💬|#CDF}}
 
{{Feature|informative|Before proceeding further it is recommend to make yourself familiar with [[Arma_Reforger:Object_Oriented_Programming_Basics|scripting basics]] & [[Arma_Reforger:Scripting_Example|example]] or [[Arma_Reforger:Scripting_Modding|tutorial]].}}
 
 
To add new scripted action for opening and closing of drawers following elements are needed:
 
* '''New script''' for drawer action
* Properly configured '''Action Contexts''' and '''Additional Actions''' in '''ActionsManagerComponent'''
 
Before going any further, first step towards adding new user action would be '''adding of ActionsManagerComponent''' to '''PortableDesk_01_Base.et''' prefab. Similar as in [[#Applying_procedural_animation_to_prefab|'''applying procedural animation to prefab''']] segment, this can be done in few ways and all those methods are described on [[Arma_Reforger:Prefabs_Basics|'''Prefabs Basics''']] page.
 
In this tutorial, it is assumed that user have already some experience with scripts in general. If not, a good starting point might be {{GameCategory|armaR|Modding|Guidelines|Scripting}} and then checking one of the scripting tutorials [[Arma Reforger:Scripting Example|Scripting Example]] or  [[Arma Reforger:Scripting Modding|Scripting Modding]].
 
In [[Arma_Reforger:Script_Editor|'''Script Editor''']], in [[Arma_Reforger:Script_Editor#Projects|'''Projects''']] tab, it is possible to check some of the already existing '''User Actions''' in '''Game('Scripts/Game')''' →  '''Scripts → Game → UserActions.'''  A good candidate for inspiration might be '''[enfusion://ScriptEditor/Scripts/Game/UserActions/SCR_DoorUserAction.c SCR_DoorUserAction]'''  which has some of parts, which could be potentially reused for '''drawer open/close''' action.
 
 
== Creating new user action ==
 
Starting with creation of new scripted user action, it will be necessary to prepare correct folder structure first. In this case, new script should be created in '''Scripts → Game → UserActions''' folder.
 
By default, game is evaluating scripts located in few predefined locations (''which are defined in [[Arma_Reforger:Resource_Manager:_Options#Modules|'''Resource Manager options''' in '''Modules''' section'']]), so '''Scripts → Game''' part of the structure is extremely important - script outside of that folder would not be compiled otherwise. '''UserActions ''' folder is recommendation though since all other vanilla user actions are located over there.
 
[[Image:armareforger-new-prop-script-structure.png|900px]]
 
[[Image:armareforger-new-prop-script-rb.png|right]]
When folder structure is ready, it is time to create a new script called '''SCR_DrawerUserAction.c'''. In general, it can be done in at least three ways:
 
# Via '''Create''' button in '''Resource Browser''' (doesn't matter if its attached to which editor it is attached, '''Resource Manager''' will work fine though)
## To use this method, navigate to '''Scripts → Game → UserActions''' folder and then either click on '''Create''' button or use RMB on file list. In both cases, a new menu will appear from which you can select '''Script''' option. This will
# Via '''Add New Script..'''. context menu in '''Projects''' window
# Via '''Script Wizard'''
 
In principle, to make your new user action selectable in '''Additional Actions''' inside '''ActionsManagerComponent''', you have to inherit from '''ScriptedUserAction''' class - just like '''SCR_DoorUserACtion''' does. This can be simply achieved by writing following code in '''SCR_DrawerUserAction.c'''
<enforce>
class SCR_DrawerUserAction : ScriptedUserAction
{
}
</enforce>
Next step would be getting reference to '''SingalsManagerComponent'''. It is done once in init and reference to it is cached in memory.
<enforce>
class SCR_DrawerUserAction : ScriptedUserAction
{
//! Signal manager to pass signals into procedural animation
private SignalsManagerComponent m_SignalsManager;
 
//------------------------------------------------------------------------------------------------
override void Init(IEntity pOwnerEntity, GenericComponent pManagerComponent)
{
m_SignalsManager = SignalsManagerComponent.Cast(pOwnerEntity.FindComponent(SignalsManagerComponent));
}
}
</enforce>
{{Clear}}
Once that is set, it is a proper moment to add new attribute to the action itself. To do so, add {{Link|enfusion://ScriptEditor/scripts/Core/attributes.c;221|[Attribute()] }} tag above variable that you want to expose. Attributes can be provided in two ways:
 
* Without parameters names, just values are typed, separated by coma. Example: ''[Attribute("hello", UIWidgets.EditBox)]''
* With parameter names, list of parameters can be checked in Script Editor [enfusion://ScriptEditor/scripts/Core/attributes.c;231 over there].
 
In this tutorial, the 2nd method was used.
<enforce>
class SCR_DrawerUserAction : ScriptedUserAction
{
[Attribute( defvalue: "Drawer 1", uiwidget: UIWidgets.EditBox, desc: "Signal index of drawer" )]
private string m_sSignalName; // string for pairing with the user action
}
</enforce>
Above code should translate to parameter being visible in '''SCR_DrawerUserAction''' as on picture below. This part is detailed more in detail later, so for now we can continue with writing script.
 
[[Image:armareforger-new-prop-script-action-parameter.png]]
 
Further step is finding of signal index in '''SingalsManagerComponent''' using name provided by attribute exposed before. To do so, it is necessary to override two methods:
 
* '''CanBeShownScript''' - controls if this action can be performed by the provided user entity
* '''CanBePerformedScript''' - controls if this action can be shown in the UI by the provided user entity
 
In case of '''CanBeShownScript''', work is quite simple since it is assumed that action should be always visible if it can be performed.
 
'''CanBePerformedScript''' does some simple validation of input and verifies if '''SingalsManagerComponent''' is present on entity, if not, then the script will exit. Afterwards, code is validating  '''m_iSignalIndex''' variable. By default it is set to -1 and in such case, code will try to find '''m_sSignalName''' in '''SingalsManagerComponent ''' and return correct index. If its not found, then action won't be visible.
<enforce>
class SCR_DrawerUserAction : ScriptedUserAction
{
[...]
private int m_iSignalIndex = -1;
 
//------------------------------------------------------------------------------------------------
override bool CanBeShownScript(IEntity user)
{
return CanBePerformedScript(user);
}
 
//------------------------------------------------------------------------------------------------
override bool CanBePerformedScript(IEntity user)
{
if(!m_SignalsManager) // Do nothing if there is no signal manager
return false;
 
if (m_iSignalIndex < 0) // Check if signal index is valid
{
m_iSignalIndex = m_SignalsManager.FindSignal(m_sSignalName);
return false;
}
 
return true;
}
[...]
}
</enforce>
After that, code for sending signal to '''Procedural Animation Project''' can be added. This is done by finding signal (''via [enfusion://ScriptEditor/Scripts/Game/generated/Components/SignalsManagerComponent.c;35 FindSignal] method'') in '''SignalManagerComponent''', which was automatically registered by linked procedural animation in '''ProcAnimComponent'''.  
 
Since setting '''ValRT''' in '''Procedural Animation Projects''' do a full movement of the drawer, '''targetValue''' variable  switches between 0 and '''MAX_SIGNAL_VALUE''' constants, so the drawer is not fully opened. Of course, this can be changed/optimized and this is mainly a '''showcase how to work with signals'''. Value of '''targetValue''' is then passed to '''SignalsManagerComponent''' through [enfusion://ScriptEditor/Scripts/Game/generated/Components/SignalsManagerComponent.c;37 '''SetSignalValue'''] method, which is finally passed to procedural animation.
<enforce>
class SCR_DrawerUserAction : ScriptedUserAction
{
[...]
const float MAX_SIGNAL_VALUE = 0.25;
[...]
//---------------------------------------------------------
override void PerformAction(IEntity pOwnerEntity, IEntity pUserEntity)
{
float targetValue = Math.AbsFloat((m_SignalsManager.GetSignalValue(m_iSignalIndex)) - MAX_SIGNAL_VALUE);
 
m_SignalsManager.SetSignalValue(m_iSignalIndex, targetValue);
}
[...]
}
</enforce>
Last step will be handling of UI part and changing name of the action depending whether drawer is going to be closed or opened. This is done by '''overriding GetActionNameScript''' method and changing '''outName''' string. If signal connected to that particular drawer is '''equal to 0''', then we can assume that '''drawer is closed''' and action that should be visible by player should be called "'''Open'''". Otherwise, '''"Close"''' action should be presented to player.<enforce>
class SCR_DrawerUserAction : ScriptedUserAction
{
[...]
//------------------------------------------------------------------------------------------------
override bool GetActionNameScript(out string outName)
{
if((m_SignalsManager.GetSignalValue(m_iSignalIndex)) == 0)
{
outName = "Open";
} else
{
outName = "Close";
}
return true;
}
[...]
}
</enforce>
If all described above steps were done correctly, then new, '''SCR_DrawerUserAction''' action should be ready to use in '''ActionsManagerComponent'''. Below you can find full script code.
 
Full code
<spoiler>
<enforce>
class SCR_DrawerUserAction : ScriptedUserAction
{
[Attribute( defvalue: "Drawer 1", uiwidget: UIWidgets.EditBox, desc: "Signal index of drawer" )]
private string m_sSignalName; // for pairing with the user action
 
private int m_iSignalIndex;
const float MAX_SIGNAL_VALUE = 0.25;
 
//! Signal manager to pass signals into procedural animation
private SignalsManagerComponent m_SignalsManager;
 
//------------------------------------------------------------------------------------------------
override bool CanBeShownScript(IEntity user)
{
return CanBePerformedScript(user);
}
 
//------------------------------------------------------------------------------------------------
override bool CanBePerformedScript(IEntity user)
{
if(!m_SignalsManager) // Do nothing if there is no signal manager
return false;
 
if (m_iSignalIndex < 0) // Check if signal index is valid
{
m_iSignalIndex = m_SignalsManager.FindSignal(m_sSignalName);
return false;
}
 
return true;
}
 
//---------------------------------------------------------
override void PerformAction(IEntity pOwnerEntity, IEntity pUserEntity)
{
float targetValue = Math.AbsFloat((m_SignalsManager.GetSignalValue(m_iSignalIndex)) - MAX_SIGNAL_VALUE);
 
m_SignalsManager.SetSignalValue(m_iSignalIndex, targetValue);
}
 
//------------------------------------------------------------------------------------------------
override bool GetActionNameScript(out string outName)
{
if((m_SignalsManager.GetSignalValue(m_iSignalIndex)) == 0)
{
outName = "Open";
} else
{
outName = "Close";
}
return true;
}
 
//------------------------------------------------------------------------------------------------
override void Init(IEntity pOwnerEntity, GenericComponent pManagerComponent)
{
m_SignalsManager = SignalsManagerComponent.Cast(pOwnerEntity.FindComponent(SignalsManagerComponent));
}
}
</enforce>
</spoiler>
 
== Adding action contexts ==
 
[[Image:armareforger-new-prop-script-action-manager.png|right]]
With '''SCR_DrawerUserAction''' being properly setup, it is possible to move forward and start adding new '''Action Contexts''' in '''ActionsManagerComponent.'''
 
'''Action Contexts''' serves as a sort of list of interactable places , where other systems requiring user input can use them.
 
Each '''action context''' have following properties:
 
* '''Context Name''' - used by other systems to distinguish this action from the rest of action contexts
* '''Position -''' defines position of the action. Using '''PointInfo''' class, it is possible to define following things
** '''Pivot ID -''' in this drop-down list box it is possible to attach '''action context''' to '''selected bone'''. Action will follow the bone if its animated
** '''Offset''' - offset from the center of model or (''Pivot ID has some valid bone selected'') from center of the '''Pivot ID'''
** '''Angles -''' orientation of the action - it is especially important when '''Omnidirectional''' property is set to false
* '''Radius''' - this parameter defines how far, from the origin defined by '''Position''' parameter,  action context is visible.
* '''Omnidirectional -''' defines if context is available from both sides or not.
 
{{Feature|informative|Some of the extra details can be found on [[Arma_Reforger:Action_Context_Setup]] page}}
{{Clear}}
New '''Action Contexts''' can be added to '''ActionsManagerComponent''' by clicking on '''plus + sign (1)''' located to the right of the parameter. '''ActionsManagerComponent''' component has also some interesting options available '''which can speed up process of debug and setup of new actions.'''
 
After clicking with RMB on '''ActionsManagerComponent''' in '''Object Properties''' windows, a new context menu should appear containing various options for debuging and one action for '''assisted creation of new action contexts''' - '''Create user action context(s) from bones.'''
 
After clicking '''Create user action context(s) from bones''' option, a new window will appear listing all bones that '''don't have action context defined yet'''. By clicking on '''drawer_1 with {{Controls|LMB}}''' and clicking on '''drawer_6''' with {{Controls|LMB}} while holding left {{Controls|Shift}}, you can select multiple entries at once. It is also possible to select multiple elements by holding left control and then clicking with {{Controls|LMB}}. Once all drawer related bones (from 1 to 6) are selected, it is possible to confirm selection by clicking on '''OK''' button.
 
[[Image:armareforger-new-prop-script-action-manager-create-actions-bones.gif]]
 
It's also worth to mention that this context menu has few other options, which are quite useful for setting up & debugging of context actions. Below you can see in action transform gizmos (activated via ''Toggle context(s) transform gizmo visualization'' ) and radius visualization (activated via ''Toggle context(s) radius visualization'' option). ''Toggle context(s) visibility angle visualization'' is also quite handy in setting non '''Omnidirectional''' actions.
 
[[Image:armareforger-new-prop-script-action-manager-context-menu.png]]
 
Position of the action context can be further tweaked by changing '''Offset''' values in '''Position''' object.
 
[[Image:armareforger-new-prop-script-action-adjustments.gif]]
 
== Adding additional actions ==
[[Image:armareforger-new-prop-script-action-manager-additional-actions.gif|right]]
Additional actions are actions, which are scripted. Some of the actions like get in, '''switch seat or opening of doors are handled''' by respective components like '''DoorComponent''' or '''SCR_BaseCompartmentComponent'''. Other more specific actions, which don't necessarily need a whole component to be handled, are handled via '''Additional Actions''' array. In vanilla game, '''flushing toilet''' or '''opening hatches in BTR-70''' are handled via this kind of actions and '''drawer open/close action is also a good candidate to use this method'''.
 
New '''additional actions''' can be added to the asset by clicking on plus icon to the right of '''Additional Actions''' property inside '''ActionsManagerComponent'''. Once that plus sign is clicked, a new menu pops up asking for a type of action which should be added to the asset. In this case '''SCR_DrawerUserAction ''' should be selected from the list.
 
After adding first '''SCR_DrawerUserAction''' element to the array'''''', there are '''few things that need to be adjusted over there'''. First task will be configuring '''Parent Context List''' parameter. This array contain list of contexts where this action will be visible. It is possible to use multiple contexts for such action but in this case, only single context - '''previously created drawer_1 -''' should be present in '''Parent Context List''' array.
 
Next thing will be defining of '''Signal Name''' parameter. This is custom property which was added by '''SCR_DrawerUserAction''' and, as it was mentioned before, it should contain name of the '''signal''' defined in '''Input''' node of '''Procedural Animation Editor Signal''' (.''siga file''). In this case it will be '''Drawer 1'''
 
If all steps were properly followed, then it should be already possible to test it in-game and verify if the user action is visible & usable. If action is not visible, verify if bone used as '''Pivot ID''' is correctly rotated and that radius of action is correct.
 
{{Clear}}
= Adding sounds =
 
{{Messagebox|'''Overview'''
Following topics will be covered in this paragraph
 
* Creating audio project
* Assigning it to object|💬|#CDF}}
 
{{Feature|informative|Before proceeding further, it is recommended to make yourself familiar with the [[Arma Reforger:Audio Editor|Audio Editor]] documentation and the [[Arma Reforger:Audio Editor: Getting Started Tutorial|Audio Editor: Getting Started Tutorial]].}}
 
== Creating new audio project ==
 
New '''audio project''' can be created quite easily inside '''Audio Editor'''. To do so, open '''Audio Editor''' and either select from '''File → New → Project..'''. option or use '''{{Controls|Ctrl|Shift|N}}''' shortcut.
 
[[Image:armareforger-new-prop-sound-new-project.png|center]]
 
== Setting nodes in audio project ==
 
For drawer open/close action following things will be required in audio project:
 
* '''2 [[Arma_Reforger:Audio_Editor:_Nodes#BankLocal|BankLocal nodes]]''' (''aka Bank node)'' - one for opening and another for closing of drawer
* '''2 [[Arma_Reforger:Audio_Editor:_Nodes#Shader|Shader nodes]]''' - separate for opening and drawer. Applies panning and attenuation based on the spatial relation between the in-game listener and emitter
* '''2 [[Arma_Reforger:Audio_Editor:_Nodes#Sound |Sound nodes]]''' - same as above. The root node of a signal chain. Must be present in every chain in order for sound to be playable. Name of the '''Sound''' node can be later to trigger '''Sound Event''' via scripts
* '''[[Arma_Reforger:Audio_Editor:_Nodes#Amplitude|Amplitude node]]''' - controls amplitude attenuation that is applied by the '''Shader -''' shared with both '''Shader nodes'''
* '''[[Arma_Reforger:Audio_Editor:_Nodes#Frequency |Frequency node]]''' - controls frequency attenuation that is applied by the '''Shader -''' shared with both '''Shader nodes'''
* '''[[Arma_Reforger:Audio_Editor:_Nodes#Spatiality |Spatiality node]]''' - controls spatiality that is applied by the '''Shader''' '''-''' shared with both '''Shader nodes'''
* '''[[Arma_Reforger:Audio_Editor:_Nodes#Mixer|OutputState node]]''' ''(aka Mixer or [enfusion://ResourceManager/~ArmaReforger:Sounds/FinalMix.afm FinalMix.afm])'' - This node serves as a way to group sounds based on type so that they can be processed as a unit before being sent to the final output(s). As with the Signal node, this node contains some internal logic that defines how each sound group is processed. This internal logic can be edited by double-clicking on the node.
 
=== Adding audio banks ===
 
Starting configuration of '''audio project''' with creation of '''audio banks''', new '''Bank nodes''' can be easily added by following below steps:
 
* Click on '''BankLocal''' button in the upper section of the editor
* Click on that new '''Bank''' node and navigate to '''Unsorted section''' in '''Item Detail''' window
* Fill in '''Samples''' array with audio files (''start with Sfx_RuggedDesk_Drawer_Open_01.wav)'' that should be played when this audio bank is used. This can be done in two ways:
** By drag and dropping registered audio file in wav format on '''Bank''' node
** By adding new element to '''Samples''' array via plus button and then assigning wav file in '''Filename''' field
 
This should be enough to have it in working state. Additionally, following steps can be performed to make it more pleasant to look at:
 
* Rename '''Bank''' node to f.e. ''"Open"'' by changing '''Name''' parameter in '''Item Detail''' window
* Reposition '''Bank''' node to make space for another '''Bank''' node
 
After that, above steps  can be repeated to create ''Close'' '''Bank''' node, which would contain ''Sfx_RuggedDesk_Drawer_Close_01.wav'' sample. With two bank nodes in place, it is also possible to already start process of beautification of the audio project by aligning and then grouping those nodes in '''Audio Bank'''s group.
 
[[Image:armareforger-new-prop-sound-audio-bank.gif]]
 
=== Adding shaders ===
 
Process of adding '''new shaders''' to '''audio project''' is quite similar, if not even simpler, to explained above procedure of adding audio banks.
 
In principle, those two steps have to be done for both '''Close''' and '''Open''' variants:
 
* Click on '''Shader''' button in top section of the main window
* Connect '''Out''' port on '''Bank node''' with '''In port on Shader node'''
 
Once again, it is also recommended to '''change names''' of the nodes and then '''group''' them improve readability of the audio project.
 
[[Image:armareforger-new-prop-sound-adding-shader.gif]]
 
=== Adding special nodes ===
 
Next in audio project configuration will be adding of '''Amplitude, Frequency & Spatiality''' nodes to the working file. Adding of those nodes should be at this point quite straightforward so in this chapter we will focus more on '''configuration of new nodes'''.
 
Beginning with '''Amplitude''' node, here are few things that has be done in order to have it working correctly:
 
* In '''Item Detail''' window, change '''Curve''' parameter from '''None''' to '''Logarithm'''. This action will enable '''attenuation of the sound''' or in other words, sound will be more '''silent the further away you are from the sound source'''.
** After changing '''Curve''' parameter to '''Logarithm''', two new parameters should appear''':'''
*** '''Inner Range''' - this parameter define distance in meters below no attenuation is applied. By default it is set to 1 and for this asset we can leave it as it is
*** '''Outer Range''' - this parameter define distance in meters beyond sound is muted. For such small drawer as this, '''5 meters''' would be a sensible number
* '''Amplitude Out''' port should be connected to '''Amplitude''' port on both '''Close & Open''' shaders.
 
Second on the list is '''Frequency''' node, which also affects attenuation of the sound & similar to '''Amplitude''' node, following things have to be adjusted on that node
 
* In '''Item Detail''' window, enable '''Enable Distance Att''' parameter
** Default values should be fine for this rugged desk - for more information see Audio Editor nodes documentation
* '''Frequency Out''' port should be connected to '''Frequency''' port on both '''Close & Open''' shaders.
 
Last but not least it is time to configure '''Spatiality''' node, which controls 3D sound perception.
 
* In '''Item Detail''' window, change '''Spatial Factor''' parameter '''to 1.0 -''' this will enable 3D like perception of the sound.
* '''Spatiality Out''' port should be connected to '''Spatiality''' port on both '''Close & Open''' shaders.
 
[[Image:armareforger-new-prop-sound-adding-special-nodes.gif]]
 
=== Adding sound nodes ===
 
With shaders being properly configured, it is time to move to '''Sound''' nodes. In this case, '''name of the Sound node is important''', since it will be later used in script to trigger '''playing of the sound event'''. Sound nodes can be added by clicking on '''Sound''' button in top section of the main window. Both '''close and open action need a separate Sound node''', so two '''Sound''' nodes are necessary.
 
Once both nodes are present in work board, change their name to '''SOUND_DRAWER_CLOSE''' and '''SOUND_DRAWER_OPEN''' and then connect it to respective shaders.
 
'''Sound''' nodes have quite a lot of parameters which can be tweaked so at later stage, when whole asset is configured, it is recommended to play with parameters that are available over there.
 
[[Image:armareforger-new-prop-sound-adding-sound-node.gif]]
 
=== Adding final mix ===
 
Final step will be adding of [enfusion://ResourceManager/~ArmaReforger:Sounds/FinalMix.afm FinalMix.afm] (''also known as [[Arma_Reforger:Audio_Editor:_Nodes#Mixer|Mixer]]'') to the audio project and then connecting outputs of '''Sound''' nodes to '''ENV_Objects''' port on '''OutputState''' node.
 
[[Image:armareforger-new-prop-sound-final-mix.gif]]
 
=== Result ===
 
In the end, audio project should look somewhat similar to the picture below. Since '''Procedural Animation Editor''' & '''Audio Editor''' are sharing a lot of code, it is also possible to [[#Aligning_and_grouping_nodes|'''align & group nodes''']] here too.
 
[[Image:armareforger-new-prop-sound-audio-project-result.png|center]]
{{Clear}}
It is also possible to check playback of the sounds inside '''Audio Editor''' - without switching to play mode - by selecting node and then hitting '''space''' button. Example of using sound debug can be found on [[Arma_Reforger:Weapon_Modding#Audio_Bank_Content_Change|Weapon Modding]] tutorial page.
 
== Applying sound to prefab ==
 
[[Image:armareforger-new-prop-sound-adding-component.png|left]]
 
In order to apply sounds to prefab, first step towards would be '''adding of SoundComponent''' to it. As described before, this can be achieved by using '''[[Arma_Reforger:Prefabs_Basics#Adding_new_components_to_entity_instance|+ Add Component]]''' button and selecting '''SoundComponent''' from list.
 
Once that component is present and selected, it is possible to add new element to '''Filenames''' array. Since in this tutorial only single '''.acp''' file was created, one element in this array should be enough.
 
After new element in array is present, it is possible to fill that property either by drag and dropping '''audio project file''' on that resource field or by clicking on button with two dots and the selecting '''Rugged Desk .acp file.'''
{{Clear}}
 
== Playing sound in script ==
 
First step towards triggering a sound from the script will be fetching of '''SoundComponent''' in '''SCR_DrawerUserAction script'''. Similar to '''SignalManagerComponent''', this can done by using [enfusion://ScriptEditor/scripts/Core/generated/Entities/IEntity.c;536 '''FindComponent'''] method.
<enforce>
class SCR_DrawerUserAction : ScriptedUserAction
{
[...]
//! Sound component
private SoundComponent m_SoundComponent;
 
//------------------------------------------------------------------------------------------------
override void Init(IEntity pOwnerEntity, GenericComponent pManagerComponent)
{
[...]
// get Sound component
m_SoundComponent = SoundComponent.Cast(pOwnerEntity.FindComponent(SoundComponent));
}
}
</enforce>
Next, at the bottom of '''PerformAction''' method, code for triggering sounds can be added. This is done by calling '''SoundEvent''' method and passing name of the '''Sound''' node, which was previously defined in '''audio project''', as a parameter.
<enforce>
class SCR_DrawerUserAction : ScriptedUserAction
{
//---------------------------------------------------------
override void PerformAction(IEntity pOwnerEntity, IEntity pUserEntity)
{
[...]
// Check if sound component exist
if (m_SoundComponent)
{
// If target value is above 0, then trigger SOUND_DRAWER_OPEN event, which will play sound of drawer opening
// Otherwise drawer closing sound will be played via SOUND_DRAWER_CLOSE sound event
if(targetValue > 0)
{
m_SoundComponent.SoundEvent("SOUND_DRAWER_OPEN");
}
else
{
m_SoundComponent.SoundEvent("SOUND_DRAWER_CLOSE");
}
}
}
}
</enforce>
Once those changes are saved and compiled, this desk should be already in state where closing and opening of drawers plays some sounds! Below you can find full code in case you had some troubles with implementing those extra bits of code
 
Full code
<spoiler>
<enforce>
class SCR_DrawerUserAction : ScriptedUserAction
{
[Attribute( defvalue: "Drawer 1", uiwidget: UIWidgets.EditBox, desc: "Signal index of drawer" )]
private string m_sSignalName; // for pairing with the user action
 
private int m_iSignalIndex;
const float MAX_SIGNAL_VALUE = 0.25;
 
//! Signal manager to pass signals into procedural animation
private SignalsManagerComponent m_SignalsManager;
//! Sound component
private SoundComponent m_SoundComponent;
 
//------------------------------------------------------------------------------------------------
override bool CanBeShownScript(IEntity user)
{
return CanBePerformedScript(user);
}
 
//------------------------------------------------------------------------------------------------
override bool CanBePerformedScript(IEntity user)
{
if(!m_SignalsManager) // Do nothing if there is no signal manager
return false;
 
if (m_iSignalIndex < 0) // Check if signal index is valid
{
m_iSignalIndex = m_SignalsManager.FindSignal(m_sSignalName);
return false;
}
 
return true;
}
 
//---------------------------------------------------------
override void PerformAction(IEntity pOwnerEntity, IEntity pUserEntity)
{
float targetValue = Math.AbsFloat((m_SignalsManager.GetSignalValue(m_iSignalIndex)) - MAX_SIGNAL_VALUE);
 
m_SignalsManager.SetSignalValue(m_iSignalIndex, targetValue);
 
// Check if sound component exist
if (m_SoundComponent)
{
// If target value is above 0, then trigger SOUND_DRAWER_OPEN event, which will play sound of drawer opening
// Otherwise drawer closing sound will be played via SOUND_DRAWER_CLOSE sound event
if(targetValue > 0)
{
m_SoundComponent.SoundEvent("SOUND_DRAWER_OPEN");
}
else
{
m_SoundComponent.SoundEvent("SOUND_DRAWER_CLOSE");
}
}
}
 
//------------------------------------------------------------------------------------------------
override bool GetActionNameScript(out string outName)
{
if((m_SignalsManager.GetSignalValue(m_iSignalIndex)) == 0)
{
outName = "Open";
} else
{
outName = "Close";
}
return true;
}
 
//------------------------------------------------------------------------------------------------
override void Init(IEntity pOwnerEntity, GenericComponent pManagerComponent)
{
m_SignalsManager = SignalsManagerComponent.Cast(pOwnerEntity.FindComponent(SignalsManagerComponent));
m_SoundComponent = SoundComponent.Cast(pOwnerEntity.FindComponent(SoundComponent));
}
}
</enforce></spoiler>
 
= Editor integration =
 
{{Messagebox|'''Overview'''
Following topics will be covered in this paragraph
 
* Creating placeable entities for in-game editor
* Configuring placeable entities appearance in entity browser|💬|#CDF}}
 
{{Feature|informative|Recommended pages to familirize with: [[Arma_Reforger:Game_Master:_Editable_Entities_Configuration]], [[Arma_Reforger:Game_Master:_Image_Generation_Tutorial]], [[Arma_Reforger:Mod_Localisation]], [[Arma_Reforger:Asset_Browser_Mod_Integration]] }}
 
 
== Generating placeable entity ==
 
Once the configuration of the prefab is done, it is possible to use one of the editor plugins to prepare '''Editable Entities'''. This can be done by using '''Create/Update Selected Editable Prefabs''' plugin, which will create '''new, editable prefabs''' for assets which usually are not replicated (''like props)'' and don't have one of the ''Editable Components'' attached to it.
 
Usage of that plugin is quite well explained on [[Arma_Reforger:Game_Master:_Editable_Entities_Configuration#Existing_Prefab|Game Master Existing Prefab Configuration]] page and therefore some of the details are skipped here. In case of that set of rugged desk props following steps were performed:
 
* In '''Resource Browser''' (''main one, it doesn't work with Resource Browser 2!'')  attached to '''Resource Manager''', all prefabs in '''PrefabsEditable → Military → Camps ''' folder were selected. Assets with '''_base,_Base,_dst,_Dst or_DST suffix are automatically omitted''' by the plugin so they can be also selected without any issues - this behavior can be tweaked in [enfusion://ResourceManager/~ArmaReforger:Configs/Workbench/EditablePrefabs/EditablePrefabsConfig.conf '''EditablePrefabsConfig.conf'''].
* From '''Plugins→ Editor''' menu '''Create/Update Selected Editable Prefabs''' plugin was selected. Alternatively '''{{Controls|Ctrl|Shift|U}}''' shortcut can be used
 
After that, new prefabs should be automatically generated. Those new '''editable prefabs''' created by the plugin are stored in '''Auto''' folder of filesystem ''(aka addon/mod)'' they belong to. Over there, new inherited prefabs with '''E_''' prefix are present, which are '''inheriting from original, non editable prefabs''' and they are '''mimicking file structure of the original prefab'''. In this case, it means that all editable prefabs should be located in '''PrefabsEditable → Auto → Military → Camps''' folder.
 
Additionally, plugin also prepares '''placeholder preview images''' for all assets - without it, it is impossible to go through next step which is generation of proper preview images.
 
[[Image:armareforger-new-prop-editor-placeable-entities.gif]]
 
== Generating preview images ==
 
New, proper preview images can be created using special world located within Arma Reforger data ({{Link|enfusion://WorldEditor/worlds/Editor/Slots/AssetImages/Eden_AssetImages.ent;6454.71,171.752,6435.05;-27.5997,25.4986,0|link}}) . Instructions about usage of that special world can be found on [[Arma Reforger:Game Master: Image Generation Tutorial|Game Master: Image Generation Tutorial]] and here you can find a short instruction on how it was done for '''Sample New Prop''' addon:
 
* Load {{Link|enfusion://WorldEditor/worlds/Editor/Slots/AssetImages/Eden_AssetImages.ent;6454.71,171.752,6435.05;-27.5997,25.4986,0|Eden_AssetImages.ent}}
* Select '''SCR_EditorImageGeneratorEntity''' from Hierarchy window
* Adjust viewport to 400x300
* In diagnostic menu, set ''Game > Compressed format in WB'' to ''true''
* Select prefabs in '''Resource Browser''' attached to '''World Editor''' which should be '''subject of preview image generation'''. In this case all '''prefabs in PrefabsEditable → Auto → Military → Camps folder were selected'''
* Switch to '''Play''' mode
 
If editable prefabs were correctly generated in previous step, then new pictures should be ready to use. If not, check '''Console Log''' for hints about what went wrong.
 
 
== Changing display name ==
 
[[Image:armareforger-new-prop-editor-display-name.png|left]]
Display name of the prefab can be changed in prefabs located in '''PrefabsEditable''' folder inside '''Auto''' subfolder which was described in paragraph about generating placeable entities.
 
Once those editable prefabs are located and present in World Editor (either by placing them or using Edit prefab button), it is time to change their configuration. Bunch of editor related configuration is located in '''SCR_EditableEntityComponent''' and among parameters that you can change there you can find '''Name''' parameter in '''Visualization''' section of that component.
 
Over here, change '''Name''' parameter so it reflects desired display name of that asset in [[Arma_Reforger:Game_Master#Entity_Browser|'''Entity Browser''']] - in this case ''Sand Rugged Desk'' was picked, and it was made inline with [[Arma_Reforger:Editor_Entity_Naming_Conventions]]
 
{{Clear}}
=== Setting up localization table ===
{{Feature|warning|Currently, non localized entities cannot be searched in Entity Browser, therefore it is '''highly recommend to localize editable prefabs!'''}}
 
After changing the strings in the prefab, it is possible to use '''localization plugin''' to add string to localization table. It is also worth to note, that in some case it might be faster to first '''localize placeholder strings''' and then '''change those strings inside''' '''String Editor -''' in any case, both workflows have their advantages and its matter of preference which one to use.
 
In this example, first method was used - adjusting display names in prefab and then putting those strings to '''localization table (.st)''' via '''Localize Selected Assets''' plugin. Before that, it is necessary to create localization table and runtime variant of it and the register those elements in game project. Whole process is described in detail on [[Arma Reforger:Mod Localisation|Mod Localisation]] so here is short version of that procedure:
 
* Create "'''Language'''" folder in the root addon file system
* Inside of that folder, following files have to be created:
** '''GUI string table''' - this is main file which is used by '''String Editor'''. It is important to assign to it unique name so it doesn't clash with other mods - in this case file was called ''samplenewprop_localization.st''
*** ''After  samplenewprop_localization.st'' was created, click on it with {{Controls|RMB}} and select '''Open File in New Tab''' option from '''Context Menu''' and set parameters to '''following values'':'''''
**** ''Target Prefix'': '''Target_'''
**** ''Item Class Name'': '''CustomStringTableItem'''
** '''StringTableRuntime -''' version of localization table used by the game - it is stripped from all '''String Editor''' related content. Each language needs separate config file. In this tutorial, ''samplenewprop_localization.en_us.conf'' was created
 
[[Image:armareforger-new-prop-editor-creating-localization.gif]]
 
Once files are created, it is time to plug them into game project:
 
* Open '''Workbench options''' by clicking on '''Options''' from '''Workbench''' top menu.
* Navigate to '''Widget Manager Settings → String Tables'''
* Added new '''StringTableDefinition'''
* Assign ''samplenewprop_localization.st'' to '''String Table Source''' property
* Add new element to '''Languages''' array
** Change '''Code''' property to '''en_us'''
** Assign ''samplenewprop_localization.en_us.conf'' to '''String Table Runtime''' property
* Save changes by clicking on '''OK''' button
 
[[Image:armareforger-new-prop-editor-configuring-localization.gif]]
 
=== Adding strings to localization table ===
 
With string table in place, it is possible to actually fill it with data. This can be done by following below steps (see [[Arma Reforger:Mod Localisation|Mod Localisation]] for more details):
 
* Select all prefabs inside '''PrefabsEditable → Auto → Military → Camps''' folder in '''Resource Browser''' (it can be either '''Resource Browser''' attached to '''Resource Manager''' or '''World Editor''')
* Click on '''Localize Selected Assets''' in '''Plugins''' tab or use {{Controls|Ctrl|Shift|L}} shortcut
* In window that appeard make following adjustment:
** Change '''Config Path''' config and use
** Assign ''samplenewprop_localization.st'' in '''String Table Override''' property
** Type '''SampleMod-''' in '''Prefix Override''' property
** Click on '''Localize''' button
 
Plugin now should open ''samplenewprop_localization.st '' in '''String Editor''' and fill all the detected strings. If file is empty, then make sure that '''String Table Override''' property is correctly assigned and check '''Console Log''' for errors or warnings.
 
[[Image:armareforger-new-prop-editor-localizing-assets.gif]]
 
== Adjusting labels ==
 
[[Image:armareforger-new-prop-editor-labels.png|left]]
Entity labels are used by in-game Editor Entity Browser to [[Arma_Reforger:Game_Master#Filters|filter]] content. By default, some of those labels are automatically assigned by '''Create/Update Selected Editable Prefabs''' plugin base on their '''type ('''''is it GenericEntity or Vehicle class?),'' '''folder in which they are located''' (''Prefabs in Prefabs/Military folder will get Theme_Military'' ''label)'', '''parameters in their prefabs''' (''Mass in RigidBody, size of the group by counting elements in Unit Prefab Slots, etc),'' '''size of bounding box''' and so on. Most of those rules can be checked by opening [enfusion://ResourceManager/~ArmaReforger:Configs/Workbench/EditablePrefabs/EditablePrefabsConfig.conf '''EditablePrefabsConfig.conf''']. It is also possible to add some custom rules as it was for instance described in the [[Arma Reforger:Faction Creation#Adjusting generators configs|Faction creation guide]].
 
Beside that, it is also possible to manually add extra labels or even custom ones by changing content of '''Authored Labels''' array in '''SCR_EditableEntityComponent''' . In case of that prop, it is recommended to add '''CONTENT_MODDED''' label to '''Authored Labels''' array (''Auto Labels array shouldn't be touched by the user since content of that array might get overridden by editor plugin!)'' for each asset prefab in '''PrefabsEditable → Auto → Military → Camps''' folder. This can be done by clicking on '''button with plus sign''' on the right side of the '''Authored Labels''' property and then select from that new element in array '''CONTENT_MODDED''' label from drop down menu.
{{Clear}}
 
== Registering asset ==
 
The final step in editor integration is adding editable props to register of placeable assets. Whole process is described in detail on [[Arma Reforger:Asset Browser Mod Integration|Asset Browser Mod Integration]] page so here is simplified list of steps that had to be done:
 
* Create new '''SCR_PlaceableEntitiesRegistry'''  register in ''SampleMod_NewProp\Configs\Editor\PlaceableEntities'' called '''NewProp_Props.conf'''
* Override in addon [enfusion://ResourceManager/~ArmaReforger:Prefabs/Editor/Modes/EditorModeEdit.et '''EditorModeEdit.et''']
* Open [enfusion://ResourceManager/~ArmaReforger:Prefabs/Editor/Modes/EditorModeEdit.et '''EditorModeEdit.et'''] and in '''SCR_PlacingEditorComponent, add new entry to Registries''' array by i.e. drag and dropping '''NewProp_Props.conf'''
* Save changes in [enfusion://ResourceManager/~ArmaReforger:Prefabs/Editor/Modes/EditorModeEdit.et '''EditorModeEdit.et''']
* Open'''NewProp_Props.conf''', select all prefabs in '''PrefabsEditable → Auto → Military → Camps ''' inside '''Resource Browser''' attached to '''Resource Manager''' and then drop that selection onto '''Prefabs''' array inside of that config
** Furthermore, you can also change '''Addon''' & '''Source Directory''' property so plugin can in future '''semi-automatically fill or update''' that '''Prefabs''' array
 
[[Image:armareforger-new-prop-editor-register.png]]
 
{{Feature|informative|Please note that GUID of any new file is '''generated from filesystem path + file name'''. In order to avoid conflicts with other mods, it is recommended to use '''unique name for registers by i.e. adding tag as prefix'''.}}
 
After all those steps, assets should be available in in-game [[Arma_Reforger:Game_Master#Entity_Browser|'''Entity Browser!''']]
 
= Testing result =
{{Messagebox|'''Overview'''
In this paragraph you can read about:
 
* Testing your creation in Game Master
* Testing your creation in new world|💬|#CDF}}
 
In '''Workbench''', new prop can be tested either by '''launching  [[Arma_Reforger:Game_Master|Game Master scenario]]''' and then placing new assets through '''Asset Browser''' or by '''simply creating a new sub-world in World Editor''' and then placing asset in game
 
 
== Testing in Game Master ==
 
To test new prop in '''Game Master''', load [enfusion://WorldEditor/worlds/GameMaster/GM_Eden.ent;4657.23,50.7969,10727.1;-33.3344,23.4751,0;1385091 '''GM_Eden.ent '''] world in [[Arma_Reforger:World_Editor|'''World Editor''']] and once it's ready, switch to [[Arma_Reforger:World_Editor#Play_Game|'''Play mode''']] by either pressing on green arrow or via '''F5 shortcut''' (''furthermore, that option is also available in '''Game''' tab''). This should initiate loading of scenario and once it's completed, regular Game Master interface should be present.
 
[[Image:armareforger-new-prop-testing-playmode.png]]
 
Now, by bringing up [[Arma_Reforger:Game_Master#Entity_Browser|'''Entity Browser''']] either by pressing '''Tab''' or by clicking on '''Place entities''' button in bottom right section of the interface
 
[[Image:armareforger-new-prop-testing-gamemaster.png]]
 
== Testing in new world ==
 
Simplest & fastest way to do it might be loading [enfusion://WorldEditor/worlds/MP/MpTest.ent;110.145,5.1562,100.424;-35.2569,46.3466,0 '''MpTest'''] world and then creating a new subworld of it. To do so, follow this instruction:
 
[[Image:armareforger-new-prop-testing-subworld.png]]
 
* Click on '''File → New World''' ('''''{{Controls|Ctrl|N}} shortcut''''') or on '''New World''' icon in the toolbar
* Select '''Sub-scene (of current world)''' option and confirm it with '''OK''' button
* Save current world by selecting '''File → Save World''' option ('''{{Controls|Ctrl|S}} shortcut''') and save it somewhere inside your addon
 
[[Image:armareforger-new-prop-testing-subworld-creation.gif]]
 
After that, you can place prop prefab - i.e. ''PortableDesk_01_Sand.et'' - into the world and switch to '''Play mode'''. Once in play mode, you should be able to interact with the prop!
 
[[Image:armareforger-new-prop-testing-subworld-result.png]]
 
{{GameCategory|armaR|Modding|Tutorials|Assets}}

Latest revision as of 22:03, 2 March 2025

Retrieved from "https://community.bistudio.com/wiki?title=User:Reyhard/Sandbox&oldid=372972"