addonscript-spec/docs/schema/relation.md
Timo Ley 4e9571c3d5
All checks were successful
continuous-integration/drone/push Build is passing
continuous-integration/drone/pr Build is passing
Add links to relation
2022-03-03 21:35:59 +01:00

2.2 KiB

Relation Object

{
  "id": "othermod",
  "namespace": "com.example",
  "version": "[1.0]",
  "repositories": ["repo1"],
  "flags": [],
  "links": ["https://example.com/othermod.json", "./othermod.json"],
  "conditions": {}
}

Required properties

id

This is the ID of the addon this relation refers to.

Optional properties

namespace

This is the namespace of the related addon. This property will be implicitly equal to the namespace of the addon, if it was not set explicitly.

version

This is a maven version range that specifies, which versions of the related addon are targeted by this relation. You can either set this property or semver, but exactly one of them has to be set.

semver

This is a semver version range of supported versions of this relation. It will only allow versions of the related addon, which have a valid semver version number, which is in this range.

repositories

This is an array of repository IDs. These are the repositories, from which AddonScript should try to get this relation from, in the order as they are specified in the array. If this property is not set or the array is empty, AddonScript will try to resolve the relation by the namespace from all defined repositories.

flags

This is an array of flags for this relation. If this property is not present in a relation object, the relation will use the default flags.

This is an array of links, which are pointing to an AddonScript JSON file, that contains the related addon. When resolving relations, AddonScript should try to getthe related addon from the first link in this array. If the link doesn't work or the version of the linked addon is not in the version range of this relation, the next link should be tried or, if there is no link left, the addon should be resolved from the repositories

conditions

This is a conditions object. It can only be used, if the optional flag was set.