News BocX
  • Need DeObfuscation service? Join our Discord
  • We are configuring the store keep tuned!
Sign in to follow this  
Mr_Masterbay

[RUST] PlayerSkins

Recommended Posts

[RUST] PlayerSkins


Required Dependencies:

Hidden Content

    Give reaction or reply to this topic to see the hidden content.
Optional Dependencies:

Hidden Content

    Give reaction or reply to this topic to see the hidden content.

Hidden Content

    Give reaction or reply to this topic to see the hidden content.

This plugin requires a Steam API key to download approved skin icons from the workshop and/or use workshop items
You can get a Steam API key from 

Hidden Content

    Give reaction or reply to this topic to see the hidden content.

Once you have your Steam API key copy it to your config (Workshop Options -> Steam API key)

PlayerSkins allows players to purchase skins for items using in game currency such as RP (ServerRewards) or coins (Economics). They can then apply those skins to their items using the 'Reskin' menu

4994384fcd1fbff99edfc5df106490ef.jpg
01be8e2708d06a05802ed3e7645f378c.jpg
58168eea5971c7a10b445ec2b9f38741.jpg

Important Information
By default the plugin does not import all workshop skins and I highly advise that you do not do so. At the time of writing this there are around 40,000 skins on the workshop which will consume around 8-9gb of disk space. Importing every skin will significantly impact your servers performance which will be most noticeable when anything accesses the image database such as when a player edits a sign

I have provided commands which you can use to import workshop skins either at random, random for a specified item, or a specific skin

Workshop skins come and go constantly all day, meaning that one day a skin might be available and the next it will not. There is nothing that can be done about this as once it is removed from the workshop you will no longer be able to apply that skin to a item. When the plugin loads it grabs that latest list of available workshop skins so don't get sad if some have disappeared.

All approved skins are automatically added to the skin shop

All imported workshop skins will be unavailable when the plugin first loads until the workshop list has been downloaded. This is to prevent further sales (and skin timeouts) of skins that have since been removed from the workshop. Once the workshop list has loaded and the plugin has processed it then any imported skins that are still on the workshop will appear in the skin shop.

Features
- Option to add any skin from the Steam workshop
- Large and small skin shop UI
- Small and easy to use reskin menu to apply skins at any time
- Adjust skin costs, required permissions, or delete a skin from within admin section of the menu
- Custom assignable permissions to allow VIPs to purchase different skins
- Ability to setup NPCs to access the skin shop and reskin menu
- Word filter to prevent skins from ever entering the skin shop
- Ability to use the skin shop as an item shop by giving the players the item with the specified skin on purchase

Permissions
playerskins.shop - Required to open the shop
playerskins.reskin - Required to open the reskin menu
playerskins.admin - Required to use see and use the admin functions
playerskins.nocharge - Skins don't cost anything for players with this permission

Chat Commands
/skin - Opens the reskin menu
/skin shop - Opens the skin shop

Console Commands
playerskins.skins import <item shortname> <skin ID> - Import the specified workshop skin
playerskins.skins import random <amount> - Import the specified amount of random skins for random items
playerskins.skins import random <item shortname> <amount> - Import the specified amount of random skins for the specified item
playerskins.skins remove <item shortname> <skin ID> - Remove the specified skin from the skin shop

playerskins.setprice <item shortname> <amount> - Set the price for all skins for the specified item
playerskins.setprice all <amount> - Set the price for all skins for all items

How to import skins from the workshop
There are 3 ways you can add workshop items to the skin list by using the commands provided above.

- Importing specific skins
If you want to import a specific skin use the command playerskins.skins import <item shortname> <skin ID>, specifying the item short name and the ID of the skin you want to import.

- Importing random skins for a specific item
If you want to import say 50 random skins for the Assault Rifle for example you would type playerskins.skins import random rifle.ak 50. This will select 50 random AssaultRifle skins and import them into the skin shop

- Importing random skins for all items
If you don't want to bother picking and choosing you can import random skins for random items by typing playerskins.skins import random <amount>, replacing <amount> with the amount of skins you wish to import.

Accessing the Admin section of the menu
You can access the admin section of the menu by clicking the "Admin Mode" button. Now when you click on a item the admin menu will appear next to the item popup from which you can adjust the cost, required permission, or delete the item from the store
0942f33ee0153d407a971234019f080c.jpg

Config Options
"Announcement Options" - These are options regarding automated announcements to players regarding accessing the skin shop and reskin menu

"Purchase Options" - These are options regarding the purchase of skins from the skin shop. You can select the plugin required to pay for these skins or disable the purchase system entirely and make all skins free

"Skin Shop Options" - Options regarding the skin shop.
-- "Custom permissions which can be assigned to skins" - These are permissions that can be assigned to skins to only allow VIP players access to purchase them. You can add/remove these permission as you see fit. When granting a permission it must be prefixed with "playerskins.<permission>"
-- "NPC user IDs that players can interact with to open the skin shop" - Here you can set NPC IDs (HumanNPC) which can be interacted with to open the skin shop
-- "Disable the '/skin shop' command and force players to access it via a NPC" - This will disable the '/skin shop' command entirely and force players to interact with NPCs to open the skin shop
-- "Allow players to sell unwanted skins back to the skin store" - By enabling this players will be able to sell unwanted skins back to the skin shop
-- "Give player the item when they purchase a skin" - This turns the skin shop into a item shop by giving the player the item with the skin they purchased. This disables the re-skin menu
-- "Forced display mode for skin shop (Full, Minimalist, None)" - This will force the UI mode a player can use. Set this to 'None' to allow players to switch between the large and small UI

"Re-skin Options" - Options regarding the reskin menu
-- "NPC user IDs that players can interact with to open the re-skin menu" - Here you can set NPC IDs (HumanNPC) which can be interacted with to open the reskin menu
-- "Disable the '/skin' command and force players to access it via a NPC" - This will disable the '/skin' command entirely and force players to interact with NPCs to open the reskin menu

"Workshop Options" - Options regarding Steam workshop and workshop skins
-- "Retrieve workshop skin information when the plugin loads" - By enabling this the plugin will connect to the Steam workshop and pull the latest list of workshop items. Disabling this will disable workshop skins throughout the entire plugin
-- "Word filter for workshop skins" - If a skin partially contains any words in this list it can not be imported to the skin shop

"UI Options" - Options regarding the UI coloring and style

Config

Code (C#):

{
  "Announcement Options": {
    "Display help information to players": true,
    "Information display interval (minutes)": 10
  },
  "Purchase Options": {
    "Enable purchase system": false,
    "Plugin used to purchase skins (ServerRewards, Economics)": "ServerRewards"
  },
  "Skin Shop Options": {
    "Custom permissions which can be assigned to skins": [
      "vip1",
      "vip2",
      "vip3"
    ],
    "NPC user IDs that players can interact with to open the skin shop": [],
    "Disable the '/skin shop' command and force players to access it via a NPC": false,
    "Allow players to sell unwanted skins back to the skin store": true,
    "Give player the item when they purchase a skin (this disables the reskin menu)": false,
    "Forced display mode for skin shop (Full, Minimalist, None)": "None",
    "Send a help message to players when exiting the skin shop": true,
    "List of shortnames for items to be blocked from appearing in the skin shop": []
  },
  "Re-skin Options": {
    "NPC user IDs that players can interact with to open the re-skin menu": [],
    "Disable the '/skin' command and force players to access it via a NPC": false
  },
  "Workshop Options": {
    "Disable approved skins from the skin shop": false,
    "Enable workshop skins in the skin shop": true,
    "Word filter for workshop skins. If the skin title partially contains any of these words it will not be available as a potential skin": [],
    "Force image URLs to use HTTP instead of HTTPS": true,
    "Steam API key (get one here 

Hidden Content

    Give reaction or reply to this topic to see the hidden content.
: ""
  },
  "UI Options": {
    "UI Colors": {
      "Background": {
        "Color (hex)": "#2b2b2b",
        "Alpha (0.0 - 1.0)": 0.7
      },
      "Panel": {
        "Color (hex)": "#545554",
        "Alpha (0.0 - 1.0)": 1.0
      },
      "Button": {
        "Color (hex)": "#393939",
        "Alpha (0.0 - 1.0)": 1.0
      },
      "ButtonSelected": {
        "Color (hex)": "#d85540",
        "Alpha (0.0 - 1.0)": 1.0
      }
    }
  },
  "Version": {
    "Major": 2,
    "Minor": 0,
    "Patch": 20
  }
}
 

 

Share this post


Link to post
Share on other sites
Sign in to follow this