// Internal usage example:
@Service
public class LuckPermsMetaService {

    private final LuckPerms luckPerms;

    public double getMultiplier(Player player) {
        User user = luckPerms.getUserManager().getUser(player.getUniqueId());
        if (user == null) return 1.0;

        String meta = user.getCachedData().getMetaData().getMetaValue("balance-multiplier");
        return meta != null ? Double.parseDouble(meta) : 1.0;
    }

    public BigDecimal getDailyLimit(Player player) {
        MetaDataStack meta = luckPerms.getUserManager().getUser(player.getUniqueId())
            .getCachedData().getMetaData();
        String limit = meta.getMetaValue("max-daily-transfer");
        return limit != null ? new BigDecimal(limit) : new BigDecimal("1000000");
    }
}

/lp user Notch meta set balance-multiplier 1.5
/lp group vip meta set max-daily-transfer 500000
/lp group premium meta set tax-exempt true
/lp group admin permission set vault.admin true

public EconomyResponse depositWithContext(Player player, BigDecimal amount, String currency) {
    Contexts contexts = luckPerms.getContextManager().getContexts(player);

    // World-specific currency restriction
    if (currency.equals("nether_coins") && !contexts.getContexts().containsKey("world:world_nether")) {
        return new EconomyResponse(0, 0, EconomyResponse.ResponseType.FAILURE,
            "nether_coins can only be used in the Nether");
    }

    return economy.depositPlayer(player, amount.doubleValue());
}

# config.yml
luckperms:
  enabled: true
  use_meta_multipliers: true
  use_meta_limits: true
  context_aware_currencies: true
  cache_meta_seconds: 300
  auto_register_permissions: true

softdepend:
  - LuckPerms

if (Bukkit.getPluginManager().isPluginEnabled("LuckPerms")) {
    LuckPerms api = LuckPermsProvider.get();
    metaService = new LuckPermsMetaService(api);
    permissionRegistry = new LuckPermsPermissionRegistry(api);
} else {
    metaService = new DefaultMetaService();
    permissionRegistry = new BukkitPermissionRegistry();
}

1. Admin runs /eco give Notch 1000
2. VaultPermissionRegistry checks vault.eco.give
3. LuckPermsMetaService reads balance-multiplier meta
   ├─ balance-multiplier = 1.5 → final amount = 1500
   └─ tax-exempt = false → apply 2% transfer tax
4. depositPlayer() executes with adjusted amount
5. TransactionEvent is fired with multiplier metadata