Search the Community

[ ✓ ] 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. Forge lets your players make their weapons, armour and tools stronger, one level at a time. They pick an item, pick what to improve (damage, magazine size, durability or protection), put a stone in and see their exact chance before they click. A win levels the item up and renames it, like "Assault Rifle +7". A fail burns the stone, and from +5 it can cost a level, unless a ward was in the slot. The levels live on the item itself, so a forged rifle keeps its bonus when it is traded, looted, dropped, stored or carried through a restart. At +3, +6 and +9 the item opens gem sockets, and at +15 a prismatic socket that takes cursed gems. Thirteen gems in three grades and three cursed gems add headshot damage, lifesteal, thorns, a second wind and more, and seven resonances reward the right gems sitting together in one item. Stones, catalysts, wards and gems drop from crates, barrels and scientists, refine into better tiers and fuse into better grades. New in 1.1.0: tools join the forge with a YIELD track and gathering gems, worn gear builds equipment sets, five legendary items drop with fixed stats, crates and NPCs can drop pre-forged loot, SALVAGE breaks a forged item back into stones and gems, reward tables pay out from Raidable Bases or any event, and any item can be the forge cost. New in 1.2.0: admins can hand out items above the level caps with forge.giveitem, rocket launchers and the MGL can forge a bigger magazine, and drops from BetterNpc, NpcSpawn and event NPCs no longer get wiped. New in 1.2.1: milestone announcements: pick the levels (+5, +10, +15...) that the whole server hears about, in chat and as an NCP notification. New players get a welcome card and a guided tour of the real window, and admins get a first-run setup with three presets that set the whole balance in one click. Works on Oxide and Carbon Needs CrashExtensions (included) 5 tracks, 4 stone tiers, 24 gems, 4 sets, 5 legendaries Casual, Standard and Hardcore presets Jump to: Features · Screenshots · Trailer · How a forge works · Commands · Permissions · Works with · Install · Configuration · Test server · FAQ Features For players One forge window. Your weapons and gear on the left, the item with its condition and sockets in the middle, the tracks, the materials and the success chance on the right. One button forges. Four tracks. DAMAGE (+4% per level, up to +10), MAGAZINE (+10% rounds per level, up to +5), DURABILITY (-8% wear per level, up to +5) and PROTECTION for gear (-2% attack damage taken per level, up to +10). Odds you can read. The chance is shown before you click, added up from the stone, the catalyst, forge heat and any VIP bonus, and the IF IT FAILS panel says exactly what a fail would cost. Four stone tiers. Rough, Refined, Flawless and Mythic. A better stone reaches higher (+4, +6, +8, +10) and has better odds at every level. Catalysts and wards. A catalyst adds +5, +10 or +15 points of chance. A ward keeps your level when a forge fails, and it is only used up when it actually saved something. Forge heat. Every failed forge makes that item's next try easier, up to a cap, so a bad run never feels like a dead loss. A win resets it. Stats that travel. Levels, heat and gems are stored on the item. Trade it, loot it, drop it or die with it: the bonus goes with it. Gem sockets. Sockets open at +3, +6 and +9, and a prismatic socket at +15. Thirteen gems in three grades, plus three cursed gems with a big upside and a real drawback. Resonances. The right pair of gems in one item unlocks a bonus: a headshot that gives the round back, animal kills that heal you, no gear wear from player hits, and four more. Gems you can see. When a gem triggers, everyone nearby sees it: a headshot bursts in sparks, lifesteal draws blood, a thorn clangs the shield and cuts the attacker, a saved round ejects a shell, Second Wind injects and sparkles, Bloodhound howls. Each effect is a list of prefabs in the config, with one switch for all of them. Tools. Hatchets, pickaxes, the chainsaw, jackhammer, sickle and the server's other gathering tools take a YIELD track (+4% gathered per level, up to +10) and tool gems: PROSPECTOR, LUMBERJACK, SKINNER and SMELTER, with the MOTHERLODE and TIMBERLINE resonances. More gear gems. FORAGER, GREEN THUMB, ARTISAN and MEDIC, plus the FIELD MEDIC resonance. Equipment sets. VANGUARD, WARDEN, RANGER and NOMAD give bonuses at 2, 4 and 6 worn pieces. The GEAR screen and the chip over the belt show your progress, and a toast pops when a tier unlocks. Legendaries. Five named items with fixed stats and gems drop from crates and NPCs, with a gold look, a found toast and a chat line. They can't be forged further, salvaged or recycled away. Pre-forged loot. Crates and NPCs can drop an item that already has levels, sometimes with a gem. Salvage. Break a forged item under REFINE for a share of the stones its paid levels took, its gems and optional currency. Refine and fuse. Three stones make one of the next tier, three gems make one of the next grade, with the chance shown before you roll. Codex and history. Every material and gem with its odds and where it drops on your server, and your last 50 forges with your success rate and best item. Easy to learn. A welcome card on the first open, a guided tour that lights up each part of the real window, a sockets tour and a help page with your server's own numbers. Outside the window. A chip over the belt with the levels of the forged item you hold, result toasts, and a warning card before you recycle a forged item, with a KEEP IT button. For server owners First-run setup. The first time an admin opens Forge, three presets (Casual, Standard, Hardcore) set the odds, failure rules, drop rates, costs and heat in one click, with the three compared side by side, plus a page of on and off switches. Your risk, your rules. Failure bands by target level decide what a fail costs: nothing but the materials, a level, double heat or, on hardcore servers, the item itself behind a second click. Drops you control. A chance per material for every loot container (elite, military and locked crates and barrels by default; add any container by its prefab name) and for scientist kills. Gems drop mostly Chipped, rarely Radiant. Any currency. The forge cost in scrap, any item you pick (shortname and skin), Economics, ServerRewards or free. Reward tables. forge.reward <steamid> <table> [rolls] pays a drop table from Raidable Bases, events, quests or anything that runs a console command. A player on the death screen gets it on respawn, even across a restart. NPC drops by name. Add any NPC to the drop sources by prefab or display name. Recycling that cannot be farmed. A recycled forged item gives back a share of the stones its levels needed, always less than what went in, and a warning card shows the player what they would lose first. Milestone announcements. Pick the levels the whole server hears about (+10, +15 and +20 by default, add +5 or any other): a chat line to everyone, an NCP notification, or both. VIP bonus. Extra chance per permission, off until you add one. Admin view. Look up any online or sleeping player, see every forged item and its levels, change a level, reset an item or a player, and give materials. Every action is logged. Console and Tebex. forge.give hands out stones, catalysts, wards, extractors and gems from the server console, RCON or a Tebex package. Everything in the config. Every track, stone, catalyst, gem value, drop chance, cost, resonance, interface switch and sound, and every text in the lang file. Safe with other plugins. A name another plugin gave an item is left alone, an item whose data belongs to another plugin is never touched, and a broken config file is never overwritten. For developers OnForgeCompleted hook. Called after every forge with the player, the item uid, the track, its new level and the result (Success, Failed, Warded or Broken). See the FAQ. OnForgeLegendaryFound hook. Called the first time a player picks up a legendary that dropped. API. API_GiveReward, API_GiveMaterial, API_CreateLegendary, API_CreateForged, API_CreateLeveled, API_SetLevel and API_GetLevel. Screenshots Every screen below is Forge running in Rust. The forge: item, tracks, materials and the success chance A successful forge A failed forge: what was lost and the heat it built Sockets: gems, grades and resonances Refine: three stones into the next tier Tool forge: YIELD and tool gems Tool sockets: PROSPECTOR, SMELTER and MOTHERLODE Equipment sets and their tier bonuses A set bonus building on the GEAR screen The legendaries and where they drop A legendary rifle with its fixed stats Salvage: what a forged item gives back Stone codex: odds by level and where it drops Gem codex: every gem and its value by grade Resonances: the gems that work together History: every forge, refine and gem change How it works, with your server's numbers The guided tour lights up the real window The welcome card on the first open First-run setup: pick a preset Admin view: a player's forged items The chip over the belt shows the levels of the forged item you hold Trailer The Forge trailer (click to play, 55 seconds) How a forge works Pick an item and a track. Firearms take DAMAGE, MAGAZINE and DURABILITY (a gun that holds one round, like the Eoka, skips MAGAZINE); bows and melee weapons DAMAGE and DURABILITY; armour and clothing PROTECTION and DURABILITY. Each forge raises one track by one level, and the item's name shows the total ("Assault Rifle +7"). Add a stone. Its tier caps the level: Rough up to +4, Refined +6, Flawless +8, Mythic +10. A catalyst and a ward are optional. Read the chance. Default Mythic odds run from 100% at +1 down to 15% at +10, and heat adds +3 per failed try on that item, up to +15. Forge. By default the cost is 50 scrap plus 50 per target level. A win levels the track up at once. If it fails. Up to +4 only the materials burn. From +5 the track drops a level, and from +8 the heat gain doubles. A ward cancels the loss. On a Hardcore server an item can also break from +9, after a second click, and its attachments and ammo come back. Sockets. At +3, +6 and +9 the item opens a socket, and at +15 the prismatic one. A firearm can reach +20 in total, a bow, melee weapon or piece of gear +15. Commands /forge - open the forge. The name is configurable. /forgeadmin - the admin view, or the first-run setup until it is finished. /forge hud move - drag the held-item chip over the belt to a new place. /forge hud done saves the place, /forge hud reset puts it back. Admin From the server console, RCON, Tebex or a player with forge.admin (the player has to be online): forge.give <player> <material> [amount] - give stones, catalysts, wards, extractors or gems (for example forge.give <steamid> stone.mythic 3, or gem.vampire.2 for a Cut Vampire gem). forge.give <player> legendary <id> - give a legendary (emberfang, widowmaker, anvil, deepcore, gravewarden or your own ids), with no announcement. forge.reward <player> <table> [rolls] - roll a reward table 1 to 20 times (raidable_easy, raidable_medium, raidable_hard, event or your own). forge.setlevel <player> <item uid> <track> <level> - set one track of an item (damage, magazine, durability, protection or yield) from 0 to 50, above its cap too. forge.giveitem <player> <shortname> <track>=<level> [...] [skin=<id>] - give an item already forged, above the caps too (for example forge.giveitem <steamid> rifle.lr300 damage=25 magazine=10). Made for shops and kits. forge.reset <player> [item uid] - clear the levels, heat and gems of a player's forged items, or of one item. forge.inspect <player> - list a player's forged items with their uid. forge.panel - open the admin view from the F1 console. Permissions forge.use - open the forge and forge items. forge.sockets - the SOCKETS tab: insert and extract gems. forge.refine - the REFINE tab: refine stones and fuse gems. forge.admin - the setup, the admin view and the console commands. Admins need forge.use too. A permission you add to the VIP bonus (for example forge.vip) - extra chance on every forge. A permission that starts with forge. is registered for you. A typical setup: oxide.grant user YOUR_STEAM_ID forge.admin oxide.grant group default forge.use oxide.grant group default forge.sockets oxide.grant group default forge.refine Works with NCP: free, optional: forge milestones show to everyone as an NCP notification, next to or instead of the chat line Economics / ServerRewards: optional forge cost in money or points instead of scrap Raidable Bases or any event plugin: pay a reward table with forge.reward <player> <table> from its console commands Custom Item Manager: optional, its custom items as stones, gems and other materials, or as the forge cost 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. Install the plugin. Copy Forge.cs into oxide/plugins (Carbon: carbon/plugins). It compiles on its own and creates its config. Grant the permissions above, give yourself forge.use and forge.admin, and type /forge. The first-run setup opens: pick a preset, pick your options, press FINISH SETUP. 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. Configuration Everything lives in oxide/config/Forge.json, and the first-run setup sets the main parts in game. Player history is stored in oxide/data/Forge; the forge levels themselves are stored on the items. Config sections (click to expand) Test server Available on our test server. Try Forge before you buy: join and type /forge in chat. client.connect 91.229.114.54:28015 FAQ Q: Do I need Economics or ServerRewards? A: No. The forge costs scrap by default. Economics and ServerRewards are optional, and the cost can also be turned off. Q: Do the levels stay on the item? A: Yes. Levels, heat and gems are stored on the item itself, so they follow it through trades, loot, boxes, deaths and restarts, and a skin change at the repair bench keeps them (a skin that would turn it into a different item is refused). Q: Is it pay-to-win? A: Only if you make it so. The VIP chance bonus is empty by default, and players get stones from loot, scientists, refining and recycling. Q: Can I make it harder or easier? A: Pick Casual, Standard or Hardcore in the first-run setup, then fine-tune any number in the config. Hand-edited odds, drops and costs are kept unless you ask the setup to put the preset's numbers back. Q: Can I give stones from my store? A: Yes. Run forge.give <steamid> <material> <amount> as the Tebex command while the player is online. Q: What happens when a forged item is recycled? A: The recycler gives back a share of the stones its levels needed (35% by default, rounded down), and its gems shatter. Before that, a warning card shows the player what they would lose and offers to move the item back. Q: How do I pay Forge rewards from Raidable Bases? A: Add forge.reward {steamid} raidable_hard (or easy/medium) to the commands Raidable Bases runs when a raid is completed, using its own placeholder for the player's Steam ID. Q: Does MEDIC stack with other healing plugins? A: Yes, but its extra heal only counts what still fits: if another plugin heals you to full first, MEDIC has nothing left to add. 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/Forge.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: Only to download its pictures (about 120 small images: icons, buttons and the stone and gem art) once from the Venux CDN, cdn.crashplugins.space, which your server then keeps. Nothing about your server or your players is sent. You do not need ImageLibrary. If you set a material skin id of your own, Forge sends that id (and nothing else) once at load to the public Steam API, api.steampowered.com, to check it is a Workshop item. Q: How do other plugins react to a forge? A: Forge calls void OnForgeCompleted(BasePlayer player, ulong itemUid, string track, int level, string result) after every forge. track is damage, magazine, durability or protection, level is the track's new level and result is Success, Failed, Warded or Broken. Questions, ideas or bug reports? Use the Support tab of this file or join our Discord.

[ ! ] The zip contains a DLL extension that goes into RustDedicated_Data/Managed. Some hosts do not allow uploading DLLs - check with your host before buying. [ ! ] Relics is a loot RPG for Rust. Sealed relic crates drop from the world (loot containers, barrels, NPCs, animals, ore nodes, trees and fishing), and unwrapping one reveals a relic with its own rarity, its own rolled affixes and, on the better ones, an active ability. Players equip up to six, and every affix feeds a live modifier table: gather yields, damage against players, NPCs, animals, the helicopter and Bradley, resistances, craft and research refunds, loot luck, healing, and stranger ones like reflecting melee damage or hitting harder at night. 96 relics ship across 8 sets and 6 rarities. A forge fuses three relics into the next rarity, enchants them to level 10, rerolls a single affix and salvages the rest into dust. A codex tracks what has been found on the server, who found it first and where the missing ones drop, and a mastery tree turns relic activity into permanent passive bonuses. And there is a black market. A broker hides near a monument and moves every couple of hours: he buys the relics you do not want, sells a rotating table with a sealed crate for the gamblers, and runs a consignment stall where players sell to each other at their own price. Relics can also leave the bag as real items to trade, vend, stash or lose on death. Works on Oxide and Carbon Needs CrashExtensions (included in the zip) 96 relics, 8 sets, 6 rarities English, Spanish, Portuguese and Russian built in Jump to: Features · How it plays · Screenshots · Included relics · Commands · Permissions · Works with · Install · Configuration · Test server · FAQ · API Features For players A reveal for every find. Unwrapping a crate opens a full-screen appraisal with rays, stamps and a wax seal for the rarest relics. 96 relics, 8 sets, 6 rarities. Each relic rolls its own affixes, and a set of 2 or 3 pieces adds a bonus on top. 40 passive affixes. Gather yields, damage against players, NPCs, animals, the helicopter and Bradley, resistances, craft and research refunds, loot luck, healing, thorns, night damage and more. 13 active abilities. One bindable key, a radial wheel when two or more are equipped, and a cooldown per relic. The forge. Fuse three relics into the next rarity, enchant to level 10, reroll a single affix, or salvage the rest into dust. A codex. Every relic on the server: who found it first, what it rolls and where it drops. A mastery tree. Mastery levels buy permanent passive bonuses. A black market. A broker who buys relics, sells a rotating table and runs a player consignment stall. He talks through NpcDialogue, included in the zip. Relics as real items. TAKE OUT turns a relic into an item you can trade, vend or stash. Unwrapping it puts that exact relic back. A HUD tray. Above the hotbar, with every equipped relic and its ability cooldown, and every player can move it. For server owners Slots as a VIP hook. Everybody starts with 3 equipped slots and a permission raises the cap to 6. Locked slots show in the bag as an upsell. In-game editor. /relics admin edits every relic in game, so nobody has to touch a file. Your economy. The black market trades in scrap, Economics or ServerRewards, and the forge runs on dust that players earn by salvaging, so no economy plugin is needed. When Economics or ServerRewards refuses a payment, the relic stays with the player. Sell crates. relics.givecrate is made for your shop or Tebex. Death modes. Keep everything (the default), lose durability, or drop the equipped or all relics into the corpse. Everything is a switch. Every drop chance, every affix, every animation and every sound can be tuned or turned off. Safe player files. A player file the plugin cannot read is left exactly as it is and never written over, and nothing can be added to that player's bag until you restore it. 4 languages. English, Spanish, Portuguese and Russian are built in, every text and all 96 relics included, and each player sees the language of their own game. Wipe your way. One config switch wipes every bag on a new map save. It is off by default, so relics carry across wipes. For developers Hooks and an API. OnRelicObtained, OnRelicActiveUsed and the Relics_* calls: give relics and crates, read a modifier, add dust, open the market. See the API. Console and RCON commands. The give commands and the broker calls run from the server console, which is where your shop, quests and NPC dialogues point. How it plays Find. Sealed crates drop from loot containers, barrels, NPC and animal kills, ore nodes, trees and fishing. Every source has its own chance in the config. Unwrap. The reveal shows the relic's name, rarity, rolled affixes and ability. Equip. Up to 3 slots (6 with permissions). The affixes apply at once, a set bonus appears at 2 and 3 pieces, and each ability gets its own cooldown. Forge. Fuse three relics into the next rarity, enchant to level 10, reroll an affix, or salvage a relic into dust, which pays for the rest. Progress. Relic activity earns mastery XP, mastery levels unlock permanent bonuses, and the codex keeps track of every relic found on the server. Trade. Sell to the broker, list a relic on his consignment stall, or take it out as an item. Screenshots Every screen below is Relics running in Rust. The relic bag: equipped slots, abilities and the totals from every relic A mythic reveal The forge The codex The mastery tree The broker's table Selling to the broker The consignment stall The relic editor (admin) The HUD tray above the hotbar Included Relics Eight sets of ten relics, plus 16 old-world oddities that belong to no set: Miner's - 2 pieces: +8% ore yield. 3 pieces: +10% instant mine chance Hunter's - 2 pieces: +8% animal harvest. 3 pieces: +15% damage vs animals Warden's - 2 pieces: +4% bullet resistance. 3 pieces: +10% melee resistance Raider's - 2 pieces: +6% explosive resistance. 3 pieces: +6% free upgrade chance Scavenger's - 2 pieces: +5% loot luck. 3 pieces: +8% craft refund chance Alchemist's - 2 pieces: +10% healing bonus. 3 pieces: +20% bleeding resistance Nomad's - 2 pieces: +20% fall damage resistance. 3 pieces: +15% cold resistance Sentinel's - 2 pieces: +8% damage vs NPCs. 3 pieces: +10% headshot damage A few of the legendaries and the rarest: Heart of the Quarry (Legendary, Miner's) - Quake: every ore node around you is emptied straight into your inventory Alpha Skull (Legendary, Hunter's) - Thunderclap: slams every NPC and animal around you Raid King's Crown (Legendary, Raider's) - Warcry: you and the teammates near you hit harder for a while Midas Scrap Heart (Legendary, Scavenger's) - Magnet: pulls the loose items around you into your inventory Void Shard (Mythic, Sentinel's) - Aegis: a shield that cuts incoming damage. "It does not reflect light. It keeps it." Yours to change: all 96 live in oxide/data/Relics/templates.json, plain JSON, and the in-game editor writes the same file. An update only ever adds new relics to it and never touches the ones you edited. In-Game Editor No file editing needed. /relics admin opens every relic in a searchable list and an editor for its name, rarity, set, ability, affix pool and drop sources, with a preview of its reveal. Duplicate a built-in relic to start a new one. Who can open it: players with relics.admin, and server admins always. Commands Players /relics - open the relic bag /relics forge, /relics codex, /relics mastery - open the forge, the codex or the mastery tree /relics hud, /relics hud move, /relics hud reset - show or hide the HUD tray, drag it anywhere on screen, or put it back where the server default is /relics use - use your active ability /relics help - the command list in chat relics.use - the same as /relics use, as a console command on purpose so players can bind it: bind f relics.use (one ability: the key fires it; two or more: a wheel opens), or fire one directly with bind g "relics.use Quake" Admin /relics admin - the in-game relic editor relics.give <player> <id | rarity | random> [minRarity] - give a specific relic, a random one of a rarity, or a random one relics.givecrate <player> [minRarity] [amount] - give sealed crates, the one to point your shop or Tebex at relics.dust <player> <amount> - give or take forge dust, offline players included relics.masteryxp <player> <xp> - give mastery XP, offline players included relics.templates.reset confirm - rewrite the relic file from the 96 built-in relics relics.wipe confirm - delete every player bag, the codex and the black market /relics broker where | tp | move | open | restock | add | list | remove | clear - find, move, open or restock the broker and pin his hiding spots relics.bm.open <steamid> [buy | sell | consign] and relics.bm.rumor <steamid> - console and RCON calls for NPC dialogues and other plugins The give commands run from the server console and RCON as well. <player> is a SteamID64 or the exact player name. Permissions relics.use - find, open and equip relics. Required: without it a player is not in the system at all, so grant it to your default group relics.forge - fuse, enchant and reroll. Salvage and repair stay free relics.admin - the in-game editor and the give and wipe commands. Staff only relics.slots.4, relics.slots.5, relics.slots.6 - raise the equipped slot cap. Everybody starts at 3, and the highest one a player holds wins relics.market.vip - 5 consignment stall slots instead of 3 Locked slots show in the bag as a VIP upsell, and the stall takes any extra slot permissions you add in the config. A typical setup opens everything to everyone and keeps the extra slots for your VIPs: oxide.grant group default relics.use oxide.grant group default relics.forge oxide.grant group vip relics.slots.5 oxide.grant group vip relics.market.vip Works with NpcDialogue: included free in the zip: the black market broker talks through the game's own conversation screen Economics / ServerRewards: optional black market currency, scrap by default Tebex or any shop: sell crates with relics.givecrate from the server console or RCON 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. Install the plugin. Copy Relics.cs into oxide/plugins (Carbon: carbon/plugins). It compiles on its own and creates its config, data and language files. Grant the permissions above. Nobody finds or equips a relic until relics.use is granted. Then open /relics admin and tune the rest 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. Updating from an earlier Relics? Replace Relics.cs. Your config, templates.json, the codex, the black market and every player's bag load as they are. The extension in the zip is the current build: copy it over the old one and restart once. Back up oxide/config/Relics.json and oxide/data/Relics first. Configuration Everything lives in oxide/config/Relics.json. The 96 relics are in oxide/data/Relics/templates.json, each player's bag in oxide/data/Relics/players, and the codex and the black market in oxide/data/Relics/global.data. Config sections (click to expand) Test server Available on the new Meowcraft test server. Open relics with /relics, and find the black market broker near a monument. FAQ Q: I run Relics. What changes when I update? A: Replace Relics.cs and, if you update the extension too, restart once. Your config, relic file, codex, black market and every player's bag load as they are. Q: Can relics be traded or stolen? A: Yes. The consignment stall lets players sell relics to each other through the broker, and TAKE OUT turns a relic into a real item: trade it, vend it or keep it in a box, where it can be raided like anything else. Unwrapping it puts that exact relic back, and a copied item can only be claimed once. Nothing is lost on death by default; the DropEquipped and DropAll modes drop relics into the corpse. Q: Does this change vanilla gear balance? A: No. Relics are their own items in their own bag. They never touch weapons, armour or any vanilla item. Q: Do I need an economy plugin? A: No. The forge runs on dust, earned by salvaging relics, and the black market trades in scrap. Economics or ServerRewards take one config line. If the economy plugin refuses a payment, the sale or the collect does not go through and the relic stays with the player. Q: Do I need NpcDialogue? A: No, but it comes free in the zip. With NpcDialogue installed the broker talks through the vanilla conversation screen first. Without it, pressing E on him opens the market directly. Q: Is it pay to win? A: Your call. The natural VIP hook is slots: everybody plays with 3 and a rank raises the cap to 6. You can also sell sealed crates in your shop with relics.givecrate, sell the forge, or keep it all free. Q: Will it survive a wipe? A: Your choice. A config switch wipes every bag on a new map save. It is off by default, so relics carry across wipes. Q: What happens if a player's file is damaged? A: After a crash or a full disk a player file can come back unreadable. The console says so, Relics leaves the file exactly as it is, and that player plays on an empty bag that is never saved: nothing can be added to it, crates and relic items stay in the inventory, and the broker charges nothing. Restore the file (a backup, or the leftover .TMP Windows can leave beside it after a crash) and have the player reconnect. The README in the zip has the steps. Q: How heavy is it? A: Built for high population servers. The panels only send what changed, saves are spread across frames, and the combat and gathering bonuses step aside for players who carry no relic for them. Every animation plays once per action and none of them loops. Q: Does it contact any outside service? A: Only to download its pictures (about 250 small images, the relic art included) once from rust-cui.crashplugins.space, which your server then caches. Nothing about your server or your players is sent. Q: Can I translate it? A: It already speaks four: English, Spanish, Portuguese and Russian are built into the plugin, every text and all 96 relics included, and each player sees the language their game runs in. For another language, copy oxide/lang/en/Relics.json to oxide/lang/<code>/Relics.json and translate it: it lists every key, the relics included. Q: Does it work on Carbon? A: Yes. The extension goes into carbon/extensions instead of RustDedicated_Data/Managed, and everything else is the same. API / Hooks // Hooks void OnRelicObtained(BasePlayer player, string templateId, int rarity) void OnRelicActiveUsed(BasePlayer player, string activeId) // API: Relics?.Call<T>("Method", ...) // ids as ulong: (ulong)player.userID (player.userID alone returns null) // Relics_AddDust takes a long: 100L (an int returns null) // The give calls and AddDust return false when nothing was given or added: // the bag is full, the player's file could not be read, or dust would pass its cap bool Relics_GiveRandom(ulong userId, int minRarity = 0, string source = "Api") bool Relics_GiveTemplate(ulong userId, string templateId) bool Relics_GiveCrate(ulong userId, int minRarity = 0, int amount = 1) float Relics_GetModifier(ulong userId, string affixId) long Relics_GetDust(ulong userId) bool Relics_AddDust(ulong userId, long amount) int Relics_GetEquippedCount(ulong userId) string Relics_GetActiveSet(ulong userId) bool Relics_OpenBlackMarket(ulong userId, string tab = "buy") Vector3 Relics_GetBrokerPosition() Questions, ideas or bug reports? Use the Support tab of this file or join our Discord.