About OnlyPlugins
Discover, download and share Oxide plugins for the game Rust, made for the community.
Overview
OnlyPlugins is a directory where the Rust community can discover, download and share Oxide/uMod plugins for the game Rust. Anyone can browse and download plugins for free. Anyone can also become a Publisher and upload their own plugins — there's no paywall to contribute.
Every plugin here is checked against a live Oxide/Rust build using our own Compiler before it's accepted, so what you download is confirmed to actually compile against the current game version.
Accounts & roles
Browsing and downloading needs no account. Creating an account (Register) unlocks leaving ratings/reviews and subscribing to a plugin's update notifications. From there, access grows through a few levels:
| Level | Who | Unlocks |
|---|---|---|
| Member | Anyone with an account | Reviews, ratings, subscribing to plugin updates |
| Publisher | Any Member who validates via Discord | Uploading plugins, proposing edits, the Compiler |
| Trusted | Publishers granted extra trust by staff | Uploads & edits go live immediately, skipping the review queue |
| Moderator | Appointed by staff | Reviewing the upload & edit queue |
| Admin | Appointed by staff | Full site administration |
Publisher status is open to everyone — see Publisher tools below for how to unlock it. Trusted, Moderator and Admin are granted individually by the team and aren't self-service.
Browsing, downloading & reviews
- Browse — search plugins by name, filter by category, and sort by popularity, rating, or newest.
- Plugin pages — each plugin has a description, changelog with version history and diffs between versions, and a reviews tab.
- Downloads — free, no account required. Plugins with a staging build let you grab the version built for Rust's staging/beta branch as well as the main branch.
- Security scan badge — plugins are automatically scanned for suspicious code patterns (e.g. code that reaches out to the network or file system in unusual ways). A flag is a warning to look closer, not proof of anything malicious — click it to see exactly which lines matched.
- Ratings & reviews — logged-in Members can leave a star rating and written review on any plugin.
- Subscribe — logged-in Members can subscribe to a plugin to be notified about future updates.
- Authors — browse every publisher and see what they've published.
Publisher tools
Anyone can become a Publisher — it just needs a verified email and a Discord account in our server. Go to Account → Validate, link your Discord user ID, and confirm the activation code we send you there. Once linked, uploading is unlocked immediately.
As a Publisher you can:
- Upload a plugin — submit your
.csfile, an icon/banner, category, description and changelog. New Publisher uploads go into a short moderator review queue before they go live. - Propose edits — suggest a code change to any existing plugin (not just your own). A moderator reviews the diff before it's merged.
- Staging builds — publish a second build targeted at Rust's staging branch alongside your main build, with its own scheduled "after wipe" action.
- Version history — every accepted update is kept, with a line-by-line diff viewer against any previous version.
- Use the Compiler (below) to check your code compiles before you ever submit it.
The Compiler
The Compiler is one of the site's core tools: it validates your plugin's C# source against a live reference build of Oxide/Rust — the same kind of build the game server itself would use — so you find out about compile errors before you upload, not after.
Find it at Account → Compiler once you're a Publisher.
Branches
Every check runs against one of two branches, and the tool shows you the exact Oxide.Rust version and Assembly-CSharp build date each branch is currently compiled against:
- Main — matches the live, current production version of Rust.
- Staging — matches Facepunch's staging/beta branch, so you can get ahead of an upcoming update.
Single Editor mode
A full code editor in your browser (syntax highlighting, bracket matching, search) where you can paste code or load a .cs file from your computer:
- New scaffolds a fresh plugin file for you — give it a class name, an info/display name and an author, and it builds the boilerplate.
- Insert hook… is a searchable picker covering 660+ Oxide hooks (lifecycle hooks like
Init()/Unload(), chat & console commands, and boilerplate like permission registration, config classes, and data file load/save), and drops the snippet straight in at your cursor. - Validate (or Ctrl+Enter) sends your code to the chosen branch. Pass/fail shows immediately; on failure, click any error to jump straight to that line and column in the editor.
Bulk Validator mode
Pick or drag-and-drop up to 1,000 .cs files at once — useful for checking an entire plugin collection against a branch in one go. Files are sent in batches, run several at a time, and each file gets its own row showing pass/fail/error and how long it took to compile.
For scripts & AI coding agents
The Compiler also exposes a small password-protected JSON API, separate from your site login, so a script or an AI agent that's writing a plugin can validate its own code before handing it back to a person. Full request/response docs — including a ready-to-run example — are published at ?action=api_spec (no password needed just to read the docs).
Developer API
Separate from the Compiler's API above, there's also a small read-only Developer API for browsing published plugins and checking a plugin's latest version and download link — handy for bots, launchers, or in-game portals that want to check for updates automatically.