addonscript-spec/docs/concepts/flags.md

40 lines
2.2 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,
2021-11-14 00:25:43 +01:00
the user should be able to choose, whether he wants to install the relation or file with this flag, or not. This flag
2022-02-16 23:27:55 +01:00
can be used in combination with the [conditions](../schema/conditions.md) property.
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.