Identica
OfficialPremium

Settings

Every setting of providers/Premium/settings.yml.

providers/Premium/settings.yml holds Premium's settings. Premium detection explains how the detection settings work together.

detection:
  methods:
    - LOOKUP
  recheckOnMismatch: false
  lookup:
    profileEndpoint: "https://api.mojang.com/users/profiles/minecraft/%s"
    timeout: "3s"
    cacheTtl: "5m"
profileSnapshotTtl: "10m"
replication:
  cache:
    profile: "premium-profile"
    profileSnapshot: "premium-profile-snapshot"

detection

methods

Takesa list of CLIENT_PROFILE and LOOKUP

Default["LOOKUP"]

Affectshow a player with a username not linked to any account is recognised as premium

Premium tries the methods from top to bottom. See Methods.

recheckOnMismatch

Takestrue or false

Defaultfalse

Affectswhether CLIENT_PROFILE looks a username up again, without the cache, when the client's profile id differs from the cached profile

lookup

How Premium looks up the premium profile of a username. Both detection methods and the provider choice of a registration that asks the player use it.

profileEndpoint

Advanced

Takesa URL with %s or {username} where the username goes

Default"https://api.mojang.com/users/profiles/minecraft/%s"

Affectswhere premium profiles are looked up

The endpoint answers with the profile as JSON with its id in an id field, or with 204 or 404 when the username has no profile. A blank value treats every username as having no premium profile.

timeout

Advanced

Takesa duration

Default"3s"

Affectshow long a lookup may take

A lookup that fails or times out treats the username as having no premium profile, and its answer is not cached. Zero or a negative value waits without limit.

cacheTtl

Takesa duration

Default"5m"

Affectshow long lookup answers are kept

Zero or a negative value looks every username up again.

profileSnapshotTtl

Takesa duration

Default"10m"

Affectshow long Premium remembers the premium profile it saw for a username

Zero or a negative value remembers nothing.

replication.cache

Advanced

The names under which Premium shares its lookups between proxies through replication. Every proxy of a network uses the same names.

profile

Takesa non-blank string

Default"premium-profile"

Affectsthe name of the shared lookup answers

profileSnapshot

Takesa non-blank string

Default"premium-profile-snapshot"

Affectsthe name of the shared profile snapshots

A blank value stops Premium from loading.

On this page