QuickSkins 1.0.0

Overview

QuickSkins is a quality-of-life plugin for Rust servers that lets players instantly reskin all their equipped wearables with a single click. Designed for convenience and style, QuickSkins features a customizable UI with curated skinsets for different biomes or themes (Snow, Desert, Forest, Blackout, and more). With permission-based access, real-time UI, and admin tools, QuickSkins makes it easy for players to look their best—no manual skin swapping required.

Important:
To comply with Rust’s Terms of Service, it is strongly recommended to use only custom skins that you own or have the rights to. Avoid distributing or applying paid or restricted skins to players who do not own them.

Players simply open their inventory to see the QuickSkins panel, then click a button to instantly apply a full set of matching skins to their gear. Admins can configure skinsets, permissions, and UI appearance to fit any server’s needs.

Key Features

• One-Click Skin Application: Instantly reskin all equipped wearables to a curated set with a single button press.
• Customizable Skinsets: Easily configure skinsets for different biomes, playstyles, or server themes.
• Permission-Based Access: Restrict specific skinsets to VIPs, donators, or groups using Oxide/Carbon permissions.
• Sleek UI Integration: Modern, minimal UI panel appears in the inventory.
• Admin Tools: Fetch equipped skin IDs for easy configuration and troubleshooting.
• Feedback Options: Toast notifications or chat messages for user feedback.
• Localization Ready: All messages and UI text are fully configurable.

Example Configuration

{
  "UI": {
    "ButtonHeight": 16.0,
    "ButtonSpacing": 2.0,
    "ButtonTopMargin": 6.0,
    "MinButtonWidth": 42.0,
    "MaxButtonWidth": 100.0,
    "ButtonTextPadding": 14.0,
    "ButtonFontSize": 11,
    "FigureWidthPx": 10.0,
    "FigureLeftPaddingPx": 3.0,
    "BackgroundColor": "0.6 0.6 0.6 0.10",
    "TextColor": "0.9 0.9 0.9 0.75",
    "ButtonMaterial": "assets/content/ui/uibackgroundblur.mat"
  },
  "Messages": {
    "UseToasts": true,
    "NoPermission": "You do not have permission to use this skinset.",
    "SkinsetNotFound": "Skinset '{0}' is not configured.",
    "Applied": "Applied skinset: {0}",
    "NothingToApply": "No matching wearable items found to reskin.",
    "AdminOnly": "You do not have permission to use this command.",
    "NoWearablesEquipped": "You have no wearable items equipped."
  },
  "Buttons": [
    {
      "Label": "Snow",
      "FigureColor": "0.88 0.97 0.98 0.95",
      "SkinsetKey": "snow",
      "Permission": "quickskins.use.snow",
      "Command": "quickskins.apply snow"
    },
    {
      "Label": "Desert",
      "FigureColor": "0.93 0.79 0.69 0.95",
      "SkinsetKey": "desert",
      "Permission": "quickskins.use.desert",
      "Command": "quickskins.apply desert"
    },
    {
      "Label": "Forest",
      "FigureColor": "0.00 0.39 0.00 0.95",
      "SkinsetKey": "forest",
      "Permission": "quickskins.use.forest",
      "Command": "quickskins.apply forest"
    },
    {
      "Label": "Blackout",
      "FigureColor": "0.00 0.00 0.00 0.95",
      "SkinsetKey": "blackout",
      "Permission": "quickskins.use.blackout",
      "Command": "quickskins.apply blackout"
    }
  ],
  "Skinsets": {
    "blackout": {
      "coffeecan.helmet": 2120618167,
      "hoodie": 2080975449,
      "jacket": 2137516645,
      "metal.facemask": 2105454370,
      "metal.plate.torso": 2105505757,
      "pants": 2080977144,
      "roadsign.gloves": 2530894213,
      "roadsign.jacket": 2120615642,
      "roadsign.kilt": 2120628865,
      "shoes.boots": 2090776132
    },
    "desert": {
      "coffeecan.helmet": 2496517898,
      "hoodie": 2503910428,
      "jacket": 10012,
      "metal.facemask": 2475428991,
      "metal.plate.torso": 2475407123,
      "pants": 2503903214,
      "roadsign.gloves": 2510097681,
      "roadsign.jacket": 2496520042,
      "roadsign.kilt": 2496523983,
      "shoes.boots": 2510093391
    },
    "forest": {
      "coffeecan.helmet": 2570227850,
      "hoodie": 2563940111,
      "jacket": 10009,
      "metal.facemask": 2551475709,
      "metal.plate.torso": 2551474093,
      "pants": 2563935722,
      "roadsign.gloves": 2575539874,
      "roadsign.jacket": 2570233552,
      "roadsign.kilt": 2570237224,
      "shoes.boots": 2575506021
    },
    "snow": {
      "coffeecan.helmet": 2696378175,
      "hoodie": 2674836342,
      "jacket": 2661903671,
      "metal.facemask": 2668165249,
      "metal.plate.torso": 2668149001,
      "pants": 2674838261,
      "roadsign.gloves": 2706128764,
      "roadsign.jacket": 2696375601,
      "roadsign.kilt": 2696358587,
      "shoes.boots": 2752873720
    }
  }
}

Commands

• /getskinids — Lists all equipped wearables and their skin IDs for easy configuration.

Permissions

• quickskins.use.<skinset> — Grants access to use a specific skinset (e.g., quickskins.use.snow).
• quickskins.admin — (Optional) For admin-only features.

Support & Customization

For support, feature requests, or custom modifications, contact the plugin author via private message.