GUIDE Carbon Framework — Complete Setup & Optimization Guide

Joker™ · 2026-03-15T00:35:04+0000

Carbon Framework — Complete Setup & Optimization Guide
Beginner Friendly | Updated March 2026 | ~8 min read

Introduction

Carbon is a Rust-only modding framework built specifically for this game. Unlike Oxide/uMod which supports dozens of games, Carbon was designed from the ground up for Rust — meaning faster plugin loads, lower RAM usage, and same-day updates after Rust patches.

Carbon vs Oxide — quick comparison:

Feature	Oxide	Carbon
Rust-specific	No (multi-game)	Yes
Update speed	Slow	Same-day
Memory usage	Higher	~15% lower
Oxide plugin support	-	100% compatible
Built-in profiler	No	Yes

Every plugin written for Oxide works on Carbon without any modification.

Step 1 — Install Carbon

Remove Oxide first if you have it installed — running both causes crashes on startup.

Self-hosted (Linux):

Code:

# Download latest Carbon release
wget https://github.com/CarbonCommunity/Carbon/releases/latest/download/Carbon.Linux.Release.tar.gz

# Extract to server root
tar -xzf Carbon.Linux.Release.tar.gz

# Add to startup script
export LD_PRELOAD="./carbon/preloader/CarbonPreloader.so"

Hosting panel (Pterodactyl, TCAdmin):
Look for a "Mod Framework" or "Plugin Manager" option and select Carbon. If unavailable, use the file manager to upload and edit startup arguments manually.

Step 2 — Folder Structure

After Carbon installs and the server boots once, this structure is auto-created:

Code:

RustServer/
├── carbon/
│   ├── plugins/     ← .cs plugin files go here
│   ├── config/      ← auto-generated .json configs
│   ├── data/        ← plugin data / databases
│   ├── logs/        ← error logs per plugin
│   └── extensions/  ← .dll extension files

If you used Oxide before: same structure, just /carbon/ instead of /oxide/.

Step 3 — Install and Reload Plugins

Download the .cs file from uMod.org, Codefling, or other sources
Upload it to /carbon/plugins/ via FTP or your panel file manager
Carbon hot-loads plugins automatically — no restart needed

Manual commands (RCON / console):

Code:

c.reload PluginName     # reload one plugin
c.reload *              # reload ALL plugins
c.unload PluginName     # unload without deleting
c.plugins               # list all loaded plugins

Success output:

Code:

Loaded plugin BetterChat v3.4.2 by OxideMod (0.002s)

Common mistake: Browsers rename files to PluginName (1).cs — always rename and remove spaces/brackets before uploading.

Step 4 — Configure Plugins

When a plugin loads for the first time, Carbon auto-creates a .json config file in /carbon/config/.

Use Notepad++ or VS Code to edit — never plain Notepad (it breaks line endings on some systems).

JSON rules to remember:

Always use double quotes " for strings
No trailing comma after the last item
One formatting error = plugin will not load

Step 5 — Optimize Your Server

Add these to your server.cfg or startup command:

Code:

# Performance
fps.limit 60
gc.buffer 256
server.tickrate 30

# World
spawn.min_rate 0.5
spawn.max_rate 1.0
server.worldsize 3500

# Carbon
carbon.debug false
carbon.hotload true

Convar	Value	Effect
fps.limit	60	Saves CPU significantly
gc.buffer	256	Reduces RAM stutter
server.tickrate	30	Entity update frequency
spawn.min_rate	0.5	Reduces NPC CPU load

Step 6 — Troubleshooting

Plugin fails to load:
Check /carbon/logs/ — there is a log file per plugin with the exact error.

Code:

# Missing dependency
Error: Plugin 'RaidableBases' requires 'ZoneManager' to be loaded first.

# Bad .cs file (outdated plugin)
Error: CS0246 - The type or namespace 'BasePlayer' could not be found.

# JSON config error
Error: JsonReaderException - Unexpected character: } (line 14)

Server crashes on startup: Most likely a plugin built for an older Rust version. Always check the plugin was updated within the last 30 days.

High memory / lag:

Code:

c.memory      # memory usage per plugin
c.gc          # force garbage collection
c.perfstats   # full performance stats

Summary

Remove Oxide, install Carbon using the startup preloader
Upload .cs plugins to /carbon/plugins/
Reload with c.reload PluginName or c.reload *
Edit config files in /carbon/config/ using a proper JSON editor
Add performance convars to server.cfg
Check /carbon/logs/ when something breaks

If this guide helped you drop a like — more Rust server guides coming soon.

GUIDE Carbon Framework — Complete Setup & Optimization Guide

Joker™

Joker_Oxide