addonscript-spec/docs/schema/meta.md

92 lines
1.9 KiB
Markdown
Raw Normal View History

2021-06-23 22:06:21 +02:00
# Meta Object
2021-11-14 00:37:29 +01:00
```json
2021-11-13 20:47:21 +01:00
{
2021-11-14 00:37:29 +01:00
"addon": {
"name": "My cool addon name",
"icon": "./icon.png",
"description": "./README.md",
"summary": "My Addon",
"website": "https://example.com",
"source": "https://gitea.com/user/myaddon",
"issues": "https://gitea.com/user/myaddon/issues",
2022-01-29 17:45:11 +01:00
"type": "mod",
"contributors": [{"name": "Alice", "email": "alice@example.com"}, {"name": "Bob", "email": "bob@example.com"}]
2021-11-14 00:37:29 +01:00
},
"version": {
"changelog": "./CHANGELOG.md",
"timestamp": 1594753200
},
"additional": {}
2021-11-13 20:47:21 +01:00
}
```
## Optional properties
2021-11-14 00:17:32 +01:00
### addon
2021-11-14 00:37:29 +01:00
2021-11-14 00:17:32 +01:00
An [addon mata](#addon-meta-object) object.
2021-11-13 20:47:21 +01:00
2021-11-14 00:17:32 +01:00
### version
2021-11-14 00:37:29 +01:00
2021-11-14 00:17:32 +01:00
A [version mata](#version-meta-object) object.
### additional
2021-11-14 00:37:29 +01:00
2021-11-14 00:17:32 +01:00
This object can contain any arbitrary data,
# Addon Meta Object
## Optional Properties
### name
2021-11-14 00:37:29 +01:00
The full, human-readable name of the addon. This is what a program such as a launcher SHOULD
2021-11-14 00:17:32 +01:00
display to the user.
### icon
2021-11-14 00:37:29 +01:00
A [link](../concepts/links.md) to the icon of the addon. This path SHOULD point to an image file of small resolution
which is ideally square. It MAY be dispayed to users in programs.
2021-11-14 00:17:32 +01:00
### description
2021-11-14 00:37:29 +01:00
A [link](../concepts/links.md) to a description file for the addon. The file SHOULD be in CommonMark markdown.
2021-11-14 00:17:32 +01:00
### summary
2021-11-14 00:37:29 +01:00
2021-11-14 00:17:32 +01:00
A short description of the addon, to be shown in lists and menus where the addon is shown aside others.
### website
2021-11-14 00:37:29 +01:00
2021-11-14 00:17:32 +01:00
A URL to a website about the addon
### source
2021-11-14 00:37:29 +01:00
2021-11-14 00:17:32 +01:00
A URL to the source code of the addon.
### issues
2021-11-14 00:37:29 +01:00
2021-11-14 00:17:32 +01:00
A URL to an issue tracker for the addon.
2022-01-29 17:45:11 +01:00
### type
The type of the addon, for example `mod`, `modpack` or `resourcepack`.
2021-11-14 00:17:32 +01:00
### contributors
2021-11-14 00:37:29 +01:00
An array of people who have contributed to the addon. Each contributor is represented by an object, which
MUST have a `name` and a `email` property.
2021-11-14 00:17:32 +01:00
# Version Meta Object
## Optional properties
### changelog
2021-11-14 00:37:29 +01:00
2022-02-26 12:27:59 +01:00
A [link](../concepts/links.md) to a changelog file for the addon.
2021-11-14 00:17:32 +01:00
### timestamp
2021-11-14 00:37:29 +01:00
2021-11-14 00:17:32 +01:00
A unix timestamp of the time and date of the version's release.