EclexToolkit 1.0.2

ec'lex's Toolkit

A two-part mod for Unturned (3.x) that adds quick-stacking, restocking, and inventory sorting:

• Server plugin (OpenMod) — 20 commands covering inventory management, survival utilities, and admin tools; plus automatic features like death feed, auto-sort/stack on open, item magnet, and persistent career stats
• Client module (native Unturned module) — adds four buttons to the inventory screen so you can run the most-used commands without typing

Inspired by Terraria's quick-stack, sort, and pocket-storage features.

Features

Sort order: Guns → Melee → Throwables → Attachments & ammo → Medical → Food & water → Clothing → Tools → Buildables → Misc

Automatic features

Project structure

QuickStack/
  Plugin/                          ← OpenMod server plugin
    Commands/
      QuickStackCommand.cs         ← /quickstack (alias /qs)
      RestockCommand.cs            ← /restock (alias /rs)
      RepairCommand.cs             ← /repair [container|vehicle]
      HealCommand.cs               ← /heal
      StatsCommand.cs              ← /stats
      CompassCommand.cs            ← /compass
      MaxSkillsCommand.cs          ← /maxskills (alias /ms)
      ExperienceCommand.cs         ← /experience (alias /xp)
      ItemCommand.cs               ← /item (alias /i)
      TimeCommand.cs               ← /time
      WeatherCommand.cs            ← /weather
      ClearCommand.cs              ← /clear
      DieCommand.cs                ← /die
      GodCommand.cs                ← /god
      PingCommand.cs               ← /ping
      SortCommand.cs               ← /sort
      MagnetCommand.cs             ← /magnet
      PocketCommand.cs             ← /pocket [set|in|out]
      HomeCommand.cs               ← /home [set|clear]
      WarpCommand.cs               ← /warp <name> [set|delete|list]
    Events/
      PlayerEventListener.cs       ← death feed + kill/death stats + session tracking
      StorageOpenListener.cs       ← auto-sort/stack on container open
    Services/
      IQuickStackService.cs
      QuickStackService.cs
      IRestockService.cs
      RestockService.cs
      IRepairService.cs
      RepairService.cs
      ISortService.cs
      SortService.cs
      IGodModeService.cs
      GodModeService.cs
      IPlayerStatsService.cs
      PlayerStatsService.cs
      IItemMagnetService.cs
      ItemMagnetService.cs
      MagnetTicker.cs
      IPocketStorageService.cs
      PocketStorageService.cs
      IHomeService.cs
      HomeService.cs
      IWarpService.cs
      WarpService.cs
    EclexToolkitPlugin.cs
    openmod.yaml
    config.default.yaml
  Client/                          ← Unturned client module (optional UI)
    UI/
      InventoryButtons.cs          ← IMGUI buttons injected into inventory screen
    EclexToolkitNexus.cs           ← IModuleNexus entry point
    EclexToolkit.module            ← module manifest
    EclexToolkit.Client.csproj

Installation

Server plugin — via OpenMod (recommended)

Requirements: Unturned dedicated server (3.x) with OpenMod for Unturned installed.

Run this command in your server console or RCON:

om install EclexToolkit@1.0.1

Then fully restart the server (not just om reload — OpenMod cannot hot-swap plugin code). On next startup, OpenMod will create Servers/<name>/OpenMod/plugins/EclexToolkit/config.yaml with defaults.

Automated (building from source)

install.bat in the repo root walks you through the options interactively — just double-click it. It calls install.ps1 automatically with the right flags and keeps the window open so you can read the output.

install.bat      ← double-click this

Alternatively, run the PowerShell script directly:

.\install.ps1

What it does:

1. Downloads and installs the latest OpenMod for Unturned into your U3DS (skipped if already present)
2. Builds the plugin, packages it as a .nupkg, and registers it in OpenMod's packages.yaml
3. Auto-detects your Unturned game client and deploys the UI module to <Unturned>/Modules/EclexToolkit/

Common flags:

Note: After running install.ps1, do a full server restart. om reload does not reload plugin code.

Manual — client module (optional UI buttons)

Each player who wants the inventory buttons installs this on their own machine. Neither side requires the other to have it.

1. Build Client/EclexToolkit.Client.csproj or take EclexToolkit.Client.dll from Client/bin/Debug/net461/.

2. Create a folder inside your Unturned Modules/ directory (same folder as Unturned.exe):

   Unturned/Modules/EclexToolkit/
   

3. Copy both files into that folder:

   • EclexToolkit.Client.dll
   • Client/EclexToolkit.module

4. Launch Unturned. When you open your inventory in-game, four buttons appear in the bottom-right corner of the screen (above the hotbar):

   • Quick Stack — /quickstack — consolidate inventory into nearby containers
   • Restock — /restock — pull items from nearby containers
   • Sort Inventory — /sort — organize your backpack
   • Sort Container — /sort container — organize open container

The buttons send the corresponding chat command to the server when clicked. They only appear while the inventory screen is open. The /repair command is still available via chat (type /repair manually) but not on the UI buttons.

Configuration

After the first server start, edit Servers/<name>/OpenMod/plugins/EclexToolkit/config.yaml:

radius: 10.0

autoOnOpen:
  enabled: false
  sort: false
  quickStack: false

deathFeed:
  enabled: true
  messages:
    - "{player} failed the vibe check. Administered by: {cause}."
    # ... edit the full pool in config.yaml

magnet:
  defaultRadius: 5.0

Persistent data files (auto-created on first use):

• Servers/<name>/OpenMod/plugins/EclexToolkit/player_stats.json — career stats (kills, deaths, playtime)
• Servers/<name>/OpenMod/plugins/EclexToolkit/homes.json — player home positions
• Servers/<name>/OpenMod/plugins/EclexToolkit/warps.json — named warp points
• Servers/<name>/OpenMod/plugins/EclexToolkit/pocket_storage.json — designated pocket container positions

Reload without restarting:

/openmod reload EclexToolkit

Building from source

Requirements

• .NET SDK (supports .NET Framework 4.6.1 targets)
• Unturned dedicated server or game client installed

Getting the game DLLs

Both projects reference DLLs from the Unturned managed directory. Update the HintPath values in each .csproj to your install:

Build server plugin

dotnet build Plugin/EclexToolkit.csproj

Output: Plugin/bin/Debug/net461/EclexToolkit.dll

Build client module

dotnet build Client/EclexToolkit.Client.csproj

Output: Client/bin/Debug/net461/EclexToolkit.Client.dll

Contributing

Exploring the Unturned API

The projects compile against Assembly-CSharp.dll directly. To read or verify API signatures you need to decompile it. Do not commit decompiled output.

Step 1 — Install a decompiler

• ILSpy (cross-platform) — github.com/icsharpcode/ILSpy
• dnSpy (Windows) — github.com/dnSpy/dnSpy
• JetBrains dotPeek — jetbrains.com/decompiler

Step 2 — Open the DLL

Open Unturned_Data\Managed\Assembly-CSharp.dll. The namespaces you'll use are SDG.Unturned (inventory, barricades, UI) and UnityEngine.

Step 3 — Export for IDE browsing (optional)

In ILSpy: File → Save Code… — export to a folder outside this repo and open it as a read-only reference project.

Guidelines

• Verify SDG API calls against the decompiled source before using them — method signatures are not stable across game updates.
• Keep services stateless where possible.
• Test on a local dedicated server before committing.