---
title: "How to configure the StackSizeController plugin for Rust"
description: "Configure StackSizeController on your Rust server: permissions, every command, worked examples, and the low grade fuel gotcha that affects vehicle spawn fuel."
url: "https://www.gameserverkings.com/knowledge-base/rust/add-stacksizecontroller/"
category: "Rust"
category_url: "https://www.gameserverkings.com/knowledge-base/rust/"
published: "2026-08-01T18:24:09.829Z"
updated: "2026-08-19T10:53:16.414Z"
source_format: "html"
site: "GameServerKings"
---

# How to configure the StackSizeController plugin for Rust

<p>StackSizeController changes how high items and resources stack in Rust. On a high gather-rate server the vanilla 1,000 wood cap fills a box almost immediately, so raising stack limits is usually one of the first things owners configure.</p>
<h2>Before you start</h2>
<p>StackSizeController is an Oxide plugin, so your server needs Oxide as its modding framework and the plugin file dropped into <code>oxide/plugins</code>. If you have not set that up yet, start with <a href="/knowledge-base/rust/how-to-install-oxide/">How to install Oxide</a>.</p>
<p>The plugin writes its config to <code>oxide/config/StackSizeController.json</code> once it has loaded for the first time. You can edit that file directly from the <strong>Files</strong> tab in your <a href="https://app.gameserverkings.com">GameServerKings panel</a>, or drive everything through the in-game commands below.</p>
<h2>Permissions</h2>
<p>Every command is permission-gated, so grant the ones you need before using them. Run these as an admin from the F1 console, or from the <strong>Console</strong> tab of your <a href="/games/rust-server-hosting/">Rust game server hosting</a>:</p>
<table>
<thead><tr><th>Permission</th><th>Grants access to</th></tr></thead>
<tbody>
<tr><td><code>stacksizecontroller.setstack</code></td><td>Set the stack size of a single item</td></tr>
<tr><td><code>stacksizecontroller.setstackcat</code></td><td>Set the stack size of a whole category</td></tr>
<tr><td><code>stacksizecontroller.setallstacks</code></td><td>Set the stack size of every item at once</td></tr>
<tr><td><code>stacksizecontroller.itemsearch</code></td><td>Search items and see their current stack size</td></tr>
<tr><td><code>stacksizecontroller.listcategories</code></td><td>List category stack sizes</td></tr>
<tr><td><code>stacksizecontroller.listcategoryitems</code></td><td>List the items inside a category</td></tr>
<tr><td><code>stacksizecontroller.vd</code></td><td>Regenerate the vanilla stack-size reference file</td></tr>
</tbody>
</table>
<p>Grant them to your admin group like this:</p>
<pre><code class="language-text">oxide.grant group admin stacksizecontroller.setstack
oxide.grant group admin stacksizecontroller.setstackcat
oxide.grant group admin stacksizecontroller.setallstacks
oxide.grant group admin stacksizecontroller.itemsearch
oxide.grant group admin stacksizecontroller.listcategories
oxide.grant group admin stacksizecontroller.listcategoryitems
oxide.grant group admin stacksizecontroller.vd</code></pre>
<p>If you are new to Oxide groups and permissions, <a href="/knowledge-base/rust/oxide-permissions-101/">Oxide permissions 101</a> covers how <code>oxide.grant</code>, groups and users fit together.</p>
<h2>Commands</h2>
<table>
<thead><tr><th>Command</th><th>What it does</th></tr></thead>
<tbody>
<tr><td><code>stacksizecontroller.setstack &lt;item&gt; &lt;limit&gt;</code></td><td>Set one item's stack size, by shortname or item ID</td></tr>
<tr><td><code>stacksizecontroller.setstackcat &lt;category&gt; &lt;multiplier&gt;</code></td><td>Set stack sizes for an entire category</td></tr>
<tr><td><code>stacksizecontroller.setallstacks &lt;multiplier&gt;</code></td><td>Set stack sizes for every item in the game</td></tr>
<tr><td><code>stacksizecontroller.itemsearch &lt;name&gt;</code></td><td>Find an item and show its current stack size. Accepts partial names.</td></tr>
<tr><td><code>stacksizecontroller.listcategories</code></td><td>List every category and its stack size</td></tr>
<tr><td><code>stacksizecontroller.listcategoryitems &lt;category&gt;</code></td><td>List the items in a category. Needs the exact category name.</td></tr>
<tr><td><code>stacksizecontroller.vd</code></td><td>Reverts stack sizes and rewrites the plugin's record of every item's vanilla stack size. Run it after a Rust update changes a default.</td></tr>
</tbody>
</table>
<h2>Examples</h2>
<p>Set wood to stack to 1,000:</p>
<pre><code class="language-text">stacksizecontroller.setstack wood 1000</code></pre>
<p>Set everything in the Resources category:</p>
<pre><code class="language-text">stacksizecontroller.setstackcat Resources 50000</code></pre>
<p>Set every item in the game at once:</p>
<pre><code class="language-text">stacksizecontroller.setallstacks 20000</code></pre>
<p>Not sure of an item's shortname? Search for it first &mdash; partial names work:</p>
<pre><code class="language-text">stacksizecontroller.itemsearch sulfur</code></pre>
<h2>Things to be careful of</h2>
<div class="callout">
<p><strong>Low grade fuel is tied to vehicle spawn fuel.</strong> Rust fuels a vendor-bought minicopter with a fifth of the low grade fuel stack limit, so raising that limit to 10,000 would hand every buyer 2,000 low grade &mdash; a large and probably unintended giveaway. The plugin has handled this since v4.1.3: it spots a vendor-spawned minicopter carrying exactly a fifth of a stack and resets it to the vanilla 100. It deliberately stands aside if AirFuel, GetToDaChoppa or VehicleVendorOptions is loaded, because those manage vehicle fuel themselves &mdash; so if you run one of them, check what your players actually receive before you raise low grade.</p>
</div>
<p>Two more worth knowing:</p>
<ul>
<li><strong>Very large stacks affect performance.</strong> Huge stacks mean fewer entities for the same loot, which usually helps &mdash; but combined with a high gather rate they can make raids and recycling produce enormous single stacks. If your server starts hitching, stack sizes are worth reviewing alongside <a href="/knowledge-base/rust/server-performance/">the usual performance checks</a>.</li>
<li><strong>Changes apply going forward.</strong> Items already sitting in boxes keep their existing stacks until they are moved or combined.</li>
</ul>
<h2>What to read next</h2>
<ul>
<li><a href="/knowledge-base/rust/how-to-install-oxide/">How to install Oxide</a> &mdash; getting the modding framework in place</li>
<li><a href="/knowledge-base/rust/oxide-permissions-101/">Oxide permissions 101</a> &mdash; groups, users and <code>oxide.grant</code></li>
<li><a href="/knowledge-base/rust/popular-plugins/">Popular Rust plugins</a> &mdash; what else is worth running</li>
<li><a href="/knowledge-base/rust/admin-commands/">Rust admin commands</a> &mdash; the wider admin reference</li>
</ul>
