Updated: Made item aliases an optional feature, item aliases can now be set in item_aliases.csv when required. Also makes the default kit valid now (excluding an issue with damage values).

BlaneyXYZ · BlaneyXYZ · commit d1ac60a38b6a · 2025-10-09T20:18:11.000+11:00
diff --git a/modules/RoyalCommands/pom.xml b/modules/RoyalCommands/pom.xml
@@ -23,7 +23,7 @@
                 <includes>
                     <include>*.yml</include>
                     <include>*.txt</include>
-                    <include>items.csv</include>
+                    <include>item_aliases.csv</include>
                 </includes>
             </resource>
         </resources>
diff --git a/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/Config.java b/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/Config.java
@@ -366,15 +366,15 @@ public void reloadConfiguration() {
 
         Reader in = null;
         try {
-            in = new FileReader(new File(this.plugin.getDataFolder() + File.separator + "items.csv"));
+            in = new FileReader(new File(this.plugin.getDataFolder() + File.separator + "item_aliases.csv"));
             CSVReader reader = new CSVReader(in);
             RoyalCommands.inm = new ItemNameManager(reader.readAll());
             reader.close();
         } catch (FileNotFoundException e) {
-            this.plugin.getLogger().warning("items.csv was not found! Item aliases will not be used.");
+            this.plugin.getLogger().warning("item_aliases.csv was not found! Item aliases will not be used.");
             RoyalCommands.inm = null;
         } catch (final IOException e) {
-            this.plugin.getLogger().warning("Internal input/output error loading items.csv. Item aliases will not be used.");
+            this.plugin.getLogger().warning("Internal input/output error loading item_aliases.csv. Item aliases will not be used.");
             RoyalCommands.inm = null;
         } finally {
             try {
diff --git a/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/ItemNameManager.java b/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/ItemNameManager.java
@@ -26,29 +26,30 @@ public class ItemNameManager {
     public ItemNameManager(Iterable<String[]> values) {
         for (String[] s : values) {
             if (s.length < 1) continue;
+            if (s[0].startsWith("#")) continue;
             String[] aliases;
             try {
-                aliases = s[2].split(",");
+                aliases = s[1].split(",");
             } catch (IndexOutOfBoundsException e) {
                 Logger l = Logger.getLogger("Minecraft");
                 l.warning("[RoyalCommands] Values passed in ItemNameManager invalid: ");
                 for (String ss : s) l.warning("[RoyalCommands] - " + ss);
                 continue;
             }
             Material m;
-            short data;
+            short data = 0;
             try {
                 m = Material.valueOf(s[0]);
             } catch (IllegalArgumentException ex) {
-                RoyalCommands.getInstance().getLogger().warning("Material in items.csv is invalid: " + s[0]);
-                continue;
-            }
-            try {
-                data = Short.valueOf(s[1]);
-            } catch (NumberFormatException e) {
-                RoyalCommands.getInstance().getLogger().warning("Data in items.csv file is invalid: " + s[1]);
+                RoyalCommands.getInstance().getLogger().warning("Material in item_aliases.csv is invalid: " + s[0]);
                 continue;
             }
+//            try {
+//                data = Short.valueOf(s[1]);
+//            } catch (NumberFormatException e) {
+//                RoyalCommands.getInstance().getLogger().warning("Data in item_aliases.csv file is invalid: " + s[1]);
+//                continue;
+//            }
             synchronized (items) {
                 items.put(aliases, new Pair<>(m, data));
             }
diff --git a/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/RUtils.java b/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/RUtils.java
@@ -5,6 +5,7 @@
  */
 package org.royaldev.royalcommands;
 
+import org.apache.commons.lang3.ArrayUtils;
 import org.mvplugins.multiverse.core.world.LoadedMultiverseWorld;
 import org.mvplugins.multiverse.core.world.MultiverseWorld;
 
@@ -86,6 +87,7 @@
 import org.royaldev.royalcommands.rcommands.CmdBack;
 import org.royaldev.royalcommands.spawninfo.SpawnInfo;
 import org.royaldev.royalcommands.tools.NameFetcher;
+import org.royaldev.royalcommands.tools.Pair;
 import org.royaldev.royalcommands.tools.UUIDFetcher;
 
 @SuppressWarnings("unused")
diff --git a/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/RoyalCommands.java b/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/RoyalCommands.java
@@ -392,7 +392,7 @@ public boolean isVanished(Player p, CommandSender cs) {
 
     public void loadConfiguration() {
         if (!new File(getDataFolder(), "config.yml").exists()) saveDefaultConfig();
-        if (!new File(getDataFolder(), "items.csv").exists()) saveResource("items.csv", false);
+        if (!new File(getDataFolder(), "item_aliases.csv").exists()) saveResource("item_aliases.csv", false);
         if (!new File(getDataFolder(), "rules.txt").exists()) saveResource("rules.txt", false);
         if (!new File(getDataFolder(), "help.txt").exists()) saveResource("help.txt", false);
         if (!new File(getDataFolder(), "warps.yml").exists()) saveResource("warps.yml", false);
diff --git a/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/rcommands/CmdGive.java b/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/rcommands/CmdGive.java
@@ -25,7 +25,7 @@
 public class CmdGive extends TabCommand {
 
     public CmdGive(final RoyalCommands instance, final String name) {
-        super(instance, name, true, new Short[]{CompletionType.ONLINE_PLAYER.getShort(), CompletionType.ITEM_ALIAS.getShort()});
+        super(instance, name, true, new Short[]{CompletionType.ONLINE_PLAYER.getShort(), CompletionType.ITEM.getShort()});
     }
 
     public static boolean giveItemStandalone(CommandSender cs, Player target, String itemname, int amount) {
diff --git a/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/rcommands/CmdHelmet.java b/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/rcommands/CmdHelmet.java
@@ -21,7 +21,7 @@
 public class CmdHelmet extends TabCommand {
 
     public CmdHelmet(final RoyalCommands instance, final String name) {
-        super(instance, name, true, new Short[]{CompletionType.ITEM_ALIAS.getShort()});
+        super(instance, name, true, new Short[]{CompletionType.ITEM.getShort()});
     }
     /**
      * TODO: Add support to add a helmet to another player
diff --git a/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/rcommands/CmdItem.java b/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/rcommands/CmdItem.java
@@ -30,7 +30,7 @@ public class CmdItem extends TabCommand {
     private static final Flag<String> loreFlag = new Flag<>(String.class, "description", "lore", "l");
 
     public CmdItem(final RoyalCommands instance, final String name) {
-        super(instance, name, true, new Short[]{CompletionType.ITEM_ALIAS.getShort()});
+        super(instance, name, true, new Short[]{CompletionType.ITEM.getShort()});
         this.addExpectedFlag(CmdItem.nameFlag);
         this.addExpectedFlag(CmdItem.loreFlag);
     }
diff --git a/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/rcommands/CmdRecipe.java b/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/rcommands/CmdRecipe.java
@@ -36,15 +36,15 @@
 import org.royaldev.royalcommands.MessageColor;
 import org.royaldev.royalcommands.RUtils;
 import org.royaldev.royalcommands.RoyalCommands;
-import org.royaldev.royalcommands.exceptions.InvalidItemNameException;
+
 
 @ReflectCommand
 public class CmdRecipe extends TabCommand {
 
     private final Map<String, Integer> tasks = new HashMap<>();
 
     public CmdRecipe(final RoyalCommands instance, final String name) {
-        super(instance, name, true, new Short[]{CompletionType.ITEM_ALIAS.getShort()});
+        super(instance, name, true, new Short[]{CompletionType.ITEM.getShort()});
         this.plugin.getServer().getPluginManager().registerEvents(new WorkbenchCloseListener(), this.plugin);
     }
 
diff --git a/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/rcommands/CmdUses.java b/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/rcommands/CmdUses.java
@@ -47,7 +47,7 @@ public class CmdUses extends TabCommand {
     private final Map<String, Integer> tasks = new HashMap<>();
 
     public CmdUses(final RoyalCommands instance, final String name) {
-        super(instance, name, true, new Short[]{CompletionType.ITEM_ALIAS.getShort()});
+        super(instance, name, true, new Short[]{CompletionType.ITEM.getShort()});
         this.plugin.getServer().getPluginManager().registerEvents(new WorkbenchCloseListener(), this.plugin);
     }
 
diff --git a/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/rcommands/TabCommand.java b/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/rcommands/TabCommand.java
@@ -112,7 +112,10 @@ protected List<String> getCompletionsFor(final CommandSender cs, final Command c
                     final String name = m.getKeyOrNull().getKey();
                     final String lowerCaseName = name.toLowerCase();
                     if (!lowerCaseName.startsWith(arg)) continue;
+                    // Minecraft default item names
                     possibilities.add(lowerCaseName.equals(arg) ? 0 : possibilities.size(), name);
+                    // Custom item names
+                    possibilities.addAll(RoyalCommands.inm.getPossibleNames(arg));
                 }
                 break;
             case ATTRIBUTE:
@@ -279,7 +282,7 @@ protected enum CompletionType {
          */
         ONLINE_PLAYER((short) 1),
         /**
-         * Completes for any item alias in items.csv.
+         * Completes for any item alias in item_aliases.csv.
          */
         ITEM_ALIAS((short) 2),
         /**
diff --git a/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/rcommands/kits/Kit.java b/modules/RoyalCommands/src/main/java/org/royaldev/royalcommands/rcommands/kits/Kit.java
@@ -18,6 +18,7 @@
 
 import java.util.ArrayList;
 import java.util.List;
+import java.util.logging.Level;
 
 /**
  * A class representing a kit.
@@ -68,11 +69,11 @@ private Enchantment getEnchantment(final ConfigurationNode enchantment) {
      * @param item Node representing an ItemStack
      * @return ItemStack of null
      */
+    // TODO Handle invalid item names better
     private ItemStack getItemStack(final ConfigurationNode item) {
-        final ItemStack is = RoyalCommands.inm.getItemStackFromAlias(item.getString("type"));
-        final Damageable imd = (Damageable) is.getItemMeta();
+        final ItemStack is = RUtils.getItem(item.getString("type"), item.getInt("amount", 1));
         if (is == null) return null;
-        is.setAmount(item.getInt("amount", 1));
+        final Damageable imd = (Damageable) is.getItemMeta();
         imd.setDamage(item.getShort("damage", (short) 0));
         final ItemMeta im = is.getItemMeta();
         im.setDisplayName(RUtils.colorize(item.getString("name")));
@@ -92,7 +93,9 @@ private List<ItemStack> getItemStacks(final List<ConfigurationNode> items) {
         final List<ItemStack> itemStacks = new ArrayList<>();
         for (final ConfigurationNode item : items) {
             final ItemStack is = this.getItemStack(item);
-            if (is == null) continue;
+            if (is == null) {
+                continue;
+            }
             itemStacks.add(is);
         }
         return itemStacks;
diff --git a/modules/RoyalCommands/src/main/resources/config.yml b/modules/RoyalCommands/src/main/resources/config.yml
@@ -279,7 +279,7 @@ kits:
       description: An example kit.
       # List of items for this kit
       items:
-        - type: LOG:OAK
+        - type: OAK_LOG
           amount: 1
           # You can use colors in lore and names
           name: "&rWood of Champions"
@@ -299,9 +299,9 @@ kits:
     wool:
       description: A kit containing wool.
       items:
-        - type: WOOL:BLACK
+        - type: BLACK_WOOL
           amount: 64
-        - type: WOOL:BLUE
+        - type: BLUE_WOOL
           amount: 35
     # This kit can only be used once (cooldown of -1)
     onetime:
diff --git a/modules/RoyalCommands/src/main/resources/item_aliases.csv b/modules/RoyalCommands/src/main/resources/item_aliases.csv
@@ -0,0 +1 @@
+#"DIAMOND_SWORD","stabby_knife"
diff --git a/modules/RoyalCommands/src/test/java/org/royaldev/royalcommands/TestAliases.java b/modules/RoyalCommands/src/test/java/org/royaldev/royalcommands/TestAliases.java
@@ -1,16 +1,13 @@
 package org.royaldev.royalcommands;
 
-import org.bukkit.Material;
+
 import org.bukkit.configuration.ConfigurationSection;
 import org.bukkit.configuration.file.YamlConfiguration;
 import org.junit.After;
 import org.junit.Before;
 import org.junit.Test;
-import org.royaldev.royalcommands.opencsv.CSVReader;
-
 import java.io.File;
-import java.io.FileReader;
-import java.io.Reader;
+
 import java.util.ArrayList;
 import java.util.List;
 import java.util.logging.Logger;
@@ -19,7 +16,6 @@
 import static org.junit.Assert.assertTrue;
 import static org.mockito.Mockito.*;
 
-
 public class TestAliases {
 
     private YamlConfiguration pluginYml = null;
@@ -33,25 +29,6 @@ private YamlConfiguration getPluginYml() {
         return this.pluginYml;
     }
 
-    @Test
-    public void testAliases() throws Throwable {
-        final Logger l = Logger.getLogger("org.royaldev.royalcommands");
-        final File csv = new File("src/main/resources/items.csv");
-        assertTrue("No items.csv found!", csv.exists());
-        final Reader in = new FileReader(csv);
-        CSVReader r = new CSVReader(in);
-        final ItemNameManager inm = new ItemNameManager(r.readAll());
-        boolean allAliasesExist = true;
-        for (final Material m : Material.values()) {
-            if (inm.aliasExists(m)) continue;
-            if (m.name().startsWith("LEGACY")) continue;
-            if (allAliasesExist) allAliasesExist = false;
-            l.warning("Missing alias for Material " + m.name() + ".");
-        }
-        r.close();
-        assertTrue("Missing aliases!", allAliasesExist);
-    }
-
     private RoyalCommands makeRoyalCommands() {
         final RoyalCommands rc = mock(RoyalCommands.class);
         when(rc.getLogger()).thenReturn(Logger.getAnonymousLogger());

Original file line number	Diff line number	Diff line change
`@@ -25,7 +25,7 @@`
`25`	`25`	`public class CmdGive extends TabCommand {`
`26`	`26`
`27`	`27`	`public CmdGive(final RoyalCommands instance, final String name) {`
`28`		`- super(instance, name, true, new Short[]{CompletionType.ONLINE_PLAYER.getShort(), CompletionType.ITEM_ALIAS.getShort()});`
	`28`	`+ super(instance, name, true, new Short[]{CompletionType.ONLINE_PLAYER.getShort(), CompletionType.ITEM.getShort()});`
`29`	`29`	`}`
`30`	`30`
`31`	`31`	`public static boolean giveItemStandalone(CommandSender cs, Player target, String itemname, int amount) {`
Original file line number	Diff line number	Diff line change
`@@ -21,7 +21,7 @@`
`21`	`21`	`public class CmdHelmet extends TabCommand {`
`22`	`22`
`23`	`23`	`public CmdHelmet(final RoyalCommands instance, final String name) {`
`24`		`- super(instance, name, true, new Short[]{CompletionType.ITEM_ALIAS.getShort()});`
	`24`	`+ super(instance, name, true, new Short[]{CompletionType.ITEM.getShort()});`
`25`	`25`	`}`
`26`	`26`	`/**`
`27`	`27`	`* TODO: Add support to add a helmet to another player`
Original file line number	Diff line number	Diff line change
`@@ -30,7 +30,7 @@ public class CmdItem extends TabCommand {`
`30`	`30`	`private static final Flag<String> loreFlag = new Flag<>(String.class, "description", "lore", "l");`
`31`	`31`
`32`	`32`	`public CmdItem(final RoyalCommands instance, final String name) {`
`33`		`- super(instance, name, true, new Short[]{CompletionType.ITEM_ALIAS.getShort()});`
	`33`	`+ super(instance, name, true, new Short[]{CompletionType.ITEM.getShort()});`
`34`	`34`	`this.addExpectedFlag(CmdItem.nameFlag);`
`35`	`35`	`this.addExpectedFlag(CmdItem.loreFlag);`
`36`	`36`	`}`
Original file line number	Diff line number	Diff line change
`@@ -47,7 +47,7 @@ public class CmdUses extends TabCommand {`
`47`	`47`	`private final Map<String, Integer> tasks = new HashMap<>();`
`48`	`48`
`49`	`49`	`public CmdUses(final RoyalCommands instance, final String name) {`
`50`		`- super(instance, name, true, new Short[]{CompletionType.ITEM_ALIAS.getShort()});`
	`50`	`+ super(instance, name, true, new Short[]{CompletionType.ITEM.getShort()});`
`51`	`51`	`this.plugin.getServer().getPluginManager().registerEvents(new WorkbenchCloseListener(), this.plugin);`
`52`	`52`	`}`
`53`	`53`