Difference between revisions of "Documentation/Engine/Units/package version info"

From SCS Modding Wiki
Jump to navigation Jump to search
m (Attributes)
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
'''Package version info''' is a [[Documentation/Engine/Units|unit]] containing workshop mod package information, such as the name of the folder or archive with content and the array of compatible game versions. It is used in each workshop mod's [[Documentation/Tools/SCS_Workshop_Uploader/versions.sii|versions.sii]].
+
Package version info is unit containing version informations such like name of the folder or archive with content and the array of compatible game versions.
  
== Special Case: Universal Version ==
+
The package version info without defined compatible_versions is called universal version. This version will be used for all game versions that are not explictly defined inside versions.sii file.
Each workshop mod's versions.sii file may have a ''single'' package version info without any defined compatible_versions, called the “universal version.” The associated package will be used for all game versions that are not defined by another package version info unit inside the versions.sii file.
+
 
 +
'''package_version_info unit attributes:'''
  
== Attributes ==
 
 
{| class="wikitable"
 
{| class="wikitable"
 +
!|Type
 
!|Name
 
!|Name
!|[[Documentation/Engine/Units#Attribute_types|Type]]
 
!|Required/Optional
 
 
!|Description
 
!|Description
 
|-
 
|-
 +
|string
 
|package_name
 
|package_name
|style="text-align:center;"|string
+
|The name of the folder or archive with the version-specific mod content. This is required attribute.
|style="text-align:center;"|Required
 
|The name of the folder or archive with the version-specific mod content. For zip archives, package_name is just the file name without the extension.
 
 
|-
 
|-
 +
|string array
 
|compatible_versions
 
|compatible_versions
|style="text-align:center;"|string array
+
|The array containg set of versions that are compatible with this version definition. This attribute is optional, if not specified this version will be used for all of the game versions - you can only have one `package_version_info` with this parameter not specified in versions.sii
|style="text-align:center;"|Optional
 
|The array containing the set of versions that are compatible with this version definition. If not specified this package will be used for all of the game versions not explicitly defined for other packages. <BR />'''Important:''' Each workshop mod's versions.sii can only contain ''one'' `package_version_info` unit without this parameter specified.
 
|-
 
|informational
 
|style="text-align:center;"|bool
 
|style="text-align:center;"|Optional
 
|When true, it indicates that the package contains information only. If unspecified, it defaults to false.
 
 
|}
 
|}
 
{{UnitDef|def=<nowiki>  "package_version_info":{
 
  "superclass":"unit",
 
  "attrs":{
 
    "package_name":{
 
    "type": "string"
 
    },
 
    "compatible_versions":{
 
    "type": "string_array"
 
    },
 
    "informational":{
 
    "type": "bool"
 
    }
 
  }</nowiki>}}
 
 
== See Also ==
 
[[Tutorials/SCS_Workshop_Uploader/How_to_use_mod_versioning|Tutorial: How to Use Mod Versioning]]
 

Revision as of 09:26, 16 February 2016

Package version info is unit containing version informations such like name of the folder or archive with content and the array of compatible game versions.

The package version info without defined compatible_versions is called universal version. This version will be used for all game versions that are not explictly defined inside versions.sii file.

package_version_info unit attributes:

Type Name Description
string package_name The name of the folder or archive with the version-specific mod content. This is required attribute.
string array compatible_versions The array containg set of versions that are compatible with this version definition. This attribute is optional, if not specified this version will be used for all of the game versions - you can only have one `package_version_info` with this parameter not specified in versions.sii