HiddenGifts

Turn your Hytale server into a treasure hunt.
Admins hide a chest anywhere in the world, players get proximity hints as they explore,
and the first to find it claims tiered loot rewards — all broadcast live to the server.

Features

• Admin-placed treasure chests — Use /hiddengift place for a random tier or /hiddengift place rare to pick one
• Proximity notifications — Players get a toast alert when they're within range of the hidden chest
• Tiered reward system — Common, Rare, and Legendary tiers with weighted random selection, each with configurable item pools and quantity ranges
• Server-wide announcements — Placement and discovery broadcast via event titles, toast notifications, and chat messages
• Indestructible chest — The gift chest cannot be damaged or broken by players
• Finder cooldown — Prevent the same player from claiming back-to-back (configurable duration)
• Fully configurable — All tiers, items, messages, radius, cooldowns, and the chest block ID are editable in config.json

How It Works

1. An admin runs /hiddengift place [tier] while looking at a block
2. A chest appears on top of that block and the server is notified a treasure has been hidden
3. Players exploring the world receive a proximity toast when they get close
4. The first player to walk up to the chest claims the loot — items go straight to inventory
5. Everyone sees who found it, what tier it was, and what they won

Commands

Requirements

PlayerData-Core (required) — Tracks per-player find stats and cooldowns. Must be installed and loaded before HiddenGifts.

Installation

1. Install PlayerData-Core
2. Drop the HiddenGifts .jar into your server's plugins folder
3. Start the server — a default config.json is generated automatically
4. Edit config.json to customize tiers, rewards, and messages

Configuration Guide

A config.json file is generated in the plugin's data folder on first run. Below is every setting explained.

General Settings

Tier System

Tiers are defined under the "tiers" key as a map. Each tier name (e.g. "common", "rare", "legendary") maps to a tier object. You can add, remove, or rename tiers freely.

Tier Object

Item Object (inside items array)

How Tier Selection Works

With weights common: 60, rare: 30, legendary: 10 (total = 100):

• Common — picked ~60% of the time
• Rare — picked ~30% of the time
• Legendary — picked ~10% of the time

How Rewards Are Rolled

Example: A rare tier with pickCountMin: 2, pickCountMax: 3 and 4 items in the pool:

1. Roll a number between 2 and 3 → e.g. 3
2. Randomly pick 3 items from the pool
3. For each picked item, roll a quantity between its min and max

Messages

All display text is configurable. Use the placeholders shown below — they are replaced at runtime.

Placement Messages (shown to the whole server when a chest is hidden)

Proximity Messages (shown to individual players near the chest)

Discovery Broadcast (shown to the whole server when someone finds it)

Personal Feedback (shown only to the finder)

Cooldown Messages (shown when a player on cooldown gets near a chest)

Misc Messages (used in commands)

Full Default Config

{
  "hintRadius": 30,
  "finderCooldownMinutes": 10,
  "placerCanClaim": false,
  "chestBlockId": "Furniture_Christmas_Chest_Small",
  "tiers": {
    "common": {
      "weight": 60,
      "pickCountMin": 1,
      "pickCountMax": 2,
      "items": [
        { "item": "Ingredient_Bar_Iron", "min": 2, "max": 5 },
        { "item": "Ingredient_Bar_Copper", "min": 3, "max": 8 }
      ]
    },
    "rare": {
      "weight": 30,
      "pickCountMin": 2,
      "pickCountMax": 3,
      "items": [
        { "item": "Ingredient_Bar_Cobalt", "min": 1, "max": 3 },
        { "item": "Tool_Pickaxe_Iron", "min": 1, "max": 1 }
      ]
    },
    "legendary": {
      "weight": 10,
      "pickCountMin": 3,
      "pickCountMax": 5,
      "items": [
        { "item": "Tool_Pickaxe_Cobalt", "min": 1, "max": 1 },
        { "item": "Weapon_Sword_Iron", "min": 1, "max": 1 }
      ]
    }
  },
  "messageHiddenPlaced": "A {tier} treasure has been hidden somewhere in the world!",
  "messagePlacedToast": "Treasure Hidden!",
  "messagePlacedToastHint": "A {tier} gift is waiting to be found!",
  "messageProximityHint": "You sense a hidden treasure nearby...",
  "messageProximityToast": "Treasure Nearby!",
  "messageFoundTitle": "{player} Found It!",
  "messageFoundSubtitle": "A {tier} treasure has been claimed!",
  "messageFoundToast": "{player} found a hidden treasure!",
  "messageFoundToastHint": "They claimed the {tier} reward!",
  "messageFoundChat": "--- {player} found a {tier} treasure! ---",
  "messageRewardFormat": "Reward: {reward}",
  "messagePersonalFoundTitle": "Treasure Found!",
  "messagePersonalFoundToast": "Reward Collected!",
  "messagePersonalFoundChat": "+ {reward} added to your inventory!",
  "messagePersonalFoundStats": "Total treasures found: {found}",
  "messageCooldownToast": "On Cooldown",
  "messageOnCooldown": "You found one recently! Wait {minutes} minutes.",
  "messageNoGiftActive": "No hidden gift is currently active.",
  "messageAlreadyActive": "A hidden gift is already active!",
  "messageStats": "You have found {found} hidden treasures!"
}