Add additive grant system for monetization

- Add PlayerGrants data class and GrantStorage for persistent grants
- Implement admin commands: grant/revoke homes, grant/revoke instanttp, status
- Grants stack additively with permission-based limits
- Support both console and player execution for admin commands
- Player lookup supports both username and UUID

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: cryptobench

src/main/java/com/easyhome/EasyHome.java

@@ -7,8 +7,11 @@
 import com.easyhome.commands.HomesCommand;
 import com.easyhome.commands.SetHomeCommand;
 import com.easyhome.config.HomeConfig;
+import com.easyhome.data.GrantStorage;
 import com.easyhome.data.HomeStorage;
 import com.easyhome.util.WarmupManager;
+
+import java.util.UUID;
 import com.hypixel.hytale.server.core.entity.entities.Player;
 import com.hypixel.hytale.server.core.plugin.JavaPlugin;
 import com.hypixel.hytale.server.core.plugin.JavaPluginInit;
@@ -20,6 +23,7 @@ public class EasyHome extends JavaPlugin {
 
     private HomeConfig config;
     private HomeStorage storage;
+    private GrantStorage grantStorage;
     private WarmupManager warmupManager;
 
     public EasyHome(JavaPluginInit init) {
@@ -34,6 +38,9 @@ public void setup() {
         // Initialize storage
         storage = new HomeStorage(getDataDirectory());
 
+        // Initialize grant storage
+        grantStorage = new GrantStorage(getDataDirectory());
+
         // Initialize warmup manager
         warmupManager = new WarmupManager();
 
@@ -58,6 +65,11 @@ public void shutdown() {
             storage.saveAll();
         }
 
+        // Save grant data
+        if (grantStorage != null) {
+            grantStorage.saveAll();
+        }
+
         // Shutdown warmup manager
         if (warmupManager != null) {
             warmupManager.shutdown();
@@ -72,15 +84,63 @@ public HomeStorage getStorage() {
         return storage;
     }
 
+    public GrantStorage getGrantStorage() {
+        return grantStorage;
+    }
+
     public WarmupManager getWarmupManager() {
         return warmupManager;
     }
 
     /**
      * Get the home limit for a player.
-     * Uses config-based defaults with optional permission overrides.
+     * Combines permission-based limits and grant-based bonuses additively.
+     *
+     * Formula: min(baseLimit + bonusHomes, maxHomeLimit)
+     * Where baseLimit = permissionLimit (if enabled) or defaultLimit
+     */
+    public int getHomeLimit(Player player, UUID playerId) {
+        // Check for unlimited permission first
+        if (player.hasPermission("homes.limit.unlimited")) {
+            return config.getMaxHomeLimit();
+        }
+
+        int baseLimit = config.getDefaultHomeLimit();
+
+        // If permission overrides are enabled, check for specific limits
+        if (config.isPermissionOverridesEnabled()) {
+            // Check for specific permission-based limits (highest first)
+            if (player.hasPermission("homes.limit.50")) {
+                baseLimit = 50;
+            } else if (player.hasPermission("homes.limit.25")) {
+                baseLimit = 25;
+            } else if (player.hasPermission("homes.limit.10")) {
+                baseLimit = 10;
+            } else if (player.hasPermission("homes.limit.5")) {
+                baseLimit = 5;
+            } else if (player.hasPermission("homes.limit.3")) {
+                baseLimit = 3;
+            } else if (player.hasPermission("homes.limit.1")) {
+                baseLimit = 1;
+            }
+        }
+
+        // Add bonus homes from grants (additive stacking)
+        int bonusHomes = grantStorage.getBonusHomes(playerId);
+        int effectiveLimit = baseLimit + bonusHomes;
+
+        // Cap at max home limit
+        return Math.min(effectiveLimit, config.getMaxHomeLimit());
+    }
+
+    /**
+     * Get the home limit for a player (convenience method).
+     * Uses config-based defaults with optional permission and grant overrides.
      */
     public int getHomeLimit(Player player) {
+        // This overload is for backwards compatibility when UUID is not available
+        // In this case, grants cannot be checked, so only permission limits apply
+
         // Check for unlimited permission first
         if (player.hasPermission("homes.limit.unlimited")) {
             return config.getMaxHomeLimit();
@@ -92,7 +152,6 @@ public int getHomeLimit(Player player) {
         }
 
         // Check for specific permission-based limits (highest first)
-        // These override the default if enabled
         if (player.hasPermission("homes.limit.50")) {
             return Math.min(50, config.getMaxHomeLimit());
         }
@@ -115,4 +174,14 @@ public int getHomeLimit(Player player) {
         // Fall back to config default
         return config.getDefaultHomeLimit();
     }
+
+    /**
+     * Get the home limit for an offline player by UUID only.
+     * Uses grants and default limit (cannot check permissions for offline players).
+     */
+    public int getHomeLimitByUuid(UUID playerId) {
+        int bonusHomes = grantStorage.getBonusHomes(playerId);
+        int grantLimit = config.getDefaultHomeLimit() + bonusHomes;
+        return Math.min(grantLimit, config.getMaxHomeLimit());
+    }
 }