ScienceTechWorks • STW suite

STW/Clothes

A server-managed clothing and equipment catalog for Arma Reforger by Bohemia Interactive. It lets an administrator curate selected third-party clothing and equipment, then adds the enabled selection to US, USSR and FIA faction arsenals.

STW/Clothes works through the ordinary faction arsenal. It does not add a separate player menu, placeable object, or clothing content of its own.

STW suite connection

STW/Clothes is part of the STW suite by STW (ScienceTechWorks, sciencetechworks@gmail.com). It is designed to expose a deliberate, manageable selection of clothing and equipment supplied by the content mods already loaded by a server, without editing the original faction configurations.

STW Clothes Arsenal Refresh is the companion integration for dedicated multiplayer servers and remote clients. It refreshes arsenals after STW/Clothes has injected the selected items, so they display correctly. It is not normally needed for local single-player or a locally hosted Game Master session.

What STW/Clothes adds

On the server, STW/Clothes reads an active catalog and inserts each enabled, available entry into the item arsenal of the configured target factions. The default targets are US, USSR and FIA. Each entry can be excluded from individual factions and assigned an arsenal supply cost.

Content requirement: STW/Clothes does not manufacture clothing. A catalog entry can only be added when its prefab is available from Arma Reforger or another content mod loaded for the session. Missing or unsuitable entries are skipped.

For players

Players use the usual faction arsenal in the scenario. After the server has completed its startup injection, the enabled clothing and equipment chosen by the administrator appear in the normal arsenal for the relevant faction. There is no player-side configuration file or special STW/Clothes interaction.

On multiplayer clients, the server sends its injected catalog after the player connects. Items deliberately disabled globally or for that faction will not be added.

Game Master and scenario-author use

For a locally hosted Game Master session, prepare the profile catalog and restart the session after changing it. STW/Clothes injects into existing faction item catalogs; it does not require a Game Master placeable or a scenario prefab. Scenario authors normally only need to ensure the required clothing-content mods and STW/Clothes are loaded, then choose target faction keys that exist in their scenario.

Server setup

  1. Load STW/Clothes plus the clothing/equipment content mods whose prefabs you want to offer.
  2. For a dedicated multiplayer server or remote clients, also include STW Clothes Arsenal Refresh (ID 69F662416CF0D216). It is optional for local single-player and locally hosted Game Master use.
  3. Start the server once. The profile folder and its JSON files are created automatically.
  4. Use the Clothes Catalog Curator to create a small active selection from the master catalog, then replace the active catalog while the server is stopped.
  5. Restart the server. In Game Master, restart the session. The server injects the active selection and synchronizes it to joining clients.

The project documentation identifies the Arsenal Refresh companion above as the multiplayer refresh integration. No other named STW companion is required by STW/Clothes. Third-party clothing mods are only needed when their selected prefabs are present in your catalog.

Clothes Catalog Curator webpages

STW/Clothes intentionally starts with an empty active catalog so a very large clothing list does not slow the arsenal. Captain Sprocket’s recommended workflow is to use the curator to produce the selection your server actually needs.

Guide: Clothes Catalog Curator
Curator: Clothes Catalog Curator

  1. Start the server once, then stop it.
  2. Open the curator and choose STWClothesFull.json from the profile folder.
  3. Select the source mods to use and set category limits. Smaller choices generally open faster in multiplayer.
  4. Generate the reduced catalog. The browser downloads STWClothes.json.
  5. Copy that download into the profile folder, replacing the empty/current STWClothes.json, then restart.

The webpage does not modify the server directly; it only downloads the active catalog for the administrator to place in the profile folder.

Configuration

Live settings are stored in the server or hosted-session profile:

$profile:STW/Clothes/

$profile is the profile directory supplied when the server starts (for example, via its -profile parameter). Its exact disk location depends on the server installation; open that profile directory and look for STW/Clothes.

FileWhat it does
STWClothesConfig.jsonSystem settings: master enablement, defaults, batch handling, logging and target factions.
STWClothesFull.jsonThe complete master catalog copied from the packaged default on first start. Keep it unchanged for normal use; it is the source file for making new curated selections. An existing file is not replaced.
STWClothes.jsonThe active curated catalog actually injected into faction arsenals. A new installation creates it empty.
Safe editing routine: stop the server or end the Game Master session; make a backup copy; edit with a plain-text editor; preserve valid JSON; then restart. Do not edit during injection: the mod writes its current configuration and active catalog when injection finishes. If the active catalog is invalid, the mod logs a warning and uses an empty catalog for that load.

STWClothesConfig.json settings

SettingDefaultPlain-language behavior
enabledtrueMaster switch for catalog injection. Set false to leave STW/Clothes inactive.
defaultSupplyCost10Default cost for newly created catalog entries. The source clamps it to 010000.
itemsPerBatch12How many catalog entries are processed per injection batch. Valid stored values are clamped to 1100. Smaller values spread startup work across more batches.
batchDelayMilliseconds25Delay between injection batches, clamped to 01000. Larger values make injection take longer but distribute its work.
verboseLoggingfalseWhen true, writes detailed messages for individual additions and skipped entries to the server log.
targetFactionKeys["US", "USSR", "FIA"]Faction keys that receive enabled items. Use keys that exist in the running scenario; unavailable factions are skipped.

STWClothes.json item entries

The file contains an items array. Curator-generated entries use the following fields:

FieldMeaning
prefabFully qualified prefab path for the clothing/equipment item.
sourceModAddon root name recorded for catalog organization. The runtime does not use it as an automatic mod download or dependency installer.
enabledGlobal item switch; true by default. False retains the entry but prevents injection.
manualFallbackAllows runtime insertion when a suitable source arsenal entry cannot be found. Packaged assignments use true.
supplyCostCost applied to a runtime fallback entry; default 10.
disabledFactionKeysArray of factions that must not receive this otherwise enabled item; an empty array allows all configured target factions.
Captain Sprocket patch

Captain Sprocket community

Captain Sprocket
Arma Reforger server: STW Reforger
Community: https://discord.gg/T2AZp6GGMJ

Manual home: STW Online Manuals