GiftDrops

GiftDrops

Your server chat is about to get a lot more exciting.

GiftDrops drops surprise challenges at random intervals — a math puzzle appears, or a scrambled code flashes — and the race is on. The first player to type the correct answer in chat wins real item rewards straight to their inventory.

No menus. No sign-ups. Just play and react.

Built to keep your player base engaged between builds, during downtime, or anytime the server needs a burst of energy.

---

How It Works

1. A challenge appears with animated titles, toast notifications, and chat messages
2. Players race to type the answer in chat
3. The fastest correct answer wins — items land directly in their inventory
4. A cooldown prevents the same player from winning back-to-back

That's it. No setup required from players. They just need to be paying attention.

---

Challenge Types

Math Questions

Randomized arithmetic at varied difficulty. Addition, subtraction, multiplication, and division — all producing clean whole-number answers.

GiftDrop! First to answer: What is 34 + 17? GiftDrop! First to answer: What is 12 × 9? GiftDrop! First to answer: What is 44 ÷ 4?

Reaction Codes

A randomly generated code flashes. Pure speed — type it first, win.

Three formats keep players on their toes:

• Digit codes — 4829
• Mixed alphanumeric — A3K7B2
• Letter codes — XKQM

Case-insensitive, so nobody loses to a caps lock mishap.

---

Visual Feedback

Every event hits through multiple visual channels so nobody misses it:

• Full-screen animated title with decorative bars — the challenge front and center
• Toast notification popup — achievement-style corner alert
• Styled chat messages — colored header, the question, and a hint

When someone wins:

• Gold celebration title broadcast to all players with the winner's name
• Personal "You Won!" title with reward details just for the winner
• "Reward Collected!" toast confirming items landed in their inventory
• Win counter tracking total GiftDrop victories

When nobody answers in time:

• Subtle "Time's Up!" title and a warning toast — low-key, not intrusive

---

Fully Configurable

Everything lives in a single config.json:

• Rewards — any item ID, any quantity, multiple rewards per event
• Timing — event interval, duration, winner cooldown
• Every single display string — translate the entire plugin into any language by editing the config

{
  "eventIntervalMinutes": 15,
  "winnerCooldownMinutes": 5,
  "eventDurationSeconds": 30,
  "rewards": [
    { "item": "Ingredient_Bar_Iron", "amount": 3 },
    { "item": "Ingredient_Bar_Cobalt", "amount": 1 }
  ]
}

Item IDs follow the Hytale asset format (e.g., Ingredient_Bar_Iron, Tool_Pickaxe_Iron). Refer to community item databases for the full list of valid IDs.

---
Permissions
┌─────────────────┬─────────┬─────────────────────────────────────────────────────────┐
│   Permission    │ Default │                       Description                       │
├─────────────────┼─────────┼─────────────────────────────────────────────────────────┤
│ giftdrops.start │ Denied  │ Allows using /giftdrop start to manually trigger events │
└─────────────────┴─────────┴─────────────────────────────────────────────────────────┘
All players can participate in events and use /giftdrop stats with no permission needed. Only manually starting events requires the giftdrops.start permission, which is denied by default. Grant it to admins or moderators through your permission setup.

Commands
┌─────────────────┬─────────────────────────────────────────────────────────┐
│     Command     │                       Description                       │
├─────────────────┼─────────────────────────────────────────────────────────┤
│ /giftdrop start │ Manually trigger a challenge (requires giftdrops.start) │
├─────────────────┼─────────────────────────────────────────────────────────┤
│ /giftdrop stats │ Check your total wins (available to all players)        │
└─────────────────┴─────────────────────────────────────────────────────────┘
---
Requirements

- PlayerData Core — must be installed on the server. GiftDrops uses it for persistent win tracking and cooldown storage. Without it, the plugin will not start.

---
What's Next

GiftDrops v1 ships lean on purpose. No bloat, no unnecessary dependencies. Future versions may add new challenge types, leaderboards, or economy integration — but only if players want them.