customkits

CustomKits

CustomKits

Version: 1.6.3

For Rocket: 4.9.3.0

1 – Make sure you combine the Libraries folder in the download zip with the one in your Rocket server located here: .../Servers/<ServerName>/Rocket

2 – Make sure you setup the correct permissions so your players can actually save kits!

This plugin allows players to save their current inventory as a kit that can be loaded later on. You can create and configure as many Presets as you want, to allow players different numbers of slots and item limits. There are also many other features including Copy, MaxSkills, AutoSave, AutoLoad, the Slot Shop for buying more slots, and even more 😉

Buy extra slots to be able to save even more kits (Uconomy or AviEconomy required)

Please note: Most permissions are based off of main commands. So the permission for /Save is “CK.Save”, and the permission for /Clear is “CK.ClearInventory”, and so on. All other permissions are posted below:

Permission

Description

CK.Preset.<preset name>

Gives access to X Preset (THIS IS REQUIRED FOR PLAYERS TO SAVE KITS)

CK.Preset.*

Gives access to unlimited amount of slots and no item limit (unless you specify one – see FAQ below)

CK.Copy.Bypass

Prevent others from copying your inventory

Configuration

<SandboxMode>true</SandboxMode> - setting this to false will clear player's inventories when they save a kit, and delete that kit when they load it <DefaultKitName>Default</DefaultKitName> - this will be the kit name for those who don't specify one when using /Save, /Load, /Del [kit name] <StoreKits>true</StoreKits> - formerly "RetainKits_OnRestart", this will automatically store all player's saved kits so that they will be reloaded when the server is restarted <RetainKitsOnDeath>true</RetainKitsOnDeath> - well, this one is self-explanatory: keep players saved kits if they die <RetainKitsOnDisconnect>true</RetainKitsOnDisconnect> - and keep their saved kits if they disconnect <IncludeClothing>true</IncludeClothing> - include player's clothing in saved kits

<DisableItemDrops>false</DisableItemDrops> - prevent items dropping from the player when they die<Presets> - these are different configurations for each player, the permission to access the preset is "CK.Preset.<Preset Name>" <Preset Name="Default" SlotCount="1" ItemLimit="15" /> - set the name of the preset however you want <Preset Name="Member" SlotCount="2" ItemLimit="30" /> - SlotCount is the amount of kits that players can save <Preset Name="VIP" SlotCount="3" ItemLimit="45" /> - Itemlimit is the maximum amount of items players can have <Preset Name="*" SlotCount="0" ItemLimit="60" /> </Presets> <BlackList> - you can prevent players from including these items in their kits <ItemID>1441</ItemID> <ItemID>261</ItemID> <ItemID>262</ItemID> </BlackList> <EnableSlotShop>true</EnableSlotShop> - enable the shop for buying additional slots if you use Uconomy or AviEconomy (this overrides the SlotCount for Presets) <CostPerSlot>500</CostPerSlot> - cost of each slot when you buy

Additional Features

In config, setting the default kitname to “preset_name” will make it the same as the preset name for that player

FAQ

Q.) I know how useful this is for players, but how about server admins?

A.) This plugin can be very useful for server owners/admins, because it can be used in conjunction with server VIP ranks to give players another good reason for upgrading to VIP!

Example… Make it so default players can save/load only one kit, while VIP players can save/load more! (configurable)

Q.) How can I fix the “no permissions” error when trying to save a kit?

A.) You need to make sure that the groups and permissions (see above) are setup correctly in your server’s Permissions.config.xml file!

Q.) How can I set an item limit for the “CK.preset.*“preset?

A.) Just add the line <Preset Name=”*” MaxKits=”1″ ItemLimit=”x” /> to the preset list in config, substituting x for the desired item limit. MaxKits doesn’t matter and will always default to an unlimited amount.

Q.) What is the StoredKits.json file for?

A.)StoredKits.json is the file in which player’s saved kits are stored when the server is shutdown. After your server starts back up, your players should be able to load their previously saved kits.

Q.) What about ExtraSlots.json?

A.) This is the file in which player’s bought slots are stored when the server is shutdown.

Q.) Why isn’t X command working?

A.) Solution 1 – Other plugins may be overriding CustomKits’s commands, so just use their aliases instead!

Solution 2 – Delete your server’s Command.config.xml file. A fresh, new file will be generated automatically and your commands should work again!