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

Drop EcoTaleRewards-1.0.0.jar into your server's Mods folder
Ensure Ecotale plugin is installed
Start the server — a default config will be generated
Edit EcoTaleRewards.json to customize rewards, streaks, and return tiers
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

EcoTale Rewards