MultiplierService

Manages price multipliers for different scenarios.

bShop Multiplier API

The bShop plugin now includes a comprehensive multiplier system that allows both permission-based and temporary player-specific multipliers.

Features

• Permission-based Multipliers: Configured in config.yml and applied based on player permissions

• Temporary Multipliers: Can be given/removed via commands or API calls

• API Integration: Full API support for external plugins

• Admin Commands: Built-in commands for multiplier management

Configuration

Permission-based Multipliers

Configure in config.yml:

multipliers:
  enabled: true
  max_multiplier: 5.0
  stack_multipliers: false
  permission_multipliers:
    bshop.multiplier.1.5: 0.5
    bshop.multiplier.2.0: 1.0
    bshop.multiplier.3.0: 2.0

• enabled: Enable/disable the multiplier system

• max_multiplier: Maximum allowed multiplier value

• stack_multipliers: If true, multipliers stack additively; if false, only highest applies

• permission_multipliers: Map of permission to multiplier bonus

Admin Commands

Give Multiplier

/shop multiplier give <player> <multiplier>

Gives a temporary multiplier to a player.

Example:

/shop multiplier give PlayerName 2.5

Remove Multiplier

/shop multiplier remove <player>

Removes a temporary multiplier from a player.

Example:

/shop multiplier remove PlayerName

Check Multiplier

/shop multiplier check <player>

Shows detailed multiplier information for a player.

Example:

/shop multiplier check PlayerName

List Multipliers

/shop multiplier list

Lists all active temporary multipliers.

Clear Multipliers

/shop multiplier clear

Removes all temporary multipliers from all players.

API Usage

Getting the API

import net.bumpier.bshop.BShopAPI;
import net.bumpier.bshop.util.MultiplierService;

BShopAPI api = BShopAPI.getInstance();
MultiplierService multiplierService = api.getMultiplierService();

Basic Multiplier Operations

// Get a player's current multiplier
double multiplier = multiplierService.getPlayerMultiplier(player);

// Get formatted multiplier display
String display = multiplierService.getMultiplierDisplay(player);

// Apply multiplier to a price
double adjustedPrice = multiplierService.applyMultiplier(player, basePrice);

Temporary Multiplier Management

// Set a temporary multiplier
boolean success = multiplierService.setTemporaryMultiplier(player, 2.5);

// Set by UUID (for offline players)
boolean success = multiplierService.setTemporaryMultiplier(playerUuid, 2.5);

// Remove a temporary multiplier
boolean removed = multiplierService.removeTemporaryMultiplier(player);

// Check if player has temporary multiplier
boolean hasTemp = multiplierService.hasTemporaryMultiplier(player);

// Get temporary multiplier value
Double tempMultiplier = multiplierService.getTemporaryMultiplier(player);

// Get all temporary multipliers
Map<UUID, Double> allTemp = multiplierService.getTemporaryMultipliers();

// Clear all temporary multipliers
multiplierService.clearTemporaryMultipliers();

System Information

// Check if multipliers are enabled
boolean enabled = multiplierService.isEnabled();

// Get maximum allowed multiplier
double maxMultiplier = multiplierService.getMaxMultiplier();

// Check if multipliers stack
boolean stackMultipliers = multiplierService.isStackMultipliers();

// Get all permission multipliers
Map<String, Double> permissionMultipliers = multiplierService.getPermissionMultipliers();

Integration Example

Here's a complete example of how to integrate multiplier functionality into your plugin:

public class MyPlugin extends JavaPlugin {
    
    private BShopAPI bShopAPI;
    
    @Override
    public void onEnable() {
        // Get bShop API
        bShopAPI = BShopAPI.getInstance();
        if (bShopAPI == null) {
            getLogger().severe("bShop not found! Please install bShop first.");
            getServer().getPluginManager().disablePlugin(this);
            return;
        }
        
        // Register commands
        getCommand("mymultiplier").setExecutor(new MyMultiplierCommand(this));
    }
    
    public class MyMultiplierCommand implements CommandExecutor {
        private final MyPlugin plugin;
        
        public MyMultiplierCommand(MyPlugin plugin) {
            this.plugin = plugin;
        }
        
        @Override
        public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
            if (args.length < 3) {
                sender.sendMessage("Usage: /mymultiplier <give|remove|check> <player> [multiplier]");
                return true;
            }
            
            String action = args[0].toLowerCase();
            String playerName = args[1];
            Player target = Bukkit.getPlayer(playerName);
            
            if (target == null) {
                sender.sendMessage("Player not found: " + playerName);
                return true;
            }
            
            MultiplierService multiplierService = bShopAPI.getMultiplierService();
            
            switch (action) {
                case "give":
                    if (args.length < 3) {
                        sender.sendMessage("Usage: /mymultiplier give <player> <multiplier>");
                        return true;
                    }
                    try {
                        double multiplier = Double.parseDouble(args[2]);
                        boolean success = multiplierService.setTemporaryMultiplier(target, multiplier);
                        if (success) {
                            sender.sendMessage("Gave " + multiplier + "x multiplier to " + target.getName());
                            target.sendMessage("You received a " + multiplier + "x sell multiplier!");
                        } else {
                            sender.sendMessage("Failed to give multiplier to " + target.getName());
                        }
                    } catch (NumberFormatException e) {
                        sender.sendMessage("Invalid multiplier value: " + args[2]);
                    }
                    break;
                    
                case "remove":
                    boolean removed = multiplierService.removeTemporaryMultiplier(target);
                    if (removed) {
                        sender.sendMessage("Removed multiplier from " + target.getName());
                        target.sendMessage("Your sell multiplier has been removed!");
                    } else {
                        sender.sendMessage(target.getName() + " didn't have a temporary multiplier.");
                    }
                    break;
                    
                case "check":
                    double currentMultiplier = multiplierService.getPlayerMultiplier(target);
                    String display = multiplierService.getMultiplierDisplay(target);
                    sender.sendMessage("Multiplier for " + target.getName() + ": " + display);
                    break;
                    
                default:
                    sender.sendMessage("Unknown action: " + action);
                    break;
            }
            
            return true;
        }
    }
}

Permissions

• bshop.admin.multiplier.give - Give temporary multipliers

• bshop.admin.multiplier.remove - Remove temporary multipliers

• bshop.admin.multiplier.list - List all temporary multipliers

• bshop.admin.multiplier.clear - Clear all temporary multipliers

Notes

• Temporary multipliers take precedence over permission-based multipliers

• Multipliers are applied to sell prices only

• Temporary multipliers are not persistent (reset on server restart)

• The maximum multiplier value is enforced by the max_multiplier setting

• All multiplier operations are thread-safe