EcoTaleRewards

Daily Login Calendar, Streak System & Return Rewards for Hytale Servers

Boost player retention with a fully featured MMORPG-style daily reward system. Players log in, open the calendar, and claim escalating rewards — coins, XP, items, and custom commands. Consistent logins build streaks for bonus multipliers, and returning players get a warm welcome-back package.

✨ Features

📅 30-Day Login Calendar

• Beautiful in-game GUI calendar with color-coded day statuses
• Green — claimed · Yellow — available today · Gray — locked · Red — missed
• Each day awards configurable coins, XP, items, and server commands
• Weekly milestone days (7, 14, 21, 28, 30) with bonus loot
• Strict or soft mode — choose whether missed days block progress
• Grace period (default 2 days) — forgive short absences
• Auto-opens 3 seconds after first daily login (once per day)

🔥 Streak System

• Tracks consecutive daily logins
• Rising multiplier: base 1.0 + 0.02 per day (up to 3.0×)
• Milestone bonuses at 7 / 14 / 30 / 60 / 90 day streaks
• Partial reset on break — streak divides by 2 instead of resetting to zero
• Milestone rewards: bonus coins, XP, and reward multiplier boosts

🎁 Return Rewards

• 4 tiers based on absence length:
  • 1 week — 300 coins, 150 XP
  • 2 weeks — 750 coins, 400 XP
  • 1 month — 2,000 coins, 1,000 XP
  • 3+ months — 5,000 coins, 2,500 XP
• Includes custom items and commands per tier
• Shown as a special banner in the calendar GUI

👑 VIP Multipliers

• Permission-based VIP tiers multiply all rewards
• Default tiers: VIP (1.25×), MVP (1.5×), MVP+ (2.0×)
• Fully customizable — add unlimited tiers with any permission node

🛡️ Anti-Abuse Protection

• Minimum online time before claiming
• Relog cooldown (default 60 minutes)
• Max 1 claim per day
• Full reward logging for auditing

🌐 Multi-Language Support

• Built-in English and Russian localizations
• Localization support for 6 languages — EN, RU, PT-BR, FR, DE, ES
• All messages use MiniMessage formatting

⚙️ Admin Tools

• In-game Admin GUI with live configuration editing
• Toggle Debug Mode, Strict Mode, Streak system
• Adjust calendar days, grace period, cooldowns via sliders
• Visual Calendar Editor — browse days and modify coins, XP, items
• Reload config, force-save data, reset all players

Commands

🔑 Permissions

📦 Requirements

⚡ Quick Setup

1. Drop EcoTaleRewards-1.0.0.jar into your server's Mods folder
2. Ensure Ecotale plugin is installed
3. Start the server — a default config will be generated
4. Edit EcoTaleRewards.json to customize rewards, streaks, and return tiers
5. Use /rewards reload or the Admin GUI to apply changes

The calendar GUI automatically opens 3 seconds after a player joins the server.

🎮 Reward Configuration

Items

Items use Hytale's internal item IDs with an optional count:

Weapon_Sword_Bronze:1
Tool_Pickaxe_Adamantite:1
Plant_Crop_Wheat_Item:16
Ore_Cobalt:3

Commands

Server commands with {player} placeholder:

say {player} completed week 1!
give {player} some_item 5

📄 Storage

Player data is stored as individual JSON files in the plugin's players/ directory. Data includes:

• Current calendar day and claim history
• Streak count and last login date
• Total coins, XP, and items received
• Return reward eligibility

Auto-save runs every 5 minutes (configurable).

Made by CrystalRealm · hytale-server.pro-gamedev.ru