Compare commits

..

3 Commits

Author SHA1 Message Date
hyperdefined
7b10ed61ae update README.md 2026-04-16 18:02:44 -04:00
hyperdefined
a881f60ed8 ok git just forget this file 2026-04-09 19:06:45 -04:00
hyperdefined
bdef9453c7 2.0.4 2026-04-09 19:06:22 -04:00
5 changed files with 247 additions and 22 deletions

View File

@@ -10,11 +10,12 @@
<a href="https://patreon.com/hyperdefined"><img alt="patreon-singular" height="40" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/donate/patreon-singular_vector.svg"></a> <a href="https://patreon.com/hyperdefined"><img alt="patreon-singular" height="40" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/donate/patreon-singular_vector.svg"></a>
</p> </p>
ToolStats is a Paper plugin that display various stats about tools. This plugin is inspired off of [GearStats](https://www.spigotmc.org/resources/gearstats.12960/). You can either track all statistics by default, or a use a token system to add statistics to tool/armor. You can configure how each statistic is shown on the item, or disable it! ToolStats is a Paper plugin that displays various stats about tools. This plugin is inspired off of [GearStats](https://www.spigotmc.org/resources/gearstats.12960/). You can either track all statistics by default, or a use a token system to add statistics to tool/armor. You can configure how each statistic is shown on the item, or disable it!
Here is everything it tracks: Here is everything it tracks:
* Blocks mined (pickaxes, shovels, axes, hoes, shears). * Blocks mined (pickaxes, shovels, axes, hoes, shears).
* Crops mined (hoes). * Crops harvested (hoes).
* Player/mob kills (swords, axes, tridents, bows/crossbows, mace). * Player/mob kills (swords, axes, tridents, bows/crossbows, mace).
* Ownership of items when crafted, looted (from chests/vaults/barrels), traded, spawned via creative, and caught from fishing. * Ownership of items when crafted, looted (from chests/vaults/barrels), traded, spawned via creative, and caught from fishing.
* Armor damage taken (shields too). * Armor damage taken (shields too).
@@ -30,24 +31,34 @@ Here is everything it tracks:
The best part is, this data is stored on the item itself. The best part is, this data is stored on the item itself.
This plugin also has compatibility for: This plugin also has compatibility for:
* [RoseStacker](https://modrinth.com/plugin/rosestacker) * [RoseStacker](https://modrinth.com/plugin/rosestacker)
If item lore is ever incorrect/missing, you can run `/toolstats reset`. This command fixes the lore on whatever item you are holding. You can see some of the stats below as examples:
![Image](https://docs.hyper.lol/plugins/toolstats/assets/image.png) | Crafted Origin | Player/Mob Kills | Fish Caught |
![Image](https://docs.hyper.lol/plugins/toolstats/assets/image2.png) |---|---|---|
![Image](https://docs.hyper.lol/plugins/toolstats/assets/image3.png) | ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image.png) | ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image2.png) | ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image3.png) |
![Image](https://docs.hyper.lol/plugins/toolstats/assets/image4.png)
![Image](https://docs.hyper.lol/plugins/toolstats/assets/image5.png) | Sheep Sheared | Dropped By | Damage Taken |
![Image](https://docs.hyper.lol/plugins/toolstats/assets/image6.png) |---|---|---|
![Image](https://docs.hyper.lol/plugins/toolstats/assets/image7.png) | ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image4.png) | ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image5.png) | ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image6.png) |
![Image](https://docs.hyper.lol/plugins/toolstats/assets/image8.png)
![Image](https://docs.hyper.lol/plugins/toolstats/assets/image9.png) | Mob Kills | Elytra | Looted Origin |
![Image](https://docs.hyper.lol/plugins/toolstats/assets/image10.png) |---|---|---|
![Image](https://docs.hyper.lol/plugins/toolstats/assets/image11.png) | ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image7.png) | ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image8.png) | ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image9.png) |
![Image](https://docs.hyper.lol/plugins/toolstats/assets/image13.png)
![Image](https://docs.hyper.lol/plugins/toolstats/assets/image14.png) | Traded Origin | Spawned Origin | Raw NBT Data |
![Image](https://docs.hyper.lol/plugins/toolstats/assets/image12.png) |---|---|---|
| ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image10.png) | ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image11.png) | ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image12.png) |
| Crops Harvested | Flight Time | Arrows Shot |
|---|---|---|
| ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image13.png) | ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image14.png) | ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image15.png) |
| Critical Strikes | Trident Throws | Logs Stripped |
|---|---|---|
| ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image16.png) | ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image17.png) | ![Image](https://docs.hyper.lol/plugins/toolstats/assets/image18.png) |
## Documentation ## Documentation
Visit the [wiki](https://docs.hyper.lol/plugins/toolstats/about/) for help. Visit the [wiki](https://docs.hyper.lol/plugins/toolstats/about/) for help.

View File

@@ -20,7 +20,7 @@ dependencies {
} }
group = "lol.hyper" group = "lol.hyper"
version = "2.0.3" version = "2.0.4"
description = "ToolStats" description = "ToolStats"
java.sourceCompatibility = JavaVersion.VERSION_25 java.sourceCompatibility = JavaVersion.VERSION_25

View File

@@ -29,6 +29,7 @@ import org.bukkit.command.CommandSender;
import org.bukkit.command.ConsoleCommandSender; import org.bukkit.command.ConsoleCommandSender;
import org.bukkit.entity.Player; import org.bukkit.entity.Player;
import org.bukkit.inventory.ItemStack; import org.bukkit.inventory.ItemStack;
import org.bukkit.inventory.PlayerInventory;
import org.bukkit.inventory.ShapedRecipe; import org.bukkit.inventory.ShapedRecipe;
import org.bukkit.inventory.meta.ItemMeta; import org.bukkit.inventory.meta.ItemMeta;
import org.bukkit.persistence.PersistentDataContainer; import org.bukkit.persistence.PersistentDataContainer;
@@ -227,6 +228,29 @@ public class CommandToolStats implements BasicCommand {
} }
return; return;
} }
case "add": {
if (!sender.hasPermission("toolstats.add")) {
sender.sendMessage(Component.text("You do not have permission for this command.", NamedTextColor.RED));
return;
}
if (sender instanceof ConsoleCommandSender) {
sender.sendMessage(Component.text("You must be a player for this command.", NamedTextColor.RED));
return;
}
// Make sure /toolstats add <stat> is present
if (args.length < 2) {
sender.sendMessage(Component.text("Invalid syntax. Usage: /toolstats add <stat>", NamedTextColor.RED));
return;
}
//Make sure they typed in a valid stat
String stat = args[1];
if (!toolStats.tokenData.getTokenTypes().contains(stat)) {
sender.sendMessage(Component.text("That is not a valid stat.", NamedTextColor.RED));
return;
}
addStat(stat, (Player) sender);
return;
}
default: { default: {
sender.sendMessage(Component.text("Invalid sub-command.", NamedTextColor.RED)); sender.sendMessage(Component.text("Invalid sub-command.", NamedTextColor.RED));
} }
@@ -449,6 +473,169 @@ public class CommandToolStats implements BasicCommand {
target.getInventory().addItem(token); target.getInventory().addItem(token);
} }
/**
* Add a stat to an item, setting it to zero.
* @param stat The stat to add.
* @param player The player running the command.
*/
private void addStat(String stat, Player player) {
PlayerInventory playerInventory = player.getInventory();
ItemStack heldItem = playerInventory.getItemInMainHand();
ItemMeta heldItemMeta = heldItem.getItemMeta();
if (heldItemMeta == null) {
return;
}
if (toolStats.itemChecker.checkTokens(heldItemMeta.getPersistentDataContainer(), stat)) {
player.sendMessage(Component.text("This item already has this stat.", NamedTextColor.RED));
return;
}
if (stat.equalsIgnoreCase("remove") || stat.equalsIgnoreCase("reset")) {
player.sendMessage(Component.text("That is not a valid stat.", NamedTextColor.RED));
return;
}
ItemStack newItem = toolStats.itemChecker.addToken(heldItem, stat);
switch (stat) {
case "crops-mined": {
if (toolStats.config.getBoolean("enabled.crops-harvested")) {
newItem.setItemMeta(toolStats.itemLore.updateCropsMined(newItem, 0));
} else {
player.sendMessage(Component.text("This stat is disabled.", NamedTextColor.RED));
return;
}
break;
}
case "blocks-mined": {
if (toolStats.configTools.checkConfig(newItem.getType(), "blocks-mined")) {
newItem.setItemMeta(toolStats.itemLore.updateBlocksMined(newItem, 0));
} else {
player.sendMessage(Component.text("This stat is disabled.", NamedTextColor.RED));
return;
}
break;
}
case "damage-taken": {
if (toolStats.config.getBoolean("enabled.armor-damage")) {
newItem.setItemMeta(toolStats.itemLore.updateArmorDamage(newItem, 0.0, false));
} else {
player.sendMessage(Component.text("This stat is disabled.", NamedTextColor.RED));
return;
}
break;
}
case "damage-done": {
if (toolStats.configTools.checkConfig(newItem.getType(), "damage-done")) {
newItem.setItemMeta(toolStats.itemLore.updateWeaponDamage(newItem, 0.0, false));
} else {
player.sendMessage(Component.text("This stat is disabled.", NamedTextColor.RED));
return;
}
break;
}
case "mob-kills": {
if (toolStats.configTools.checkConfig(newItem.getType(), "mob-kills")) {
newItem.setItemMeta(toolStats.itemLore.updateMobKills(newItem, 0));
} else {
player.sendMessage(Component.text("This stat is disabled.", NamedTextColor.RED));
return;
}
break;
}
case "player-kills": {
if (toolStats.configTools.checkConfig(newItem.getType(), "player-kills")) {
newItem.setItemMeta(toolStats.itemLore.updatePlayerKills(newItem, 0));
} else {
player.sendMessage(Component.text("This stat is disabled.", NamedTextColor.RED));
return;
}
break;
}
case "arrows-shot": {
if (toolStats.config.getBoolean("enabled.arrows-shot")) {
newItem.setItemMeta(toolStats.itemLore.updateArrowsShot(newItem, 0));
} else {
player.sendMessage(Component.text("This stat is disabled.", NamedTextColor.RED));
return;
}
break;
}
case "sheep-sheared": {
if (toolStats.config.getBoolean("enabled.sheep-sheared")) {
newItem.setItemMeta(toolStats.itemLore.updateSheepSheared(newItem, 0));
} else {
player.sendMessage(Component.text("This stat is disabled.", NamedTextColor.RED));
return;
}
break;
}
case "flight-time": {
if (toolStats.config.getBoolean("enabled.flight-time")) {
newItem.setItemMeta(toolStats.itemLore.updateFlightTime(newItem, 0));
} else {
player.sendMessage(Component.text("This stat is disabled.", NamedTextColor.RED));
return;
}
break;
}
case "fish-caught": {
if (toolStats.config.getBoolean("enabled.fish-caught")) {
newItem.setItemMeta(toolStats.itemLore.updateFishCaught(newItem, 0));
} else {
player.sendMessage(Component.text("This stat is disabled.", NamedTextColor.RED));
return;
}
break;
}
case "wither-kills": {
if (toolStats.config.getBoolean("enabled.bosses-killed.wither")) {
newItem.setItemMeta(toolStats.itemLore.updateBossesKilled(newItem, 0, "wither"));
} else {
player.sendMessage(Component.text("This stat is disabled.", NamedTextColor.RED));
return;
}
break;
}
case "enderdragon-kills": {
if (toolStats.config.getBoolean("enabled.bosses-killed.enderdragon")) {
newItem.setItemMeta(toolStats.itemLore.updateBossesKilled(newItem, 0, "enderdragon"));
} else {
player.sendMessage(Component.text("This stat is disabled.", NamedTextColor.RED));
return;
}
break;
}
case "critical-strikes": {
if (toolStats.config.getBoolean("enabled.critical-strikes")) {
newItem.setItemMeta(toolStats.itemLore.updateCriticalStrikes(newItem, 0));
} else {
player.sendMessage(Component.text("This stat is disabled.", NamedTextColor.RED));
return;
}
break;
}
case "trident-throws": {
if (toolStats.config.getBoolean("enabled.trident-throws")) {
newItem.setItemMeta(toolStats.itemLore.updateTridentThrows(newItem, 0));
} else {
player.sendMessage(Component.text("This stat is disabled.", NamedTextColor.RED));
return;
}
break;
}
case "logs-stripped": {
if (toolStats.config.getBoolean("enabled.logs-stripped")) {
newItem.setItemMeta(toolStats.itemLore.updateLogsStripped(newItem, 0));
} else {
player.sendMessage(Component.text("This stat is disabled.", NamedTextColor.RED));
return;
}
break;
}
}
player.sendMessage(Component.text(stat + " has been added!", NamedTextColor.GREEN));
}
/** /**
* Handle edit subcommand. * Handle edit subcommand.
* *
@@ -969,6 +1156,7 @@ public class CommandToolStats implements BasicCommand {
editedItemMeta.lore(newLore); editedItemMeta.lore(newLore);
} else { } else {
player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED)); player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED));
return;
} }
break; break;
} }
@@ -997,6 +1185,7 @@ public class CommandToolStats implements BasicCommand {
editedItemMeta.lore(newLore); editedItemMeta.lore(newLore);
} else { } else {
player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED)); player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED));
return;
} }
break; break;
} }
@@ -1025,6 +1214,7 @@ public class CommandToolStats implements BasicCommand {
editedItemMeta.lore(newLore); editedItemMeta.lore(newLore);
} else { } else {
player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED)); player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED));
return;
} }
break; break;
} }
@@ -1053,6 +1243,7 @@ public class CommandToolStats implements BasicCommand {
editedItemMeta.lore(newLore); editedItemMeta.lore(newLore);
} else { } else {
player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED)); player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED));
return;
} }
break; break;
} }
@@ -1081,6 +1272,7 @@ public class CommandToolStats implements BasicCommand {
editedItemMeta.lore(newLore); editedItemMeta.lore(newLore);
} else { } else {
player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED)); player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED));
return;
} }
break; break;
} }
@@ -1109,6 +1301,7 @@ public class CommandToolStats implements BasicCommand {
editedItemMeta.lore(newLore); editedItemMeta.lore(newLore);
} else { } else {
player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED)); player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED));
return;
} }
break; break;
} }
@@ -1137,6 +1330,7 @@ public class CommandToolStats implements BasicCommand {
editedItemMeta.lore(newLore); editedItemMeta.lore(newLore);
} else { } else {
player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED)); player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED));
return;
} }
break; break;
} }
@@ -1166,6 +1360,7 @@ public class CommandToolStats implements BasicCommand {
editedItemMeta.lore(newLore); editedItemMeta.lore(newLore);
} else { } else {
player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED)); player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED));
return;
} }
break; break;
} }
@@ -1194,6 +1389,7 @@ public class CommandToolStats implements BasicCommand {
editedItemMeta.lore(newLore); editedItemMeta.lore(newLore);
} else { } else {
player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED)); player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED));
return;
} }
break; break;
} }
@@ -1222,6 +1418,7 @@ public class CommandToolStats implements BasicCommand {
editedItemMeta.lore(newLore); editedItemMeta.lore(newLore);
} else { } else {
player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED)); player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED));
return;
} }
break; break;
} }
@@ -1250,6 +1447,7 @@ public class CommandToolStats implements BasicCommand {
editedItemMeta.lore(newLore); editedItemMeta.lore(newLore);
} else { } else {
player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED)); player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED));
return;
} }
break; break;
} }
@@ -1278,6 +1476,7 @@ public class CommandToolStats implements BasicCommand {
editedItemMeta.lore(newLore); editedItemMeta.lore(newLore);
} else { } else {
player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED)); player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED));
return;
} }
break; break;
} }
@@ -1306,6 +1505,7 @@ public class CommandToolStats implements BasicCommand {
editedItemMeta.lore(newLore); editedItemMeta.lore(newLore);
} else { } else {
player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED)); player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED));
return;
} }
break; break;
} }
@@ -1334,6 +1534,7 @@ public class CommandToolStats implements BasicCommand {
editedItemMeta.lore(newLore); editedItemMeta.lore(newLore);
} else { } else {
player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED)); player.sendMessage(Component.text("This item does not have that stat.", NamedTextColor.RED));
return;
} }
break; break;
} }
@@ -1347,6 +1548,8 @@ public class CommandToolStats implements BasicCommand {
player.sendMessage(Component.text("Removed stat " + stat + " for held item!", NamedTextColor.GREEN)); player.sendMessage(Component.text("Removed stat " + stat + " for held item!", NamedTextColor.GREEN));
} }
@Override @Override
public @NonNull Collection<String> suggest(@NonNull CommandSourceStack source, String[] args) { public @NonNull Collection<String> suggest(@NonNull CommandSourceStack source, String[] args) {
CommandSender sender = source.getSender(); CommandSender sender = source.getSender();
@@ -1371,6 +1574,9 @@ public class CommandToolStats implements BasicCommand {
if (sender.hasPermission("toolstats.purge")) { if (sender.hasPermission("toolstats.purge")) {
suggestions.add("purge"); suggestions.add("purge");
} }
if (sender.hasPermission("toolstats.add")) {
suggestions.add("add");
}
return suggestions; return suggestions;
} }
@@ -1392,6 +1598,15 @@ public class CommandToolStats implements BasicCommand {
.collect(Collectors.toList()); .collect(Collectors.toList());
} }
// suggest keys for add
if (args.length == 2 && args[0].equalsIgnoreCase("add") && sender.hasPermission("toolstats.add")) {
// yes I am lazy
return toolStats.tokenData.getTokenTypes().stream()
.filter(s -> !s.equals("remove") && !s.equals("reset"))
.map(s -> s.equals("crops-mined") ? "crops-harvested" : s)
.collect(Collectors.toList());
}
// suggest keys for remove // suggest keys for remove
if (args.length == 2 && args[0].equalsIgnoreCase("remove") && sender.hasPermission("toolstats.remove")) { if (args.length == 2 && args[0].equalsIgnoreCase("remove") && sender.hasPermission("toolstats.remove")) {
// yes I am lazy // yes I am lazy

View File

@@ -69,10 +69,6 @@ public class RoseStacker {
difference = before; difference = before;
} }
toolStats.logger.info("before: {}", before);
toolStats.logger.info("after: {}", after);
toolStats.logger.info("difference: {}", difference);
callback.accept(difference); callback.accept(difference);
}, 1); }, 1);
} }

View File

@@ -30,6 +30,9 @@ permissions:
toolstats.remove: toolstats.remove:
description: Allows the usage of /toolstats remove. description: Allows the usage of /toolstats remove.
default: op default: op
toolstats.add:
description: Allows the usage of /toolstats add.
default: op
dependencies: dependencies:
server: server: