Backpack Button｜免费插件

插件介绍

添加一个高度可配置的 UI 按钮用于打开背包

The Backpacks plugin will automatically disable its built-in GUI button when it detects the Backpack Button plugin.

主要用途

主要用于backpacks、gui等服务端功能。本插件由 WhiteThunder 发布，当前目录记录版本为 v1.1.3，uMod 累计下载 27,579 次。

适用场景

希望改善玩家交互与日常体验的社区服务器

功能分类

查看 uMod 官方英文简介

Adds a highly configurable UI button for opening Backpacks

权限节点

backpackbutton.use

Allows players to see and toggle the backpack button.

授权示例：oxide.grant user 玩家名权限节点；撤销使用 oxide.revoke。

指令说明

backpackui

Displays help information about how to use the command, as well as the available button positions.

backpackui <position> (Left | Right | Toggle | Off) -- Changes your preferred backpack button position. Use Toggle to show or hide the button without changing preferred position. Use Off to hide the backpack button.

配置说明

Default configuration:

{ "Commands": [ "backpackui", "backpackbutton" ], "Background": { "Enabled": true, "Color": "0.969 0.922 0.882 0.035", "Sprite": "assets/content/ui/ui.background.tiletex.psd" }, "Gather mode indicator": { "Enabled": true, "Color": "0.4 0.8 1 1" }, "Retrieve mode indicator": { "Enabled": true, "Color": "0.4 0.8 1 1" }, "Occupied & total slots": { "Show occupied slots": true, "Show total slots": true, "Offset min": "0 -18", "Offset max": "60 0", "Text align": "MiddleCenter", "Default color": "0.4 0.8 0.4 1", "Enable dynamic color": true, "Dynamic color by fullness percent": { "70": "0.8 0.8 0.2 1", "80": "0.8 0.4 0.2 1", "90": "0.8 0.2 0.2 1" } }, "Fill bar": { "Enabled": true, "Width": 4.0, "Sprite": "assets/content/ui/ui.background.tiletex.psd", "Default color": "0.4 0.8 0.4 1", "Enable dynamic color": true, "Dynamic color by fullness percent": { "70": "0.8 0.8 0.2 1", "80": "0.8 0.4 0.2 1", "90": "0.8 0.2 0.2 1" } }, "Default button position": "Right", "Button positions": [ { "Name": "Left", "Enabled": true, "Offset X": -263.5, "URL": "", "Skin ID": 3050420442, "Image size": 56.0 }, { "Name": "Right", "Enabled": true, "Offset X": 185.0, "URL": "", "Skin ID": 3050420772, "Image size": 56.0 } ] }

Commands

Determines which commands can be used to change button preferences.

Background

Controls the background panel behind the backpack image.Enabled (true or false) -- Determines whether the background panel is enabled. Default: true.Color -- Determines the color of the background panel. Default: "0.969 0.922 0.882 0.035".Sprite -- Determines the sprite of the background panel. This must be a valid client-side asset. There is no definitive reference for all known client-side assets, so if you want to customize this, you are on your own. Default: "assets/content/ui/ui.background.tiletex.psd".

Gather mode indicator

Controls the display of the Gather mode indicator, which is displayed while the player's backpack has Gather mode enabled for at least one page.Enabled (true or false) -- Determines whether the Gather mode indicator is enabled. Default: true.Color -- Determines the text color of the indicator. Default: "0.4 0.8 1 1".

Retrieve mode indicator

Controls the display of the Retrieve mode indicator, which is displayed while the player's backpack has Retrieve mode enabled for at least one page.Enabled (true or false) -- Determines whether the Retrieve mode indicator is enabled. Default: true.Color -- Determines the text color of the indicator. Default: "0.4 0.8 1 1".

Occupied & total slots -- Controls the display of the occupied & total slots text. If both occupied and total slots are enabled, you will see text like "15/48". If only one number is enabled, you will see just that number.Show occupied slots (true or false) -- Determines whether the current number of occupied slots is displayed. Default: true.Show total slots (true or false) -- Determines whether the backpack's total capacity is displayed. Default: true.Offset min -- Determines the X and Y coordinates of the bottom left point of the invisible box that contains the text, relative to the bottom left of the backpack button.Offset max -- Determines the X and Y coordinates of the top right point of the invisible box that contains the text, relative to the bottom left of the backpack button.Text align -- Determines the text alignment. Default value: "MiddleCenter".Allowed values: "UpperLeft", "UpperCenter", "UpperRight", "MiddleLeft", "MiddleCenter", "MiddleRight", "LowerLeft", "LowerCenter", "LowerRight".Default color -- Determines the default text color. The displayed color may be different, if you have set "Enable dynamic color": true. Default value: "0.4 0.8 0.4 1".Enable dynamic color (true or false) -- Determines whether dynamic text color is enabled. Default: true.Dynamic color by fullness percent -- Determines the text color according to how full the backpack is.

Fill bar

Controls the display of the fill bar, which indicates how full the backpack is.Enabled (true or false) -- Determines whether the fill bar is enabled. Default: true.Sprite -- Determines the sprite of the fill bar. This must be a valid client-side assets. There is no definitive reference for all known client-side assets, so if you want to customize this, you are on your own. Default value: "assets/content/ui/ui.background.tiletex.psd".Width -- Determines the width of the fill bar. Default: 4.0.Default color -- Determines the default color of the fill bar. The displayed color may be different, if you have set "Enable dynamic color": true. Default: "0.4 0.8 0.4 1".Enable dynamic color (true or false) -- Determines whether dynamic text color is enabled. Default: true.Dynamic color by fullness percent -- Determines the text color according to how full the backpack is.

Default button position

Determines the default button position. Set to "" to disable the button by default. This value must correspond to a position Name in the Button positions section that has Enabled set to true. Default: "Right".

Button positions

Determines the available button positions.Name -- Determines the name of the button position. This name is used to generate a localization option, and can be referred to by Default button position.Enabled -- Determines whether this button position can be used.Offset X -- Determines the X offset of the bottom left corner of the button, relative to the bottom center of the screen.URL -- Determines the button image. Will have no effect if Skin ID is not 0.Skin ID -- Determines the button image, using a rust skin. Set to 0 to use URL instead. Default: 0.Image size -- Determines the size of the image. Recommended to go no higher than 60.0, especially if you have the background enabled. Default: 56.0.

Enabled (true or false) -- Determines whether the background panel is enabled. Default: true.

Color

Determines the color of the background panel. Default: "0.969 0.922 0.882 0.035".

Sprite

Determines the sprite of the background panel. This must be a valid client-side asset. There is no definitive reference for all known client-side assets, so if you want to customize this, you are on your own. Default: "assets/content/ui/ui.background.tiletex.psd".

Enabled (true or false) -- Determines whether the Gather mode indicator is enabled. Default: true.

Color

Determines the text color of the indicator. Default: "0.4 0.8 1 1".

Enabled (true or false) -- Determines whether the Retrieve mode indicator is enabled. Default: true.

Show occupied slots (true or false) -- Determines whether the current number of occupied slots is displayed. Default: true.

Show total slots (true or false) -- Determines whether the backpack's total capacity is displayed. Default: true.

Offset min

Determines the X and Y coordinates of the bottom left point of the invisible box that contains the text, relative to the bottom left of the backpack button.

Offset max

Determines the X and Y coordinates of the top right point of the invisible box that contains the text, relative to the bottom left of the backpack button.

Text align

Determines the text alignment. Default value: "MiddleCenter".Allowed values: "UpperLeft", "UpperCenter", "UpperRight", "MiddleLeft", "MiddleCenter", "MiddleRight", "LowerLeft", "LowerCenter", "LowerRight".

Default color

Determines the default text color. The displayed color may be different, if you have set "Enable dynamic color": true. Default value: "0.4 0.8 0.4 1".

Enable dynamic color (true or false) -- Determines whether dynamic text color is enabled. Default: true.

Dynamic color by fullness percent

Determines the text color according to how full the backpack is.

Allowed values: "UpperLeft", "UpperCenter", "UpperRight", "MiddleLeft", "MiddleCenter", "MiddleRight", "LowerLeft", "LowerCenter", "LowerRight".

官方配置示例

{
  "Commands": [
    "backpackui",
    "backpackbutton"
  ],
  "Background": {
    "Enabled": true,
    "Color": "0.969 0.922 0.882 0.035",
    "Sprite": "assets/content/ui/ui.background.tiletex.psd"
  },
  "Gather mode indicator": {
    "Enabled": true,
    "Color": "0.4 0.8 1 1"
  },
  "Retrieve mode indicator": {
    "Enabled": true,
    "Color": "0.4 0.8 1 1"
  },
  "Occupied & total slots": {
    "Show occupied slots": true,
    "Show total slots": true,
    "Offset min": "0 -18",
    "Offset max": "60 0",
    "Text align": "MiddleCenter",
    "Default color": "0.4 0.8 0.4 1",
    "Enable dynamic color": true,
    "Dynamic color by fullness percent": {
      "70": "0.8 0.8 0.2 1",
      "80": "0.8 0.4 0.2 1",
      "90": "0.8 0.2 0.2 1"
    }
  },
  "Fill bar": {
    "Enabled": true,
    "Width": 4.0,
    "Sprite": "assets/content/ui/ui.background.tiletex.psd",
    "Default color": "0.4 0.8 0.4 1",
    "Enable dynamic color": true,
    "Dynamic color by fullness percent": {
      "70": "0.8 0.8 0.2 1",
      "80": "0.8 0.4 0.2 1",
      "90": "0.8 0.2 0.2 1"
    }
  },
  "Default button position": "Right",
  "Button positions": [
    {
      "Name": "Left",
      "Enabled": true,
      "Offset X": -263.5,
      "URL": "",
      "Skin ID": 3050420442,
      "Image size": 56.0
    },
    {
      "Name": "Right",
      "Enabled": true,
      "Offset X": 185.0,
      "URL": "",
      "Skin ID": 3050420772,
      "Image size": 56.0
    }
  ]
}

{
  "Usage": "Usage: <color=#fd4>{0}</color> <position>\n\nPositions: {1}",
  "Off": "Off",
  "No Permission": "You don't have permission to use this command.",
  "Position.Left": "Left",
  "Position.Right": "Right"
}

更新日志

最新版本： v1.1.3

最后版本发布： 2026-06-30

最后更新（条目）： 2026-07-19

本站记录 uMod 官方插件信息。完整的历史更新日志请参阅 uMod 官方页面。

安装方法

确认服务器已安装 Oxide / uMod 或兼容的 Carbon 框架。
登录本站后点击"下载"，由 uMod 官方地址获取作者发布的文件。
将 .cs 文件放入服务器的 oxide/plugins 目录。
观察服务端控制台，确认插件编译并成功加载。
具体配置、权限、指令和依赖请查看原作者的 uMod 页面。

使用前注意

Rust 更新后，请先确认插件是否仍兼容当前服务端版本。
修改配置前建议备份原配置文件，并在测试服验证后再部署到正式服。
若插件依赖其他扩展或库，以 uMod 原作者页面的最新说明为准。
本站中文内容用于辅助理解，遇到版本差异时以官方英文文档和源码为准。

来源说明

中文介绍由 uMod 官方简介翻译整理。插件著作权、许可证、完整文档和最新发布状态均以原作者及 uMod 官方页面为准。