All Activity

[ ✓ ] 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 · 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. 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 off a chunk of health and strips that segment's armor plates. 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. Loot worth the fight. Burning heli or Bradley crates and a hackable crate where it falls, plus scrap plates you can harvest for metal fragments, charcoal and high quality metal. 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. Scales with the crowd. Health grows with the players around when it spawns, up to a cap you set. Rewards. Economics money and ServerRewards points for the top damage dealers, up to 10 places. PvE friendly. An optional loot lock gives the crates to the top damage dealer's team for as long as you want, and it survives a reload. Bases are safe by default. Building damage is off. 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. Announcements. Chat lines for start, kill and leave, to everyone or only nearby, and an optional Discord webhook. 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) and OnScrapWormRunOver (spare a player). 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, 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. 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. The next hunt is scheduled by itself, 90 minutes later by default. Commands Chat, for admins or a player with scrapworm.admin: /scrapworm start - start a hunt now in a random territory. /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 admins can always use them. Players need no permission to fight the worm. oxide.grant user YOUR_STEAM_ID scrapworm.admin Install Install the extension, once per server. Stop the server, copy Oxide.Ext.CrashExtensions.dll into RustDedicated_Data/Managed (Carbon: carbon/extensions) and start it again. The console prints Loaded extension CrashExtensions with 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.cs into oxide/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. Host does not allow DLL uploads? The zip includes CrashExtInstaller.cs. Upload it like a plugin and run crashext.install once 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) Test server Available on the new Meowcraft 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. Q: Can it hurt players in safe zones? A: No. Players in a safe zone, sleeping, in noclip or spectating are never targets. Q: Do I need Economics or ServerRewards? A: No. They are optional rewards. Without them the worm still drops its crates. 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. 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. Questions, ideas or bug reports? Use the Support tab of this file or join our Discord.