EcoTale Rewards

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

Command	Permission	Description
/calendar	ecotalerewards.use	Open the reward calendar GUI
/rewards	ecotalerewards.use	Open the reward calendar GUI
/rewards calendar	ecotalerewards.use	Open the reward calendar GUI
/rewards claim	ecotalerewards.use	Claim today's reward (CLI)
/rewards info	ecotalerewards.use	View your progress & stats
/rewards admin	ecotalerewards.admin	Open the admin GUI
/calendar admin	ecotalerewards.admin	Open the admin GUI
/rewards reload	ecotalerewards.admin	Reload configuration
/rewards reset	ecotalerewards.admin	Reset a player's data
/rewards langen	ecotalerewards.use	Switch to English
/rewards langru	ecotalerewards.use	Switch to Russian
/rewards help	ecotalerewards.use	Command reference

---

🔑 Permissions

Permission	Description
ecotalerewards.use	Access to calendar, claim, and info commands
ecotalerewards.admin	Access to admin GUI, reload, and reset commands
ecotalerewards.vip.vip	VIP tier — 1.25× reward multiplier
ecotalerewards.vip.mvp	MVP tier — 1.5× reward multiplier
ecotalerewards.vip.mvp_plus	MVP+ tier — 2.0× reward multiplier

---

📦 Requirements

Dependency	Required	Description
Ecotale ≥ 1.0.0	✅	Economy & currency system
RPG Leveling ≥ 0.2.0	✅	Level-scaling for mob rewards
EconomyAPI ≥ 1.4.5	✅	Economy & currency system
MMO Skill Tree ≥ 0.11.2	✅	Level-scaling for mob rewards
Endless Leveling ≥ 5.13	✅	Level-scaling for mob rewards

---

⚡ 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