Works with
Optional integrations and compatible files.
About Scrap Worm
[ ✓ ] Works on any host. The zip includes a small installer plugin: run crashext.install once and restart. [ ✓ ]
Scrap Worm puts a giant worm made of scrap metal under your map. It hunts inside its own territories, listens for gathering, gunshots and explosions, and breaks out of the ground right under the loudest one. While it is above ground it bites, drags, whips and crushes, and that is the only time you can hurt it.
Its armor takes reduced damage and four glowing cores along its sides take a lot more. Every core you burst strips its segment's armor, which falls behind it as a trail of scrap. Kill it and it collapses into burning heli or Bradley crates and a hackable crate, the top damage dealers get paid, and its plates are left behind for harvesting.
It runs on its own: territories on the map, a hunt on a timer, a boss health bar, chat and Discord announcements. Nothing to install on the client: the worm is built from parts every Rust client already has.

| Works on Oxide and Carbon | Needs CrashExtensions (included) |
|---|---|
| Automatic event on map territories | Top damage rewards |
Jump to: Features · Screenshots · Trailer · How a hunt goes · Commands · Permissions · Works with · Install · Configuration · Test server · FAQ
Features
For players
- A real boss fight. A worm over 20 metres long breaches out of the ground in a big arc and dives back in. Every breach is different: a low skim, a normal arc or a high leap, at its own pace and heading.
- It hunts you. Gathering, gunshots and explosions in its territory are noise, and the next breach comes up under the loudest one, or a few metres beside it when it cannot come up there. Firing a rocket somewhere else can pull it where your team wants it.
- You see it coming. The ground rumbles, dust kicks up and a ring of dirt marks where it will erupt. Stand in the ring and you take the slam.
- It fights back. It bites the nearest player in reach and drags them into its mouth, whips anyone near its tail, and runs over whoever is in its way.
- Weak points. The whole body takes reduced damage. Four glowing cores take a lot more, and each one you burst knocks 10% off its health, shared between everyone who damaged that core, and strips that segment's armor plates.
- Fight it where it can reach you. Hits count only from inside its territory, and only 25% from cover where it cannot come up under you: deep water, a monument, building privilege, beside a base or inside a raid dome.
- Every weapon works. Bullets, rockets and launcher grenades hit the body, and thrown C4 and grenades stick to it and ride along until they go off.
- Boss health bar. Name, EXPOSED or BURROWING, the four cores and its health, above the hotbar for everyone near the fight.
- Track it on the map. A red circle shows where it is while it is above ground, and goes away when it dives.
- Walls matter. Its tail and body do not hit through walls, and charges stuck to it drop off at a wall or where it dives instead of going through.
- Loot worth the fight. Burning heli or Bradley crates and a hackable crate where it falls, plus scrap plates you can harvest with a pickaxe, a jackhammer or a rock (metal fragments, charcoal and high quality metal by default, anything you like in the config).
For server owners
- Set and forget. Three territories are placed on your map by itself (open, dry ground away from monuments, the same spots for the whole wipe), shown as circles on the map, and hunts start on a timer with a minimum player count.
- Your own territories. Add spots by coordinates with their own name and radius.
-
Or somewhere new every time.
RandomLocationEachEventpicks a fresh random spot for each event, away from water, slopes and monuments. - Scales with the crowd. Health and core health grow with the players around when it spawns, up to a cap you set.
-
No farming from cover. Hits from outside the territory or from a safe zone do nothing. Hits from cover count at
CoverDamageScale(25% by default): water deeper than half a metre, a monument, building privilege, withinCoverBaseRadius(10 m) of a base, or inside a RaidableBases dome. A lone sleeping bag or box is not a base. -
A fight is not cut short. A hunt that is still fighting when
LifetimeMinutesruns out stays until it calms down, at most twice as long. -
Rewards. Economics money and ServerRewards points for the top damage dealers, up to 10 places; a place pays only for a real share of the damage (
MinRewardShare, 3% by default). -
Winner commands. Run your own server commands for the top damage player (if they reached
MinRewardShare) with{steamid},{name}and{grid}: a kit, a group, a shout. A dead or offline winner gets them when they are back, even after a restart. - Debris loot you control. Pick the items, the exact amount per piece, which pieces carry them and an optional fixed amount per hit.
-
PvE friendly. An optional loot lock gives the crates to the top damage dealer's team (if they reached
MinRewardShare) for as long as you want, and it survives a reload. - Bases are safe by default. Building damage is off, and the worm then does not breach through a base or inside building privilege. Turned on, it only hits inside the territory of the running hunt and goes through normal damage, so raid protection still applies. Players who place a Tool Cupboard in a territory get a warning popup.
-
Your own roar. Put an .ogg in the data folder and set
RoarSound: players withinSoundRadiushear it from the worm's direction. It plays through CrashExtensions' private sound (CUISound), so it needs CrashExtensions 1.12.16 or newer loaded; without a clip the vanilla roar plays. - One Colossus at a time. With Scrap Leviathan or Scrap Stormray installed, a hunt waits while one of them is out and tries again 5 to 10 minutes later.
- Announcements. Chat lines for start, kill and leave, to everyone or only nearby, and an optional Discord webhook.
- NCP and Notify toasts. Show the hunt messages as NCP 2.0 or Notify toasts, with chat as the fallback. The breach line can be turned off.
- Works with your loot plugins. The crates are the native ones, so BetterLoot and AlphaLoot fill them, and you can pick an AlphaLoot profile.
- Every number in the config. Size, speed, arc, health, damage taken, every attack, crates, rewards, timers and territories, each with a safe range.
- Four languages. English, Spanish, Brazilian Portuguese and Russian built in.
For developers
-
Hooks.
OnScrapWormStart,OnScrapWormKilled, and two you can veto:OnScrapWormCrush(protect a block) andOnScrapWormRunOver(spare a player, crate fires included). See the FAQ.
Screenshots
Every screen below is Scrap Worm running in Rust.
|
|---|
| It breaches out of the ground in a long arc, with the boss bar above the hotbar |
|
|
|---|---|
| It erupts under the loudest noise | The glowing cores are its weak points |
|
|
|---|---|
| Kill it and it bursts into scrap plates | Burning crates and scrap debris where it fell |
Trailer
The Scrap Worm trailer (click to play, 44 seconds)

How a hunt goes
- It starts. A hunt picks one of the territories, everybody gets a chat line with the grid, and the circle on the map turns red.
- It listens. Gathering, gunshots and explosions inside the territory are noise. The next breach comes up under the loudest one, or 6 to 12 m beside it when it cannot come up there, after a rumble and a ring of dirt.
- It surfaces. For a few seconds it is out of the ground: it bites and drags, whips its tail and crushes what it runs into. Underground it cannot be hurt.
- You hit it. The body takes 30% of a hit by default, a core takes double. Each burst core strips its segment's armor, and a stripped segment takes much more. Hits count only from inside the territory, and 25% from cover.
- It dies. At zero health, or with all four cores burst, it collapses. Burning crates land where it fell (outside a base if it fell inside one), its plates become harvestable debris, chat names the top damage dealer and the rewards are paid.
- Or it leaves. If nobody is around for 5 minutes, or the 25 minute hunt runs out, it burrows away. A worm that is still fighting when the time runs out stays, for up to 50 minutes in all. The next hunt is scheduled by itself, 90 minutes later by default.
Commands
Chat, for server owners or a player with scrapworm.admin:
- /scrapworm start - start a hunt now in a random territory (or a random spot).
- /scrapworm spawn - put a worm underground 15 m in front of you, then breach or loop.
- /scrapworm breach - make it breach once.
- /scrapworm loop - keep it breaching. /scrapworm stop stops after the current breach.
- /scrapworm status - its health and cores.
- /scrapworm territories - list the territories.
- /scrapworm remove - remove the worm now.
Admin
From the server console, RCON or a player with scrapworm.admin:
-
scrapworm.start- start a hunt now. -
scrapworm.territories- list the territories with their position and radius.
Permissions
- scrapworm.admin - the commands above. Server owners can always use them; moderators need this permission. Players need no permission to fight the worm.
oxide.grant user YOUR_STEAM_ID scrapworm.admin
Works with
- NCP: free, optional: hunt messages as toasts instead of chat lines
- Notify: optional: hunt messages as Notify toasts
- Economics / ServerRewards: optional top damage rewards
- AlphaLoot: fill the crates from a profile you name
- BetterLoot: fills the crates by itself (they are the native heli or Bradley crates)
-
TruePVE: works as is: the worm can hurt players and, with
DestroyBuildingson, damage buildings (ForceDamageThroughTruePVE, on by default), and players can harvest its debris - RaidableBases: raid bases are left alone: no damage inside a raid dome, no breach comes up next to one, and noise inside a dome is ignored
- Scrap Leviathan / Scrap Stormray: only one of the three is out at a time
- Carbon: same code path as Oxide
- ImageLibrary: not needed
Install
-
Install the extension, once per server. Stop the server, copy
Oxide.Ext.CrashExtensions.dllintoRustDedicated_Data/Managed(Carbon:carbon/extensions) and start it again. The console printsLoaded extension CrashExtensionswith its version. An older copy of the DLL is simply overwritten: it is one shared file for all our plugins. -
Install the plugin. Copy
ScrapWorm.csintooxide/plugins(Carbon:carbon/plugins). It compiles on its own and creates its config. -
That's it. The first hunt starts 20 minutes after the server is up. To see it now, stand on open, flat ground and type
/scrapworm start.
Updating? Scrap Worm 1.3.1 needs CrashExtensions 1.12.16 or newer (included in the zip) and does not compile on an older one. Copy the DLL over the old one and restart the server first, then replace
ScrapWorm.cs.
Host does not allow DLL uploads? The zip includes
CrashExtInstaller.cs. Upload it like a plugin and runcrashext.installonce in the server console: it downloads the extension from GitHub, checks it and installs it.
Configuration
Everything lives in oxide/config/ScrapWorm.json. Every value has a safe range: a value out of range keeps the plugin unloaded, leaves your file untouched and tells you in the console what to fix. The full list with every default and range is in the Documentation tab and the README.
Config sections (click to expand)
- The worm - size, speed, breach height, arc length, dive depth, screen shake
- Health - base health, extra health per player around and its cap, damage share on the armor, core multiplier, core health
-
Which hits count - the damage share from cover (
CoverDamageScale, 0.25) and how close to a base counts as cover (CoverBaseRadius, 10 m) - Attacks - run over, the TruePVE override, hunting by noise and how long it remembers, slam radius and damage, bite range and damage, tail range and damage
- Buildings - building damage on or off and its strength, sparing RaidableBases, the territory warning popup
- Loot - crate count, heli or Bradley crates, the hackable crate, an AlphaLoot profile, the loot lock time, the debris loot (items, exact amount per piece, minimum piece size, amount per hit)
-
Rewards - Economics and ServerRewards amounts per place, the damage share a place needs (
MinRewardShare, 0.03), winner commands, the Discord webhook - Custom roar - the clip name, who hears it and where the roar peaks in the clip
- Messages - the breach line, NCP or Notify toasts and their type, chat alongside toasts
- Health bar - on or off, who sees it, its size
- Event - automatic start, first start, interval, minimum players, lifetime (held up to twice as long by a fight), idle time and radius, global or nearby announcements
- Territories - how many are placed by itself and their radius, your own list, a random spot every event, map markers, the surface marker and its size
Test server
Available on our test server. The worm wakes up 5 minutes after the server starts and then every 20 minutes while someone is online. Its two territories, H7 and J2, show on the map: go there, make noise, and it comes for you.
client.connect 91.229.114.54:28015
FAQ
Q: Do players need a client mod?
A: No. The worm is built from scrap helicopter parts every Rust client already has, so it works on any map with no downloads.
Q: Will it wreck my players' bases?
A: Only if you turn it on. Building damage is off by default. Turned on, it only hits inside the territory of the running hunt and goes through normal damage, so raid protection plugins still apply. RaidableBases bases are always spared (you can turn that off).
Q: Can it hurt players in safe zones?
A: No. Players in a safe zone, sleeping or spectating, and admins in noclip, are never targets. Hits on the worm from a safe zone do not count either.
Q: Can players kill it from somewhere it cannot reach?
A: Not for full credit. Hits count only from inside its territory, and from cover (water deeper than half a metre, a monument, building privilege, within 10 m of a base, a raid dome) they count 25%. CoverDamageScale sets that share: 1 counts them in full, 0 ignores them.
Q: Who gets the rewards?
A: The top damage dealers, place by place. A place pays only if that player dealt at least MinRewardShare of the worm's health (3% by default); places are sorted by damage, so every place after an unpaid one is unpaid too. Below it the top player is still named in the kill notice, but gets no winner commands and no crate lock.
Q: Do I need Economics or ServerRewards?
A: No. They are optional rewards. Without them the worm still drops its crates.
Q: Can I give the winner a kit or a rank?
A: Yes. Put server commands in WinnerCommands, for example inventory.giveto {steamid} scrap 500 or oxide.usergroup add {steamid} wormslayer. Use {steamid} for anything that grants something. If the winner is dead or offline, the commands wait up to 1 hour for them.
Q: Can the messages show as toasts?
A: Yes. Turn on UseNCP (NCP 2.0) or UseNotify (Notify) and pick the type. Players get the chat line whenever a toast can't be shown, and with Notify they need its notify.see permission.
Q: Is it good for PvE?
A: Yes. Turn on the loot lock and the crates belong to the top damage dealer's team for the time you set, as long as they dealt at least MinRewardShare of the worm's health. With TruePVE the worm still hurts players and players can harvest its debris.
Q: It dies too fast or too slow. What do I change?
A: WormHealth, HealthPerExtraPlayer, BodyDamage and CoreDamage. Any attack can be weakened or turned off by setting its damage to 0.
Q: Does it work on Carbon?
A: Yes. The extension goes into carbon/extensions instead of RustDedicated_Data/Managed, and the plugin into carbon/plugins.
Q: How do I translate it?
A: English, Spanish, Brazilian Portuguese and Russian are built in. Edit oxide/lang/en/ScrapWorm.json, or copy it into another language folder and translate its values: each player reads their own game language.
Q: Does it contact any outside service?
A: It downloads three small health bar pictures once from the Venux CDN, rust-cui.crashplugins.space, which your server then keeps. Nothing about your server or your players is sent. The Discord webhook is the only other request, and only if you fill it in.
Q: Can other plugins react to the worm?
A: Yes. Scrap Worm calls void OnScrapWormStart(Vector3 position, string territory) when a hunt starts and void OnScrapWormKilled(Vector3 position, ulong topDamager) when it dies. Return anything but null from object OnScrapWormCrush(DecayEntity entity) to protect a building block, or from object OnScrapWormRunOver(BasePlayer player) to spare a player from its attacks and its crate fires.
Questions, ideas or bug reports? Use the Support tab of this file or join our Discord.





