Drops & Engagement Events

Create engaging events where users react or click to claim rewards.

The /drop Command

Create button-based or reaction-based drops linked to your custom events.

Button Drop (Default)

Posts a message with a claim button:

/drop event_id:announcement_reward label:"Claim Reward" description:"Thanks for being here!"

Reaction Drop

Attach a drop to an existing message:

/drop event_id:announcement_reward type:reaction message_id:123456789 emoji:🎉 lifespan:2h

Command Options

Parameter	Required	Description	Default
event_id	✅	Event ID from your events	-
type	❌	button or reaction	button
message_id	❌	Message to attach reaction to	-
emoji	❌	Emoji for reaction drops	🎉
lifespan	❌	How long drop is active	24h
label	❌	Button text	"Claim"
description	❌	Message above the drop	-

Lifespan Options

Time-based:

• 1s - 1 second (testing)
• 5m - 5 minutes
• 2h - 2 hours
• 24h - 24 hours (default)
• 168h - 1 week (maximum timed)

Permanent:

• permanent - Never expires
• 0 - Never expires
• unlimited - Never expires
• forever - Never expires

---

Embedding Drops in Announcements

Create engaging announcements with embedded reward drops:

Step 1: Post Your Announcement

Write and post your announcement normally:

@everyone 🎉 Big news! We just hit 10,000 members!

Step 2: Get the Message ID

1. Right-click the message
2. Click "Copy Message ID"
3. (Enable Developer Mode in Discord settings if you don't see this)

Step 3: Create the Reaction Drop

/drop event_id:celebration type:reaction message_id:PASTE_MESSAGE_ID lifespan:2h emoji:🎉

Step 4: Watch Users React!

The bot automatically:

• Adds the emoji to your message
• Tracks who reacts
• Sends rewards to claimers
• DMs users confirmation

---

Event Integration

Drops pull settings from your event configuration:

1. Create event in Partner Portal:

   • Name: Announcement Celebration
   • Reward: 25 LTZ
   • Max Claims Per User: 100 (first 100 users can claim)

2. Use in Discord:

   /drop event_id:announcement_celebration type:reaction message_id:123456

3. Event settings apply:

   • Reward amount from event config
   • Max claims respected
   • Cooldowns honored
   • Analytics tracked

Event Name Normalization

Event names with spaces are automatically normalized:

• "Announcement Celebration" → announcement_celebration
• Both formats work in the command

---

How Reaction Drops Work

1. Admin creates drop → Bot adds emoji to message
2. Users react with the correct emoji
3. Bot validates:
   • ✅ Active drop exists
   • ✅ Correct emoji used
   • ✅ User hasn't claimed yet
   • ✅ Max claims not reached
   • ✅ Drop hasn't expired
   • ✅ Event is enabled
4. Reward sent → User receives LTZ
5. Confirmation → ✅ reaction added + DM sent

---

Manual Rewards

Reward users directly for valuable contributions.

Basic Usage

/reward user:@Username event_id:helpful_contribution

Common Event IDs

Event	Suggested Use	Example Reward
helpful_answer	Helping community members	25 LTZ
bug_report	Reporting bugs	50 LTZ
content_creation	Creating guides	100 LTZ
event_participation	Attending events	20 LTZ

Configuration

Configure which roles can use /reward in Partner Portal:

• Integrations → Discord → Manual Rewards
• Set allowed roles
• Restrict event types
• Set cooldowns

---

Channel-Based Event Triggers

Configure events to only trigger in specific channels:

In Partner Portal:

1. Go to Events → Select your event
2. Under Detection Methods, select Discord
3. Enter allowed channels: feedback, support, tech-talk

Behavior:

• Channels specified: Event only triggers in those channels
• Channels empty: Event triggers anywhere
• Channel names are case-insensitive
• Don't include # prefix

Use Cases

Event	Channels	Purpose
Bug Report	report-bugs	Focus reports
Tech Discussion	tech-talk, dev-chat	Quality tech content
GM Check-in	gm-gn	Prevent GM spam
Feedback	feedback, suggestions	Direct input

---

Best Practices

Timing Your Drops

• Flash drops: Short lifespan (5-30 min) creates urgency
• Announcement drops: 2-24h gives everyone a chance
• Permanent drops: Use for evergreen content

Claim Limits

• First-come: Set max-claims to limit total claimers
• Unlimited: Use for celebration events everyone should get

Engagement Tips

1. Announce drops in your announcement channel
2. Use relevant emojis that match the event
3. Set appropriate rewards - not too high, not too low
4. Track with /stats to see engagement