Blueprint Learning
A downloadable mod
Blueprint Learning
Rethink progression on your Rust server. Workbench tech tree unlocks and scrap research are disabled — players must find blueprint items in the wild and study them to unlock crafting.
Learn Blueprints From the World
Loot containers can hold blueprint items. Find one, study it at a research table, and the item is unlocked for good — vanilla-style persistence, with exploration replacing scrap grinding.
Features
|
📜
Blueprint Item DropsLoot containers such as barrels and crates can spawn blueprint items. Every learnable blueprint is obtainable somewhere in the world. |
🚫
Vanilla Unlocks BlockedWorkbench tech tree unlocks and direct scrap research are disabled, with a clear on-screen reason and a deny sound when players attempt them. |
|
📖
Study to UnlockPlayers study a blueprint item at a research table to unlock the item permanently, just like vanilla. Crafting and repair work exactly as before. |
🎯
Tiered Drop ChanceBlueprint drop chance is tied to the item's tech tree tier. Entry-level items show up often, while high-tier blueprints stay rare and valuable. |
|
⚙️
Per-Container TuningAdjust drop chance per container type with prefab-based multipliers, exclude specific containers or blueprints, and shape progression to your server's pace. |
🗺️
Full Loot CoverageBlueprints for items missing from loot tables are automatically assigned to matching containers by category, so no learnable blueprint is unobtainable. |
How It Works
| → A loot container spawns and may include a blueprint item, rolled against the configured drop chance for that container. |
| → The player loots the blueprint item and studies it at a research table. |
| → The item is unlocked permanently — it can now be crafted and repaired as normal. |
| → Attempting a workbench tech tree unlock or direct scrap research is denied with an explanatory message and a deny sound. |
| → Unloading the plugin restores vanilla behavior entirely. |
Configuration
A configuration file is automatically generated at
oxide/config/BlueprintLearning.json
on first load.
{
"Blueprint chance settings": {
"Base chance by tech tree variant (range: 0.0 - 1.0)": {
"0": 0.25, "1": 0.23, "2": 0.2, "3": 0.18,
"4": 0.15, "5": 0.13, "6": 0.1, "7": 0.08
},
"Container prefab to base chance multiplier mapping (partial match; range: 0.0 - 10.0; default: 1.0)": {
"barrel": 0.3,
"crate_normal_2": 0.3
},
"Excluded container prefabs": [],
"Excluded blueprint target item shortnames": []
}
}
| Option | Default | Description |
|---|---|---|
Base chance by tech tree variant
|
0.25 – 0.08
|
Base blueprint drop chance per tech tree tier (0–7). Higher tiers are rarer. |
Container prefab to base chance multiplier mapping
|
barrel: 0.3
|
Per-container chance multiplier, matched by partial prefab name. Matching keys multiply together. |
Excluded container prefabs
|
[]
|
Container prefab paths that never spawn blueprint items. |
Excluded blueprint target item shortnames
|
[]
|
Item shortnames whose blueprints never spawn in containers. |
Leftover fallback mappings
|
predefined
|
Per-container category exclusions and
restricted assignments for blueprints missing from loot tables (e.g. vehicle
blueprints limited to vehicle_parts).
|
Drop Chance by Tech Tree Tier
| Tech tree tier | Base chance | Feel |
|---|---|---|
0 – 1
|
0.25 – 0.23
|
Starter items — learned early through everyday looting |
3 – 5
|
0.18 – 0.13
|
Mid-tier items — a steady but noticeable grind |
7
|
0.08
|
Endgame items — rare finds worth celebrating |
Each container rolls at most one blueprint per loot spawn. The effective per-container drop rate works out to the base chance × container multiplier, regardless of how many items the container's loot table holds.
Installation
|
1
Copy the plugin file Place BlueprintLearning.cs
into your server's oxide/plugins/
directory.
|
|
2
Start or restart your server The config file will be generated automatically at oxide/config/BlueprintLearning.json.
|
|
3
Edit the configuration Adjust drop chances, container multipliers, and exclusion lists to match your server's progression pace. |
|
4
Reload the plugin Run oxide.reload BlueprintLearning
in the server console to apply changes. Saving the config file also hot-reloads
automatically.
|
Console Commands
| Command | Description |
|---|---|
bp.help
|
Show usage help for the plugin's console commands. |
bp.chance <prefab partial>
|
Show blueprint candidates and the
effective drop chance for a container prefab (e.g. bp.chance crate_normal_2).
|
Important Notes
Workbench level requirements are unchanged. Even after learning a blueprint, players must stand near the required workbench to craft the item.
Items players have already unlocked are not reset. Installing the plugin only changes how new blueprints are learned going forward.
Blueprint items are restricted to items unlockable via the workbench tech tree — items
outside the tech tree (including DLC-required items) never drop. By default every loot
container is eligible; exclude containers such as event reward crates or high-frequency
barrels via Excluded container prefabs
to control the learning pace.
Blueprint Learning — An Oxide plugin for Rust dedicated servers.
Made by little method
Download
Click download now to get access to the following files:
Leave a comment
Log in with itch.io to leave a comment.