Skip to main content

Configuration Guide

Deep dive into the /config command and all its subcommands.

Viewing Configuration​

/config

Shows your current server configuration including:

  • Connected brand
  • Active events
  • Role bonuses
  • Channel settings
  • Test mode status

Event Management​

List All Events​

/config events

Shows all configured events with:

  • Event name and ID
  • Reward amount
  • Cooldown period
  • Max claims
  • Enabled/disabled status

Create an Event​

/config events action:create name:my_event reward:50 cooldown:24 max-claims:1
OptionRequiredDescription
name✅Event identifier (lowercase, underscores)
reward✅LTZ amount (1-10,000)
cooldown❌Hours between claims (-1 or 0 = no cooldown)
max-claims❌Per-user claim limit (-1 = unlimited)
max-total-claims❌Total claims across all users (-1 = unlimited)
smart❌Enable Smart Rewards formula mode (true/false)
channels❌Restrict to specific channels (comma-separated)
Cooldown Options
  • cooldown:-1 or cooldown:0 → No cooldown (unlimited claims per day)
  • cooldown:24 → 24-hour cooldown between claims
  • For voice events, always use cooldown:-1 (voice tracker handles rate limiting)

Edit an Event​

/config events action:edit name:daily_checkin reward:30
/config events action:edit name:gm_checkin cooldown:12

Toggle Event On/Off​

/config events action:toggle name:gm_checkin
/config events action:toggle name:gm_checkin enabled:false

Delete an Event​

/config events action:delete name:my_event

Quick Reward Adjustment​

/config reward gm_checkin 50
/config reward daily_checkin 25

Role Bonus Configuration​

Configure LTZ bonuses for Discord roles.

View Role Bonuses​

/config role-bonus

Set Multiplier​

/config role-bonus role:@VIP multiplier:1.5

Multiplier range: 1.0 to 5.0 (1.5 = 50% bonus)

Set Flat Bonus​

/config role-bonus role:@Whale flat-bonus:25

Adds fixed LTZ to every reward (0-1,000 range).

Set Both​

/config role-bonus role:@Booster multiplier:2.0 flat-bonus:10

Remove Role Bonus​

/config role-bonus clear:@OldRole

Stacking Modes​

Configure how multiple role bonuses combine:

/config stacking multiplicative   # 1.5x × 1.2x = 1.8x
/config stacking additive         # +50% + 20% = +70%
/config stacking highest          # Only best bonus applies

Admin Roles​

Control who can configure the bot.

Assign Admin Role​

/config admin-roles role:@Moderator level:event_manager

Permission Levels:

LevelValueCapabilities
Full Adminfull_adminEverything
Event Managerevent_managerEvents, drops, rewards
Perk Managerperk_managerCreate/edit perks
ViewerviewerView stats only

View Admin Roles​

/config admin-roles

Remove Admin Role​

/config admin-roles remove:@Moderator

Clear All​

/config admin-roles clear:true

Admin Notifications​

Get real-time notifications of all reward activity.

Set Admin Channel​

/config admin-channel channel:#admin-logs

View Current Channel​

/config admin-channel

Disable Notifications​

/config admin-channel clear:true

Channel Configuration​

Control which channels trigger rewards.

View Settings​

/config channels

Exclude Channel​

/config channels exclude:#spam-chat

Whitelist Mode​

Only reward in specific channels:

/config channels include-only:#rewards-chat

Boost Channel​

Give bonus rewards in a channel:

/config channels boost:#premium-chat multiplier:1.5

Clear Settings​

/config channels clear:exclude
/config channels clear:all

User Management​

Enable/disable rewards for specific users.

Disable User​

/config user disable:@user reason:"Breaking rules"

Enable User​

/config user enable:@user

Check Status​

/config user status:@user

List Disabled Users​

/config user list-disabled

Test Mode​

Safely test configuration changes without affecting real rewards.

Enable Test Mode​

/config test-mode enable:true

Restrict to Role​

/config test-mode role:@Testers

Disable Test Mode​

/config test-mode enable:false

Test mode behavior:

  • Only testers/admins receive rewards
  • All events logged with [TEST] flag
  • Does not count toward KPIs

Streak Configuration​

Set Grace Period​

/config streaks grace-period:8    # 8 hours
/config streaks grace-period:48   # 48 hours (max: 72)

Voice Configuration​

Voice rewards have their own rate-limiting system separate from event cooldowns.

View Voice Config​

/config voice

Set Voice Rewards​

/config voice minutes_per_reward:60 ltz_per_reward:25 max_daily:3
OptionDescriptionDefault
minutes_per_rewardMinutes in voice to earn one reward60
ltz_per_rewardLTZ amount per reward25
max_dailyMaximum rewards per user per day3

Voice Event Configuration​

When creating a voice_time event via /config events, use cooldown:-1 or cooldown:0:

/config events action:create name:voice_time reward:25 cooldown:-1 smart:true
Why No Cooldown for Voice?

Voice rewards use maxRewardsPerDay (configured via /config voice) as the rate limit instead of event cooldown. This allows users to claim multiple rewards in a single voice session if they've accumulated enough time.

How Voice Rate Limiting Works​

  1. Voice Tracker tracks minutes accumulated per user per day
  2. Voice Tracker enforces max_daily rewards per user
  3. Event Handler trusts voice tracker and skips cooldown check
  4. Max Total Claims still enforced if configured (global event limit)

Third-Party Integrations​

Enable Integration​

/config third-party enable:mee6

Set Reward Amount​

/config third-party reward:mee6 amount:50

Disable Integration​

/config third-party disable:mee6

View Status​

/config third-party

Daily Event Configuration​

Configure which event /daily triggers:

/config daily-event event_id:my_daily_event

Sync Discord Roles​

Import Discord roles for reward configuration:

/config sync-roles
Last updated on