addonscript-spec/docs/concepts/namespaces.md

26 lines
1.2 KiB
Markdown
Raw Normal View History

2022-02-16 23:27:55 +01:00
# Namespaces
2022-08-04 16:53:33 +02:00
Namespaces are used in conjunction with addon IDs to uniquely identify an addon.
## Format
Namespaces may only contain lowercase alphanumeric characters, hyphens (should be avoided) and dots.
They should be in a reversed domain name format. A namespace should specify the distribution source
(i.e. `com.example.repository`) or the author (i.e. `com.author.website`) of the addon and
optionally also the addon type (i.e. `com.example.repository.mods`, `com.author.website.modpacks`).
## Canonical Namespaces
While an addon can have multiple namespaces, it must have exactly one canonical
namespace, which is defined in the [addon object](../schema/addon.md#namespace).
2022-08-31 14:40:32 +02:00
An [API instance](../api/) must also return the canonical namespace of
the addon on the [addon endpoint](../api/features/addons.md#get-addon)
2022-08-04 16:53:33 +02:00
even if the addon was requested from another namespace. To check, if two addons
are the same addon, thier canonical namespace and their ID must be equal.
## Default Namespaces
2022-08-31 14:40:32 +02:00
Each [API instance](../api/) has a default namespace. Addons in the
2022-08-04 16:53:33 +02:00
repository of that API instance should have that namespace, as long as there
are no ID conflicts in the repository. The default namespace does not need
to be the canonical namespace of these addons.