Version 4.0.0 - The Universal Overhaul

This is our biggest update yet! Version 4.0.0 marks a complete evolution from the original mod, introducing a universal architecture designed to fit seamlessly into any Minecraft server. We have officially rebranded to Universal Daily Rewards to reflect this massive leap in accessibility, flexibility, and server-side performance.

✨ Major Features & Additions

• 🌍 Universal Rebranding & Default Configs: The mod is now a 100% standalone utility for all Fabric servers. We've introduced pure "Vanilla" default configurations right out of the box, ensuring a clean first-time setup for any server type.
• 📋 Dynamic Template System: Admins can now instantly switch between pre-configured reward ecosystems! Use the new /rewards-setup load <template> command to hot-swap between vanilla, economy, or cobbleverse templates without touching a single file.
• 🗣️ Native Item Localization: Default templates now utilize Minecraft's native translate keys out of the box. Instead of hardcoding names, items like Diamonds and Emeralds will automatically translate to the player's local client language, fully leveraging the Server Translations API.
• 📱 Remote Player Access: By popular demand, players can now access their rewards remotely without needing a physical NPC! Added the /daily and /rewards open commands.
• ⚙️ Configurable Immersion: Server owners prioritizing RPG immersion can easily disable these remote commands via the new "allow_player_command" toggle in global.json, keeping the focus strictly on physical NPCs.

🛠️ Full Command Reference

Player Commands

• /daily - Opens the rewards selection menu (if enabled in config).
• /rewards open - Alias for /daily.

Admin Commands (Permission Level 2+)

• /rewards-reload-<type>-config - Hot-reload specific configurations.
• /rewards-check <player> - Check current streak and playtime stats for a player.
• /rewards-force-save - Forcefully save all player data to disk immediately.
• /rewards-reset <player> - Reset all progress for a player.
• /rewards-setstreak <player> <days> - Adjust daily login streak.
• /rewards-setplaytime <player> <seconds> - Adjust tracked playtime.
• /rewards-screen-entity <add|remove> <entity> - Bind the menu to physical NPCs.

Setup Commands (Permission Level 4)

• /rewards-setup load <template> - Apply a pre-made template (vanilla, economy, cobbleverse).
• /rewards-setup allow-player-command <true|false> - Toggle remote access via /daily.

⚙️ Configuration & Flexibility

The mod uses an intuitive JSON structure that offers total freedom in how you distribute rewards. You can choose between two main methods (or mix them):

1. Command-Based Rewards (Recommended for Economy/Virtual Items)

Ideal for currency, permissions, or custom items with complex NBT. You run a command in the background and use a visual placeholder in the GUI.

• Set "give_item": false so the GUI item only acts as a visual icon.
• Add your commands to the "commands" array.

2. Direct Physical Rewards

The mod directly gives the player the physical item shown in the GUI.

• Set "give_item": true.
• The player will receive exactly what they see (amount, enchants, name, lore).

Configuration Example

The following example contrasts Command vs. Direct rewards (Day 1) and Text vs. Translate names (Day 2):

[
  {
    "day": 1,
    "id": "day_1",
    "commands": ["experience add %player% 500 points"],
    "items": [
      {
        "item": "minecraft:experience_bottle",
        "name": "{\"text\":\"500 XP Points (Command)\",\"color\":\"green\"}",
        "amount": 1,
        "give_item": false
      },
      {
        "item": "minecraft:diamond",
        "name": "{\"translate\":\"item.minecraft.diamond\",\"color\":\"aqua\"}",
        "amount": 3,
        "give_item": true
      }
    ]
  },
  {
    "day": 2,
    "id": "day_2",
    "items": [
      {
        "item": "minecraft:iron_sword",
        "name": "{\"text\":\"Custom Slayer Sword\",\"color\":\"red\",\"bold\":true}",
        "amount": 1,
        "give_item": true
      },
      {
        "item": "minecraft:golden_apple",
        "name": "{\"translate\":\"item.minecraft.golden_apple\",\"color\":\"gold\"}",
        "amount": 5,
        "give_item": true
      }
    ]
  }
]

💡 Want to see more full examples?

You can explore the complete code for all our pre-made templates directly on our GitHub repository.

📁 Browse the Templates Folder

• Vanilla Daily Config
• Vanilla Playtime Config
• Economy Daily Config
• Economy Playtime Config
• Cobbleverse Daily Config
• Cobbleverse Playtime Config

🎨 Creating Custom Templates

You can easily create your own reward presets. The mod will automatically detect them as long as you follow these steps:

1. Navigate to your server's config/rewards/templates/ folder.
2. Create two JSON files with the same prefix:
   • yourname_daily.json (for Daily Rewards)
   • yourname_playtime.json (for Playtime Rewards)
3. Use the /rewards-setup load yourname command in-game. The mod will find your files and apply them instantly!