addonscript-spec/docs/schema/addon.md
2021-11-14 00:18:00 +01:00

59 lines
1.4 KiB
Markdown

# Addon Object
``` json
{
"addonscript": {},
"id": "myaddon",
"namespace": "com.example",
"version": "1.0.0",
"files": [],
"relations": [],
"flags": ["server", "client"],
"repositories": [],
"meta": {}
}
```
## Required properties
### addonscript
This is an [AddonScript object](addonscript.md) containing information about the version of AddonScript used in this file.
### id
This is the ID of the addon.
It should be written in the `kebab-case` format, meaning lowercase only and using `-` instead of spaces.
### version
This is the version number of this version. It must follow [semver versioning specifications](https://semver.org/spec/v2.0.0.html),
as they are used to compare versions.
## Optional properties
### namespace
The namespace of the addon in a reverse-DNS format. Used to identify addons across repositories, if it is present.
### files
This is an array of [file objects](file.md) including the files belonging to this addon.
### relations
This is an array of [relation objects](relation.md) which represent addons in relation to this one.
### flags
This is an array of [flags](../flags.md) for this version.
### repositories
This is an array of [repository objects](repository.md). Each repository object defines one repository from which files or
addons can be retrieved.
### meta
This is a [meta object](meta.md) containing metadata about the addon.