addonscript-spec/docs/concepts/flags.md

39 lines
2.1 KiB
Markdown
Raw Normal View History

2021-07-30 13:42:43 +02:00
# Flags
## Side flags
2022-02-16 23:27:55 +01:00
These are flags, which specify, for which side a [version](../schema/addon.md), a [file](../schema/file.md) or
2022-06-08 19:44:19 +02:00
a [relation](../schema/relation.md) was made. If a file has no side flags set, it will inherit them from the
[version object](../schema/addon.md), while a version is required to have side flags set.
2021-07-30 13:42:43 +02:00
- `client` This flag specifies, that the version, relation or file can be installed on the client side
- `server` This flag specifies, that the version, relation or file can be installed on the server side
## Version flags
2022-02-16 23:27:55 +01:00
These are flags, which can be set for [versions](../schema/addon.md).
2021-07-30 13:42:43 +02:00
2021-11-14 00:25:43 +01:00
- `instance` This flag specifies, that this is a version of an instance addon. Instance addons represent instances of
Minecraft itself, while non-instance addons have to be installed into an existing instance of Minecraft.
2021-07-30 13:42:43 +02:00
## Relational flags
2022-02-16 23:27:55 +01:00
These are flags, which describe the relation between the addon and [related addons](../schema/relation.md)
or [files](../schema/file.md).
2021-07-30 13:42:43 +02:00
- `required` This flag specifies, that the related addon or file is required for the addon. If the addon gets installed,
2021-11-14 00:25:43 +01:00
than any relation or file, which has this flag set, also has to be installed.
2021-07-30 13:42:43 +02:00
- `optional` This flag specifies, that the related addon or file is optional for this addon. If the addon gets installed,
the user should be able to choose, whether he wants to install the relation or file with this flag, or not.
2021-07-30 13:42:43 +02:00
### Relation specific
2022-02-16 23:27:55 +01:00
These are relational flags, which can only be used for [relations](../schema/relation.md).
2021-07-30 13:42:43 +02:00
- `included` This flag specifies, that the related addon is included in this one. This also means, that if some
2021-11-14 00:25:43 +01:00
addon requires the related addon, it can also be installed with this addon instead.
2021-07-30 13:42:43 +02:00
- `incompatible` This flag specifies, that the related addon is incompatible to this one. This means, that they can't
2021-11-14 00:25:43 +01:00
be installed together in the same instance.
2021-07-30 13:42:43 +02:00
- `launch` This flag specifies, that the related addon should take care of the Minecraft launch process. It can only
2021-11-14 00:25:43 +01:00
be used, if both this and the related addon are instance addons.