Skip to content

Keysystem Configuration

Configure checkpoints, key duration, captcha, security, and theming via the dashboard. All settings are available under Project → Keysystem or Ads in the dashboard.


SettingTypeDefaultDescription
providerstringwork.inkPrimary ad provider
checkpoint_countnumber2Number of ad checkpoints
checkpoint_duration_minutesnumber1Duration per checkpoint
captcha_enabledbooleantrueCaptcha verification before checkpoints
key_duration_hoursnumber24Hours until generated key expires
allow_key_extensionbooleanfalseAllow users to extend keys
allow_forgettingbooleantrueAllow users to “forget” and redo flow
block_vpnbooleanfalseBlock VPN/proxy IPs
require_discord_oauthbooleanfalseRequire Discord sign-in

SettingTypeDescription
theme_presetstringPreset name (e.g., default, dark, light)
theme_configJSONCustom theme overrides
custom_logo_urlstringLogo image URL
custom_background_urlstringBackground image URL

SettingTypeDescription
welcome_messagestringMessage when user lands on page
completion_messagestringMessage when key is generated
checkpoint_messagesstring/JSONPer-checkpoint messages

SettingTypeDefaultDescription
provider_strategystringprimaryHow to select provider
fallback_enabledbooleanfalseUse fallback on failure
fallback_providersarrayProvider IDs in fallback order
fallback_max_retriesnumber2Retries before fallback
fallback_retry_delay_msnumber500Delay between retries
ab_test_weightsJSONA/B test weights per provider

SettingTypeDefaultDescription
activation_cooldown_secondsnumber60Cooldown between activations
max_activations_per_hournumber30Max keys per hour (per IP/session)
max_activations_per_daynumber200Max keys per day
strict_new_key_limitsnumber1Enforce new-key limits
new_key_cooldown_multipliernumber2.0Multiplier for new-key cooldown

CategoryKey Settings
Checkpointscheckpoint_count, checkpoint_duration_minutes
Keykey_duration_hours, allow_key_extension
Securitycaptcha_enabled, block_vpn, require_discord_oauth
UXallow_forgetting
Providerprovider, provider_strategy, fallback_*, ab_test_weights
Rate limitactivation_cooldown_seconds, max_activations_*, strict_new_key_limits