Search the Community

[ ! ] 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.

Plugin add artifacts with passive and active abilities PROMO FEATURES 50+ passive and active abilities (will added more) Groups and Permissons for artifacts Easy to create and edit admin menu Fully customizable screen button Translate to EN, RU, DE, FR lang Rust inventory for artifacts with fine look UI Drop artifacts on death Dynamic slots amount with perms Prohibition on the use of identical artifacts Prohibition of using artifacts with the same abilities Auto wipe players on WIPE Full customization for all kinds of abilities Artifacts have durability and can be broken Cooldown for active abilities Maximum stats for active and passive abilities Broadcasting for active and passive abilities Custom tags for lang Beautiful visual effects Patch default stack size with Harmony Artifacts Synthesis - Synthesis table, when you can combine artifacts (free addon) Meteor Event - Artifacts drop from sky (free addon) Gather Event - Artifacts drop from special ores, that spawn throughout entire map (free addon) ️ Informational and updates videos About plugins V1 Release 25 passives and 5 active abilities V1.1 Balls Update v1.2 11 new passives abilities Plugin Structure ├── Info.txt - Commands and permissions │ ├── lang/ │ ├── en - English │ ├── ru - Russian │ ├── de - German │ └── fr - French │ ├── plugins/ │ ├── Artifacts.cs - Main plugin │ ├── ArtifactsSynthesis.cs - Synthesis table │ ├── ArtifactsMeteorEvent.cs - Meteor event │ └── ArtifactsGatherEvent.cs - Gather event │ └── data/Artifacts/ ├── Artifacts/ - Artifacts configurations ├── Players/ - Player data storage └── Prefabs/ - Custom plugin prefabs PASSIVE ABILITIES "Miner" - Increases ore gathering efficiency Start amount + ability % (ex. 1k resources, 12% value = 1120 resources) "Woodcutter" - Boosts wood amount collected Start amount + ability % (ex. 1k resources, 12% value = 1120 resources) "Picker" - Increases all resources collected from the ground Start amount + ability % (ex. 1k resources, 12% value = 1120 resources) "Butcher" - Improves harvesting from animals Start amount + ability % (ex. 1k resources, 12% value = 1120 resources) "Angler" - Increases fish catch quantity Successful = value % (ex. 1.0 = 100%, 0.2 = 20%, 0.01 = 1%) Start amount X from config (ex. 2 start 2 from config = 4 finish ) "Scavenger" - Finds more scrap in loot containers Successful = value % (ex. 1.0 = 100%, 0.2 = 20%, 0.01 = 1%) Start amount X from config (ex. 2 start 2 from config = 4 finish ) "Farmer" - Improves crop yield Start amount + ability % (ex. 1k resources, 12% value = 1120 resources) "HeatBane" - Reduces damage from high temperatures 1.0f - ability % (ex. 10 damage, 30% value = 7 damage) "FrostBane" - Reduces damage from freezing conditions 1.0f - ability % (ex. 10 damage, 30% value = 7 damage) "RadBane" - Decreases radiation damage 1.0f - ability % (ex. 10 damage, 30% value = 7 damage) "Fatstack" - Increases calories and hydration when eating Start amount + ability % (ex. 10 c+h, 12% value = 11 c+h) "BleedResistance" - Reduces bleeding damage 1.0f - ability % (ex. 10 damage, 30% value = 7 damage) "BeastResistant" - Decreases damage taken from animals 1.0f - ability % (ex. 10 damage, 30% value = 7 damage) "BeastSlayer" - Increases damage dealt to animals 1.0f + ability % (ex. 10 damage, 30% value = 13 damage) "ScientistResistant" - Reduces damage from scientists 1.0f - ability % (ex. 10 damage, 30% value = 7 damage) "ScientistSlayer" - Boosts damage against scientists 1.0f + ability % (ex. 10 damage, 30% value = 13 damage) "BradleySlayer" - Increases damage dealt to Bradley 1.0f + ability % (ex. 10 damage, 30% value = 13 damage) "BradleyResistant" - Reduces damage from Bradley 1.0f - ability % (ex. 10 damage, 30% value = 7 damage) "HeliSlayer" - Increases damage dealt to helicopter 1.0f + ability % (ex. 10 damage, 30% value = 13 damage) "HeliResistant" - Reduces damage from helicopter 1.0f - ability % (ex. 10 damage, 30% value = 7 damage) "LuckyShot" - Chance for critical hit damage Successful = value % (ex. 1.0 = 100%, 0.2 = 20%, 0.01 = 1%) Damage X from config (ex. 20 damage 2.0 from config = 40 damage) "Feather" - Reduces damage from falling Start amount - ability % (ex. 10 damage, 30% value = 7 damage) "Vampire" - Gains health when dealing damage Damage ability % (ex. 20 damage 20% value = 20.0 0.2 = 4 heal) [Types] Scientist, Animal, Heli, Bradley "Medic" - Increases healing amount from medic tool (work with instant heal only) Start amount + (Start amount ability %) (ex. 10 heal, 50% value = 10 + (10 0.5) = 15 heal) "LuckyMiner" - Chance to get loot when finish mining ore Successful = value % (ex. 1.0 = 100%, 0.2 = 20%, 0.01 = 1%) Spawn random prefab from config on Ore position "Smelter" - Processes ore during mining Successful = value % (ex. 1.0 = 100%, 0.2 = 20%, 0.01 = 1%) "CoalMiner" - Сonverts wood into coal during mining Successful = value % (ex. 1.0 = 100%, 0.2 = 20%, 0.01 = 1%) "Gunsmith" - Chance to return bullet when firing Successful = value % (ex. 1.0 = 100%, 0.2 = 20%, 0.01 = 1%) "Archer" - Chance to return arrow when shooting Successful = value % (ex. 1.0 = 100%, 0.2 = 20%, 0.01 = 1%) "Researcher" - Chance to return scrap when researching Successful = value % (ex. 1.0 = 100%, 0.2 = 20%, 0.01 = 1%) "Builder" - Chance to return resources when upgrading structure Successful = value % (ex. 1.0 = 100%, 0.2 = 20%, 0.01 = 1%) "Chef" - Cooking meat while butchering animals Successful = value % (ex. 1.0 = 100%, 0.2 = 20%, 0.01 = 1%) "GoldenHands" - Items take longer to break Return to item % from loose condition (ex. loose 2.0, value 50% = return 1.0 ) "SuperMiner" - Faster ore extraction Gather speed = start speed + value % * 2 (ex. 1.5(start) * 200% * 2 = 5.5(speed)) "SuperWoodcutter" - Faster tree cutting Gather speed = start speed + value % * 2 (ex. 1.5(start) * 200% * 2 = 5.5(speed)) "FireResistance" - Increased fire resistance 1.0f - ability % (ex. 10 damage, 30% value = 7 damage) "ExplosiveResistance" - Increased explosion protection 1.0f - ability % (ex. 10 damage, 30% value = 7 damage) "SiegeMan" - Increases the damage to buildings from explosives 1.0f + ability % (ex. 10 damage, 30% value = 13 damage) "LuckyRaider" - The chance of a double explosion Successful = value % (ex. 1.0 = 100%, 0.2 = 20%, 0.01 = 1%) "ExperienceRaider" - Increases the chance of detonation for satchels and beancans Successful = value % (ex. 1.0 = 100%, 0.2 = 20%, 0.01 = 1%) ACTIVE ABILITIES "Collector" - Searching loot around you Work with radius around player "Pathfinder" - Searching animals around you Work with radius around player "Geologist" - Searching ores around you Work with radius around player "Ranger" - Searching scientists around you Work with radius around player "Raider" - Searching traps around you Work with radius around player "Flora" - Everything starts to grow around you Work with radius around player "Fire Ball" - Launches a fireball in front of you Damage depends on the value of the artifact Radius is taken from the config "Ore Ball" - Gather ores around you Work with radius around player "Tree Ball" - Gather tree around you Work with radius around player "Loot Ball" - Loot containers around you Work with radius around player "Killer Ball" - Launches a killerball to your target, when you attack The damage depends on the value of the artifact PERMISSIONS ABILITIES You can add permissions to artifact Permissions will be added when player move artifact to special container and remove when artifact will be removed from container Recommendations Use only unique perm for artifact Not use on different artifacts one perm Not use perm that use other plugin If you remove artifact with perm, then remove this perm GROUPS ABILITIES You can add groups to artifact Groups will be added when player move artifact to special container and remove where artifact will be removed from container Recommendations Use only unique perm for artifact Not use on different artifacts one group Not use group that use other plugin If you remove artifact with group, then remove this group If you need use one perm on different artifact, then create different groups and grant them with that perm PLUGIN COMMANDS Admin: artifact.admin - show admin menu (need be admin) artifact.give "skinId" "Player Name\SteamId" - give artifact to player (console or perm : artifacts.give) table.give "Player Name\SteamId" - give synthesis table to player (console or perm: artifactssynthesis.give) /agather.spawn "Optional: Ore Presset Name" - spawn custom ore front of you (need be admin) (if presset empty, spawn first from config) /ameteor.spawn "Optional: Artifact id" - spawn meteor on your position (need be admin) Player: artifact.use "config ability name" - try use active ability artifact.broadcast - on/off broadcast of ability's message and effect artifact.open - open main artifact menu PLUGIN PERMISSIONS artifacts.give - grant to use command artifact.give artifactssynthesis.give - grant to use command table.give artifacts.slots.default, artifacts.slots.vip, artifacts.slots.premium - set amount of slots for artifacts (may change in config) THREE FREE ADD-ONS Synthesis table - сombine artifacts to create stronger ones Gather event - сustom ores appear all over the map, mine them so that you can get an artifact at the end Meteor event - artifacts fall from the sky to the island as meteorite TEST SERVER Join our test server to view and experience all our unique features yourself! Copy the IP Address below to start playing! connect 194.147.90.147:28015 API JObject GetArtifact(ulong skinId) Get artifact info by skinId ["name"] string ["skinId"] ulong ["onlyOne"] bool ["condition"] float ["passives"] Dictionary<string, float> ["actives"] Dictionary<string, float> ["groups"] List<string> ["permissions"] List<string> Item CreateArtifact(ulong skinId) Create artifact by skinId Item GiveArtifact(BasePlayer player, ulong skinId) Create artifact by skinId and give to player Item GiveArtifact(ItemContainer container, ulong skinId) Create artifact by skinId and move to container BaseEntity DropArtifact(ulong skinId, Vector3 position) Create artifact by skinId and drop on position float GetPlayerAbilityValue(ulong userId, string ability) Return player ability value (not count max stat) bool IsItemArtifact(Item item) Return true if item is artifact, else false CONFIGS Main Synthesis table Gather event Meteor event

This plugin adds artifacts when a metal detector flag is destroyed. Players using a metal detector can place flags, and when they are broken, they can receive random artifacts with different drop chances. Main Features: Added API hooks for external plugin integration. Multiple levels of metal detectors with different detection rates. Configurable artifacts: adjust drop rates, amounts, and rarity. Flexible detector system: add new levels via configuration. Logs all player actions: flag placement, destruction, and artifact findings. Localization support (Russian, English, Ukrainian). ⚙ Settings: All parameters can be changed in the configuration file. You can: Modify artifact drop chances. Configure detector levels and permission-based chances. Define which crates can contain detectors. Permissions: apdetectorartifacts.default – standard drop chances. apdetectorartifacts.vip – increased chances for VIP players. apdetectorartifacts.premium – maximum chances for premium players. CFG (NEW): { "Notify on artifact found": true, "Maximum artifacts per flag": 1, "Maximum detectors per crate": 1, "Random drop mode": true, "Detectors": [ { "Short Name": "metal.detector", "Enabled": true, "Name": "OTKLIK lvl-1", "Skin ID": 3573505954, "Detector level": 1, "Detection chances by permission": { "apdetectorartifacts.default": 30, "apdetectorartifacts.vip": 50, "apdetectorartifacts.premium": 30 }, "Spawn crates": [ "crate_normal_2", "crate_tools", "crate_normal", "crate_elite", "supply_drop" ], "Artifacts": [ { "Name": "Stone Blood", "Short Name": "battery.small", "Skin ID": 3568625849, "Drop Chance": 50, "Amount": 1 }, { "Name": "Bubble", "Short Name": "battery.small", "Skin ID": 3573380276, "Drop Chance": 5, "Amount": 1 }, { "Name": "Slug", "Short Name": "battery.small", "Skin ID": 3568625724, "Drop Chance": 20, "Amount": 1 }, { "Name": "Snowflake", "Short Name": "battery.small", "Skin ID": 3568625801, "Drop Chance": 25, "Amount": 1 }, { "Name": "Torch", "Short Name": "battery.small", "Skin ID": 3568625951, "Drop Chance": 20, "Amount": 1 }, { "Name": "Stone Heart", "Short Name": "battery.small", "Skin ID": 3568625893, "Drop Chance": 20, "Amount": 1 }, { "Name": "Fireball", "Short Name": "battery.small", "Skin ID": 3568625373, "Drop Chance": 20, "Amount": 1 }, { "Name": "Film", "Short Name": "battery.small", "Skin ID": 3568625303, "Drop Chance": 15, "Amount": 1 }, { "Name": "Runaway Bun", "Short Name": "battery.small", "Skin ID": 3568625506, "Drop Chance": 10, "Amount": 1 }, { "Name": "Shell", "Short Name": "battery.small", "Skin ID": 3568625656, "Drop Chance": 20, "Amount": 1 }, { "Name": "Pacifier", "Short Name": "battery.small", "Skin ID": 3568625225, "Drop Chance": 1, "Amount": 1 } ] }, { "Short Name": "metal.detector", "Enabled": true, "Name": "GILKA lvl-2", "Skin ID": 3573505518, "Detector level": 2, "Detection chances by permission": { "apdetectorartifacts.default": 25, "apdetectorartifacts.vip": 45, "apdetectorartifacts.premium": 40 }, "Spawn crates": [ "crate_normal_2", "crate_tools", "crate_normal", "crate_elite", "supply_drop" ], "Artifacts": [ { "Name": "Stone Blood", "Short Name": "battery.small", "Skin ID": 3568625849, "Drop Chance": 20, "Amount": 1 }, { "Name": "Bubble", "Short Name": "battery.small", "Skin ID": 3573380276, "Drop Chance": 5, "Amount": 1 }, { "Name": "Slug", "Short Name": "battery.small", "Skin ID": 3568625724, "Drop Chance": 20, "Amount": 1 }, { "Name": "Snowflake", "Short Name": "battery.small", "Skin ID": 3568625801, "Drop Chance": 15, "Amount": 1 }, { "Name": "Torch", "Short Name": "battery.small", "Skin ID": 3568625951, "Drop Chance": 15, "Amount": 1 }, { "Name": "Stone Heart", "Short Name": "battery.small", "Skin ID": 3568625893, "Drop Chance": 20, "Amount": 1 }, { "Name": "Fireball", "Short Name": "battery.small", "Skin ID": 3568625373, "Drop Chance": 10, "Amount": 1 }, { "Name": "Film", "Short Name": "battery.small", "Skin ID": 3568625303, "Drop Chance": 10, "Amount": 1 }, { "Name": "Runaway Bun", "Short Name": "battery.small", "Skin ID": 3568625506, "Drop Chance": 10, "Amount": 1 }, { "Name": "Shell", "Short Name": "battery.small", "Skin ID": 3568625656, "Drop Chance": 10, "Amount": 1 }, { "Name": "Pacifier", "Short Name": "battery.small", "Skin ID": 3568625225, "Drop Chance": 1, "Amount": 1 } ] }, { "Short Name": "metal.detector", "Enabled": true, "Name": "MEDVED lvl-3", "Skin ID": 3573506189, "Detector level": 3, "Detection chances by permission": { "apdetectorartifacts.default": 20, "apdetectorartifacts.vip": 40, "apdetectorartifacts.premium": 55 }, "Spawn crates": [ "crate_normal_2", "crate_tools", "crate_normal", "crate_elite", "supply_drop" ], "Artifacts": [ { "Name": "Stone Blood", "Short Name": "battery.small", "Skin ID": 3568625849, "Drop Chance": 45, "Amount": 1 }, { "Name": "Bubble", "Short Name": "battery.small", "Skin ID": 3573380276, "Drop Chance": 10, "Amount": 1 }, { "Name": "Slug", "Short Name": "battery.small", "Skin ID": 3568625724, "Drop Chance": 40, "Amount": 1 }, { "Name": "Snowflake", "Short Name": "battery.small", "Skin ID": 3568625801, "Drop Chance": 40, "Amount": 1 }, { "Name": "Torch", "Short Name": "battery.small", "Skin ID": 3568625951, "Drop Chance": 40, "Amount": 1 }, { "Name": "Stone Heart", "Short Name": "battery.small", "Skin ID": 3568625893, "Drop Chance": 40, "Amount": 1 }, { "Name": "Fireball", "Short Name": "battery.small", "Skin ID": 3568625373, "Drop Chance": 35, "Amount": 1 }, { "Name": "Film", "Short Name": "battery.small", "Skin ID": 3568625303, "Drop Chance": 30, "Amount": 1 }, { "Name": "Runaway Bun", "Short Name": "battery.small", "Skin ID": 3568625506, "Drop Chance": 25, "Amount": 1 }, { "Name": "Shell", "Short Name": "battery.small", "Skin ID": 3568625656, "Drop Chance": 25, "Amount": 1 }, { "Name": "Pacifier", "Short Name": "battery.small", "Skin ID": 3568625225, "Drop Chance": 2, "Amount": 1 } ] }, { "Short Name": "metal.detector", "Enabled": true, "Name": "VELES lvl-4", "Skin ID": 3573506935, "Detector level": 4, "Detection chances by permission": { "apdetectorartifacts.default": 15, "apdetectorartifacts.vip": 35, "apdetectorartifacts.premium": 60 }, "Spawn crates": [ "crate_normal_2", "crate_tools", "crate_normal", "crate_elite", "supply_drop" ], "Artifacts": [ { "Name": "Stone Blood", "Short Name": "battery.small", "Skin ID": 3568625849, "Drop Chance": 40, "Amount": 1 }, { "Name": "Bubble", "Short Name": "battery.small", "Skin ID": 3573380276, "Drop Chance": 35, "Amount": 1 }, { "Name": "Slug", "Short Name": "battery.small", "Skin ID": 3568625724, "Drop Chance": 100, "Amount": 1 }, { "Name": "Snowflake", "Short Name": "battery.small", "Skin ID": 3568625801, "Drop Chance": 30, "Amount": 1 }, { "Name": "Torch", "Short Name": "battery.small", "Skin ID": 3568625951, "Drop Chance": 30, "Amount": 1 }, { "Name": "Stone Heart", "Short Name": "battery.small", "Skin ID": 3568625893, "Drop Chance": 30, "Amount": 1 }, { "Name": "Fireball", "Short Name": "battery.small", "Skin ID": 3568625373, "Drop Chance": 30, "Amount": 1 }, { "Name": "Film", "Short Name": "battery.small", "Skin ID": 3568625303, "Drop Chance": 40, "Amount": 1 }, { "Name": "Runaway Bun", "Short Name": "battery.small", "Skin ID": 3568625506, "Drop Chance": 25, "Amount": 1 }, { "Name": "Shell", "Short Name": "battery.small", "Skin ID": 3568625656, "Drop Chance": 25, "Amount": 1 }, { "Name": "Pacifier", "Short Name": "battery.small", "Skin ID": 3568625225, "Drop Chance": 5, "Amount": 1 } ] }, { "Short Name": "metal.detector", "Enabled": true, "Name": "SVAROG lvl-5", "Skin ID": 3573506771, "Detector level": 5, "Detection chances by permission": { "apdetectorartifacts.default": 10, "apdetectorartifacts.vip": 30, "apdetectorartifacts.premium": 65 }, "Spawn crates": [ "crate_normal_2", "crate_tools", "crate_normal", "crate_elite", "supply_drop" ], "Artifacts": [ { "Name": "Stone Blood", "Short Name": "battery.small", "Skin ID": 3568625849, "Drop Chance": 50, "Amount": 1 }, { "Name": "Bubble", "Short Name": "battery.small", "Skin ID": 3573380276, "Drop Chance": 50, "Amount": 1 }, { "Name": "Slug", "Short Name": "battery.small", "Skin ID": 3568625724, "Drop Chance": 50, "Amount": 1 }, { "Name": "Snowflake", "Short Name": "battery.small", "Skin ID": 3568625801, "Drop Chance": 50, "Amount": 1 }, { "Name": "Torch", "Short Name": "battery.small", "Skin ID": 3568625951, "Drop Chance": 50, "Amount": 1 }, { "Name": "Stone Heart", "Short Name": "battery.small", "Skin ID": 3568625893, "Drop Chance": 50, "Amount": 1 }, { "Name": "Fireball", "Short Name": "battery.small", "Skin ID": 3568625373, "Drop Chance": 50, "Amount": 1 }, { "Name": "Film", "Short Name": "battery.small", "Skin ID": 3568625303, "Drop Chance": 50, "Amount": 1 }, { "Name": "Runaway Bun", "Short Name": "battery.small", "Skin ID": 3568625506, "Drop Chance": 50, "Amount": 1 }, { "Name": "Shell", "Short Name": "battery.small", "Skin ID": 3568625656, "Drop Chance": 50, "Amount": 1 }, { "Name": "Pacifier", "Short Name": "battery.small", "Skin ID": 3568625225, "Drop Chance": 8, "Amount": 1 } ] } ] } API Hooks: I have added an API for integration with other plugins. Here’s what has been done: Added API Hooks: OnArtifactFound – Called before an artifact is given, allowing other plugins to cancel the drop. OnArtifactGiven – Called after an artifact has been given. OnFlagDestroyed – Called when a flag is destroyed. Added API Methods: RegisterArtifactHandler – Allows other plugins to register handlers for specific artifacts. UnregisterArtifactHandler – Allows unregistering a previously registered handler. OnArtifactFound(BasePlayer player, ArtifactConfig artifact) Called before an artifact is given, can be used to cancel the drop. OnArtifactGiven(BasePlayer player, ArtifactConfig artifact, Item item) Called after an artifact is granted to a player. OnFlagDestroyed(BasePlayer player, Vector3 position, DetectorConfig detector) Called when a metal detector flag is destroyed. Compatibility: Oxide/uMod. This plugin is actively being developed, with plans to make it more engaging and functional! This plugin works well in combination with other plugins that utilize custom item mechanics! (I will soon release a new plugin that will work alongside APDetectorArtifacts.)