Bukkit

KNAPSACK FREQUENTLY ASKED QUESTIONS

General Questions:

• Material Listing 1.8.x
• What happens if I change my Knapsack Material/Item in the configuration? What happens to those Knapsacks?
  • The Knapsack still exists and is manageable. However, your players will not be able to right click(use) the old Knapsack(s).
  • Instead they will have to use command (/ks [id] or /ks see [id] [player]) to open those Knapsacks.
  • Additionally, depending on the player and permissions, you may want to give your players (knapsack.clear.drops) permissions node so if you do change the material/id of a Knapsack, players can easily clear and drop all the items within there old Knapsacks. Then they can remove (again depending on permissions) the same old knapsack and give or craft a new style Knapsack and then pick-up all their items. If you don't provide permissions for the clear with drops, players can also just interface that old Knapsack, manually (/ks sackmode) and then open a chest and transfer those old Knapsack items into the chest.

• Some of my players keep getting a message This Knapsack is too withered to pickup when they come across a Knapsack lying on the ground and are trying to pick it up. What does this mean? When a player drops a Knapsack upon death and does not have the (knapsacks.keepondeath) permission node, the Knapsack is fair game to all players until one of two things happens.
  
  • If the player who dropped the Knapsack(s) does not go back for their Knapsack(s) then other players can pick them up (after a short delay).
  • If the player who dropped the Knapsack(s) re-spawns and performs a recovery on said Knapsack(s), then the Knapsack(s) that were dropped become withered and no other player, including the original player can pick up said Knapsack(s). This avoid duplication of Knapsacks when dropped in the world from any player, period.
    • If the player who dropped the Knapsack(s) re-spawns and Does Not perform the recovery on said Knapsack(s) in time, then any other player in the vicinity of said Knapsack(s) can pick them up. When this happens the owner of the Knapsack(s) will receive a message telling them who picked up their Knapsack(s) and then it's up to the owner and the player who picked up the Knapsack(s) to deal with.
      • Note: Any player picking up another players Knapsack can not open and/or modify said Knapsack with out proper permissions.
        • (knapsacks.open.other) - Will allow a player to open another players Knapsack, only
        • (knapsacks.see.other) - Will allow a player to see another players Knapsack using command, only.
        • (knapsacks.modify.other) - Will allow a player to modify the contents of another players Knapsack
          • Put them altogether for any player and that player can open and steal another players Knapsack contents.
            • A player may claim another players Knapsack and take ownership of said Knapsack, only if the Knapsack is empty first

• What do I need to do when upgrading from a previous version of Knapsack to the latest version? Unless the change log for the latest version indicates special instructions on upgrading, you don't need to do anything but delete the old '.jar' file from your plugins folder and place the latest versions '.jar' file into the plugins folder and re-start your server.

• When I upgrade Knapsack versions, do I need to delete the 'userdata\sackdata.db' file? Absolutely Not. Deleting this database will remove all player Knapsacks, inventory in those Knapsacks as well as all System/Player relations to Knapsacks. Knapsack will automatically upgrade your databases during server re-start and/or when players log back onto the sever after an upgrade has been performed. Do Not Delete the 'userdata\sackdata.db' file when upgrading!

• I am in Survival Mode and change to Creative Mode. My Knapsacks disappear? Why? Knapsacks are restricted, in their entirety, in Creative Mode. There is no reason to even need to use a Knapsack in Creative Mode, at least none that I've come across or been suggested for.
  • Additionally, when you or other players change game modes, Knapsacks will automatically (can be configured) save all your Knapsacks the player is carrying (on your back) and await your return to Survival or Creative Mode. Once Creative Mode is exited, depending on the autosave and autorestore options in the configuration, the players Knapsacks that were saved will be restored or the player will need to to issue the command (/ks getsacks). If the command is needed, Knapsack will inform the player.

• I'm an admin on the server and am setting up some chests with Crafted Knapsacks but I can't? Are you in Creative Mode? If so, you will not be able to. You will need to switch to Survival Mode to do what you want to do!
  • Why? Because of the many factors that Creative Mode brings for players and their inventories, Knapsacks just restricts Creative Mode usage, clicks and most commands. Players can still list their Knapsacks, port to stashed Knapsacks, create Knapsack Links and a few other commands, but basically while in Creative Mode, you or players are restricted to Knapsacks.

• I have a plug-in that uses "Nether Rack" as a custom block for doing a purchase of a store item. Whenever I right click the Nether Rack with a Knapsack in-hand the Knapsack always opens. How can I make it so the Knapsack does not open and the Nether Rack performs it function, in this case buying or selling an item from my store. Simple: In the configuration, look for the Section called "RightClickActions". In this section is a sub-section called "CustomBlocks". Add the following to the "CustomBlocks" sub-section: - netherrack,true

• I have 3 servers and the server all my players spawn in is considered a HUB server and all players branch out from there to my other 2 servers where I allow Knapsack usage. Make sure you DO NOT add the Knapsacks plugin to your plugin folder of your hub server. Knapsacks is an independent plugin per server. Version 2 will include full mySQL as well as sqlLite which will allow an entire network to use Knapsacks regardless of the server the player is on. But until version 2 is release (future), only place Knapsacks on the server where you want to allow the use of Knapsacks. Pretty clean-cut!

• I have 4 worlds on my server and I want to restrict the use of the Beast Pack (54 slot) Knapsack in 2 of these 4 worlds. How can I do this and still have all the other Knapsacks available? Simple. In the Configuration Section called "Knapsacks", locate the "Sack" you want to exclude the 2 worlds in and in the "NotInWorlds" setting, enter the world name(s). Players may still have a Knapsack of this size, but they will not be able to use or move items into and/or out of these world/sack excluded Knapsacks.

• I keep getting a Black Listed Message every now and then when I walk over Rotten Flesh. By default Knapsacks comes pre-built with the configuration for Rotten_Flesh as a black listed item. The item needs to be removed from the Sack Section for each and every Sack you no longer want it black listed for.

• I want to allow my players to drop their Knapsacks. How can this be achieved? Simple. It can't! Knapsacks does not allow players to drop owned Knapsacks, unless the player is carrying a Knapsack that is not theirs. Knapsacks can be picked up from the ground that are not yours, but other players Knapsacks of which were dropped when that player died and did not have the permissions "knapsacks.keepondeath". Also, Crafted Knapsacks are the only Knapsacks that can be dropped if you are carrying them.

• I am a staff member on a server and when ever I issue the command "/more" on a Knapsack I get a message and I can't increase the stack size of this size Knapsack. Simple. You are not allowed to duplicate any size Knapsack because they are owned by players, in this case, you. Therefore Knapsacks intercepts the "/more" command and restricts it use. However you can use the "/more" command on non-owner Knapsacks which are Crafted Knapsacks. Craft each of the Knapsacks you wish to get more of and issue the "/more" command on each of those. That do whatever it is your trying to do with all these extra Knapsacks.

Auto-Filling Questions:

• How do my players fill their Knapsacks before their inventory. Place the (-first) flag on the Knapsacks you want to fill first (/ks fill [id] -first). Depending on if that size Knapsack is defaulting (server-wide) to fill first or not is the only factor for filling first outside of placing the " -first " flag on that same Knapsack.
  

• How come my items are not going to my Knapsack? They keep going to me, the player and I have 2 Knapsacks and one of them is set up to fill cobblestone and all my ores. But I want everything else to fill to my other Knapsack. Simple. first and foremost you will need to set the (-first) flag for each of the Knapsacks. It sounds like the server settings is not to fill first so that gives players the control on filling their Knapsacks. If perhaps you just want to fill your preferred items (cobblestone and all your ores) to the set Knapsack but want to worry about the other Knapsack after your inventory has filled up, just set the preferred Knapsack with the (-first) setting and just those items will fill.
  

• I want to give my players the power to have 6 or 8 Knapsacks they can fill but Knapsacks is only allowing them to fill up to 4(four) Knapsacks in their fill-chain. Simple. In the configuration, section "Config.AutoFill.MaxSacks" change the default value of 4 to the new value. This is the setting that allows players to add 'x' Knapsacks to their fill-chain.

• I am trying to move one of my Knapsacks to my chest in my house. But whenever I do I get this message that I the Knapsack is part of Auto-Fill and I have to toggle Auto-Fill off before I can move it. What is this all about? Because Knapsacks tries to keep things like they are in life, you can not fill items you pickup to a stashed Knapsack in a chest. So when you try to move the Knapsack, Knapsacks see the Knapsack you are moving is part of where you want to over-flow items into. Therefore, you need to turn off Auto-Filling to force the stashing of the Knapsack into a chest or other storage container. Additionally, if you leave there area where you stashed the Knapsack and attempt to turn on Auto-Fill again, it will not allow you to because you are no longer carrying the Knapsack. You need to remove that stashed Knapsack from the fill-chain if you have other Knapsacks in the fill-chain than you are carrying.

• I run a Sky Survival type of server and flying is a big part of my server. I'm having an issue with players being able to fill their Knapsack while flying. Simple. In the configuration, section "Config.AutoFill.Realisim.Flying" change the default value (false) to (true). By default, Knapsacks restricts the use of filling while players are flying, sprinting and riding animals (horse, pigs, etc...). However, these are all settings that can be over-ridden in the config in this section.

• I only have one Knapsack and I have it set to fill specific junk items like string, spider eyes, sticks and slime balls. But whenever I pickup one of these items, it goes right to my inventory first. Simple. You need to tell Auto-Fill to fill the Knapsack first. Set the flag on the sack to (-first). Use " /ks fill [id] -first "

• I have 3 Knapsacks in my fill-chain, two of which are for preferred items and the other is just for any other type of over-flow. I have all my Knapsacks in the fill-chain set to (-first) but my preferred sacks keeps getting items that are not part of the filter or preferred. Simple. Your non-preferred Knapsack is full, so Auto-Fill will try to continue to over-flow or fill to other Knapsacks in your fill-chain.

• I have 4 Knapsacks in my fill-chain (1,2,3,4). I want to make Knapsack #4 the first in my fill-chain so it fills before 1 and 2 because 3 is for preferred items only. How do I make #4 the first in my chain without removing the entire chain. Simple. Use " /ks fill add 4,1,2,3 ". This will re-order your fill chain as you stated!

• I have 3 Knapsacks in my fill-chain and I just got access to the Beast Pack and want to add it to my fill chain, but I want it to be the 2nd fill-sack in the chain. How can I do this without removing all my other fill in the chain and then having to re-add them. Simple. Use " /ks fill add 1,4,2,3 " or whatever your order is except for the new sack (4). Issuing an "add" with a new Knapsack is the same as creating or adding a fill-chain. Auto-Fill is smart enough to recognize the fill was not part of the chain before and will add it to the order you entered.

• How can I stop filling to a Knapsack without taking it out of my fill-chain? Simple. Use " /ks fill [id] -off " for each of the Knapsacks you want to turn off but leave in the fill-chain for later use.

Interface and Linking Questions:

• How do I create a Knapsack Link? Place the Knapsack Spy and Linking Tool (default is blaze rod) in your hand. Use (/ks int link), punch the block that you want to create a Knapsack Link to.

• When I create a link to a block I get the message that the link was created. But then I put a Knapsack in-hand and use it on the block and link I just created and nothing happens! Why? The reason is most likely because the block you created the Knapsack Link on is not a Action or Custom Action Block. Outside of Minecraft's base actionable blocks (chest, signs, etc..) you need to add to the CustomActionBlock configuration section if you want a specific block to react to a Knapsack when said Knapsack is used on it.
  

• I think I have about 50 Knapsack Links. How can I locate a link I created a long time ago that I no longer need? First off, if you no longer need a link and you broke the block that link you think you no longer use, that Link was removed when the block was broken. So you are all set. However, if this is not the case then use (/ks list ?) When you view a list of all your Knapsack Links, there is a location affixed to the list. Not that this location is the answer to your question, but it may steer you in the right direction along with the Link Id. Link Id's are added based on when they are created. So if you created a Link a while ago and your current links are around 50, they you should be looking somewhere in the vicinity of links 1-xxx. You can then issue command (/ks int port [linkId]) to port yourself to that link and you'll discover if its the link you wanted or not.

• How do I Interface my Knapsack with a server shop? A Knapsack link to that shop needs to be created first (see above faq). Then, place the Knapsack you wish to use for interfacing with the servers shop,in your hand. Right-Click (use) that Knapsack (in-hand) on the sign, chest or block of the server shop. You will be forced into "SackMode". Thereafter you can then begin performing transactions from the servers shop. When the transactions take place, items are added or taken from your inventory which is actually your Knapsack's Inventory that you entered SackMode with. When you are done performing transactions, simply left click(punch) any block and you will be returned to your normal Player Inventory. All items you purchased and/or sold to/from your Knapsack will be saved.

• I am viewing my Player Inventory while in SackMode and I my inventory is full of red slots. What is that all about? When you interface and enter SackMode, depending on the size of the Knapsack you interfaced with, only 'x' amount of slots will be available to you in Player Inventory View and/or Knapsack Inventory View. For example. You interface with a size 9 Knapsack. Because a size 9 Knapsack can only hold 9 slots of inventory, you will only be able to access your HotBar slots. All other slots will be "filled" with the Filler Item making them unavailable for use. Furthermore, while still in SackMode and you happen to pickup an item or two while walking from one shop to another, your immediate slots for that Knapsack will be the only slots that fill with item pickups. Once those slots are full, its the same as if your player inventory became full, you can't pickup anything else up.

• I am viewing my Knapsacks Inventory while in SackMode and my Knapsack has red slots. Why? When you interface and enter SackMode all slots and the items from those slots are transferred to your player inventory. The Knapsack's slots are then filled with the unavailable "filler" item and are deemed unavailable for interacting with and moving items into and/or out of until you exit your current SackMode Interface. Remember, all your Knapsacks slots and items are now in your Player's Inventory View. So whatever you do when in SackMode with items, is affecting that Knapsack's inventory, not your player inventory and depending on the size of the Knapsack that was interfaced, only 'x' slots are available.

• I am interfaced in SackMode using a Size 54 Knapsack. How do I access my items that are not in my player's inventory view? Because the Players Inventory can only hold 36 item slots, that's all that is transferred to the players inventory from the Knapsack. Do access the remaining slots of the Knapsack, either switch to that Knapsack (in last available slot depending on size, in player inventory or hot-bar, always when in SackMode) and right-click(use) or issue command (/ks [knapsackId]) to open the Knapsack. When you open the Knapsack you are currently interfaced with in SackMode you will only be able to access those remaining slots that were not transferred to the Player Inventory Slots. In the case of size 45 Knapsack, it would be the last two rows of the Knapsack. In the case of a size 54 Knapsack, it would be the last row of the Knapsack.

• Can I use commands to buy or sell with my Knapsack? Yes, you can. If there is no Knapsack Link available or you prefer not to create one for a command buy/sell/repair, etc.., Get the Knapsack you wish to interface with, place it in your hand and issue command (/ks sackmode). This will force you into manual SackMode Interface mode with that Knapsack. You can then use a command, say "/buy steak 10" and 10 pieces of steak will be added to your player inventory, which is your Knapsack you interfaced with. To return to your normal Player Inventory (exit SackMode), issue command (/ks sackmode) again or simply left click(punch) any block to exit SackMode. Done.
  
  
  • NOTE: The actual command (/ks sackmode) may be different on one server than another. This command is a configurable command for the server owner. If you not sure, issue command (/ks) and you will be able to see one, if you have permission to enter manual SackMode, and two, the actual name of it.
    
    

    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!