EcoTale 奖励

EcoTaleRewards

Hytale 服务器的每日签到日历、连续签到系统与回归奖励

通过一个功能完备的 MMORPG 风格每日奖励系统，提升玩家留存率。玩家登录后，打开日历即可领取逐渐升级的奖励——包括金币、经验值、物品和自定义命令。持续登录可积累连续签到次数，获得奖励倍率加成；回归玩家则会收到一份温馨的欢迎回归礼包。

---

✨ 功能

📅 30 天签到日历

• 精美的游戏内 GUI 日历，使用颜色编码标识每日状态
• 绿色 — 已领取 · 黄色 — 今日可领取 · 灰色 — 未解锁 · 红色 — 错过
• 每天奖励可配置的 金币、经验值、物品 和 服务器命令
• 每周里程碑（第 7、14、21、28、30 天）提供额外奖励
• 严格或宽松模式 — 可选择错过天数是否会阻碍进度
• 宽限期（默认 2 天） — 允许短暂缺席
• 每日首次登录后 3 秒自动打开日历（每天一次）

🔥 连续签到系统

• 追踪连续每日登录次数
• 递增倍率：基础 1.0 + 每天 0.02（最高 3.0 倍）
• 连续签到 7 / 14 / 30 / 60 / 90 天里程碑奖励
• 中断时部分重置 — 连续天数除以 2 而不是归零
• 里程碑奖励：额外金币、经验值和奖励倍率提升

🎁 回归奖励

• 根据缺席时长分为 4 个等级：
  • 1 周 — 300 金币，150 经验值
  • 2 周 — 750 金币，400 经验值
  • 1 个月 — 2,000 金币，1,000 经验值
  • 3 个月以上 — 5,000 金币，2,500 经验值
• 每个等级包含自定义物品和命令
• 在日历 GUI 中以特殊横幅显示

👑 VIP 倍率

• 基于权限的 VIP 等级，可倍率所有奖励
• 默认等级：VIP (1.25 倍)、MVP (1.5 倍)、MVP+ (2.0 倍)
• 完全可自定义 — 可添加无限等级，使用任何权限节点

🛡️ 反滥用保护

• 领取前需要最低在线时长
• 重新登录冷却时间（默认 60 分钟）
• 每天最多领取 1 次
• 完整奖励记录，便于审计

🌐 多语言支持

• 内置 英语 和 俄语 本地化
• 支持 6 种语言的本地化 — 英语、俄语、巴西葡萄牙语、法语、德语、西班牙语
• 所有消息使用 MiniMessage 格式

⚙️ 管理员工具

• 游戏内管理 GUI，支持实时配置编辑
• 开关调试模式、严格模式、连续签到系统
• 通过滑块调整日历天数、宽限期、冷却时间
• 可视化日历编辑器 — 浏览天数并修改金币、经验值、物品
• 重载配置、强制保存数据、重置所有玩家

---

命令

命令	权限	描述
/calendar	ecotalerewards.use	打开奖励日历 GUI
/rewards	ecotalerewards.use	打开奖励日历 GUI
/rewards calendar	ecotalerewards.use	打开奖励日历 GUI
/rewards claim	ecotalerewards.use	领取今日奖励 (命令行)
/rewards info	ecotalerewards.use	查看你的进度和统计
/rewards admin	ecotalerewards.admin	打开管理 GUI
/calendar admin	ecotalerewards.admin	打开管理 GUI
/rewards reload	ecotalerewards.admin	重载配置
/rewards reset	ecotalerewards.admin	重置玩家数据
/rewards langen	ecotalerewards.use	切换到英语
/rewards langru	ecotalerewards.use	切换到俄语
/rewards help	ecotalerewards.use	命令参考

---

🔑 权限

权限	描述
ecotalerewards.use	访问日历、领取和信息命令
ecotalerewards.admin	访问管理 GUI、重载和重置命令
ecotalerewards.vip.vip	VIP 等级 — 1.25 倍奖励倍率
ecotalerewards.vip.mvp	MVP 等级 — 1.5 倍奖励倍率
ecotalerewards.vip.mvp_plus	MVP+ 等级 — 2.0 倍奖励倍率

---

📦 依赖要求

依赖	必选	描述
Ecotale ≥ 1.0.0	✅	经济与货币系统
RPG Leveling ≥ 0.2.0	✅	生物奖励等级缩放
EconomyAPI ≥ 1.4.5	✅	经济与货币系统
MMO Skill Tree ≥ 0.11.2	✅	生物奖励等级缩放
Endless Leveling ≥ 5.13	✅	生物奖励等级缩放

---

⚡ 快速设置

1. 将 EcoTaleRewards-1.0.0.jar 放入服务器的 Mods 文件夹
2. 确保已安装 Ecotale 插件
3. 启动服务器 — 将生成默认配置
4. 编辑 EcoTaleRewards.json 以自定义奖励、连续签到和回归等级
5. 使用 /rewards reload 或管理 GUI 应用更改

日历 GUI 会在玩家加入服务器 3 秒后自动打开。

---

🎮 奖励配置

物品

物品使用 Hytale 的内部物品 ID，可附加数量：

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

命令

服务器命令，使用 {player} 占位符：

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

---

📄 存储

玩家数据以独立 JSON 文件的形式存储在插件的 players/ 目录中。数据包括：

• 当前日历天数和领取历史
• 连续天数和最后登录日期
• 已获得的总金币、经验值和物品
• 回归奖励资格

自动保存每 5 分钟运行一次（可配置）。

---

由 CrystalRealm 制作 · hytale-server.pro-gamedev.ru