Bump to 1.3.1

Closes #1

.gitignore

@@ -3,3 +3,4 @@ build/
 out/
 .idea/
 libs/
+run/

README.md

@@ -1,27 +1,37 @@
 # ItemEconomy II
-ItemEconomy II is a fork of [ItemEconomy](https://modrinth.com/plugin/itemeconomy), keeping it updated to later versions of Minecraft and adding new features.
+<p align="center">
+<img alt="image" align="center" src="https://github.com/user-attachments/assets/06b7c885-e11d-415c-b45c-bea51f7e2cb7" />
+</p>
 
-This PaperMC plugin integrates with Vault to provide a unique, item-based economy system for your Minecraft server. Instead of relying solely on virtual balances, players use in-game items as physical currency, adding a layer of immersion and realism to your economy.
+**ItemEconomy II** is a fork of [ItemEconomy](https://modrinth.com/plugin/itemeconomy), keeping it updated to later versions of Minecraft and adding new features.
-Features:
 
-- Item-Based Currency: Set any Minecraft item as your server's currency (default: diamonds).
+This PaperMC plugin integrates with VaultUnlocked to provide a unique, item-based economy system for your Minecraft server. Instead of relying solely on virtual balances, players use in-game items as physical currency, adding a layer of immersion and realism to your economy.
-- VaultUnlocked Integration: Fully compatible with VaultUnlocked, enabling seamless interaction with other economy-based plugins.
-- Simple logic: Just checks if the user has the item/how many when queried.
-- Customizable Formatting: Define how your currency is displayed, including singular and plural forms.
-- Ender Chest support: Items on Ender Chests are counted in the user balance.
 
-## Configuration Example:
+ItemEconomy is as powerful as you need and as simple as you want, with every feature being optional.
-```yaml
-item: diamond        # Define the item to be used as currency.
-singular: diamond    # Singular form of the currency.
-plural: diamonds     # Plural form of the currency.
-format: "{}$"        # Customize how the currency is displayed in messages.
-ender_chest: balance # Either none or balance
-```
-This configuration will use diamonds as the currency, displayed as {amount}$, e.g., "5 diamonds" or "1 diamond".
 
-## Usage:
+## Features
+- **Item-Based Currency:** Set any Minecraft item as your server's currency (diamonds by default).
+- **VaultUnlocked Integration:** Fully compatible with VaultUnlocked, enabling seamless interaction with other economy-based plugins.
+- **Simple logic:** Just checks if the user has the item/how many when queried.
+- **Customizable Formatting:** Define how your currency is displayed, including singular and plural forms.
+- **Ender Chest support:** Items on Ender Chests are counted in the user balance.
+- **Built-int optional balance and pay commands** with support for permissions.
+- **Translation support** with per-user language and per-language currency name.
 
+## Configuration
+An updated example configuration file is available [here](https://github.com/adrianvic/ItemEconomy/blob/main/src/main/resources/config.yml).
+
+## Usage
 - Players can earn, trade, and store the configured item as physical currency.
-- Integrates seamlessly with Vault-compatible plugins for shops, auctions, and more.
+- Once they spend the currency, that amount of the item will be subtracted from their inventory.
 - Administrators can customize the item and formatting to match their server's theme.
+
+## Commands
+<dl>
+  <dt>/balance <player></dt>
+  <dd>Prints player balance, permission is `iteco.balance` but is allowed by default. Requires permission `iteco.balance.others` to specify other user.</dd>
+<dt>/pay <player> <amount></dt>
+<dd>Transfers money from your account to another player's, permission is `iteco.pay` but is allowed by default.</dd>
+<dt>/itecoreload</dt>
+<dd>Reloads the plugin configuration, requires permission `iteco.reload`.</dd>
+</dl>

src/main/java/io/github/adrianvic/itemeconomy/Config.java

@@ -1,9 +1,10 @@
 package io.github.adrianvic.itemeconomy;
 
+import org.bukkit.ChatColor;
 import org.bukkit.Material;
+import org.bukkit.entity.Player;
 
-import java.util.HashMap;
+import java.util.*;
-import java.util.Map;
 
 public class Config {
     private static Map<String, String> entries = new HashMap<>();
@@ -12,10 +13,15 @@ public class Config {
     public static void loadConfig(UnrealConfig conf) {
         uConf = conf;
         entries.put("item", "diamond");
-        entries.put("format", "{}$");
+        entries.put("format", "{} $");
         entries.put("plural", "diamonds");
         entries.put("singular", "diamond");
         entries.put("ender_chest", "balance");
+        entries.put("commands", "true");
+        entries.put("player", "&a{}");
+        entries.put("localization", "default");
+        getAvailableLocales().forEach(l -> entries.put("plural_%s".formatted(l.getLanguage()), entries.get("plural")));
+        getAvailableLocales().forEach(l -> entries.put("singular_%s".formatted(l.getLanguage()), entries.get("singular")));
 
         Map<String, String> missingValues = new HashMap<>();
 
@@ -44,6 +50,44 @@ public class Config {
        return entries.get(entry).equals(value);
     }
 
+    public static boolean safeIs(String entry, String value) {
+        return is(entry.toLowerCase(Locale.ROOT), value.toLowerCase(Locale.ROOT));
+    }
+
+    public static String getCurrencyText(int amount, String lang) {
+        String plural = entries.get("plural_%s".formatted(lang));
+        String singular = entries.get("singular_%s".formatted(lang));
+
+        if (plural == null || singular == null) {
+            plural = entries.get("plural");
+            singular = entries.get("singular");
+        }
+
+        return ChatColor.translateAlternateColorCodes('&', entries.get("format")
+                .replace("{}", String.valueOf(amount))
+                .replace("$", (amount != 1) ? plural : singular)
+        + ChatColor.RESET
+        );
+    }
+
+    public static String getCurrencyText(int amount, Locale locale) {
+        return getCurrencyText(amount, locale.getLanguage());
+    }
+
+    public static String getCurrencyText(int amount) {
+        return getCurrencyText(amount, getServerLocale().getLanguage());
+    }
+
+
+    public static Locale getServerLocale() {
+        Locale locale = Locale.forLanguageTag(entries.get("localization"));
+        if (locale.getCountry().isEmpty()) {
+            locale = Locale.getDefault();
+        }
+
+        return locale;
+    }
+
     public static UnrealConfig getuConf() {
         return uConf;
     }
@@ -58,4 +102,19 @@ public class Config {
 
         return Material.DIAMOND;
     }
+
+    public static String playerPrefix(String playerName) {
+        return ChatColor.translateAlternateColorCodes('&', entries.get("player").replace("{}", playerName)) + ChatColor.RESET;
+    }
+
+    public static String playerPrefix(Player player) {
+        return playerPrefix(player.getName());
+    }
+
+    public static Set<Locale> getAvailableLocales() {
+        return Set.of(
+                Locale.forLanguageTag("en"),
+                Locale.forLanguageTag("pt")
+        );
+    }
 }

src/main/java/io/github/adrianvic/itemeconomy/Main.java

@@ -2,6 +2,8 @@ package io.github.adrianvic.itemeconomy;
 
 import java.util.*;
 
+import io.github.adrianvic.itemeconomy.commands.Balance;
+import io.github.adrianvic.itemeconomy.commands.Pay;
 import io.github.adrianvic.itemeconomy.commands.Reload;
 import net.milkbowl.vault.economy.Economy;
 import org.bukkit.Bukkit;
@@ -13,111 +15,134 @@ import org.bukkit.plugin.ServicePriority;
 import org.bukkit.plugin.java.JavaPlugin;
 
 public class Main extends JavaPlugin {
-   private static Main instance;
+    private static Main instance;
+    private static Economy economy;
 
-   public void onEnable() {
+    public void onEnable() {
-      instance = this;
+        instance = this;
-      Config.loadConfig(new UnrealConfig(this, this.getDataFolder(), "config.yml"));
+        Config.loadConfig(new UnrealConfig(this, this.getDataFolder(), "config.yml"));
-      Bukkit.getServicesManager().register(Economy.class, new VaultLayer(), this, ServicePriority.High);
+        getLogger().info(Messages.ENABLING.get(
-      getCommand("itecoreload").setExecutor(new Reload());
+                "ItemEconomy",
-   }
+                getDescription().getVersion(),
+                Config.getServerLocale()
+        ));
+        economy = new VaultLayer();
+        Bukkit.getServicesManager().register(Economy.class, economy, this, ServicePriority.High);
 
-   public static JavaPlugin getInstance() {
+        getCommand("itecoreload").setExecutor(new Reload());
-      return instance;
+        if (Config.safeIs("commands", "true")) {
-   }
+            getCommand("balance").setExecutor(new Balance());
+            getCommand("pay").setExecutor(new Pay());
+        }
+    }
 
-   public void onDisable() {
+    public void onDisable() {
-      super.onDisable();
+        super.onDisable();
-   }
+    }
 
-   public enum InventoryID {
+    public static JavaPlugin getInstance() {
-      INVENTORY,
+        return instance;
-      ENDER_CHEST
+    }
-   }
 
-   public static Inventory getInventory(Player player, InventoryID inventory) {
+    public static Economy getEconomy() {
-      Inventory inv = player.getInventory();
+        return economy;
+    }
 
-      switch (inventory) {
+    public enum InventoryID {
-         case INVENTORY -> {
+        INVENTORY,
-            inv = player.getInventory();
+        ENDER_CHEST
-         }
+    }
-         case ENDER_CHEST -> {
+
-            if (Config.is("ender_chest", "balance")) {
+    public static Inventory getInventory(Player player, InventoryID inventory) {
-               inv = player.getEnderChest();
+        Inventory inv = player.getInventory();
-            } else {
+
-               inv = getInstance().getServer().createInventory(null, 9);
+        switch (inventory) {
+            case INVENTORY -> inv = player.getInventory();
+            case ENDER_CHEST -> {
+                if (Config.is("ender_chest", "balance")) {
+                    inv = player.getEnderChest();
+                } else {
+                    inv = getInstance().getServer().createInventory(null, 9);
+                }
             }
-         }
+        }
-      }
 
-      return inv;
+        return inv;
-   }
+    }
 
-   public static List<ItemStack> getInventoryList(Player player, InventoryID inventory) {
+    public static List<ItemStack> getInventoryList(Player player, InventoryID inventory) {
-      Inventory inv = getInventory(player, inventory);
+        Inventory inv = getInventory(player, inventory);
-      return Arrays.stream(inv.getContents()).map((o) -> o == null ? new ItemStack(Material.AIR) : o).toList();
+        return Arrays.stream(inv.getContents()).map((o) -> o == null ? new ItemStack(Material.AIR) : o).toList();
-   }
+    }
 
-   public static List<ItemStack> getInventoryList(Player player) {
+    public static List<ItemStack> getInventoryList(Player player) {
-      return getInventoryList(player, InventoryID.INVENTORY);
+        return getInventoryList(player, InventoryID.INVENTORY);
-   }
+    }
 
-   public static double getBalance(Player player, InventoryID inventory) {
+    public static double getBalance(Player player, InventoryID inventory) {
-      return (double) getInventoryList(player, inventory).stream().filter(Objects::nonNull).filter((i) -> {
+        return getInventoryList(player, inventory).stream().filter(Objects::nonNull).filter((i) -> i.getType().equals(Config.ecoItem())).mapToInt(ItemStack::getAmount).sum();
-         return i.getType().equals(Config.ecoItem());
+    }
-      }).mapToInt(ItemStack::getAmount).sum();
-   }
 
-   public static double getBalance(Player player) {
+    public static double getBalance(Player player) {
-      Double total = 0.0D;
+        double total = 0.0D;
 
-      for (InventoryID id : InventoryID.values()) {
+        for (InventoryID id : InventoryID.values()) {
-         total += getBalance(player, id);
+            total += getBalance(player, id);
-      }
+        }
 
-      return total;
+        return total;
-   }
+    }
 
-   public static double getBalance(String player) {
+    public static double getBalance(String player) {
-      return getBalance(Bukkit.getPlayer(player));
+        return getBalance(Bukkit.getPlayer(player));
-   }
+    }
 
-   public static boolean removeItems(Player player, Material type, int amount) {
+    public static boolean removeItems(Player player, Material type, int amount) {
-      int remaining = amount;
+        int remaining = amount;
 
-      remaining = removeFrom(player.getInventory(), type, remaining);
+        remaining = removeFrom(player.getInventory(), type, remaining);
-      if (remaining > 0) {
+        if (remaining > 0) {
-         remaining = removeFrom(player.getEnderChest(), type, remaining);
+            remaining = removeFrom(player.getEnderChest(), type, remaining);
-      }
+        }
 
-      return remaining == 0;
+        return remaining == 0;
-   }
+    }
 
-   private static int removeFrom(Inventory inv, Material type, int amount) {
+    private static int removeFrom(Inventory inv, Material type, int amount) {
-      if (amount <= 0) return 0;
+        if (amount <= 0) return 0;
 
-      for (ItemStack stack : inv.all(type).values()) {
+        for (ItemStack stack : inv.all(type).values()) {
-         int take = Math.min(stack.getAmount(), amount);
+            int take = Math.min(stack.getAmount(), amount);
-         stack.setAmount(stack.getAmount() - take);
+            stack.setAmount(stack.getAmount() - take);
-         amount -= take;
+            amount -= take;
-         if (amount == 0) break;
+            if (amount == 0) break;
-      }
+        }
 
-      return amount;
+        return amount;
-   }
+    }
 
+    public static void addItems(Player player, Material type, int amount) {
+        if (amount <= 0) return;
 
-   public static void addItems(Player player, Material type, int amount) {
+        HashMap<Integer, ItemStack> invOverflow =
-      HashMap<Integer, ItemStack> invOverflow = getInventory(player, InventoryID.INVENTORY).addItem(new ItemStack(type, amount));
+                getInventory(player, InventoryID.INVENTORY)
-      HashMap<Integer, ItemStack> echestOverflow = getInventory(player, InventoryID.ENDER_CHEST).addItem(new ItemStack(type, invOverflow.values()
+                        .addItem(new ItemStack(type, amount));
-              .stream()
-              .mapToInt(ItemStack::getAmount)
-              .sum()));
 
+        int overflowAmount = invOverflow.values()
+                .stream()
+                .mapToInt(ItemStack::getAmount)
+                .sum();
 
-      for (ItemStack overflow : echestOverflow.values()){
+        if (overflowAmount <= 0) {
-         player.getWorld().dropItemNaturally(player.getLocation(), overflow);
+            return;
-      }
+        }
-   }
+
+        HashMap<Integer, ItemStack> echestOverflow =
+                getInventory(player, InventoryID.ENDER_CHEST)
+                        .addItem(new ItemStack(type, overflowAmount));
+
+        for (ItemStack overflow : echestOverflow.values()) {
+            player.getWorld().dropItemNaturally(player.getLocation(), overflow);
+        }
+    }
 }

src/main/java/io/github/adrianvic/itemeconomy/Messages.java

@@ -0,0 +1,51 @@
+package io.github.adrianvic.itemeconomy;
+
+import io.github.adrianvic.itemeconomy.commands.Utils;
+import org.bukkit.ChatColor;
+import org.bukkit.entity.Player;
+
+import java.util.Locale;
+import java.util.ResourceBundle;
+
+public enum Messages {
+    ENABLING("enabling"),
+    BALANCE_SUCCESSFUL("balance-successful"),
+    BALANCE_OTHER_SUCCESSFUL("balance-other-successful"),
+    MUST_BE_PLAYER_TO_ISSUE_COMMAND("must-be-player-to-issue-command"),
+    PAY_SUCCESSFUL("pay-successful"),
+    PAY_RECEIVED("pay-received"),
+    PAY_COULD_NOT_REALIZE_TRANSACTION("pay-could-not-realize-transaction"),
+    PAY_COULD_NOT_FIND_TARGET("pay-could-not-find-target"),
+    PAY_NOT_ENOUGH_MONEY("pay-not-enough-money"),
+    PAY_INVALID_AMOUNT("pay-invalid-amount"),
+    RELOADING("reloading"),
+    RELOAD_ERROR("reload-error"),
+    RELOAD_FINISHED("reload-finished");
+
+
+    private final String path;
+    Messages(String path) { this.path = path; }
+
+    private String raw(Locale locale) {
+        ResourceBundle bundle = ResourceBundle.getBundle("messages", locale);
+        return bundle.getString(path);
+    }
+
+    public String get(Locale locale, Object... args) {
+        String pattern = raw(locale);
+        try {
+            return ChatColor.translateAlternateColorCodes('&', args.length == 0 ? pattern : String.format(pattern, args));
+        } catch (Exception e) {
+            return pattern;
+        }
+    }
+
+    public String get(Player player, Object... args) {
+        Locale locale = Utils.localeOrDefault(player);
+        return get(locale, args);
+    }
+
+    public String get(Object... args) {
+        return get(Config.getServerLocale(), args);
+    }
+}

src/main/java/io/github/adrianvic/itemeconomy/VaultLayer.java

@@ -26,7 +26,7 @@ public class VaultLayer implements Economy {
    }
 
    public String format(double amount) {
-      return Config.get("format").replace("{}", String.valueOf(amount));
+      return Config.getCurrencyText((int) amount);
    }
 
    public String currencyNamePlural() {

src/main/java/io/github/adrianvic/itemeconomy/commands/Balance.java

@@ -0,0 +1,49 @@
+package io.github.adrianvic.itemeconomy.commands;
+
+import io.github.adrianvic.itemeconomy.Config;
+import io.github.adrianvic.itemeconomy.Main;
+import io.github.adrianvic.itemeconomy.Messages;
+import org.bukkit.Bukkit;
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandExecutor;
+import org.bukkit.command.CommandSender;
+import org.bukkit.command.TabCompleter;
+import org.bukkit.entity.Player;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.stream.Collectors;
+
+public class Balance implements CommandExecutor, TabCompleter {
+    @Override
+    public boolean onCommand(@NotNull CommandSender commandSender, @NotNull Command command, @NotNull String s, @NotNull String @NotNull [] strings) {
+        if ((commandSender.isOp() || commandSender.hasPermission("iteco.balance.others")) && strings.length > 0) {
+            double amount = Main.getEconomy().getBalance(strings[0]);
+            commandSender.sendMessage(Messages.BALANCE_OTHER_SUCCESSFUL.get(
+                    Utils.localeOrDefault(commandSender),
+                    Config.playerPrefix(strings[0]),
+                    Config.getCurrencyText((int) amount, Utils.localeOrDefault(commandSender))
+            ));
+        } else {
+            if (commandSender instanceof Player player) {
+                double amount = Main.getEconomy().getBalance(player);
+                commandSender.sendMessage(Messages.BALANCE_SUCCESSFUL.get(player, Config.getCurrencyText((int) amount, Utils.localeOrDefault(commandSender))));
+            } else {
+                commandSender.sendMessage(Messages.MUST_BE_PLAYER_TO_ISSUE_COMMAND.get());
+            }
+        }
+        return true;
+    }
+
+    @Override
+    public @Nullable List<String> onTabComplete(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String @NotNull [] args) {
+        if ((sender.isOp() || sender.hasPermission("iteco.balance.others")) && args.length == 1) {
+            return Bukkit.getOnlinePlayers()
+                    .stream()
+                    .map(Player::getName)
+                    .collect(Collectors.toList());
+        }
+        return List.of();
+    }
+}

src/main/java/io/github/adrianvic/itemeconomy/commands/Pay.java

@@ -0,0 +1,79 @@
+package io.github.adrianvic.itemeconomy.commands;
+
+import io.github.adrianvic.itemeconomy.Config;
+import io.github.adrianvic.itemeconomy.Main;
+import io.github.adrianvic.itemeconomy.Messages;
+import net.milkbowl.vault.economy.EconomyResponse;
+import org.bukkit.Bukkit;
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandExecutor;
+import org.bukkit.command.CommandSender;
+import org.bukkit.command.TabCompleter;
+import org.bukkit.entity.Player;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Locale;
+import java.util.stream.Collectors;
+
+public class Pay implements CommandExecutor, TabCompleter {
+    @Override
+    public boolean onCommand(@NotNull CommandSender commandSender, @NotNull Command command, @NotNull String s, @NotNull String @NotNull [] strings) {
+        if (strings.length < 2) {
+            commandSender.sendMessage(command.getUsage());
+            return false;
+        }
+
+        int amount;
+
+        try {
+            amount = Integer.parseInt(strings[1]);
+            String amountString = Config.getCurrencyText(amount, Utils.localeOrDefault(commandSender));
+
+            if (commandSender instanceof Player player && Main.getEconomy().has(player, amount)) {
+                if (Bukkit.getPlayer(strings[0]) instanceof Player target) {
+                    EconomyResponse withdrawResponse = Main.getEconomy().withdrawPlayer(player.getName(), amount);
+                    if (withdrawResponse.transactionSuccess()) {
+                        EconomyResponse depositResponse = Main.getEconomy().depositPlayer(target.getName(), amount);
+                        if (depositResponse.transactionSuccess()) {
+                            commandSender.sendMessage(Messages.PAY_SUCCESSFUL.get(
+                                    Utils.localeOrDefault(commandSender),
+                                    amountString,
+                                    Config.playerPrefix(target)));
+                            target.sendMessage(Messages.PAY_RECEIVED.get(target, amountString, Config.playerPrefix(player)));
+                        } else {
+                            commandSender.sendMessage(Messages.PAY_COULD_NOT_REALIZE_TRANSACTION.get(Utils.localeOrDefault(commandSender), depositResponse.errorMessage));
+                            Main.getEconomy().depositPlayer(player.getName(), amount);
+                        }
+                    } else {
+                        commandSender.sendMessage(Messages.PAY_COULD_NOT_REALIZE_TRANSACTION.get(Utils.localeOrDefault(commandSender), withdrawResponse.errorMessage));;
+                    }
+                } else {
+                    commandSender.sendMessage(Messages.PAY_COULD_NOT_FIND_TARGET.get(Utils.localeOrDefault(commandSender)));
+                }
+            } else {
+                commandSender.sendMessage(Messages.PAY_NOT_ENOUGH_MONEY.get(Utils.localeOrDefault(commandSender)));
+            }
+        } catch (NumberFormatException nfe) {
+            commandSender.sendMessage(Messages.PAY_INVALID_AMOUNT.get(Utils.localeOrDefault(commandSender)));
+            return true;
+        }
+
+        return true;
+    }
+
+    @Override
+    public @Nullable List<String> onTabComplete(@NotNull CommandSender sender, @NotNull Command command, @NotNull String label, @NotNull String @NotNull [] args) {
+        if (sender instanceof Player player) {
+            if (args.length == 1) {
+                return Bukkit.getOnlinePlayers()
+                        .stream()
+                        .map(Player::getName)
+                        .collect(Collectors.toList());
+            }
+        }
+
+        return List.of();
+    }
+}

src/main/java/io/github/adrianvic/itemeconomy/commands/Reload.java

@@ -2,20 +2,28 @@ package io.github.adrianvic.itemeconomy.commands;
 
 import io.github.adrianvic.itemeconomy.Config;
 import io.github.adrianvic.itemeconomy.Main;
+import io.github.adrianvic.itemeconomy.Messages;
 import io.github.adrianvic.itemeconomy.UnrealConfig;
 import org.bukkit.command.Command;
 import org.bukkit.command.CommandExecutor;
 import org.bukkit.command.CommandSender;
 import org.jetbrains.annotations.NotNull;
 
+import java.util.Locale;
+
 public class Reload implements CommandExecutor {
 
     @Override
     public boolean onCommand(@NotNull CommandSender commandSender, @NotNull Command command, @NotNull String s, @NotNull String @NotNull [] strings) {
+        Locale locale = Utils.localeOrDefault(commandSender);
         try {
+            commandSender.sendMessage("[ECONOMY] %s".formatted(Messages.RELOADING.get(locale)));
             Config.loadConfig(new UnrealConfig(Main.getInstance(), Main.getInstance().getDataFolder(), "config.yml"));
+            commandSender.sendMessage("[ECONOMY] %s".formatted(Messages.RELOAD_FINISHED.get(locale)));
             return true;
         } catch (Exception e) {
+            commandSender.sendMessage("[ECONOMY] %s".formatted(Messages.RELOAD_ERROR.get(locale)));
+            e.printStackTrace();
             return false;
         }
     }

src/main/java/io/github/adrianvic/itemeconomy/commands/Utils.java

@@ -0,0 +1,15 @@
+package io.github.adrianvic.itemeconomy.commands;
+
+import io.github.adrianvic.itemeconomy.Config;
+import io.github.adrianvic.itemeconomy.Main;
+import org.bukkit.command.CommandSender;
+import org.bukkit.entity.Player;
+
+import java.util.Locale;
+
+public class Utils {
+    public static Locale localeOrDefault(CommandSender sender) {
+        return (sender instanceof Player p) ? Locale.forLanguageTag(p.getLocale().replace('_', '-')) : Config.getServerLocale();
+    }
+
+}

src/main/resources/config.yml

@@ -1,4 +1,7 @@
-item: "diamond"
+item: "diamond" # MUST be a valid item.
 singular: "diamond"
 plural: "diamonds"
-format: "{}$"
+format: "&b{} $" # {} unfolds to amount and $ to singular or plural.
+commands: "true" # Enables or disables plugin commands.
+player: "&b{}" # {} unfolds to player name.
+localization: "default" # can be "en" and "pt" too, if set to anything else uses system locale.

src/main/resources/messages.properties

@@ -0,0 +1,13 @@
+enabling=enabling
+balance-successful=balance-successful
+balance-other-successful=balance-other-successful
+must-be-player-to-issue-command=must-be-player-to-issue-command
+pay-successful=pay-successful
+pay-received=pay-received
+pay-could-not-realize-transaction=pay-could-not-realize-transaction
+pay-could-not-find-target=pay-could-not-find-target
+pay-not-enough-money=pay-not-enough-money
+pay-invalid-amount=pay-invalid-amount
+reloading=reloading
+reload-error=reload-error
+reload-finished=reload-finished

src/main/resources/messages_en.properties

@@ -0,0 +1,13 @@
+enabling=Starting %s version %s with locale '%s'.
+balance-successful=You have %s.
+balance-other-successful=%s has %s.
+must-be-player-to-issue-command=You must be a player to issue this command.
+pay-successful=Transaction of %s to %s was successfully realized.
+pay-received=You received %s from %s.
+pay-could-not-realize-transaction=Could not realize transaction: %s
+pay-could-not-find-target=Could not find target player.
+pay-not-enough-money=You don't have enough money.
+pay-invalid-amount=The amount you tried to pay is not valid.
+reloading=Reloading...
+reload-error=An error occurred while reloading the config, please check your logs.
+reload-finished=Reload complete.

src/main/resources/messages_pt.properties

@@ -0,0 +1,13 @@
+enabling=Iniciando %s versão %s com localização para %s.
+balance-successful=Você tem %s.
+balance-other-successful=%s possui %s.
+must-be-player-to-issue-command=Você precisa ser um jogador para executar esse comando.
+pay-successful=Transação de %s para %s realizada com sucesso.
+pay-received=Você recebeu %s de %s.
+pay-could-not-realize-transaction=Não foi possível realizar a transação: %s
+pay-could-not-find-target=Não foi possível encontrar o jogador-alvo.
+pay-not-enough-money=Você não tem dinheiro suficiente.
+pay-invalid-amount=A quantidade que você tentou enviar é inválida.
+reloading=Recarregando...
+reload-error=Ocorreu um erro ao recarregar, por favor, verifique seu registro.
+reload-finished=Carregamento completo.

src/main/resources/plugin.yml

@@ -1,11 +1,32 @@
 name: ItemEconomy
 main: io.github.adrianvic.itemeconomy.Main
-version: 1.1
+version: 1.3.1
-depend:
+depend: [Vault]
-- Vault
 api-version: '1.21'
 commands:
   itecoreload:
     description: Reloads the config for ItemEconomy
-    usage: /itecoreload
+    usage: "/itecoreload"
     permission: iteco.reload
+    default: op
+  balance:
+    description: Prints your balance
+    usage: "/balance"
+    aliases: [bal]
+    permission: iteco.balance
+  pay:
+    description: Transfers money from your balance to other player
+    usage: "/pay <player> <amount>"
+    permission: iteco.pay
+permissions:
+  iteco.reload:
+    description: "Permission to use the command '/itecoreload'."
+    default: false
+  iteco.balance:
+    description: "Permission to use the command '/balance'."
+    default: true
+    children:
+      iteco.balance.others: false
+  iteco.pay:
+    description: "Permission to use the command '/pay'."
+    default: true