Packages
Directory Structure Overview
All packages are located in the packages/ folder in the main game folder.
Each package is in its own folder. The package ID is written in the .info file. Package resources are divided into two main sections based on usage principles.
global
Resources in the 'global' section are applied once upon application launch and when enabling/disabling packages in the game settings.
scene
Resources in the 'scene' section are applied before scene loading, when creating a new session or when connecting to a session.
Localization
Packages support localization. Localizable resources are placed in the .lang/ folders ("lang" is the language code, usually two characters).
Package property settings
Package properties are defined by parameters in the .info file, located at the root of the package folder.
id
Unique Package Identifier. This identifier is essential for distinguishing packages. If the package is related to Steam DLC or Steam Workshop, Steam automatically assigns the identifier. For packages created via the Settings interface, a unique identifier is automatically assigned. In all other scenarios, it is advisable to use a suitable GUID generator to create the identifier (for example, http://www.guidgen.com/).
legacy_id
During the assignment of a Steam DLC ID or Workshop ID to a package, the 'id' parameter is substituted with 'legacy_id'. The value for 'legacy_id' is sourced from the original 'id'. This substitution ensures that older references, such as save game links, continue to correctly identify the package.
name
Package Name. This is an optional parameter. If the package name is not specified, the system will use the name of the folder containing the package as the default. In the case of Steam downloadable content (DLC), this parameter is ignored.
author
Package author. Optional parameter. Displayed in the package properties.
order
Order in the list of packages. The value can be either positive or negative and influences the sequence in which packages are displayed in the settings. By default, the order is set to 0, positioning the package at the top of the list.
default_disabled
This option indicates that the package is disabled by default and remains so until the player enables it in Game Settings. If this option is not set, the package is considered enabled upon installation.
hidden
This parameter determines whether the package is visible in the game settings window. If it is not specified, the package will be visible by default.
dependency <package id>
Dependency on another package. The dependency parameter block can be repeated to establish multiple dependencies. Packages are processed in the order that the dependency blocks are specified.
incompatible <package id>
Used to specify the IDs of packages that are incompatible with this package. The game will disable any package with the specified ID when this package is activated.
min_core_version
The minimum game version with which the package is compatible. If this parameter is not specified, the corresponding check is absent.
max_core_version
The maximum game version with which the package is compatible. If this parameter is not specified, the corresponding check is absent.
delete_global
List of virtually deleted resources when the 'global' section is activated.
delete_scene
List of virtually deleted resources when the 'scene' section is activated.
activate_always
Forcibly loads the package in every session, regardless of scene requirements; may cause instability or desync in multiplayer.
activate_implicit
Marks the package for global loading when it modifies core gameplay systems or global rules (e.g., balance, UI, entity behavior). Recommended for use in the mod’s info file when the package introduces global changes that must be available across all scenes
always_activate_scene
Always activate the 'scene' section of this package if the 'global' section is active. By default, the 'scene' section is activated if a map from the 'global' section of this package is loaded.
always_activate_global
This parameter indicates that the package modifies global game settings. When this package is enabled, it is consistently marked in the list for creating a host, in game saves, and other relevant areas.
client_only
The package content is available only on the client, it is not loaded on the server and does not affect gameplay.
obsolete
Allows hiding package resources (objects and textures) in the lists of available resources in the editor.
hash
The hash parameter value allows for pre-determining that the package content is the same among different users and on the server when playing together. The hash parameter value is automatically updated when the package is published in the Workshop.
sign
Digital signature. Only for packages released by Best Way. Packages with such a signature do not allow any modification.
If the signature is not verified, the package is considered corrupted and not loaded.
token_count
The number of tokens that this package provides. Tokens can only be assigned to packages released by Best Way.
token_sign
Digital signature for tokens. If authenticity is not verified, the tokens are ignored.
Examples of package property parameters
{order -100}
Lower the package in the package list by 100 points
{order +4000}
Raise the package higher in the package list by 4000 points
{default_disabled}
Default state is disabled (the same as {default_disabled 1}
{hidden 0}
The package is displayed in the package list
{hidden}
The package is not visible in the package list (the same as {hidden 1}
{dependency "b86c6020-9b25-4659-bcdf-53b12715a0a1"}
The package depends on the package with ID "b86c6020-9b25-4659-bcdf-53b12715a0a1"
{delete_global "/map/single/2-fra" "/video/menu.avi"}
When loading the global section the folder /map/single/2-fra and file /video/menu.avi are ignored
{delete_scene "/entity/service/flag"}
When loading the scene section the entity "flag" from the folder /entity/service/ is ignored.
Last updated