Capture & Hold Setup – Arma Reforger
Pr9inichek (talk | contribs) m (Add / and ArmaReforger for clearly understanding) |
|||
(18 intermediate revisions by 2 users not shown) | |||
Line 2: | Line 2: | ||
Setting up a new '''Capture & Hold''' scenario based is easy, thanks to the Prefab system and already existing '''base world''' available as part of the Capture & Hold mod. | Setting up a new '''Capture & Hold''' scenario based is easy, thanks to the Prefab system and already existing '''base world''' available as part of the Capture & Hold mod. | ||
{{GVI|armaR|1.2.1}} '''Capture & Hold''' is now packed in base game ({{Link/Enfusion|armaR|worlds/CaptureAndHold/CAH_BaseWorld.ent}}) instead of the official mod. | |||
== Creation Steps == | == Creation Steps == | ||
* Open Arma Reforger Tools. If this is not visible in your Steam Library, activate tools in the filter. | * Open Arma Reforger Tools. If this is not visible in your Steam Library, activate "tools" in the filter. | ||
* Click on "Create New" | * Click on "Create New" | ||
* Give a good Project Name like "CAH The Cowshed by xyz" so that people can search | * Give a good Project Name like "CAH The Cowshed by xyz" so that people can search for it and also directly understand what this is about. | ||
=== Initial Setup === | === Initial Setup === | ||
Start by opening the | Start by opening the Workbench and launch the World Editor from either the Quick Launch screen or Editors context menu. | ||
<gallery widths="600" heights="400" perrow="1"> | <gallery widths="600" heights="400" perrow="1"> | ||
File:armareforger-cah 01 baseworld.jpg|'''1.''' Navigate to {{hl| | File:armareforger-cah 01 baseworld.jpg|'''1.''' Navigate to {{hl|Worlds/CaptureAndHold}} and open one of the following world files (world icon): the '''CAH_BaseWorld.ent''' for Everon or '''CAH_BaseWorld_Arland.ent''' for Arland. | ||
File:armareforger-cah 02 newworld.jpg|'''2.''' In the '''File''' context menu, select the '''New World''' option. | File:armareforger-cah 02 newworld.jpg|'''2.''' In the '''File''' context menu, select the '''New World''' option. | ||
File:armareforger-cah 03 subscene.jpg|'''3.''' Make sure that the '''Sub-scene (of current world)''' option is selected in the dialog. | File:armareforger-cah 03 subscene.jpg|'''3.''' Make sure that the '''Sub-scene (of current world)''' option is selected in the dialog. | ||
File:armareforger-cah 04 saveas.jpg|'''4.''' In the '''File''' context menu select the '''Save World As''' option and pick the scenario's save destination. | File:armareforger-cah 04 saveas.jpg|'''4.''' In the '''File''' context menu select the '''Save World As''' option and pick the scenario's save destination. | ||
File:armareforger-cah 05 save dir.jpg|'''4bis.''' In our case, we select the root directory. '''TODO Add info that need to create folder Worlds and save file .ent in that folder''' | File:armareforger-cah 05 save dir.jpg|'''4bis.''' In our case, we select the root directory. '''TODO Add info that need to create folder Worlds and save file .ent in that folder''' | ||
File:armareforger-cah 06 location.jpg|'''5.''' Find a suitable scenario location. In our example, we chose St Philippe. | File:armareforger-cah 06 location.jpg|'''5.''' Find a suitable scenario location. In our example, we chose St Philippe. | ||
</gallery> | </gallery> | ||
=== Scenario Setup === | === Scenario Setup === | ||
Drag and drop the following elements from the Resource Browser | {{Note|text=By creating a sub-world of an existing CAH world you are already adding some elements to the world:}} | ||
File:armareforger-cah 07 gamemode.jpg|'''1.''' From {{hl| | [[File:Reforger CAH Base World.png|none|thumb|468x468px]] | ||
File:armareforger-cah 08 managers.jpg|'''2.''' From {{hl| | |||
File:armareforger-cah 09 area.jpg|'''3.''' From {{hl| | Continue to place the required elements to your world. | ||
Drag and drop the following elements from the Resource Browser:<gallery widths="600" heights="400" perrow="1"> | |||
File:armareforger-cah 07 gamemode.jpg|'''1.''' From {{hl|Prefabs/MP/Modes/CaptureAndHold}} drag {{hl|GameMode_CaptureAndHold.et}} | |||
File:armareforger-cah 08 managers.jpg|'''2.''' From {{hl|Prefabs/MP/Managers/Factions}} drag the {{hl|FactionManager_USxUSSR.et}} and from {{hl|Prefabs/MP/Managers/Loadouts}} drag the {{hl|LoadoutManager_USxUSSR.et}} | |||
File:armareforger-cah 09 area.jpg|'''3.''' From {{hl|Prefabs/MP/Modes/CaptureAndHold/Areas}} drag {{hl|CaptureAndHoldArea_Major.et}} | |||
File:armareforger-cah 10 area setup.jpg|'''4.''' While the '''SCR_CaptureAndHoldArea''' entity is still selected, adjust the shape as desired. | File:armareforger-cah 10 area setup.jpg|'''4.''' While the '''SCR_CaptureAndHoldArea''' entity is still selected, adjust the shape as desired. | ||
File:armareforger-cah 11 spawns.jpg|'''5.''' From {{hl| | File:armareforger-cah 11 spawns.jpg|'''5.''' From {{hl|Prefabs/MP/Spawning}} drag {{hl|SpawnPoint_US.et}} and {{hl|SpawnPoint_USSR.et}} <br>'' | ||
</gallery> | </gallery> | ||
'''Note:''' The GarbageManager is not necessary anymore. | |||
Now '''save''' the scenario and proceed. | Now '''save''' the scenario and proceed. | ||
Line 49: | Line 44: | ||
=== System Test === | === System Test === | ||
<gallery mode="traditional" widths=600px heights=400px perrow=1> | <gallery mode="traditional" widths="600px" heights="400px" perrow="1"> | ||
File:armareforger-cah_12_play.jpg|'''1.''' Make sure that the '''Play from camera position''' option is disabled and press the '''Play''' button. | File:armareforger-cah_12_play.jpg|'''1.''' Make sure that the '''Play from camera position''' option is disabled and press the '''Play''' button. | ||
File:armareforger-cah_13_test.jpg|'''2.''' Verify that the scenario is working as intended - capture points, respawn, etc. Drawing of the area trigger can help visualising its coverage. | File:armareforger-cah_13_test.jpg|'''2.''' Verify that the scenario is working as intended - capture points, respawn, etc. Drawing of the area trigger can help visualising its coverage. | ||
Line 57: | Line 52: | ||
Once done, save your changes once more and close the World Editor. | Once done, save your changes once more and close the World Editor. | ||
{{Feature|informative|It is highly recommended to use | {{Feature|informative|It is highly recommended to use {{Name|bi}}-prepared scenarios for inspiration and usage examples of individual features and components available in {{armaR}}.}} | ||
=== Scenario Header === | === Scenario Header === | ||
Line 67: | Line 62: | ||
In the Resource Browser find your mod root directory and create a "Missions" directory inside. | In the Resource Browser find your mod root directory and create a "Missions" directory inside. | ||
<gallery mode="traditional" widths=600px heights=400px perrow=1> | <gallery mode="traditional" widths="600px" heights="400px" perrow="1"> | ||
File:armareforger-cah_15_new_missionheader.jpg|'''1.''' {{Controls|RMB}} in your directory and select Create Resource → Config File in the context menu. | File:armareforger-cah_15_new_missionheader.jpg|'''1.''' {{Controls|RMB}} in your directory and select Create Resource → Config File in the context menu. | ||
File:armareforger-cah_16_missionheader_class.jpg|'''2.''' Pick a name for your Mission Header and then select the {{hl|SCR_MissionHeader}} class from the list. | File:armareforger-cah_16_missionheader_class.jpg|'''2.''' Pick a name for your Mission Header and then select the {{hl|SCR_MissionHeader}} class from the list. | ||
Line 76: | Line 71: | ||
In the '''World''' field, navigate to and select the world file. In our example it is the {{hl|MyScenario.ent}} in the mod's root directory. | In the '''World''' field, navigate to and select the world file. In our example it is the {{hl|MyScenario.ent}} in the mod's root directory. | ||
<gallery mode="traditional" widths=600px heights=400px perrow=1> | <gallery mode="traditional" widths="600px" heights="400px" perrow="1"> | ||
File:armareforger-cah_17_missionheader_edit.jpg|'''1.''' Fill in remaining fields as desired then save the file. | File:armareforger-cah_17_missionheader_edit.jpg|'''1.''' Fill in remaining fields as desired then save the file. | ||
</gallery> | </gallery> | ||
Line 84: | Line 79: | ||
Launching {{armaR}} with this newly created mod enabled should allow you to see the and launch the scenario directly: | Launching {{armaR}} with this newly created mod enabled should allow you to see the and launch the scenario directly: | ||
<gallery mode="traditional" widths=600px heights=400px perrow=1> | <gallery mode="traditional" widths="600px" heights="400px" perrow="1"> | ||
File:armareforger-cah_18_scenarios.jpg|'''1.''' Navigate to '''Scenarios'''. | File:armareforger-cah_18_scenarios.jpg|'''1.''' Navigate to '''Scenarios'''. | ||
File:armareforger-cah_19_result.jpg|'''2.''' Verify that your scenario is working as intended. | File:armareforger-cah_19_result.jpg|'''2.''' Verify that your scenario is working as intended. | ||
Line 97: | Line 92: | ||
Last, but not least is to '''publish''' the mod in the Bohemia Interactive Workshop for other people to see and play! | Last, but not least is to '''publish''' the mod in the Bohemia Interactive Workshop for other people to see and play! | ||
Important: Until your | Important: Until your masterpiece has been tested, you should use Visibility: "Private" (only for you) or "Test" (Test mod category that can be enabled in the Workbench filter). | ||
{{Feature|informative|See | {{Feature|informative|See {{Link|Arma Reforger:Mod Publishing Process}}.}} | ||
===Additional Information | === Additional Settings Information === | ||
This is added as additional information so that you get up and running with a simple version first and then start worrying about the details. | This is added as additional information so that you get up and running with a simple version first and then start worrying about the details. | ||
====Score Ending==== | ==== Score Ending ==== | ||
*Hierarchy Window: Select the object "GameMode_CaptureAndHold" | * Hierarchy Window: Select the object "GameMode_CaptureAndHold" | ||
* Object Properties: Select "SCR_ScoringSystemComponent" | * Object Properties: Select "SCR_ScoringSystemComponent" | ||
*In the settings for "Scoring:Actions" change the Score Limit[[File:CAH Score.png|none|thumb|Set the score to end the CAH game.]] | * In the settings for "Scoring:Actions" change the Score Limit [[File:CAH Score.png|none|thumb|Set the score to end the CAH game.]] | ||
====Time Ending==== | ==== Time Ending ==== | ||
*Hierarchy Window: Select the object "GameMode_CaptureAndHold" | * Hierarchy Window: Select the object "GameMode_CaptureAndHold" | ||
*Object Properties: Select "SCR_CaptureAndHoldManager" | * Object Properties: Select "SCR_CaptureAndHoldManager" | ||
*In the settings for "End Game Duration" change the value which is given in seconds | * In the settings for "End Game Duration" change the value which is given in seconds | ||
[[File:CAH Duration.png|none|thumb]] | [[File:CAH Duration.png|none|thumb]] | ||
====Scoring: Multipliers==== | ==== Scoring: Multipliers ==== | ||
You can adjust several actions so that they will have a bigger impact on the game / scoring. | You can adjust several actions so that they will have a bigger impact on the game / scoring. | ||
[[File:CAH Score Multipliers.png|none|thumb]] | [[File:CAH Score Multipliers.png|none|thumb]] | ||
====Kill Feed==== | ==== Kill Feed ==== | ||
It can be thrilling to leave the default values for this but for some communities the fun starts when they get more details in the "Kill Feed". | It can be thrilling to leave the default values for this but for some communities the fun starts when they get more details in the "Kill Feed". | ||
Line 127: | Line 122: | ||
[[File:CAH Kill Feed.png|none|thumb]] | [[File:CAH Kill Feed.png|none|thumb]] | ||
====Activate Unconsciousness==== | ==== Activate Unconsciousness ==== | ||
If you want to use it, you must activate it in the GameMode_CaptureAndHold. By default it is deactivated: | If you want to use it, you must activate it in the GameMode_CaptureAndHold. By default it is deactivated: | ||
[[File:capture-and-hold unconsciousness.png|none|thumb]] | [[File:capture-and-hold unconsciousness.png|none|thumb]] | ||
=== | ==== Spawn-Areas - No-Go Zone - Death Zone ==== | ||
You don't want the enememy to get too close to your spawn point? Simple: Use the spawn areas. | |||
[[File:CAH CAH-Zone.png|none|thumb|567x567px]] | |||
==== GarbageManager - Delete bodies from map ==== | |||
2024-03 This got disabled for now and is not available - might come back so this documentation stays. | |||
If you are annoyed of too many bodies in your CAH areas, you need to make these adjustments: | |||
[[File:ReforgerGarbageConfigCAH.png|none|thumb|1016x1016px]] | |||
# Select your instance of CAH GameMode | |||
# Select {{hl|SCR_BaseGameMode}} | |||
# Scroll down and select "Garbage System Config" and click on the search icon | |||
# Select "Override" in the right mouse button menu for GarbageSystem.conf | |||
This will create a copy of the locked file into your scenario folder so that you are able to edit it. | |||
The system will automatically open the new folder: | |||
[[File:reforger-garbage-config-2.png|none|thumb|503x503px]] | |||
Open the file and edit it. | |||
{{Feature|important|Only the classes which are defined will be deleted.}} | |||
This example shows how dead bodies are deleted after 180 seconds when player are further away than 3 meters. | |||
[[File:reforger-garbage-config-3.png|none|thumb|798x798px]] | |||
# Add a new class filter | |||
# Select "only destroyed" | |||
# Define Lifetime and the distance a living player has to have when the class is deleted. | |||
=== Common Issues === | |||
==== Can't initialize the game (World Editor won't start)==== | ==== Can't initialize the game (World Editor won't start) ==== | ||
"World Editor and some other game depended features will not be available. But rest of workbench will be functional." | "World Editor and some other game depended features will not be available. But rest of workbench will be functional." | ||
[[File:world-editor-does-not-start.jpg|none|thumb|485x485px]] | [[File:world-editor-does-not-start.jpg|none|thumb|485x485px]] | ||
'''Solution:''' Delete the official CAH from "... \My Games\ArmaReforger\addons". If the error remains, delete all addons. | |||
==== Editor crashes when using the garbage collector ==== | |||
'''Solution:''' Do not use it. A developer stated said that it is not needed anymore. | |||
==== Repair your C&H scenario after version 1 of Arma Reforger ==== | |||
Sadly, with version 1 of {{armaR}} all Capture And Hold Scenarios have to be repaired and re-published. | |||
* Open your scenario. | |||
* Accept this message with "Yes".[[File:cah-repair-message2023-12-26 15 07 30-Window.png|none|thumb]]Place a new CaptureAndHold area as described above since it was removed while validating. Do not worry about the Garbage Collector: It is gone for good. | |||
==== Repair your C&H scenario after version 1.2 of Arma Reforger ==== | |||
With version 1.2 the official Capture And Hold Scenario was implemented in the game and you have to remove the dependency from your scenario and re-publish it. | |||
* Without opening Reforger Tools: | |||
** Edit the addon.gproj from the main directory of your scenario | |||
** Remove the Dependency "591AF5BDA9F7CE8B". A corrected version without any other mods will look like this: <syntaxhighlight lang="json"> | |||
Dependencies { | |||
"58D0FB3206B6F859" | |||
} | |||
</syntaxhighlight> | |||
Save and open your scenario: | |||
* Publish | |||
* If there are errors or problems selecting a Category: Don't give up - try again. Restart Workbench. | |||
{{GameCategory|armaR|Modding|Tutorials|Scenario}} | After you have fixed your scenario, it is important to delete the official Capture&Hold from .<var>%userprofile%\Documents\My Games\ArmaReforger\addons\CaptureAMPHold_591AF5BDA9F7CE8B</var> Otherwise Reforger will run into errors. CAUTION: Move the official Capture&Hold to a safe location, as you will need to copy it back for adjustments to other maps. {{GameCategory|armaR|Modding|Tutorials|Scenario}} |
Latest revision as of 11:26, 3 January 2025
Setting up a new Capture & Hold scenario based is easy, thanks to the Prefab system and already existing base world available as part of the Capture & Hold mod.
1.2.1 Capture & Hold is now packed in base game (worlds/CaptureAndHold/CAH_BaseWorld.ent) instead of the official mod.
Creation Steps
- Open Arma Reforger Tools. If this is not visible in your Steam Library, activate "tools" in the filter.
- Click on "Create New"
- Give a good Project Name like "CAH The Cowshed by xyz" so that people can search for it and also directly understand what this is about.
Initial Setup
Start by opening the Workbench and launch the World Editor from either the Quick Launch screen or Editors context menu.
Scenario Setup
- Date unknown
- By creating a sub-world of an existing CAH world you are already adding some elements to the world:
Continue to place the required elements to your world.
Drag and drop the following elements from the Resource Browser:
Note: The GarbageManager is not necessary anymore.
Now save the scenario and proceed.
System Test
Once done, save your changes once more and close the World Editor.
Scenario Header
To launch the scenario in-game a Scenario header (named MissionHeader) config must be created.
Exit the World Editor and return to the Resource Browser.
In the Resource Browser find your mod root directory and create a "Missions" directory inside.
Open the newly created Mission Header config.
In the World field, navigate to and select the world file. In our example it is the MyScenario.ent in the mod's root directory.
In-Game Test
Launching Arma Reforger with this newly created mod enabled should allow you to see the and launch the scenario directly:
Publish it to the Workshop
Now that the scenario can be launched from the game, only a few things remain. Testing the scenario in multiplayer is important, making sure that there are enough spawn points and other gameplay details.
Last, but not least is to publish the mod in the Bohemia Interactive Workshop for other people to see and play!
Important: Until your masterpiece has been tested, you should use Visibility: "Private" (only for you) or "Test" (Test mod category that can be enabled in the Workbench filter).
Additional Settings Information
This is added as additional information so that you get up and running with a simple version first and then start worrying about the details.
Score Ending
- Hierarchy Window: Select the object "GameMode_CaptureAndHold"
- Object Properties: Select "SCR_ScoringSystemComponent"
- In the settings for "Scoring:Actions" change the Score Limit
Time Ending
- Hierarchy Window: Select the object "GameMode_CaptureAndHold"
- Object Properties: Select "SCR_CaptureAndHoldManager"
- In the settings for "End Game Duration" change the value which is given in seconds
Scoring: Multipliers
You can adjust several actions so that they will have a bigger impact on the game / scoring.
Kill Feed
It can be thrilling to leave the default values for this but for some communities the fun starts when they get more details in the "Kill Feed".
With this setting there will be no secrets about who was eliminated by whom.
Activate Unconsciousness
If you want to use it, you must activate it in the GameMode_CaptureAndHold. By default it is deactivated:
Spawn-Areas - No-Go Zone - Death Zone
You don't want the enememy to get too close to your spawn point? Simple: Use the spawn areas.
GarbageManager - Delete bodies from map
2024-03 This got disabled for now and is not available - might come back so this documentation stays. If you are annoyed of too many bodies in your CAH areas, you need to make these adjustments:
- Select your instance of CAH GameMode
- Select SCR_BaseGameMode
- Scroll down and select "Garbage System Config" and click on the search icon
- Select "Override" in the right mouse button menu for GarbageSystem.conf
This will create a copy of the locked file into your scenario folder so that you are able to edit it.
The system will automatically open the new folder:
Open the file and edit it.
This example shows how dead bodies are deleted after 180 seconds when player are further away than 3 meters.
- Add a new class filter
- Select "only destroyed"
- Define Lifetime and the distance a living player has to have when the class is deleted.
Common Issues
Can't initialize the game (World Editor won't start)
"World Editor and some other game depended features will not be available. But rest of workbench will be functional."
Solution: Delete the official CAH from "... \My Games\ArmaReforger\addons". If the error remains, delete all addons.
Editor crashes when using the garbage collector
Solution: Do not use it. A developer stated said that it is not needed anymore.
Repair your C&H scenario after version 1 of Arma Reforger
Sadly, with version 1 of Arma Reforger all Capture And Hold Scenarios have to be repaired and re-published.
- Open your scenario.
- Accept this message with "Yes".Place a new CaptureAndHold area as described above since it was removed while validating. Do not worry about the Garbage Collector: It is gone for good.
Repair your C&H scenario after version 1.2 of Arma Reforger
With version 1.2 the official Capture And Hold Scenario was implemented in the game and you have to remove the dependency from your scenario and re-publish it.
- Without opening Reforger Tools:
- Edit the addon.gproj from the main directory of your scenario
- Remove the Dependency "591AF5BDA9F7CE8B". A corrected version without any other mods will look like this:
Dependencies { "58D0FB3206B6F859" }
Save and open your scenario:
- Publish
- If there are errors or problems selecting a Category: Don't give up - try again. Restart Workbench.
After you have fixed your scenario, it is important to delete the official Capture&Hold from .%userprofile%\Documents\My Games\ArmaReforger\addons\CaptureAMPHold_591AF5BDA9F7CE8B Otherwise Reforger will run into errors. CAUTION: Move the official Capture&Hold to a safe location, as you will need to copy it back for adjustments to other maps.