Presets and themes

Presets #

ReferralTrack includes seven conservative starting profiles:

• survival
• lifesteal
• network
• discord-booster
• season-launch
• creator-code
• tebex

Run /referraltrack install <preset> to preview every value that would change. Preview mode is read-only. Apply the profile only with /referraltrack install <preset> confirm.

Before an approved install, ReferralTrack writes an exact copy of the current config.yml under plugins/ReferralTrack/backups/config-preset-<preset>-<UTC timestamp>.yml. The replacement is written through a temporary file and uses an atomic move where the operating system supports it. Database settings, credentials, tokens and webhook URLs are never part of a preset.

Each profile enables personal codes, delayed validation and fraud review, then selects conservative playtime, join-count, IP-cap, review-threshold and economy-reward defaults. It also adds a named attribution source. Operators should preview the values and adjust them for their own economy before enabling a production campaign.

Integration boundaries #

The discord-booster profile is a Discord-themed attribution profile. It does not install a Discord bot, create invites, grant roles or modify webhook credentials. ReferralTrack's optional webhook transport remains separately configured by the operator.

The tebex profile is a store-attribution profile. It does not connect to the Tebex API, consume Tebex webhooks or create coupons. No external store integration is claimed by the preset.

The network profile does not turn SQLite into shared storage. A network deployment must separately configure and verify MariaDB/MySQL, proxy routing and cross-server behavior.

Recovery #

To undo an install, stop the server, preserve the current file for diagnosis, copy the matching exact backup over config.yml, then start the server and run /referraltrack doctor. Do not restore only a fragment of the YAML because that can combine incompatible settings from two profiles.

Themes #

ReferralTrack includes three standalone interface themes:

• velor: magenta/cyan product identity and balanced default feedback.
• emerald: dark green growth-focused style with quieter effects.
• royal: blue/gold competitive style with challenge feedback.

Run /referraltrack theme to list them. /referraltrack theme <name> is a read-only preview and shows every affected configuration path. Apply only with /referraltrack theme <name> confirm.

A confirmed install writes an exact timestamped copy under plugins/ReferralTrack/backups/, applies the theme through a temporary file and reloads the live configuration. Themes change only visual and audio presentation: menu titles, filler materials, progress styling, progress/history materials and claim sound/particles. They never alter rewards, campaigns, database values, credentials, webhook URLs, permissions or stored referral data.

Themes are ordinary configuration after installation. Operators may customize every affected path; there is no runtime lock-in. Preview another theme before replacing those customizations.