Configuring content

This document describes what needs to be done to ensure your content appear within FF. For how to do that, refer to integrations.

Factions

Vanilla factions aren’t automatically playable in FF. See factions setup for details.

Items

There are three main aspects of an item configuration:

  • factions assignment - factions to which the item is related
  • shop attributes - item’s baseline price, available quantity, and other economic properties
  • item attributes - general properties of an item (is it illegal, can be used as a radio, etc.)

As much as possible, FF tries to figure out these properties automatically, based on various attributes that are present in the base game. However, for modded content, these properties are often skipped or misconfigured. That’s why some third party content works automatically, while other requires compatibility addons to be created.

All of these aspects are optional (but to ensure full usability, they should be all configured). You can see this page for detailed requirements of default shops.

Tip

If your items do not show up or function like you expect them to, see dev tools for instructions on how to check their effective configuration, and integrations for instructions on how to reconfigure it.

Weapons

In context of the shopping system, weapons are treated just like regular items. If you want custom weapons to be used by AI resistance fighters, they need to be configured as part of faction loadouts.

Vehicles

Any vehicle to be recognized and usable by FF needs to:

  • have FF vehicle attributes configured correctly
  • be assigned to at least one of the currently used factions

Vehicle attributes can be defined directly on the vehicle prefab, using JWK_VehicleAttributesComponent, or injected from an integration.

Faction assignment can be controlled by the faction config or be injected from an integration.

By default, FF factions will load assigned vehicles from a corresponding base game entity catalog. Vehicle attributes, however, must be configured explicitly, unless the prefab inherits one of the base game ones or the mod is created specifically for FF.

Tip

Missing vehicle attributes is the most common reason for vehicles not appearing in FF.

Ambient traffic

All properly configured vehicles will automatically appear in the ambient traffic. Vehicles assigned to AMBIENT faction will appear in any non-military areas, while vehicles assigned to PLAYER or ENEMY will appear in territories controlled by respective parties.

Procurement / import

Vehicle procurement / import is technically a shop, so the exact requirements depend on the specific shop type.