A downloadable mod

Download NowName your own price

Quick Sorter

Sort your inventory, containers, and backpack with a single click. Automatically merges stacks and arranges items by category.

Oxide Plugin Rust Inventory Configurable
๐Ÿ“ฆ

Tidy Up in One Click

A sort button appears wherever you need it — inventory, backpack, or any player-placed container. Items are merged into full stacks and arranged from weapons to food automatically.

Features

๐ŸŽ—

Inventory Sort

A sort button appears in the top-right corner of your inventory. Click it to instantly tidy up containerMain.

๐Ÿ“‚

Container Sort

Open any player-placed storage — Wood Box, Tool Cupboard, and more — and a sort button appears at the top of the loot panel. Map-generated crates are never affected.

๐ŸŽ’

Backpack Sort

Equip a backpack and open your inventory — a dedicated sort button appears on the BACKPACK panel. Unequip the backpack and the button disappears automatically.

๐Ÿ”

Stack Merging

Before sorting, identical items are automatically consolidated up to the maximum stack size, reducing clutter before the final ordering pass.

๐Ÿ“‹

Category Order

Items are arranged in a consistent order: Weapons โ†’ Ammo โ†’ Medical โ†’ Tools โ†’ Attire โ†’ Resources โ†’ Components โ†’ Construction โ†’ Food.

๐ŸŒ

Multi-Language

Supports English and Japanese. Each player can switch their own button label with lang ja or lang en.

How It Works

โ†’ A player with the quicksorter.use permission opens their inventory, a container, or their backpack.
โ†’ A sort button (CUI) is displayed in the appropriate position. The inventory and backpack buttons are drawn once on login and stay in sync with the Tab view automatically. The container button appears when looting starts and disappears when looting ends.
โ†’ Clicking the button first merges duplicate stacks, then sorts items by category, item name, condition (descending), and quantity (descending).

Configuration

A configuration file is automatically generated at oxide/config/QuickSorter.json on first load. Each of the four buttons can be independently customized.

{
  "Player inventory button settings": {
    "Panel color (R G B A, 0-1; default: 0.36 0.55 0.30 0.9)": "0.36 0.55 0.30 0.9",
    "Width (pixels; default: 60)": 60,
    "Height (pixels; default: 16)": 16,
    "X offset from screen center (pixels; default: 0)": 120,
    "Y offset from screen bottom (pixels; default: 0)": 343,
    "Font size (default: 11)": 11
  },
  "Backpack button settings": {
    "Panel color (R G B A, 0-1; default: 0.36 0.55 0.30 0.9)": "0.36 0.55 0.30 0.9",
    "Width (pixels; default: 60)": 56,
    "Height (pixels; default: 16)": 16,
    "X offset from screen center (pixels; default: 0)": -441,
    "Y offset from screen bottom (pixels; default: 0)": 680,
    "Font size (default: 11)": 11
  },
  "Container button settings": {
    "Panel color (R G B A, 0-1; default: 0.36 0.55 0.30 0.9)": "0.36 0.55 0.30 0.9",
    "Width (pixels; default: 60)": 59,
    "Height (pixels; default: 16)": 16,
    "X offset from screen center (pixels; default: 0)": 508,
    "Y offset from screen bottom (pixels; default: 0)": 330,
    "Font size (default: 11)": 11
  },
  "ToolCupboard button settings": {
    "Panel color (R G B A, 0-1; default: 0.36 0.55 0.30 0.9)": "0.36 0.55 0.30 0.9",
    "Width (pixels; default: 60)": 59,
    "Height (pixels; default: 16)": 16,
    "X offset from screen center (pixels; default: 0)": 508,
    "Y offset from screen bottom (pixels; default: 0)": 330,
    "Font size (default: 11)": 11
  }
}
Option Default Description
Panel color 0.36 0.55 0.30 0.9 Button background color as R G B A values in the 0โ€“1 range.
Width / Height 60 / 16 Button size in pixels.
X offset Varies per button Horizontal offset from the screen center (positive = right). Based on a 1280ร—720 reference resolution.
Y offset Varies per button Vertical offset from the bottom of the screen (positive = up). The container button Y is automatically adjusted based on row count.
Font size 11 Font size of the button label text.

Installation

1 Copy the plugin file
Place QuickSorter.cs into your server's oxide/plugins/ directory.
2 Start or restart your server
The config file will be generated automatically at oxide/config/QuickSorter.json.
3 Grant the permission
Give quicksorter.use to the players or groups that should have access to the sort buttons.
4 Adjust button positions (optional)
Edit the config file to reposition or resize any button, then run oxide.reload QuickSorter to apply the changes.

Permission

quicksorter.use

Players with this permission will see the sort button in their inventory, backpack, and any player-placed container they open. Players without it see no buttons and cannot sort.

Grant Permission

oxide.grant user <SteamID> quicksorter.use

Grant to a Group

oxide.grant group <group> quicksorter.use

Revoke Permission

oxide.revoke user <SteamID> quicksorter.use

Important Notes

Supported Containers

The sort button only appears on player-placed storage (Wood Box, Small Stash, Tool Cupboard, etc.). Map-generated containers such as Wood Crates, Metal Crates, Toolboxes, and supply crates are intentionally excluded.

Backpack Button Visibility

The backpack sort button is visible whenever a backpack is equipped and the inventory is open (Tab), regardless of whether the BACKPACK panel is expanded or collapsed. This is a known limitation of vanilla Rust — the server has no event for panel open/close. The button disappears as soon as the backpack is unequipped.

โš  Button Position and Resolution

Default button coordinates are calibrated for a 1280ร—720 reference resolution. Players on other resolutions may see buttons in slightly different positions. Adjust the X/Y offset values in the config to compensate if needed.

Quick Sorter — An Oxide plugin for Rust dedicated servers.

Made by little method

Updated 1 day ago
Published 8 days ago
StatusReleased
CategoryGame mod
Authorlittle method
Tagsmod, plugin, rust
LinksPatreon
AI DisclosureAI Assisted, Code, Graphics, Sounds, Text

Download

Download NowName your own price

Click download now to get access to the following files:

CHANGELOG.md 2.2 kB
QuickSorter.cs 25 kB

Leave a comment

Log in with itch.io to leave a comment.