Knapsack (backpack)
( backpack ) Knapsacks
Knapsacks are backpacks on steroids for MineCraft. Injected with a ton of options for both players and server owners, Knapsacks should prove to be a valuable asset to any MineCraft server.
Description
Knapsacks allow players to craft & give themselves and other players additional inventory slots. Knapsacks is packed with options for the player as well as for server owners and operators. Among those are the infamous Auto-Filling. Auto filling allows player to control what items get stored in their Knapsacks and when. Depending on how Knapsacks is configured, players will be able to keep items organized in Knapsacks Auto-Fills. Players have,for the most part, complete control on when items are filled to a Knapsack both before and after their inventory is full!
Another under-rated feature is the Knapsack expiry system. This system was built with the server owners in mind to stop the abuse of Knapsacks (crafting excessive packs, giving, dropping, etc..). Optionally, server owners can set limits on how many of a specific size Knapsack each player can have at any given point as well as an overall setting of all Knapsack sizes a player has.
Knapsacks is exactly what the name states, a Backpack on steroids! Jammed with many, many more options and more still coming
NEWS FLASH:
Always update to the latest for all bug fixes and latest Auto-Fill and other enhancements!
If your using plugin managers like plugman, etc.. DO NOT UNLOAD and LOAD Knapsacks using these plugins. You will have nothing but errors and exceptions due to database connections and event compiling priorities. You MUST restart your server when updating!
If you are running less than 1.0.28 Update now. Enhancements, Bugs and New Features Added!
Knapsack Releases/Builds:
Spigot/Bukkit 1.8.x: Bukkit/Spigot - Knapsacks-v1.0.28-Bukkit_Spigot_1_8_x
Bukkit/Spigot 1.7.10: Bukkit/Spigot - Knapsacks-v1.0.28-Bukkit_Spigot_1_7_10
Features
Completely Configurable
6 Different Steroids (9-54 slots - more coming) | Inventory Auto-Filling (1.0.12+) | |
Right-Click Sack while in Inv. GUI to Open another Sack!! | Right Click Normally to Open! | |
Give Sacks a default name | Control volume and pitch levels | |
Claim a found Knapsack | Craft any size | |
Keep Knapsacks when you Die | Custom Messaging | |
Global Black Listing | Sack Level Black Listing | |
Rename Using Anvils | Rename using commands | |
Clear a Knapsack with simple command | Clear and drop whats in a Knapsack at your feet | |
Share Knapsacks | Knapsack Thieving (not 100%) | |
Enable each Size Knapsack | Use Knapsacks stored any where!! | |
Global World Exclusions | Sack Level World Exclusions | |
Stash Knapsacks inside each other | Limits for each Sack | |
Upgrade Knapsacks | Place Limits on How Many at each Sack Level | |
Recipes for each Sack | Menu is Permission Based - keeps it short | |
Sizing for each Sack | Knapsack Expiry System, player and system to control abuse and lack of use | |
Weight for each Sack | Built-in filtering system for naming | |
Restricted Hot-Bar Swapping | Restricted Creative Use | |
Forbidden Monster Egg Spawning | Configurable Stashing Containers | |
Knapsack Recovery | Supports Minecraft Name Changes | |
SQL controlled databases | Configurable "command" for performing player cleanup of expired sacks | |
There is more..... | Interface Knapsacks with Signs, Blocks etc.. to Buy, Sell, or just to use a chest directly; known as "Knapsack Interface" (1.0.20+) |
Installation & Configuration
Installation & Configuration
Download the Knapsacks jar file.
Drop it in your plugins folder on your server.
Re-start your server.
Download your config that is automatically created at start up and Edit with your specific server settings for Knapsacks -or- just use the defaults and give it a go!!
Upload the editted config.yml back to your server and restart your server or use " /ks reload " from the console
Frequently Asked Questions:
I have compiled a bunch of questions with answers into it's own page rather than clutter this page. So if you have questions, please direct yourself to: Frequentl Asked Questions Page. If your question is not answered then please post a comment in the FAQ page and it will be answered as well as updated into the FAQ page!
Configuration Components:
The configuration for Knapsacks is pretty straight forwards. However due to the size of the config, I am only listing the components of the config on this page. Please see Installation & Configuration for complete configuration, broken down into the components.
The configuration is broken down into 6 Sections(click link above/below for config)
Plugin:
Config: (many things to config in here)
Sounds: (you make the choice!)
Notification Services (1.0.12+)
PlayerFeeds:
Knapsacks (sacks):
Installation & Configuration
Commands
Please see the Knapsacks Commands for a complete listing of all that Knapsack offers. In addition, the command page details the prerequisite or general permission node required for that command. However, each command Knapsack has may have additional functionality outside of the basic command which requires more permissions nodes.
All Permission Nodes & Easy Groups
For a complete listing of all permissions nodes and Pre-built Knapsack Permission Groups, visit the Permissions Page
Auto Filling 101
Auto Filling 101 details all the functionality behind Knapsack Auto-Filling as well as a complete list of commands and permissions for Auto Filling.
Knapsack Expiry System 101
Expiry System 101 details all the functionality behind Knapsack the Knapsack Expiry System for both Players and the Server. Also on this page is the complete list of commands and permissions for Knapsack Expiry System.
Knapsack Interface 101 (commonly called Knapsack Int)
Knapsack Interface 101 details all the functionality behind Linking Knapsacks for server and player shops, player private uses with chest, signs, etc... as well as a complete list of commands and permissions for Knapsack Interface.
Knapsack Stashing 101
Knapsack Stashing 101 details all the functionality behind Knapsack Stashing as well as a complete list of commands and permissions for Knapsack Stashing.
Monster Egg / Knapsack Id Reference
Here is a complete reference chart with each respective Knapsack for the Monster Eggs durability/typeId.
Monser Egg to Knapsack Cross Reference Chart
Default Crafting Recipes
These are completely configurable but by request, I've added this section as a quick reference! Images shown are are all the defaults that come configured when you first install Knapsacks. All default crafting recipes are located in 'images' tab of the site.
- The default crafting recipes:
Screen Shots:
The screen shots show most of the features in Knapsacks for this release. Will continue to add more and update as the features change...
Take a look at some screen shots!
Suggestions?
If you come across any bugs or issues or if you have any suggestions? Submit Issues and/or Suggestions Here
Resource Packs
Want to add the realism of the Plug-in to your GUI. Download one or all of the resource packs available now.
| Knapsack Resource Packs
To-Do
- Convert all in-line messages to language file
- Convert English language file to other languages (help wanted)
- Add Sheathing Options - Show that Sack on your back!
Add ability to interface Knapsacks with Shops, Chests...(completed-2-1-15:1.0.20+)Add ability to sell directly from Knapsacks(completed-1-24-15:1.0.20+)Add Creative Restrictions on Knapsacks(completed-1-24-15:1.0.20+)Add Support to stop Hot-bar Swapping(completed-1-24-15:1.0.20+)Add ability to exclude a preferred item(filling first and/or over-flow)Fix when players are allowed to drop Knapsacks(partial:1.0.16a)- Add option to Auto-Fill Stashed Knapsacks (logical?)
Add separate Knapsack Inventories for Creative and Survival(restrictive:1.0.20+)Add option to restrict use of Knapsack in Creative(more restrictive:1.0.16-1.0.20)World Exclusions, Global and Per Sack(completed-10-20-14:1.0.12+)Player Sack Expiry and Global Auto Clean(completed-10-19-14:1.0.12+)Death Control(completed-10-10-14:1.0.11+)Knapsack stashing enhancements(completed-12-24-14:1.0.18+)Right-Click Knapsack to Open it, same Inv. GUI(completed-10-21-14:1.0.12+)Knapsack Auto-Fill (100%)(completed-11-15-14:1.0.12+)Update with general console cmds(completed-11-15-14:1.0.12+)Migration Manager for Upgrades(completed-11-15-14:1.0.12+)- Complete Thieving Features (stalled)
- Knapsack Upgrades (stalled)
- Complete Realism Features (in-progress)
Sharing Features(completed-10-12-14:1.0.11+)Add Knapsack Recovery System(completed: 2-5-15:10.020)
Supports when "deathsacks" is disabled and players do not return
for their Knapsacksor some other freakish event occurred where player might lose Knapsack
- Add Share Items and Items Manager for Shares
- Add Knapsack Eco System
- allow buying and selling of Knapsacks
- Add Knapsack Transformation Option for each Sack.
- Player finds it, they can transform the item into a Knapsack of said [size]
Resource Pack for Knapsack Icons(completed-10-18-14:1.0.12+)
Release Notes
- 7-21-13: First "private" release for my son and his cousins on private server
- 9-15-13: Added support for more commands
- 9-16-14: Took a long business trip and no work was done...
- 9-28-14: Revamped most methods and functionality; added SQL support and UUID support
- 10-18-14: Added Player Expiry/System Expiry see change log for 1.0.12)
- 10-20-14: Added World & Sack Exclusions see change log for 1.0.12)
- 11-10-14: Added Auto-Fill Functionality see change log for 1.0.12)
- 11-16-14: Release of 1.0.12 - Steroid Injected - see change log for 1.0.12)
- 11-18-14: Release of 1.0.14 - Steroid Patch - see change log for 1.0.14)
- 11-19-14: Release of 1.0.15a/16 - Steroid Injection- see change log for 1.0.16)
- 12-11-14: Release of 1.0.16d - Auto-Fill Injection - see change log for 1.0.16d)
- 12-12-14: Release of 1.0.17 - MC1.7.x & MC 1.8.x Injection - See change log for 1.0.17)
- 12-26-14: Release of 1.0.18 - MC1.7.x & MC 1.8.x Injection - See change log for 1.0.18)
- 12-29-14: Release of 1.0.19 - MC1.7.x & MC 1.8.x Injection - See change log for 1.0.19)
- 02-01-15: Release of 1.0.20 - Knapsack Int - Bukkit(1.7.10-) See change log for 1.0.20)
- 02-01-15: Release of 1.0.20 - Knapsack Int - Bukkit/Spigot(1.8.x) See change log for 1.0.20)
- 02-03-15: 1.0.21 - 2 Qik Bug Fixes - Bukkit(1.7.10-) See change log for 1.0.21)
- 02-03-15: 1.0.21 - 2 Qik Bug Fixes - Bukkit/Spigot(1.8.x) See change log for 1.0.21)
- 02-07-15: 1.0.22a - Bug Fixes - Bukkit(1.7.10-) See change log for 1.0.22a)
- 02-07-15: 1.0.22a - Bug Fixes - Bukkit/Spigot(1.8.x) See change log for 1.0.22a)
- 02-09-15: 1.0.23 - SQL Fix & Minor fixes - Bukkit(1.7.10-) See change log for 1.0.23)
- 02-09-15: 1.0.23 - SQL Fix & Minor fixes - Bukkit/Spigot(1.8.x) See change log for 1.0.23)
- 02-11-15: 1.0.24 - Misc Fixes / Adjs. - Bukkit(1.7.10-) See change log for 1.0.24)
- 02-11-15: 1.0.24 - Misc Fixes / Adjs. - Bukkit/Spigot(1.8.x) See change log for 1.0.24)
- 03-05-15: 1.0.25 - Misc Fixes / Adjs. - Bukkit(1.7.10-) See change log for 1.0.25)
- 03-05-15: 1.0.25 - Misc Fixes / Adjs. - Bukkit/Spigot(1.8.x) See change log for 1.0.25)
- 03-08-15: 1.0.26 - Misc Fixes / Adjs. - Bukkit(1.7.10-) See change log for 1.0.26)
- 03-08-15: 1.0.26 - Misc Fixes / Adjs. - Bukkit/Spigot(1.8.x) See change log for 1.0.26)
- 03-10-15: 1.0.27 - HOT INJECTION. - Bukkit(1.7.10-) See change log for 1.0.27)
- 03-10-15: 1.0.27 - HOT INJECTION - Bukkit/Spigot(1.8.x) See change log for 1.0.27)
- 05-06-15: 1.0.28 - Fixes/Recompilations - Bukkit/Spigot(1.7.10-) See change log for 1.0.28)
- 05-06-15: 1.0.28 - Fixes/Recompilations - Bukkit/Spigot(1.8.x) See change log for 1.0.28)
Dependencies
Versions 1.0.16d and below require Vault (1.4.x)
Versions 1.0.17 and above require either Vault 1.4.x or Vault 1.5.x depending on the MC API (bukkit or spigot/bukkit) you are using.
Need Help?
If you come across any bugs or issues or if you have any suggestions? Submit Issues and/or Suggestions Here
Wanna Donate?
Care to help keep Knapsacks alive! I could use a new coffee maker!!
1.0.25 releasing later today/tonight. Fixes below glitch and a few other bug fixes...
@Astemus
Hey man! Actually, when you clear your inventory (/clear, /ci, /clearinventory), you should be messages the recovery command which is /ks getsacks. Issuing that command will "summon" those knapsacks that were saved prior to the inventory being cleared!
As for the dying in different worlds, inventory, etc. issue you explained. Have you tried to use the /ks recover [id] command and/or /ks getsacks command(s). 1 of them should work if not both of them in any situation. There are a few glitches that I fixed from 1.0.24 not released yet, so you may encounter a glitch here and there, but I think it's all ironed out and hope to get the release out very soon!!!
Thanks for your feedback (keep it coming) and thanks for the "pat on the back" as well as the support!
My users are still loving the backpacks, and no real issues to speak of!
I did have a suggestion, and it may not even be an issue for most people since the situations where you might need this shouldn't happen, but I've run into it a few times when I accidentally clear my inventory with a command like /clearinventory. But it would be nice to have a command to summon another backpack item for a specific bag that has been removed in an usual way like that. In those situations where the backpack is still saved in the database, but just the monster egg is missing to open it.
An example of a situation: I have it set to not keep the backpack on death, because I have two worlds with separate inventory; one with keepinventory on, and the other without. When I set it to keep the knapsack on death, the message is confusing/unnecessary in my keepinventory world, but the function works fine in my lose items on death world. Without the setting to keep knapsacks on death enabled, when someone dies on the "hard" world, the backpack item drops, and sometimes it becomes damaged or even lost. The knapsack is still safe in the database, but they don't have any access to it without the see command. It would be nice to have some way to get those monster eggs back.
Currently, the recovery options do not replace the backpack item in situations like this. Maybe this is a weird bug with multiple worlds? I'm not sure, but if we can summon a copy of the knapsack item that links to the specific backpack in the database, it'd be a very simple fix. It could be potentially abused, but it would be great for an admin only command, as the situations this occurs are pretty rare.
Keep up the great work, zrocweb! Waiting patiently for the next release!
@zrocweb Yea, sorry for seeming a bit confusing.
There was something wrong with my yaml formatting it seems, which prevented the knapsacks.* permission from being recognized. I was in the process of cleaning / thinning the permission files and there were tabs mixed in where yaml requires spaces only (which I suppose could be an issue, heh). Anyway..
What I was getting at was, that every time one of the ops (or admins) issued the /reload command, it seems Knapsack didn't load the sackdata for players who were already on the server at the time, so they had no access to their sacks. I only mentioned it because I had to assume that's directly related to the task error in some way.
If I'm correct I'll of course just wait for 1.0.25+.
I consequently realised, Astemus was basically reporting the same thing, so for now we just work around it via /ks getsacks (or, well, logging off and on again).
So it's not a big issue really (as long as the error doesn't actually interfere with loading and saving userdata).
What still seems odd to me is, why it happens for users who just log on to the server for the first time after a reboot/restart, but not when they log off and on again after that.
It's like Knapsack wouldn't fully initialise the database on a fresh server (re)boot.
And I'm just not sure if this is the same issue (error) or something else in parallel.
Edit: (Edited. D'oh!)
@harl
Harl.. The task error is just reporting that the secondary task could not be executed as it was previously executed when the player logged in. it's a minor bug in 1.0.24 (fixed in 1.0.25).
But I'm a little confused on the rest of your questions and statements. The only one I can answer is the permissions. knapsacks.* has always been a viable permission node, but there are situations when the ".*" is not tested for reasons not documented (mainly to avoid Ops and super perm issues).
If you can clarify more for me on the other issues I will work with you to resolve!
Is knapsacks.* a viable permission node yet?
And I'm now seeing this immediately when players log on.
It's Knapsacks 1.0.24 (still for Spigot..)
Players then seem unable to use their own Knapsack, though for some reason when they just log off and log back on, they can use it just fine. What gives?
Wait a minute...
This seems to have something to do with the /reload commands that were issued after the server started up. After each /reload the above errors would appear, until they would have their user-specific data reloaded (via relogging or /ks getsacks). I'm still at a loss though as to why that error is happening the first time they log on..
@Astemus
Good to hear u got it working ok.
The move pick setting is specific to autofill and player move events. Leave it alone as u shod t have to change it especially if ur not using auto fills. As it will not do anything with fills off. But with fills on it will affect the move pickip events that are triggered when autofill is on and may cause extreme lag on a server if altered the wrong way
As for the task error. Yeah. That is fixed. Again was something that squeaked by last release testing but is fix in current build.
If you are having issues with restoring knapsacks, go to the change log of the last release and you'll see some specific notes to help your recovery processes...
@zrocweb
It's working pretty well, thanks! I reset the config like you said in the 1.0.24 release notes, and copied over my knapsack settings, and I haven't had any real issues since then. I'm excited for the next update, so I'll be looking forward to that when you get it finished.
One weird issue I've been trying to get to the bottom of, it must have something to do with the creative settings since no one else causes this, is that I have a console error pop up whenever I log in related to a restore task failing.
I was trying to figure out where it was storing the info in the DB that was making it want to restore something, but I couldn't locate anything. I can only clear it by removing all my sacks, but it's not actually affecting anything that I can see except the one error when I log in, so, it's not a big deal overall. I'm gonna do some more sleuthing to see if I can determine the circumstances that cause it, and if I do I'll post a ticket with more specifics.
Keep up the great work!
ps. What the heck is that setting in the config called movepick?? It's been driving me crazy trying to figure out what it could be for! But, I haven't changed it because it says to not touch it. I'm just overly curious :)
@Astemus
Hey. They never were right clickable from the air because of the material (monster egg) that is used. I'm working on something that will allow them to be clickable from the air though and hopefully will be in next weeks release
How did u make out its the "lite" version settings
Is right clicking "air" not working for anyone else? It must have been the last few updates that I noticed it no longer working. I thought it was just me messing up some settings in the configuration, but I did a reset on a test server and it's still happening there.
I usually open my knapsacks from my inventory, so I didn't notice till someone else mentioned it to me. I'm hoping its just some setting i shouldn't have been screwing with :)
Thank you so much for the lovely SQL update! Now it works flawlessly!
This plugin is so polished, and the support is even better!
I recommend this plugin to everyone that is looking for a great "backpack" alternative!
CRITICAL UPDATE
Please update to 1.0.23 to resolve the SQL issue. Also in 1.0.23 are some minor fixes as well as new section for CreativeGameMode Changes...
CRITICAL UPDATE
1.0.22a:
Minor bug detected(1.0.20 - 1.0.21) during some testing that I did not catch prior to last release. Due to the stashing and recovery re-writes, I inadvertently left out a right click test when you are inside a Knapsack to right click another Knapsack to open it. Fixed in 1.0.22 along with full recovery options as well as minecraft name change support!
@harl
Harl.. You may also want to take a look into your other plugins, FastCraft and VirtualPacks seem to be conflicting a little with Knapsacks and could be the primary reason why you are seeing this more so than others. In fact, after tracing through all the errors FastCraft is in every one of them then Knapsacks. So FastCraft is your primary culprit causing the invalid gui size to clear out for the player when Knapsacks takes over on the player clicking in the Crafting Gui.
None the less, a fix to ensure the error does not spring up in Knapsacks has been addressed and is in 1.0.20.
There's a whole lot of this going on with KS 1.0.19 on our Spigot 1.8 server. Any ideas?
1.0.20: Knapsack Interface (interface shots, chests and other actionable blocks and containers with your Knapsacks) project pages has been added. The release of 1.0.20 will be Mon. 2-2-15
@chsedv
There are only a few ways you can "lose" your knapsack (and these are glitches as well as oversights on my part - fixes are in progress).
One way is if you shift-click some blocks (like workbench) it will spawn the egg and not open the sack. But you still have and own the sack.
PM me your ip and I'll take a look for myself (will need you to give me knapsacks.admin perm).
Also, what were you doing prior to the re-login. Were you in another world and returned to your hub or something like that. If so, check your world and worlds blacklisting in config.
If you would not mind, open a ticket and give me your start-up log as well as your config. If I can't determine the cause for those two, might need you to send me your database.
Regardless, there is a way to get your knapsack back. Well not actually back.
1) Do /ks clear # -drops (if you want to get the items in that knapsack).
2) Do /ks remove # 3) Do /ks remove f - u should be prompted to do this, if not then skip 4) Do /ks give [size] to get your knapsack back
This is the long way. I am working on a recovery tool for incidents like this, but its tough as it would demand some restriction as players will abuse the losing of knapsacks and just initiate the recovery. which is not what we want...
@zrocweb
Hello. No, not use any other that cleaned it. Lost only the icon of Knappack in Inventory after relogin. With command (/ks 1) i have all.
@chsedv
Hmm. Sounds like something else is going on there. The Knapsacks are saved automatically to player inventory just like anything else the Player is holding in inventory. Are you running another plugin that is dealing with inventories like Multi-Inventory?
If you post your startup log in a ticket (not here please), I might be able to see what's going on for you, especially since you mentioned that your command were not working either?