-
Posts
511 -
Joined
-
Last visited
-
Days Won
7
Content Type
Profiles
Warranty Claims
Downloads
Forums
Store
Services
Downloads Plus Support
DOWNLOADS EXTRA
Reels
Everything posted by crash
-
Version 1.2.0
27 downloads
[ ✓ ] Works on any host. [ ✓ ] The plugin needs the free CrashExtensions library. Can't upload DLLs on your host? No problem: the zip includes a small installer plugin. Drop it in your plugins folder, run crashext.install, restart once, and you're done. Pathways gives your players a reason to keep playing: every rock they hit, crate they open, animal they hunt, base they breach and minute they drive earns XP. Each level brings a skill point, and the points go into nine skill trees, Gathering, Survival, Combat, Vehicles, Crafting, Team, Demolition, Homestead and Explorer, where each skill makes a real difference in game, from more ore and shared team heals to faster fuses, longer breath underwater and vehicles that save fuel. Each tree has 11 skills and a capstone, 108 skills in all, each with its own icon in the style of Rust's own items. Every tree reads top-down like Rust's tech tree: the tree slot at the top, square skill slots joined by right-angle links that light up as skills are bought, the capstone at the bottom, on a canvas the player can drag. Click a skill and a vanilla-style panel shows what every rank gives and what it needs before a point is spent; click the tree slot for its progress, the XP it earns and its respec. Home shows every tree as a card with its points and progress. The max level is 200, so players pick a path: about five trees out of nine, saved as presets they can switch between. Spend every point of a tree and it can be prestiged up to rank 6, right from the tree: the tree resets, the points come back, and each prestige earns a point for that tree's six prestige skills, which sit in a prestige box under the tree, each with its own icon, and are kept for good. Each of the 54 is its own mechanic, not a flat percent: a tool saved before it breaks, a teammate who goes down instead of dying, a warning when an armed explosive lands near you. Most of them get stronger with the tree's prestige rank. One tree can be respecced on its own, a leaderboard ranks everyone by level or prestige with their Steam avatar, admins can build their own trees in game, and a map wipe reset is there if you want it, off by default, with a backup made before anything changes. New in 1.2.0: XP events (a night bonus, weekly scheduled events, an admin event from the console and a daily XP cap), Discord announcements, pick-one specialization groups, your own icons on the built-in trees, 54 redesigned prestige skills, nine new regular skills and a reworked node editor with tabs and an icon picker. The optional ones stay off until you set them up. Updating from 1.1.0? Read Install first. Works on Oxide and Carbon Needs CrashExtensions (included) 9 trees, 108 skills, 54 prestige skills Leaderboard, presets and an in-game tree editor Jump to: Features · Screenshots · How progression works · Commands · Permissions · Works with · Install · Configuration · Test server · FAQ Features For players Nine trees, one level. Gathering, Survival, Combat, Vehicles, Crafting, Team, Demolition, Homestead and Explorer share one level and one pool of skill points, so a player builds the mix that fits how they play. Trees like Rust's tech tree. Each tree reads top-down: the tree slot at the top, square skill slots joined by right-angle links that light up as skills are bought, the capstone at the bottom and a background glow in the tree's color. Drag the canvas in any direction with smooth inertia. 108 skills with their own icons. 11 skills and a capstone per tree, each icon built from Rust's own items, greyed out and locked until it is in reach. Know before you click. The vanilla-style skill panel shows the skill's rank, what it gives now, what the next rank adds, every rank's value and what it still needs. The tree panel shows your progress, the XP this tree earns you and its respec. Home at a glance. Your level, XP, skill points, points spent and prestige rank on top, and a card per tree with its points, progress and prestige status. Skills you feel. More ore, wood, food and crops, extra stacks, weak-spot hits, smelted ore, slower tool wear, faster and cheaper crafting, free upgrades and repairs, bigger magazines, crits and lifesteal, harder headshots and explosives, less damage taken, vehicles that save fuel and shrug off damage, XP and heals shared with your team, faster fuses and rockets, longer breath underwater, faster crate hacks, keycards that last, and more. Nine new skills in 1.2.0. Scrap Runner (recyclers you start get through more per cycle), Overhaul (a chance that a repair also restores the max condition it would lose), Tech Rebate (tech tree unlocks give back part of the blueprint items they cost), Flame Ward (less fire damage), Steady Line (reeling in a fish is easier), Quick Skinner (a chance that one hit skins a whole carcass, and of a bonus find), Warm Bed (extra health when you respawn), Body Search (a chance that an NPC you kill leaves an extra item on its body) and Prospector (a chance that a dig takes one hit, and of a bonus find). Nine capstones. Motherlode (bonus high quality metal ore every 10th ore node, and a felled tree brings down the ones around it), Second Wind (a killing blow leaves you at 15 health, once every 10 minutes), Warbound (less damage taken at low health), Overdrive (fuel saving and tougher vehicles), Salvage Run (barrel loot straight to your inventory, its components already recycled), Rallying Cry (going down heals and shields your team), Breach (blowing up an enemy base part toughens you up), Trophy Hunt (a boost for each animal you kill) and Master Key (a keycard opens the reader one level up). Team play. The Team tree works with Rust's own teams: share XP, heals, food and tea boosts with teammates nearby, and get bonuses while you stick together. Build presets. Save your whole build in a slot and apply it later in one click. Trees that lose ranks are respecced at the normal price, and you see the total before you pay. A timed free respec covers one of those trees. Respec one tree. Get a tree's points back without touching the others, with a two-step confirm that shows the points you get back, the cost and your balance after. Prestige from the tree. A maxed tree shows a PRESTIGE pill under its capstone and can be prestiged up to rank 6. Its skills start over, the points come back, and each prestige earns a point for that tree's six prestige skills, each with its own icon in the prestige box under the tree, kept through later prestiges. 54 prestige skills, each its own mechanic. No flat percents and nothing a regular skill already gives: cooldown abilities, chains, saves and alerts. Gold Rush follows a streak of finished nodes with a rush of jackpot rolls, Guardian Angel turns a nearby teammate's death into a knockdown, Blast Mining lets your explosion finish the ore nodes next to it, Ghost Walk makes scientists miss you while you crouch at a distance. Most get stronger with the tree's prestige rank, and the skill panel shows the numbers at your rank. The full list is under How progression works. Leaderboard. The top 100 by level or by prestige, each row with the player's Steam avatar, and your own rank pinned at the bottom. Always at hand. An XP row in the vanilla vitals and a small skill point button next to them that shows your unspent points and opens the window. While an XP event runs, the XP row shows its multiplier. Smooth from open to close. The window fades in, a tree unfolds from its tree slot, an upgrade flashes and counts up, a maxed skill bursts in gold, and a prestige gets its own full moment. For server owners XP from real play. Gather hits, finished nodes and trees, skinning, pickups, player, NPC and animal kills, Bradley and the patrol heli, barrels, crates, hackable crates, supply drops, missions, raids, keycard swipes, sunken crates, crafting, building, fishing and minutes spent driving. Every amount is in the config, crates and animals can pay by size, and 0 turns a source off. XP events. Off until you set them up: a night bonus, weekly scheduled events with a day, a start time (UTC) and a length, an admin event started right now with pathways.xpevent (it survives a reload and a restart) and a daily XP cap. Only the strongest event counts at a time and the night bonus multiplies on top. Players get a toast, or a chat line, when an event starts and when it ends. Kill XP that can't be farmed. No XP for killing a teammate, a sleeper, a player who respawned less than 60 seconds ago, or the same player twice inside 10 minutes. Raid XP never pays on your own or your team's base. NCP toasts. With the free NCP plugin loaded, level ups, max level, prestige, tree resets, XP lost, rested XP, XP events, the daily XP cap and capstone abilities pop up as NCP toasts, each with its own type and icon in the config. Without NCP they go to chat. Discord announcements. Off until you add a webhook: a post when a player reaches the max level, prestiges a tree, has maxed every tree or reaches a level milestone you picked. Each one is posted once per player, players with pathways.board.hide are never announced, player names can't ping anyone, and Pathways never prints the webhook URL in the console or the log. Raiding stays fair. The three raid skills and the vehicle speed skill ship switched off. Turned on, the raid skills only work inside RaidableBases raids unless you say otherwise. Your pace. The XP curve, max level (200 by default), points per level, prestige ranks, the levels needed between prestiges and the highest any reduction can reach are all yours to set. Pick-one specialization groups. Make players choose between two styles inside a tree: a group is 2 to 4 skills of one tree of which a player can hold only one, and a respec or a prestige of that tree frees the choice. None ship by default, and they are set in the config. Optional systems. BetterChat level titles, an XP loss on death and rested XP for time offline, all off by default. Open Pathways from your own NPCs (vanilla or HumanNPC). Make it yours in game. The editor builds your own trees (up to 12, with up to 40 skills each, any effect type the built-in skills use, any icon, level or permission gates, even a permission granted at max rank) and changes the numbers and icons of the built-in ones. Each skill opens on three tabs, Basics, Effect and Unlock, with a preview of the description the way players read it. It saves with backups and applies live, no reload. Your own icons. Every built-in skill, capstone and prestige skill can show an icon of yours: the editor's icon picker offers items by category, game icons, tree art or an https image URL. A tree's own icon is set in the config. Rewards. Run console commands once when a player reaches a level or a prestige rank. VIP XP. XP multipliers by permission (pathways.vip gives 1.5x out of the box), plus a global XP multiplier. Every number in the config. The value of every skill per rank, the nine capstones, the numbers of the prestige skills (in their own block, each one can be switched off), the respec cost and currency, the free respec timer, the loot tables, each tree on or off. Opt-in wipe reset. Off by default. Turned on, a map wipe resets levels, XP and skills (prestige kept if you want), copies the players folder aside first, and finishes safely even after a crash or a missed wipe. Admin commands. Give XP, set a level, give or take skill points, reset a player or a single tree and start or stop an XP event, from the server console, RCON or in game. Light on the server. The gameplay hooks are subscribed only while someone online owns a skill that needs them, effects read a per-player cache rebuilt only when skills change, the leaderboard ranks in memory, and profiles load over several frames on a reload. Safe with your files. A config with a typo is never overwritten: it is copied aside and the plugin waits for a fix. A profile that can't be read is never saved over. For developers API. GetLevel, GetXp, GetNodeRank, IsNodeActive, GetTreePrestige, GetPlayerPrestige, GetLeaderboardRank and AddXp, plus timed effects (PathwaysAddTempEffect, PathwaysRemoveTempEffect, PathwaysClearTempEffects) and pauses (PathwaysSuspend, PathwaysResume, PathwaysIsSuspended) for events and arenas. Hooks. CanPathwaysGainXp, CanPathwaysLoseXp, CanPathwaysAreaFell, CanPathwaysBlastMine, OnPathwaysLevelUp, OnPathwaysPrestige, OnPathwaysNodeUpgraded and OnPathwaysPresetApplied. See API / Hooks. Screenshots Every screen below is Pathways running in Rust. Home: your level, XP, skill points, prestige and a card for each of the nine trees The Gathering tree: square skill slots, right-angle links, the capstone at the bottom The skill panel: its value now and at the next rank, every rank and what it needs A locked skill names the skill it needs first Motherlode, the Gathering capstone, and its requirements The tree panel: progress, the XP this tree earns and its respec Combat mastered at 40 of 40, the PRESTIGE pill under its capstone Prestige: the rank the tree reaches and what it gives Home with a rank III prestige emblem Respec one tree: points back, the cost and the next free respec A respec asks for a second click The leaderboard by level, with Steam avatars and your row pinned Build presets: save a build and apply it in one click The Explorer tree and its Master Key capstone How progression works Earn XP. Everything in the XP sources list pays into one pool. Level L+1 costs 120 x (L+1)^1.34 XP by default, so the first levels come fast and the late ones take real playtime. Spend points. Each level gives one skill point, 200 by the max level. The skills in a tree's first row, right under the tree slot, can be bought right away; the others need the skill above them at rank 1 first. Skills have 3 to 5 ranks. Pick your path. The skills that are on by default add up to 347 points, so a maxed player fills about five of the nine trees. Presets make switching easy. Max a tree. Most trees take 40 points (Vehicles 37 and Demolition 30 while their off-by-default skills stay off). The capstone needs both of its branches at max rank and costs 3 points. Respec. Gives one tree's points back to the pool. It costs 250 scrap by default and is free once every 2 days; players with pathways.freerespec never pay. On a preset apply the timed free respec covers one tree and the others pay the respec price. Prestige. With every point of a tree spent, a PRESTIGE pill appears under the tree's capstone. The tree resets, its points come back, the tree's prestige rank goes up (max 6) and you get a prestige point. Players need to gain 5 levels between prestiges of any tree (at max level their XP still counts), so one set of points can't prestige every tree in an afternoon. Prestige skills. Each tree has six prestige skills in the prestige box under it, each with its own icon, that open once the tree has been prestiged. They cost one prestige point each and are kept forever. 9 trees x 6 ranks = 54 prestige points for 54 prestige skills. Each one is its own mechanic (a cooldown ability, a chain, a save, an alert), none repeats what a regular skill gives, and most get stronger with the tree's prestige rank. Specialization groups. If the server set them up, a player with a rank in one skill of a group can't buy the others: they show LOCKED and the skill panel names the choice. A respec or a prestige of that tree frees it, and the tree can still be filled and prestiged. The 54 prestige skills (click to expand) Commands /pathways - open Pathways. You can add more names for it in the config. /pathways top - the leaderboard (/pathways top prestige for the prestige tab). /pathways presets - your build presets. /pathways hud - turn your XP row on or off. pathways.open and pathways.close - the same from the F1 console, or for a bind. pathways.board <level|prestige> - the leaderboard (as text from the server console). pathways.preset <save|apply|delete> <slot> [name] - presets from the F1 console. Admin From the server console, RCON or a player with pathways.admin. <player> is a Steam ID (online or offline) or a name: pathways.givexp <player> <amount> - give XP (it levels the player up as usual). pathways.setlevel <player> <level> - set the level, XP back to the start of it. pathways.givepoints <player> <points> - give bonus skill points, or take them with a negative number. pathways.reset <player> [tree] - reset everything of a player, or only one tree's skills for free. pathways.xpevent <multiplier> <minutes> [name] - start an XP event for everyone: multiplier 1 to 10, 1 to 10080 minutes (7 days), and a name if you want one. pathways.xpevent stop - end the admin XP event. Permissions pathways.use - open Pathways and earn XP. pathways.admin - the admin console commands and the pathway editor in game. pathways.admin.grants - together with pathways.admin, lets the editor save a node that grants a permission no node grants yet. Nobody has it by default. pathways.admin.urls - together with pathways.admin, lets the editor take a new https image URL as an icon (your server downloads it). URLs already in the config keep working. Nobody has it by default. pathways.freerespec - respec any tree for free, any time (presets too). pathways.nopenalty - never lose XP on death (when the death penalty is on). pathways.board.hide - stay off the leaderboard. A permission you add to the XP multipliers (for example pathways.vip) - more XP. A permission that starts with pathways. is registered for you. A typical setup: oxide.grant group default pathways.use oxide.grant group vip pathways.vip oxide.grant user YOUR_STEAM_ID pathways.admin Works with NCP: free, optional: level ups, max level, prestige, tree resets, XP lost, rested XP and capstone abilities show as NCP toasts instead of chat lines Economics / ServerRewards: optional respec and preset currency, scrap by default Raidable Bases: the raid skills (off by default) only work inside its raids BetterChat: optional level titles in chat, off by default Discord: optional announcements through a webhook, off by default HumanNPC: open Pathways by talking to one of your NPCs, off by default Carbon: same code path as Oxide ImageLibrary: not needed, images run on our own CrashExtensions library 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. The zip ships CrashExtensions 1.12.17, and Pathways needs 1.12.15 or newer. Install the plugin. Copy Pathways.cs into oxide/plugins (Carbon: carbon/plugins). It compiles on its own and creates its config. Grant pathways.use to your players (the setup above) and type /pathways in game. Plugin does not compile? The extension is missing or too old: check the folder and restart again. On a hosting panel, upload the DLL with the file manager or SFTP, and keep a copy in case the panel resets that folder on an update. Host doesn't allow DLL uploads? Put CrashExtInstaller.cs from the zip in your plugins folder and run crashext.install once in the server console: it downloads the extension from GitHub, checks it and puts it in place. On Oxide it loads right away and Pathways starts; on Carbon it asks for one restart. Optional plugins (none is needed): Economics or ServerRewards for the respec cost, RaidableBases for the raid skills, BetterChat for chat titles, HumanNPC to open Pathways from an NPC. Updating from 1.1.0? Back up oxide/data/Pathways and oxide/config/Pathways.json first, then replace Pathways.cs (and the extension if yours is older than 1.12.15). Your config loads as it is and nothing new is switched on. Once per profile, the first time it loads on 1.2.0, every prestige skill a player owned is cleared and its prestige points come back to spend again, and ranks in the nine replaced skills come back as skill points. Prestige ranks, levels, XP and every other skill are not touched, and each player is told once. There is no way back to 1.1.0 on the same data, so keep the backup. The README in the zip has the details. Configuration Everything lives in oxide/config/Pathways.json. Player profiles are stored in oxide/data/Pathways/players. Config sections (click to expand) Test server Available on our test server. Try Pathways before you buy: join and type /pathways in chat. client.connect 91.229.114.54:28015 FAQ Q: Is XP per tree or shared? A: Shared. One level and one pool of skill points for all nine trees, so players choose where the points go. Q: Can a player max every tree? A: Not with the defaults, on purpose: 200 points against 347 in skills, so a maxed player fills about five trees. Presets let them switch builds. Raise "Max level" or "Skill points per level" if you want more. Q: Can I turn a tree off? A: Yes. Set it to false under "Trees enabled". Its tree slot shows TURNED OFF and its skills stop working; points already spent there stay spent until an admin resets that tree. Q: Will the raid skills wreck my server's raiding? A: They ship switched off. Turned on, they only work inside RaidableBases raids while "Raid effects only inside RaidableBases raids" is on (the default), never on player bases. Q: Does progress reset on a wipe? A: Only if you turn it on. With "Reset level, XP and skills on a map wipe" on, the plugin copies oxide/data/Pathways/players aside before it changes anything, then resets every profile. Prestige ranks and prestige skills are kept unless you say otherwise. Q: Do I need Economics, ServerRewards, RaidableBases, BetterChat or HumanNPC? A: No. Respecs cost scrap by default, and every one of those plugins only adds an optional feature when it is installed. Q: Can players farm kills for XP? A: Not cheaply. Teammates, sleepers, a player killed within 60 seconds of respawning and the same pair of players inside 10 minutes all give no kill XP. Q: Can I make my own trees? A: Yes, in game. Admins get NEW PATHWAY on the Home screen and EDIT PATHWAY on every tree, or DUPLICATE to start from a built-in one. Up to 12 custom trees with up to 40 skills each. Q: How do I run a double XP weekend? A: Run pathways.xpevent 2 2880 Double XP in the server console: no reload, and it survives a restart until its time is up. For a boost every weekend, add a scheduled event to the "XP events" block. Permission multipliers stack on top. Q: I'm updating from 1.1.0. What happens to my players? A: Levels, XP, prestige ranks and every skill that still exists stay. Once per profile, the prestige skills a player owned are cleared and their prestige points refunded (all 54 were redesigned), and ranks in the nine replaced skills are refunded as skill points. Back up oxide/data/Pathways first: there is no way back to 1.1.0 on the same data. Q: Can I change the icons of the built-in skills? A: Yes. EDIT PATHWAY on the tree, click the skill, BASICS tab, CHANGE: pick an item, a game icon, tree art or an https image URL, then SAVE. A new image URL needs pathways.admin.urls. A tree's own icon is set in the config. 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 is built in. Edit oxide/lang/en/Pathways.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 its art (the skill icons, frames and backgrounds) once from the Venux CDN, rust-cui.crashplugins.space, which your server then keeps. For the leaderboard avatars it reads the public Steam profile of the players on screen from steamcommunity.com. An https image you set as an icon is downloaded by your server. Discord announcements, off until you add a webhook, post the player's name, their Steam avatar when the leaderboard has it, what they reached and your server's name to your own Discord channel. Nothing else about your server or your players is sent anywhere. You do not need ImageLibrary. API / Hooks Read progress or pay XP from your own plugin: [PluginReference] private Plugin Pathways; int level = Pathways?.Call<int>("GetLevel", (ulong)player.userID) ?? 0; Pathways?.Call("AddXp", (ulong)player.userID, 250d, "MyEvent"); int GetLevel(ulong playerId), double GetXp(ulong playerId) (XP into the current level) int GetNodeRank(ulong playerId, string nodeId) (a custom node is x.<tree id>.<node id>), bool IsNodeActive(ulong playerId, string nodeId) (owned and giving its effect or permission now; an offline id reads the profile from disk, so not for every tick), int GetTreePrestige(ulong playerId, string treeId), int GetPlayerPrestige(ulong playerId) (the highest tree prestige, 0 to 6), int GetLeaderboardRank(ulong playerId, string board) (level or prestige, 0 = not on the board) void AddXp(ulong playerId, double amount, string source) - pathways.use, the global, permission and skill multipliers and CanPathwaysGainXp apply. Since 1.2.0 this XP is not shared with teammates (Shared Lessons), and XP events and the daily cap don't touch it. bool PathwaysAddTempEffect(ulong playerId, string source, string effect, string filter, float percent, float seconds), bool PathwaysRemoveTempEffect(ulong playerId, string source, string effect = null), int PathwaysClearTempEffects(string source) - timed effects by name (GatherYield, Ore...); the same source, effect and filter refresh the entry. void PathwaysSuspend(ulong playerId, string source, bool effects, bool xp), void PathwaysResume(ulong playerId, string source), bool PathwaysIsSuspended(ulong playerId) - pause a player's skills and / or XP during your event. Pauses never save: they end on disconnect and on a Pathways reload. Hooks Pathways calls: object CanPathwaysGainXp(BasePlayer player, float amount, string source) - return false to block the gain, or a number to replace the amount. object CanPathwaysLoseXp(BasePlayer player, double amount) - the death penalty: false skips it, a number replaces it. object CanPathwaysAreaFell(BasePlayer player, int count) - Motherlode's area felling: anything non-null cancels it. object CanPathwaysBlastMine(BasePlayer player, int count) - Blast Mining (prestige skill), before it finishes the nodes: anything non-null cancels it. void OnPathwaysLevelUp(BasePlayer player, int level) - once per level gained; player can be null for an offline grant. void OnPathwaysPrestige(BasePlayer player, string treeId, int rank) - after a tree is prestiged. void OnPathwaysNodeUpgraded(BasePlayer player, string nodeId, string treeId, int rank) - after each buy. A notice only: a respec does not undo what you did with it, so anything that must be taken back belongs on a permission node. void OnPathwaysPresetApplied(BasePlayer player, int slot) - after a preset is applied. Masonry Chain's free upgrade asks Oxide's own OnStructureUpgrade first (a non-null answer cancels it) and calls OnStructureUpgraded after, so building plugins see it like any other upgrade. Questions, ideas or bug reports? Use the Support tab of this file or join our Discord.$45.00 -
Changed Status from Pending to Can't Reproduce
-
Hey! I can’t reproduce this on the current build. BattlePass 4.2.0 is updating the leaderboard fine here. Also, the leaderboard refreshes when you open the tab, not while it’s sitting open. Does closing and reopening it show the new values, or does it stay stuck until o.reload?
-
Changed Status from Work in Progress to Feature Request Changed Fixed In from Not set to 1.1.0
-
Changed Status from Pending to Work in Progress
-
Hi, the Leviathan only hunts real online players, so the Boat Drivers crews and the Tugboat pirates get ignored. Boat Drivers also blocks any non-player damage to its boats and crew by default, so nothing the Leviathan does lands on them. Their NPCs shooting at it don’t count either, because only real players can damage it.
- 10 comments
-
- #scrapleviathan
- #leviathan
- (and 18 more)
-
Version 1.2.2
24 downloads
[ ✓ ] Works on any host. [ ✓ ] The plugin needs the free CrashExtensions library. Can't upload DLLs on your host? No problem: the zip includes a small installer plugin. Drop it in your plugins folder, run crashext.install, restart once, and you're done. Scrap Leviathan puts a giant sea serpent made of scrap metal in your ocean. It roams the whole sea and hunts whatever it finds: boats first, then swimmers, then players standing on the shore. Gunshots and explosions draw it in. When it attacks, the water foams, the neck rises head first out of the sea and towers over its prey, the neck follows its target and the tail swings free. It bites with a lunge and flips small open boats, breathes a jet of fire like a military flamethrower with arcing fireballs on top, and circles round to strike from another side between attacks. Its armor takes reduced damage; its two eyes and three glowing cores take a lot more, and every core you burst strips the armor around it. Kill it and the carcass floats with locked crates on its back. They open 20 seconds after the kill, and when the carcass sinks, whatever was not looted slides to the seabed with a lamp on each crate and a cyan circle on the map. The top damage dealers get paid. It all runs on its own on a schedule, and nothing goes on the client: the leviathan is built from parts every Rust client already has. Works on Oxide and Carbon Needs CrashExtensions (included) Automatic event at sea 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 sea monster boss fight. A scrap serpent roams the whole ocean, one body swinging from side to side with its humps breaking the surface, then rises head first out of the water and towers over you. The reared neck follows its target and the tail swings free. It hunts you. Boats first, then swimmers, then players on the shore. Gunshots and explosions within 300 m count as noise and pull it in. You see it coming. The water foams for a moment before the neck comes up. It fights back. Lunging bites that flip small open boats (35% of bites by default) and tip the crew into the water, a military flamethrower breath with arcing fireballs on top, and a dive between attacks to strike again from another side. Weak points. The armor takes reduced damage. Its two eyes and three glowing cores take a lot more, and each core you burst strips the armor around it. Every weapon works. Bullets, rockets, torpedoes, cannonballs and explosions all hit it. Fight it where it can reach you. Hits count only from within 300 m of it, and only 25% from where neither its bite nor its fire can reach you. Shared boss bar. Name, SURFACED or SUBMERGED, its three cores and its health, above the hotbar for everyone near the fight. Loot worth the fight. A floating carcass with locked crates on its back. They open 20 seconds after the kill, and whatever is not looted when the carcass sinks slides to the seabed, each crate with a lamp on it and a cyan circle on the map for divers. A crate nobody loots is removed 30 minutes after that circle ends. For server owners Set and forget. Three deep-water territories are found on your map by itself (the same spots for the whole wipe), and hunts start on a timer with a minimum player count. A red circle on the map follows the leviathan wherever it swims. Your own territories. Add spots by coordinates with their own name and radius, or keep it inside its territory instead of roaming the whole ocean. 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; a place pays only for a real share of the damage (MinRewardShare, 3% by default). No farming from a cliff. Hits from further than 300 m (the larger of DetectionRadius and NoiseRadius) or from a safe zone do nothing. Hits from where it cannot reach the player count at CoverDamageScale (25% by default): too high above the sea, with no deep water close enough for its bite or its fire, on the Cargo Ship, in a submarine deep under it, or after it gave up on that player. A fight is not cut short. A hunt that is still fighting when LifetimeMinutes runs out stays until it calms down, at most twice as long. Your own roar. Put an .ogg in the data folder and set RoarSound: it plays when the head breaks the surface, from the head's direction. It plays through CrashExtensions' private sound (CUISound), so it needs CrashExtensions 1.12.16 or newer loaded. The custom roar plays only near the seabed, for players on the shore and in the shallows; over deep water (boat crews, swimmers, divers) the vanilla roar plays. One Colossus at a time. With Scrap Worm or Scrap Stormray installed, a hunt waits while one of them is out and tries again 5 to 10 minutes later. Stays where it belongs. It keeps away from safe zones, oil rigs and the Cargo Ship and never leaves the water. Big boats (tugboats and player-built boats) are never flipped or damaged unless you turn that on, and its fire is aimed at players and doesn't damage bases. NCP toasts. With the free NCP plugin loaded, event messages show as toasts and the crate cooldown as a progress bar. Without NCP they go to chat. Announcements. Start, low health, kill and leave in chat, to everyone or only nearby, and an optional Discord webhook. Works with your loot plugins. The crates are the native heli or Bradley crates, so BetterLoot fills them, and you can pick an AlphaLoot profile. Every number in the config. Health, damage taken, every attack, speeds, crates, rewards, timers and territories, each with a safe range. Four languages. English, Spanish, Brazilian Portuguese and Russian built in. For developers Hooks. OnScrapLeviathanStart, OnScrapLeviathanKilled, and OnScrapLeviathanBite, which you can veto to spare a player. Since 1.2.1 OnScrapLeviathanBite is asked about once a second for every player near it. See the FAQ. Screenshots Every screen below is Scrap Leviathan running in Rust. Reared over the sea, with the shared boss bar above the hotbar Its head and spiked neck tower over a rowboat A flamethrower jet at a player with a rocket launcher Rockets hit the reared neck while the boss bar drops Killed: the carcass floats on the surface Locked crates ride the carcass until they unlock Unlooted crates sink to the seabed, each with a lamp A cyan circle on the map marks the crates on the seabed Trailer The Scrap Leviathan trailer (click to play, 50 seconds) How a hunt goes It starts. A hunt picks one of the sea territories, everybody gets a message with the grid, and a red circle on the map follows the leviathan wherever it swims. It hunts. It roams the whole ocean and goes for the closest prey: boats first, then swimmers, then players near the shore. Gunshots and explosions within 300 m pull it in too. It rises. The water foams, then the neck rises head first out of the sea. While it is up it bites, flips small open boats and breathes fire. Between attacks it dives and circles round to strike from another side. You hit it. The armor takes 30% of a hit by default, an eye or a core takes double. Each burst core strips the armor around it, and that stretch of body takes much more after that. Hits count only from within 300 m of it, and 25% from where it cannot reach you. It dies. The carcass floats with 4 locked crates on its back, which open 20 seconds after the kill. After 3 minutes the carcass sinks and whatever was not looted slides to the seabed, with a lamp on each crate and a cyan circle on the map. The top damage dealers get paid. Or it leaves. If nobody is near it for 8 minutes, or the 30 minute hunt runs out, it dives into the deep. A leviathan that is still fighting when the time runs out stays, for up to 60 minutes in all. The next hunt is scheduled by itself, 2 hours later by default. Commands Chat, for owners or a player with scrapleviathan.admin: /leviathan start - start a hunt now in a random territory. /leviathan spawn - spawn one in the deep sea near you (no time limit). /leviathan kill - kill it now (no damage rewards are paid). /leviathan despawn - remove it right away. /leviathan status - its health, cores alive, where it is and its territory. /leviathan territories - list the territories with their grid and radius. Admin From the server console, RCON or a player with scrapleviathan.admin: leviathan.start - start a hunt now. leviathan.spawn <player> - spawn one in the deep sea near that player. leviathan.kill - kill it now. leviathan.despawn - remove it. leviathan.status - its health, where it is, when it leaves, and how many hits counted at a reduced share or not at all. leviathan.territories - list the territories. Permissions scrapleviathan.admin - the commands above. Owners can always use them. Players need no permission to fight it. oxide.grant user YOUR_STEAM_ID scrapleviathan.admin Works with NCP: free, optional: event messages as toasts and the crate cooldown as a progress bar instead of chat lines 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 leviathan can hurt players and small boats, and players can hurt it Scrap Worm / Scrap Stormray: only one of the three is out at a time Carbon: same code path as Oxide 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 ScrapLeviathan.cs into oxide/plugins (Carbon: carbon/plugins). It compiles on its own and creates its config. That's it. The first hunt starts 30 minutes after the server is up, then every 2 hours. To see it now, stand near deep water and type /leviathan start. Updating from 1.0.0? Scrap Leviathan 1.2.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 ScrapLeviathan.cs. Plugin does not compile? The extension is missing or too old: check the folder and restart again. On a hosting panel, upload the DLL with the file manager or SFTP, and keep a copy in case the panel resets that folder on an update. Host doesn't allow DLL uploads? Put CrashExtInstaller.cs from the zip in your plugins folder and run crashext.install once in the server console: it downloads the extension from GitHub, checks it and puts it in place. Restart once and Scrap Leviathan loads. Configuration Everything lives in oxide/config/ScrapLeviathan.json (Carbon: carbon/configs/ScrapLeviathan.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 keys you will most likely touch are explained in the README. Config sections (click to expand) Test server Available on our test server. A hunt starts 30 minutes after the server starts and then every 2 hours while someone is online: watch chat for the grid, take a boat out to sea and make some noise. client.connect 91.229.114.54:28015 FAQ Q: Do players need a client mod? A: No. The leviathan is built from parts every Rust client already has, so it works on any map with no downloads. Q: Will it wreck my players' bases? A: Its fire is aimed at players and doesn't damage bases. Its bites hurt players and small boats; big boats (tugboats and player-built boats) are never flipped or damaged unless you turn on DamagePlayerBoats. Q: Can it hurt players in safe zones? A: No. It stays away from safe zones, oil rigs and the Cargo Ship, and players in a safe zone or on the Cargo Ship, sleeping or spectating, and admins in noclip or vanished, are never targets. Hits on it 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 within 300 m of it (the larger of DetectionRadius and NoiseRadius). From where neither its bite nor its fire can reach the player (a cliff, a beach far from deep water, the Cargo Ship, a deep submarine) they count 25%, and so do the hits of a player it gave up chasing, for the next 60 seconds. 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 its 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 message. Q: Can I give it my own roar? A: Yes. Put an .ogg (under 5 MB and 30 seconds) in oxide/data/ScrapLeviathan/sounds/ and set RoarSound to its name. It needs CrashExtensions 1.12.16 or newer loaded. The custom roar plays only near the seabed: players on the shore and in the shallows hear it, and over deep water (boat crews, swimmers, divers) the vanilla roar plays. Q: Do I need Economics or ServerRewards? A: No. They are optional rewards. Without them the leviathan still leaves its crates. Q: My map has little deep water. Will it work? A: It looks for open, deep water away from monuments, safe zones and oil rigs. A small map may get fewer than 3 territories: run /leviathan territories to check, and add your own spots under Territories if you need them. Q: It dies too fast or too slow. What do I change? A: Health, HealthPerExtraPlayer, MaxHealthMultiplier, 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/ScrapLeviathan.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 its few 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 leviathan? A: Yes. Scrap Leviathan calls void OnScrapLeviathanStart(Vector3 position, string territory) when a hunt starts and void OnScrapLeviathanKilled(Vector3 position, ulong topDamager) when it dies (topDamager is 0 when an admin killed it). Return anything but null from object OnScrapLeviathanBite(BasePlayer player) to spare a player from all of it: the bite, the fire jet, the fireballs, the fire left on the ground and the bite on their boat. A spared player is not hunted, and their hits count at CoverDamageScale. This hook changed in 1.2.1: in 1.0.0 it was called only for a player a bite or a flame pulse was about to hurt; now it is also asked about every player inside DetectionRadius and every player whose hit lands on it, about once a second each, with the answer kept for 1 second. Answer without side effects (no chat line, no counter). Questions, ideas or bug reports? Use the Support tab of this file or join our Discord.$29.99- 10 comments
-
- #scrapleviathan
- #leviathan
- (and 18 more)
-
- 7 comments
-
Yes, anyone. Its per player. So your placement wont match to player B if thats your question (if you move it)
-
Nothing to enable or command wise, just click and drag it
-
You can move it, its draggable
-
Changed Status from Pending to Feature Request Changed Fixed In from Not set to Next Version
-
Hey, thanks a lot for the kind words, really glad you’re enjoying Relics! Great idea. I just released Relics 1.1.3, which adds a RELICS button to the inventory screen, right next to the vanilla buttons and the Battle Pass one. Clicking it opens your relic bag. A couple of extras: Each player can drag the button anywhere on the screen, and it remembers that spot. /relics button reset puts it back in its default place. As the server owner, you can turn it off or change its default spot in the config, under “Inventory button”. If you have any other ideas or run into anything, let me know!
-
Hello sir, i think theres a guaranty codefling offers, you might wanna check that out
-
Your host blocks plugins from downloading files, so the installer can’t fetch the extension. Open the Scrap Worm zip, copy Oxide.Ext.CrashExtensions.dll into RustDedicated_Data/Managed (on Carbon: carbon/extensions) with your host’s file manager, then restart the server. If the host doesn’t let you upload DLLs at all, ask their support to put that file there for you
-
Not with forge.giveitem itself yet: it sets track levels only, no gems. there are two ways to do it today: Give the item, then the gems. Levels from forge.giveitem open sockets like forged ones do (at total +3, +6 and +9, and the prismatic socket at +15), so a +25 item comes with its sockets open. Give the Radiant gems with forge.give <player> gem.<kind>.3, for example gem.vampire.3, and the player puts them in from the SOCKETS tab. Make it a legendary, if you want the item to arrive with its gems already in. In the config under “Legendaries”, define an item with: its base shortname and skin; its track levels (up to 50, above your caps too); its gems, each with its grade (3 = Radiant). Then forge.give <player> legendary <id> hands it out ready-made, with no chat announcement. by default a legendary can’t be forged further and its gems can’t be removed. “Can be forged further” and “Gems can be removed” turn that off. set its drop chances to 0 if you only want to give it by command
-
- 6 comments
-
- #scrapworm
- #worm
- (and 18 more)
-
- 6 comments
-
- #scrapworm
- #worm
- (and 18 more)
-
Hey! Forge 1.2.0 is out with all three: Levels above the max: forge.giveitem <player> rifle.lr300 damage=25 gives an item already forged, above your config caps, with stats scaling the same way. forge.setlevel goes up to 50 too. Rocket launcher magazine: take rocket.launcher off the blacklist and it can forge MAGAZINE (whole rockets per level, set in the config) and DURABILITY. The MGL works too. Drops: BetterNpc, NpcSpawn and KpucTaJl’s event NPCs were wiping Forge’s drops when they refilled loot. That’s fixed. Give each NPC its own drop chances under “NPCs by prefab or display name”, using its preset name. Thanks again for the ideas!
-
Version 1.0.0
9 downloads
[ ✓ ] Works on any host. The zip includes a small installer plugin: run crashext.install once and restart. [ ✓ ] Plant Spawn Controller lets you decide how much grows on your map. Hemp, corn, pumpkins, potatoes, wheat, every berry colour, mushrooms, flowers, the stone, metal, sulfur, wood and HQM pickups, and the wood piles, dead logs and driftwood: each group gets its own density and its own respawn speed, so you can have twice the berries and half the logs with two drags. It doesn't replace Rust's spawning. It tunes the vanilla populations and lets vanilla do the spawning, so plants keep appearing where they always do, and unloading the plugin puts every vanilla value back. Nothing is written to your server.cfg. Everything happens in one admin window: pick a preset, drag a slider, weight hemp against corn, scale it all with your player count, give wipe day a boost, refill a group right now or trim the extras, and ping the nearest plants on your map. Works on Oxide and Carbon Needs CrashExtensions (included) 6 groups, 28 vanilla populations Presets, player curve, wipe boost Jump to: Features · Screenshots · Trailer · Commands · Permissions · Install · Configuration · Test server · FAQ Features Six groups. Crops (hemp, corn, pumpkin, potato, wheat), Berries (five colours, normal and jungle), Mushrooms, Flowers (sunflower, rose, orchid), Pickups (stone, metal, sulfur, wood, HQM) and Stumps & logs (wood piles, dead logs, driftwood). Density per group. From 0x to 5x of vanilla. 0 empties a group, 3x triples it. Respawn speed per group. From 0.25x to 10x, so picked plants come back slower or faster. Weights inside a group. Give hemp more of the Crops share, or make yellow berries rare. The group total stays where the density puts it. Hard cap. A max alive per group, so a high density never runs away on a big map. Player curve. 2 to 5 points on players online: more plants when the server is empty, fewer when it's full, or the other way round. Each group opts in. Wipe boost. An extra multiplier for the first hours after a wipe, on the groups you pick. Presets. Vanilla, Farming, Survival, Cooking, Barren, 2X and Low pop, one click each. Great with cooking plugins that need lots of berries and mushrooms. Refill now. Fills a group up to its new target in small steps, and pauses when the server FPS drops. Trim. Removes the extras over the target, never within 60 m of a player and never inside building privilege. It asks for a second click before it runs. Live counts. Alive and target per group and per population, the mix of each kind, and how many entities you are adding over vanilla. Map markers. /plants show crops pings the nearest plants of a group on your map for 30 seconds. Clean restore. Unload or reload and every vanilla value is back. A group you switch off goes back to vanilla too. Plays nice. Built to run next to Ore Spawn Controller and the other Spawn Controllers, and it warns you if another spawn plugin is loaded. Light on the server. One small update every 30 seconds, refill and trim spread over frames, and the admin pictures only go to admins. Screenshots Every screen below is Plant Spawn Controller running in Rust. OVERVIEW: every group, the entity budget and the presets GROUPS: density, respawn and a weight per crop Berries at x2 with the live mix of every colour CURVE: drag the points, pick the groups, set the wipe boost SETTINGS: updates, markers, refill and trim, safety Type an exact value Trim asks for a second click /plants show crops: the nearest crops on your map Trailer The Plant Spawn Controller trailer (click to play, 55 seconds) Commands Chat: /plants - open the admin window. /plants show <group> - ping the nearest plants of a group on your map (groups: crops, berries, mushrooms, flowers, pickups, logs). /plants hide - clear the markers. /plants help - list the commands. Console (server console, RCON or an admin in F1): psc.preset <id> - apply a preset: vanilla, farming, survival, cooking, barren, 2x, lowpop. psc.set <group> <density|respawn|cap|curve|enabled|boost> <value> - change one value of a group, like psc.set berries density 2. psc.set <group> weight <kind> <value> - change one weight, like psc.set crops weight hemp 1.5. psc.refill [group|all] - fill toward the target now. psc.trim [group|all] - remove the extras over the target. psc.report - alive, target and vanilla numbers for every group and population. Permissions plantspawncontroller.admin - the window, every button in it and the console commands. plantspawncontroller.show - /plants show and /plants hide without the rest (admins have them already). oxide.grant user YOUR_STEAM_ID plantspawncontroller.admin oxide.grant user YOUR_STEAM_ID plantspawncontroller.show 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's one shared file for all our plugins. Install the plugin. Copy PlantSpawnController.cs into oxide/plugins (Carbon: carbon/plugins). It compiles on its own and creates its config. Grant the permission above and type /plants. Host doesn't allow DLL uploads? Put CrashExtInstaller.cs from the zip in your plugins folder and run crashext.install once in the server console: it downloads the extension from GitHub, checks it and puts it in place. Restart once and you're done. Configuration Everything lives in oxide/config/PlantSpawnController.json, and the window sets all of it in game. Changes apply and save the moment you make them. Config sections (click to expand) Test server Available on our test server. Type /plants in chat to open the window and play with the sliders, presets and map markers. The test server puts its settings back on its own from time to time. client.connect 91.229.114.54:28015 FAQ Q: Does it replace Rust's plant spawning? A: No. Vanilla still does all the spawning, in the same places. The plugin only changes how many of each population vanilla aims for and how fast it brings them back. Q: What happens when I unload it? A: Every vanilla value goes back the moment it unloads. Plants that already exist stay until they're picked, and vanilla keeps the map at its normal numbers from there. Q: I raised a group. Why isn't the map full yet? A: Vanilla fills toward the new target over time. Press REFILL NOW to get there right away, in small steps that pause when the server FPS drops. Q: I lowered a group. Do the extras disappear? A: Not by themselves. Press TRIM EXTRA twice (the second click confirms) and it removes the extras far from players and outside bases. Q: Does it touch ore nodes? A: No. The Pickups group is the small stone, metal and sulfur pickups on the ground, not ore nodes. Ore nodes belong to Ore Spawn Controller. Q: Why does the stone pickup count read 0 during Halloween? A: That's vanilla: during Halloween the stone pickup population spawns stone, metal, sulfur, wood and bone evenly, so the plain stone row can read low. Your density and weights still apply. Q: Can I run it with other spawn plugins? A: It's made to run next to the other Spawn Controllers. If SpawnControl, ServerPopulation or PopulationControl is loaded it warns you in the console, because two plugins changing the same populations will fight. 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 is built in. Edit oxide/lang/en/PlantSpawnController.json, or copy it into another language folder and translate its values: each player reads their own game language. Q: My config file broke. Will it get overwritten? A: Never. A config that isn't valid JSON is copied aside, left untouched, and the plugin waits for you to fix it and reload. Q: Does it contact any outside service? A: Only to download its pictures (about 50 small images) once from the Venux CDN, cdn.crashplugins.space, and only admins receive them. Nothing about your server or your players is sent. You don't need ImageLibrary. Q: Can other plugins read it? A: Yes: GetMultiplier(group), GetAlive(group) and the hook OnPlantSpawnControllerApplied(string group, float multiplier). The Spawn Controller family Plant Spawn Controller is the first of a family that tunes Rust's world populations the same way, each with the same window: Ore Spawn Controller - your own ore grid: spacing per ore, odds per biome, population scaling. Out now. Tree Spawn Controller - forests, palms, cactus and bushes per biome. Coming soon. Loot Spawn Controller - roadside barrels, junkpiles, shore crates and dive sites. Coming soon. Animal Spawn Controller - predators, game, livestock and critters, with a safe wipe start. Coming soon. Vehicle Spawn Controller - minicopters, boats, cars, horses and trains, with late air. Coming soon. They share one engine, take turns so they never refill at the same time, and you can run any mix of them. Want all of them? The Spawn Controller Bundle (all five plus Ore Spawn Controller) is on venuxplugins.com. Questions, ideas or bug reports? Use the Support tab of this file or join our Discord.$9.99 -
Hey, thanks for testing Item Insurance, good to know it keeps the upgrades! Levels above the config max: Yes, I’ll add this. Admins will be able to give an item a level above the track cap, like +25 on a +15 server, and the stats scale the same way. So with +10% damage per level, a +25 LR-300 gets +250% damage. There will also be a console command that creates the item already forged, so shops and kits can hand it out. Two limits stay for balance: durability tops out at no condition lost, and protection at 90% less damage taken. Rocket launcher magazine: Launchers are blacklisted by default because rockets do their damage through the explosion, and the explosion doesn’t know which launcher fired it. So a damage level would do nothing on them. Bigger magazines do work, though. In the next update launchers will be able to take the Magazine and Durability tracks, with extra rockets per Magazine level set in the config. Item drops: Most of this is already in Forge. In the config you can set drop chances for every material: per loot container, by prefab name for NPC kills in general per NPC, by prefab or display name. BetterNpc and NpcSpawn NPCs use their preset name as the display name, so you can give each type its own chances. For events there’s also forge.reward <steamid> <table> [rolls] , which any plugin that runs console commands can call, and an API for other plugins. There is one issue I found while checking this: BetterNpc and KpucTaJl’s events clear and refill corpse and crate loot right after they spawn, and that can wipe the Forge drops that were just added. That fix goes in the same update. I’ll look at Relics separately. Thanks for the ideas, I’ll post here when the update is out.
-
Version 1.3.2
82 downloads
[ ✓ ] 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. RandomLocationEachEvent picks 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, within CoverBaseRadius (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 LifetimeMinutes runs 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 within SoundRadius hear 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) and OnScrapWormRunOver (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 DestroyBuildings on, 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.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. 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 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 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.$29.99- 6 comments
- 1 review
-
- #scrapworm
- #worm
- (and 18 more)