ClickSort
ClickSort
ClickSort is a Bukkit plugin which makes it very easy for players to sort their inventories (player/chest/dispenser) with a single or double click of the mouse. Players can sort by item ID, item name, switch between single- and double-clicking, or disable sorting entirely, all on a per-player basis and without needing any commands; it's all done with mouse clicks in inventory windows.
Latest Version
- ClickSort v1.6.1 for CraftBukkit 1.16.x~1.19.x
- ClickSort v1.5.0 for CraftBukkit 1.13.x~1.15.x
- ClickSort v1.3.4 for CraftBukkit 1.10.x~1.12.x
- ClickSort v1.3.2 for CraftBukkit 1.9.x
- ClickSort v1.3.1 for CraftBukkit 1.8.x
- ClickSort v1.3.0 for CraftBukkit 1.6.x/1.7.x
- ClickSort v1.1.2 for CraftBukkit 1.4.6+
All versions above should work on Spigot.
Video
A review of v1.0.0, with thanks to VariationVault :
Installation
- Copy ClickSort.jar into your
bukkit/plugins
folder and reload/restart your CraftBukkit server. - The
bukkit/plugins/ClickSort
folder will be automatically created, containing aconfig.yml
file. - You may edit this file as you please, and run
/clicksort reload
to reload. See Configuration for details.
As of v1.3.2, you'll have to put your item names into items.yml manually if you want to sort by item names.
Usage
ClickSort operates as follows:
- In middle-click mode (the default, or swap key 'F' since ClickSort v1.5.1) players can sort their own inventory, a chest/dispenser/hopper/dropper inventory by middle-clicking any slot in that inventory (including slots with items in).
- In double-click mode, players can sort by double-left-clicking any slot in that inventory (including slots with items in).
- In single-click mode, players can sort inventories by single-left-clicking any empty slot in that inventory.
- By default, items are sorted by item ID (see http://www.minecraftwiki.net/wiki/Data_Value for a full list of ID's) and the click mode is middle-click (in v1.1 and earlier, the default click mode was double-click).
- Players can Shift-left-click any empty inventory slot to cycle through sorting by item ID, item name, item group, or item value (see Sort Modes for more detail on each sort mode).
- Players can Shift-right-click any empty inventory slot to cycle between double-click and single-click mode, or disabled sorting.
Any mode changes will give the player a feedback message indicating the new sort or click mode. Player sort/click modes are persistent across server restarts.
As of v1.1.0, it is also possible for players to disable shift-click mode changing (on a per-player basis); some players may find themselves annoyed by accidentally shift-clicking empty inventory slots. To avoid this, players can use the /clicksort shiftclick
command to toggle shift-clicking for themselves.
Also as of v1.1.0, two commands have been added to allow players to set their sort or click modes directly; these are most useful if shift-click mode changing has been disabled:
/clicksort sort <id|name|group|value>
/clicksort click <middle|double|single|swap|none>
Protection
ClickSort attempts to respect protection plugins which cancel InventoryClickEvent by running its own event handler as late as possible and ignoring cancelled events.
Documentation
Planned
- Possible sort mode to compact items? E.g. 9 iron ingot -> iron block, 9 diamond -> diamond block etc. Might require the player to have a crafting table in their inventory, or be standing near one.
- Maybe a sorting "wand" to have the option of sorting chests without having the inventory open? A stick with some appropriate metadata set on it, for example.
Source
Changelog
Usage Statistics
Fully anonymous usage statistics are collected using bStats.
In reply to TheDimSimKing:
In reply to ChengZi368:
In reply to ChengZi368:
I have enabled the localization page and uploaded the English lines. Anyone who want to contribute is free to participate.
For now, manual reformatting is required to use the exported language files, as it does not support the yaml format that this plugin uses, but the reformatting is not very hard.
Can you please add version 1.3.4 to spigotmc.org, noticed it was outdated on that page.
Also will you be updating the plugin to 1.13 in future or does it already seem to work in 1.13 pre releases?
In reply to TheDimSimKing:
In reply to TheDimSimKing:
Getting this warn msg anyway to fix?
[12:09:02 WARN]: [ClickSort] Can't determine sort prefix for ItemStack{ELYTRA x 1} (using ELYTRA)
Thanks for updating! We've been using the plugin for years.
great plugin, works better than others i've replaced. thanks for the depth of configuration options!
Any chance this will be updated to 1.10? It works on my 1.10 server but I keep getting this error on console:
Task #2100 for ClickSort v1.3.2 generated an except ion
java.lang.IllegalArgumentException: File cannot be null
at org.apache.commons.lang.Validate.notNull(Validate.java:192) ~[spigot- 1.10.jar:git-Spigot-6016ac7-6d3efa0]
at org.bukkit.configuration.file.FileConfiguration.save(FileConfiguratio n.java:64) ~[spigot-1.10.jar:git-Spigot-6016ac7-6d3efa0]
at cn.citycraft.PluginHelper.utils.LocalUtil.getItemName(LocalUtil.java: 75) ~[?:?]
at cn.citycraft.PluginHelper.utils.LocalUtil.getItemName(LocalUtil.java: 55) ~[?:?]
at me.desht.dhutils.ItemNames.lookup(ItemNames.java:37) ~[?:?]
at me.desht.clicksort.SortingMethod.makeSortPrefix(SortingMethod.java:57 ) ~[?:?]
at me.desht.clicksort.SortKey.<init>(SortKey.java:22) ~[?:?]
at me.desht.clicksort.ClickSortPlugin.sortAndMerge(ClickSortPlugin.java: 444) ~[?:?]
at me.desht.clicksort.ClickSortPlugin.sortInventory(ClickSortPlugin.java :387) ~[?:?]
at me.desht.clicksort.ClickSortPlugin.access$1(ClickSortPlugin.java:326) ~[?:?]
at me.desht.clicksort.ClickSortPlugin$1.run(ClickSortPlugin.java:251) ~[ ?:?]
at org.bukkit.craftbukkit.v1_10_R1.scheduler.CraftTask.run(CraftTask.jav a:71) ~[spigot-1.10.jar:git-Spigot-6016ac7-6d3efa0]
at org.bukkit.craftbukkit.v1_10_R1.scheduler.CraftScheduler.mainThreadHe artbeat(CraftScheduler.java:350) [spigot-1.10.jar:git-Spigot-6016ac7-6d3efa0]
at net.minecraft.server.v1_10_R1.MinecraftServer.D(MinecraftServer.java: 741) [spigot-1.10.jar:git-Spigot-6016ac7-6d3efa0]
at net.minecraft.server.v1_10_R1.DedicatedServer.D(DedicatedServer.java: 399) [spigot-1.10.jar:git-Spigot-6016ac7-6d3efa0]
at net.minecraft.server.v1_10_R1.MinecraftServer.C(MinecraftServer.java: 672) [spigot-1.10.jar:git-Spigot-6016ac7-6d3efa0]
at net.minecraft.server.v1_10_R1.MinecraftServer.run(MinecraftServer.jav a:571) [spigot-1.10.jar:git-Spigot-6016ac7-6d3efa0]
at java.lang.Thread.run(Unknown Source) [?:1.8.0_91]
This is an amazing and needed plugin! Great job.
I'm running into a file cannot be null exception when sorting by "name". It happens every time I pick up a new item for the first time and try to sort. On the second sort I don't get the error. If I pick up 3 items that I have never picked up before and attempt a sort, it will give the exception 3 times then begin to work.
Hope this helps, thanks.
@cjburkey01 @PureSpider I will look into it.
@cjburkey01
The offhand item, as well.
In 1.9, sorting the player's inventory removes their armor. Just though I'd say that.
@amasokin
I will try to make it work with StackableItems. Thank for your suggestion.
Hey, great plugin!
Would it be possible to make an option in the config file to make it work with items with custom stacking quantities?
I use a plugin to allow people to stack potions (x4) (http://dev.bukkit.org/bukkit-plugins/stackableitems/) but ClickSort obviously just unstack the potions each time the player autosorts.
That would be really great.
Thanks!
@desht
thank you, works great
@marubal21
The main node is clicksort.sort - everyone has this by default, but you can give people the negated node in your permissions plugin if you want to control it by rank.
There are other nodes for the various commands - more info in Permissions.
I see the plugin has permission nodes, but side from the admin and the reload nodes, how would i set the other node so only certain ranks can use ClickSort, rather then everyone?
@madtomic
?
Update for what, exactly?