customkits

#27 - published a year ago

CustomKits

CustomKits

Version: 1.6.3

For Rocket: 4.9.3.0

IMPORTANT!

 

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 😉

Big thanks to Kr4ken-9 for Loadouts.

Big thanks to Zamirathe for ClearInventoryLib.

 

 

 

Please note: < > means required parameter   …   [ ] means optional parameter

 

Commands & Aliases Parameters Description
/AutoSave, /ASave <kit name> Toggle auto-saving of your inventory onDeath
/AutoLoad, /ALoad <kit name> Toggle auto-loading of specified kit onRespawn
/AutoCopy, /ACopy none Toggle auto-copy, for copying the inventory of your killer onRespawn
/AutoSkills, /ASkills none Toggle auto-skills, for maxing out your skill levels onRespawn
/Save, /SaveKit [kit name] Save your current inventory as a kit (if not using a parameter, then kit name is from the config)
/Load, /LoadKit [kit name] Load your saved kit (if not using a parameter, then kit name is from the config)
/Copy, /CopyKit <player> Copy another player’s inventory to yours
/Delete, /DeleteKit, /Del, /DelKit [kit name] Delete your saved kit / or all of them (if not using a parameter, then kit name is from the config)
/List, /ListKits [player] List your saved kits (or someone else’s if you have permission “CK.list.other”)
/ClearInventory, /CI, /Clear [player] Clear your current inventory (or someone else’s if you have permission “CK.clearinventory.other”)
/MaxSkills, /Skills [player] Maximize your skill levels (or someone else’s if you have permission “CK.maxskills.other”)
/Buyslot, /Buy <amount of slots> 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
  • Automatic update downloads!
  • AutoStore feature will automatically store player’s saved kits (and extra slots) every time the server auto-saves
  • Support for Uconomy and AviEconomy in the Slot Shop
  • 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 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!

 

Support

 Bug Tracker

 All Releases

Image result for discord icon Join My Discord for More!

Image result for donate icon Like my work? Consider a donation 🙂

Default configuration


Default english translation


<?xml version="1.0" encoding="utf-8"?>
<Translations xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Translation Id="autoskills_on" Value="Auto-skills have been enabled!" />
  <Translation Id="autoskills_off" Value="Auto-skills have been disabled!" />
  <Translation Id="autocopy_on" Value="Auto-copy has been enabled!" />
  <Translation Id="autocopy_off" Value="Auto-copy has been disabled!" />
  <Translation Id="autosave_on" Value="Auto-save has been enabled and will be saved as &quot;{0}&quot;!" />
  <Translation Id="autosave_off" Value="Auto-save has been disabled!" />
  <Translation Id="autoload_on" Value="Auto-load has been enabled for &quot;{0}&quot;!" />
  <Translation Id="autoload_off" Value="Auto-load has been disabled!" />
  <Translation Id="slotshop_help" Value="Welcome to the Slot Shop! Use /buy &lt;amount_of_slots&gt;" />
  <Translation Id="slotshop_disabled" Value="Sorry, the Slot Shop is disabled!" />
  <Translation Id="not_enough" Value="You don't have enough to buy more slots!" />
  <Translation Id="bought_slot" Value="You bought an extra slot for {0} {1}!" />
  <Translation Id="bought_slots" Value="You bought {0} extra slots for a total of {1} {2}!" />
  <Translation Id="max_skills" Value="All of your skills have been maxed out!" />
  <Translation Id="max_skills_other" Value="You maxed out {0}'s skills!" />
  <Translation Id="copy_bypass" Value="{0}'s inventory cannot be copied!" />
  <Translation Id="copied" Value="You copied {0}'s inventory!" />
  <Translation Id="auto_stored" Value="Successfully stored CustomKits and ExtraSlots!" />
  <Translation Id="are_you_sure" Value="Type &quot;/yes&quot; to delete all CustomKits!" />
  <Translation Id="all_kits_deleted" Value="Successfully deleted all CustomKits!" />
  <Translation Id="kit_deleted" Value="Successfully deleted, {0}" />
  <Translation Id="kit_saved" Value="Successfully saved, {0}" />
  <Translation Id="kit_loaded" Value="Successfully loaded, {0}" />
  <Translation Id="kit_list" Value="Your saved CustomKits: {0}" />
  <Translation Id="kit_list_other" Value="{0}'s saved CustomKits: {1}" />
  <Translation Id="no_saved_kits" Value="You don't have any saved CustomKits!" />
  <Translation Id="no_saved_kits_other" Value="{0} doesn't have any saved CustomKits!" />
  <Translation Id="no_kit_exists" Value="A CustomKit with that name doesn't exist!" />
  <Translation Id="no_kits_left" Value="You have reached the maximum amount of CustomKits!" />
  <Translation Id="blacklisted" Value="{0} is blacklisted and cannot be saved in a CustomKit!" />
  <Translation Id="item_limit" Value="You can't have more than {0} items in your CustomKit!" />
  <Translation Id="ci_bypass" Value="{0}'s inventory cannot be cleared!" />
  <Translation Id="inventory_cleared" Value="Your inventory has been cleared!" />
  <Translation Id="inventory_cleared_other" Value="You cleared {0}'s inventory!" />
  <Translation Id="player_doesn't_exist" Value="{0} either doesn't exist, or is offline!" />
  <Translation Id="empty_inventory" Value="Failed, because your inventory is empty!" />
  <Translation Id="unsupported_character" Value="You cannot use {0} as your kit name!" />
</Translations>

Commands and permissions


/autocopy

Permissions: autocopy

Toggle Auto-copy


/autoload <kit name>

Permissions: autoload

Toggle Auto-load


/autosave <kit name>

Permissions: autosave

Toggle Auto-save


/buyslot <amount>

Permissions: buyslot

Buy more slots with economy currency


/autoskills

Permissions: autoskills

Toggle Auto-maxskills


/maxskills [player]

Permissions: maxskills

Max out your (or someone else's) skills


/copy <player>

Permissions: copy

Copy someone else's inventory to your own


/clearinventory [player]

Permissions: clearinventory

Clear your (or someone else's) inventory


/delete [kit name / *]

Permissions: delete

Delete some (or all) of your saved kits


/list [player]

Permissions: list

List your (or someone else's) saved kits


/load [kit name]

Permissions: load

Load your saved kits


/save [kit name]

Permissions: save

Save your current inventory as a kit


Git changelog


466a8c1194ef79e 2017-09-13 02:22:13

Update 1.6.3

  • - Minor bug fixes
  • - Overall improvements
  • - Updated libraries

5704bf534de7649 2017-09-13 02:20:08

...

    7d32ec4f9f54fa8 2017-09-13 02:20:03

    ...

      be14774f8e572ba 2017-09-13 02:19:59

      ...

        35a1681c7b3e95c 2017-09-13 02:19:56

        ...

          23618e8d67e9136 2017-09-13 02:19:53

          ...

            4c36d8043c3c97b 2017-09-13 02:19:49

            ...

              a31ba3adf6bb414 2017-09-13 02:19:07

              ...

                3a5d7df95ccc62a 2017-09-13 02:18:57

                ...

                  b76671728cbf77b 2017-08-25 08:59:07

                  Update README.md

                    db48d5b0bf6391b 2017-08-21 08:26:31

                    Update 1.6.2

                    • - fixed bug preventing giving player's slots when they connect
                    • - various stability improvements
                    • - removed /reloadkits command (caused errors)
                    • - removed AutoBackup feature (didn't work how it was intended)

                    9cc3697212f5bae 2017-08-13 05:53:58

                    Update README.md

                      ed06f2f9f920752 2017-08-13 05:52:26

                      update 1.6.1

                      • - stability improvements
                      • - updated libraries

                      74b384a8cecd958 2017-08-06 09:06:42

                      Update README.md

                        3ef6ce217190777 2017-08-06 09:05:37

                        update 1.6.0

                        • - Added option in config for preventing item drops when players die
                        • - Items dropped in the Arena lobby will immediately disappear (clears up lag)
                        • - Stability improvements (including... new update checker, permission fail safe, & more...)
                        • - Updated libraries & avieconomy

                        00538b8e10cb873 2017-08-06 09:01:12

                        ...

                          1342313db569f73 2017-07-24 23:29:41

                          Update README.md

                            5a2abedb36dafc9 2017-07-24 23:26:09

                            minor fixes & tweaks

                            • - added /reload to instantly load in all kits from StoredKits.json file (only for console)
                            • - fixed deleting player's kits onDisconnect, if SlotShop was disabled
                            • - fixed Rocket Reload errors

                            c1720c7b0b234ae 2017-07-19 08:59:59

                            Update README.md

                              d0cf684ee056cc6 2017-07-19 08:58:25

                              update 1.5.1

                              • fixed issues with loading kits
                              • fixed issues with IncludeClothes option in config
                              • minor API change

                              93c99e89a4a7720 2017-07-18 09:52:31

                              Update README.md

                                f39100978ed6ba2 2017-07-18 09:51:44

                                ...

                                  938baca7871c4ed 2017-07-18 09:51:35

                                  ...

                                    e3ca90a846ce713 2017-07-18 09:47:58

                                    update 1.5

                                    • Biggest update yet

                                    3ac88d7d7ad32ef 2017-07-18 09:43:01

                                    ...

                                      7a773ea1754a449 2017-07-18 09:42:54

                                      ...

                                        64d2742366f7fdc 2017-07-18 09:42:48

                                        ...

                                          dc9f4aaedf9d1b1 2017-07-03 06:54:04

                                          ...

                                            d2d322ee1856b6c 2017-07-03 06:17:02

                                            Update README.md

                                              e6bb6aa01930fb7 2017-07-03 05:39:49

                                              Update 1.4.3

                                              • Minor update: many fixes

                                              50225b766eab761 2017-06-25 13:35:53

                                              Update README.md

                                                f9afface3cfa350 2017-06-25 13:16:53

                                                Update 1.4.2

                                                • Minor tweaks, error and bug fixes

                                                f6cfd0d0c77e378 2017-06-25 13:12:28

                                                ...

                                                  7a9b3cf13d53a0d 2017-06-07 07:54:34

                                                  reup #2

                                                    80de4ab8d39595f 2017-06-07 07:33:42

                                                    reup

                                                      a0cb59ef9228248 2017-06-07 07:24:20

                                                      Delete CustomKits.csprojResolveAssemblyReference.cache

                                                        b607244b69b6a6a 2017-06-07 07:24:15

                                                        Delete DesignTimeResolveAssemblyReferencesInput.cache

                                                          aae7a854a982bf0 2017-06-07 07:24:09

                                                          Delete DesignTimeResolveAssemblyReferences.cache

                                                            41b06df0cba1ae4 2017-06-07 07:24:04

                                                            Delete CustomKits.dll

                                                              2d15adc0e2701d0 2017-06-07 07:24:00

                                                              Delete CustomKits.pdb

                                                                73033514c424764 2017-06-07 07:23:56

                                                                Delete CustomKits.csproj.FileListAbsolute.txt

                                                                  730867212eb4c41 2017-06-07 07:23:50

                                                                  Delete CoreCompileInputs.cache

                                                                    1095416503349e8 2017-06-07 07:23:43

                                                                    Delete Rocket.Unturned.dll

                                                                      38ba4b665c599e8 2017-06-07 07:23:38

                                                                      Delete UnityEngine.dll

                                                                        607cfdea96cd5d0 2017-06-07 07:23:34

                                                                        Delete Rocket.Core.dll

                                                                          1dfb84ec7908fbf 2017-06-07 07:23:30

                                                                          Delete Rocket.API.dll

                                                                            61ed83901b7cb82 2017-06-07 07:23:25

                                                                            Delete Newtonsoft.Json.dll

                                                                              d62692009690cae 2017-06-07 07:23:20

                                                                              Delete CustomKits.pdb

                                                                                4272a6af5ef8194 2017-06-07 07:23:16

                                                                                Delete CustomKits.dll

                                                                                  bc2e09969c9f167 2017-06-07 07:23:11

                                                                                  Delete Assembly-CSharp.dll

                                                                                    e99e9ecbc43ce39 2017-06-07 07:23:05

                                                                                    Delete Assembly-CSharp-firstpass.dll

                                                                                      f812f070f3d2386 2017-06-07 07:22:11

                                                                                      Delete 1.3.3.zip

                                                                                        8fa23ac0aaefc7a 2017-06-07 07:22:06

                                                                                        Delete 1.3.2.zip

                                                                                          da51f8160449ef4 2017-06-07 07:22:02

                                                                                          Delete 1.3.1.zip

                                                                                            c227d0a1d148eb3 2017-06-07 07:21:56

                                                                                            Delete 1.3.zip

                                                                                              2ac4acf3d38fe50 2017-06-07 07:09:23

                                                                                              Update README.md

                                                                                                f81420e61379533 2017-06-07 07:08:53

                                                                                                update 1.4.1

                                                                                                  6de9df2a9a947a4 2017-06-07 07:07:25

                                                                                                  update 1.4.1

                                                                                                    94f36571396b3df 2017-06-07 05:53:32

                                                                                                    Update README.md

                                                                                                      383fe024415f616 2017-06-07 05:50:28

                                                                                                      Delete

                                                                                                        a4e2a6c1d9d8bbd 2017-06-07 05:49:55

                                                                                                        update 1.4

                                                                                                          e5d0029b77ca2ad 2017-06-07 05:42:16

                                                                                                          Delete Newtonsoft.Json.dll

                                                                                                            f37074bb203eef4 2017-05-16 21:57:46

                                                                                                            Update README.md

                                                                                                              8a2254668c27d53 2017-05-16 21:33:55

                                                                                                              update 1.3.3

                                                                                                              • fixes

                                                                                                              3f78e6fecdb018a 2017-04-25 22:45:41

                                                                                                              Update README.md

                                                                                                                531687750a87907 2017-04-25 22:06:08

                                                                                                                Update 1.3.2

                                                                                                                • Fixes

                                                                                                                110d690d5abe935 2017-04-12 03:05:52

                                                                                                                Update README.md

                                                                                                                  58d7949f832648c 2017-04-12 02:53:54

                                                                                                                  Update 1.3.1

                                                                                                                  • Fixes, ability to delete all kits at once, and some less-important changes

                                                                                                                  ef0abce5120e34e 2017-04-08 00:56:05

                                                                                                                  thank you kr4ken

                                                                                                                    4e7f94b6241eb2e 2017-04-08 00:50:11

                                                                                                                    Update README.md

                                                                                                                      Download

                                                                                                                      Build #27
                                                                                                                      By downloading this file, you agree to our license terms.

                                                                                                                      Repository

                                                                                                                      github.com

                                                                                                                      License

                                                                                                                      MIT

                                                                                                                      Author

                                                                                                                      Teyhota