Unique ids
Choose how accounts get their UUIDs, and give one player a UUID of your choice.
Every account has a UUID that backend servers and other plugins see as the player's unique id. Identica assigns it when the account is created, and the account keeps it from then on, also when its username or provider changes.
Choosing a mode
identity.uniqueIdMode in settings.yml decides how new accounts get their UUID.
Choose before players register
Changing the mode does not change the UUIDs of existing accounts. Backend plugins store data under the UUID, so accounts created under different modes do not line up with what those plugins expect.
A new random UUID that belongs to Identica. It has nothing to do with the username or the provider.
This is the default and the recommended mode. Username changes and moves between providers never touch the UUID, so a player keeps their data on every backend.
RANDOM | OFFLINE | PREMIUM | |
|---|---|---|---|
| Recommended | Yes | No | No |
| Matches existing offline-mode data | No | Yes | No |
| Matches existing premium data | No | No | Yes |
| Works for every provider | Yes | Yes | Only providers that know a premium UUID |
Giving one player a chosen UUID
To give one player a particular UUID, such as their offline-mode UUID on a RANDOM network, reserve it for their username and let them register again:
/identica admin delete <username>, then/identica admin delete confirm, removes the current account. A deleted account's UUID is not kept./identica admin reservation set <username> <uuid>reserves the UUID. Usernames are compared without regard to case.- The player joins and registers within
identity.reservationTtl, 15 minutes by default. The new account gets the reserved UUID, and the reservation is used up.
/identica admin reservation info <username> shows the UUID reserved for a username, and /identica admin reservation delete <username> removes the reservation. In RANDOM and OFFLINE modes a reservation takes the place of the UUID the mode would assign; PREMIUM always assigns the premium UUID.
/identica admin clear <username> removes an account but reserves its UUID for its username, so the player keeps their UUID when they register again.
Accounts registered from the console with /identica credential register get the UUID reserved for their username as well, which is how accounts from another authentication plugin keep their UUIDs; see Coming from another plugin.