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

A challenge appears with animated titles, toast notifications, and chat messages
Players race to type the answer in chat
The fastest correct answer wins — items land directly in their inventory
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.