SPECIAL THANKS TO SKINGAMES FOR THE UI WORK!
CustomSets is a labor of love for me. I always envisioned a Kits-style plugin with built in purchasing (to eliminate kits in ServerRewards or GUIShop or any of the other numerous workarounds) and skin support that was 100% UI based and that is exactly what this is.
This plugin allows admins to create Sets which include items for the belt, wear, and main containers. Items for the belt are saved in their exact order and placed in that exact spot on redemption of the Set.
To create a Set an admin will want to fill their inventory with everything they want in the set and then open the CustomSets UI using /sets or the optional keybinding. They will enter Admin Mode and click the "Create New Set" button. This will automatically copy all of the items in the inventory containers and place them in the UI boxes. From here the admin can change skins of items. Once ready, the admin can begin the saving process which walks the admin through the options based on selections. These include if the Set should have a permission, if the set is hidden in the UI (great for if you want to make sets for Factions, or teams, or any other method that is only give or called from other plugins), if the Set requires a permission and isn't hidden what it should cost to unlock, the number of uses per reset period (see config options for USES reset interval), how many minutes the cooldown is, and finally type a name for the Set.
Created sets that have been saved can be edited at anytime to change skins, cost, cooldown, permission, hidden, uses, and remove items. The only thing you can not do is add more items but that could potentially be added down the road. In my opinion it isn't very hard to redeem the Set, then recreate it with the extra items you want.
To create Sets a player must be Auth2 or have CustomSets.admin.
For a player to access the menu via chat command or key binding they must have CustomSets.allow.
For more information on permissions
CONFIG OPTIONS:InfoInterval = 15, --> Sets frequency of Chat Informational Messages (Set to 0 to disable the message entirely)MenuKeyBinding = "", --> Key bindingUsePayment = false, --> Allows players to purchase access to a set using ServerRewards and Economics.ShowLockedSets = true, --> If set to false, sets that require a permission will not be visible to players without the permission. If you intend to use "UsePayment" then you want this set to true so players can see the sets they want to purchase. Otherwise there will be nothing visible to buy :pUsesResetInterval_InHours = 24, --> Sets how often set "uses" reset. By default set uses are for 24 hours. So 24 hours after the first use of that set, the number of uses will reset.Categories = new List<string> {"Basic", "Special", "Unlimited", "NoCooldowns", "VIP", "ADMIN ONLY" }, --> Add/Remove category names from this section to breakout the menu into categories. Sets will register under these categories.. (see images).SpawnSets = new Dictionary<int, string>{{1, "setName1"},{2, "setName2"},{3, "setName3"},} --> Same functionality I built into Kits. The sets listed here will attempt to be given to a player on respawn based on permisions, uses, and cooldown.
FOR DEVELOPERS:
I mimicked in exact format all of the Kits hooks. So if you change the hook from Kits?.Call .. to CustomSets?.Call.. it should work the same way.
Beyond that I also made all my own hooks.
CustomSets is a labor of love for me. I always envisioned a Kits-style plugin with built in purchasing (to eliminate kits in ServerRewards or GUIShop or any of the other numerous workarounds) and skin support that was 100% UI based and that is exactly what this is.
This plugin allows admins to create Sets which include items for the belt, wear, and main containers. Items for the belt are saved in their exact order and placed in that exact spot on redemption of the Set.
To create a Set an admin will want to fill their inventory with everything they want in the set and then open the CustomSets UI using /sets or the optional keybinding. They will enter Admin Mode and click the "Create New Set" button. This will automatically copy all of the items in the inventory containers and place them in the UI boxes. From here the admin can change skins of items. Once ready, the admin can begin the saving process which walks the admin through the options based on selections. These include if the Set should have a permission, if the set is hidden in the UI (great for if you want to make sets for Factions, or teams, or any other method that is only give or called from other plugins), if the Set requires a permission and isn't hidden what it should cost to unlock, the number of uses per reset period (see config options for USES reset interval), how many minutes the cooldown is, and finally type a name for the Set.
Created sets that have been saved can be edited at anytime to change skins, cost, cooldown, permission, hidden, uses, and remove items. The only thing you can not do is add more items but that could potentially be added down the road. In my opinion it isn't very hard to redeem the Set, then recreate it with the extra items you want.
To create Sets a player must be Auth2 or have CustomSets.admin.
For a player to access the menu via chat command or key binding they must have CustomSets.allow.
For more information on permissions
CONFIG OPTIONS:InfoInterval = 15, --> Sets frequency of Chat Informational Messages (Set to 0 to disable the message entirely)MenuKeyBinding = "", --> Key bindingUsePayment = false, --> Allows players to purchase access to a set using ServerRewards and Economics.ShowLockedSets = true, --> If set to false, sets that require a permission will not be visible to players without the permission. If you intend to use "UsePayment" then you want this set to true so players can see the sets they want to purchase. Otherwise there will be nothing visible to buy :pUsesResetInterval_InHours = 24, --> Sets how often set "uses" reset. By default set uses are for 24 hours. So 24 hours after the first use of that set, the number of uses will reset.Categories = new List<string> {"Basic", "Special", "Unlimited", "NoCooldowns", "VIP", "ADMIN ONLY" }, --> Add/Remove category names from this section to breakout the menu into categories. Sets will register under these categories.. (see images).SpawnSets = new Dictionary<int, string>{{1, "setName1"},{2, "setName2"},{3, "setName3"},} --> Same functionality I built into Kits. The sets listed here will attempt to be given to a player on respawn based on permisions, uses, and cooldown.
FOR DEVELOPERS:
I mimicked in exact format all of the Kits hooks. So if you change the hook from Kits?.Call .. to CustomSets?.Call.. it should work the same way.
Beyond that I also made all my own hooks.
