Artifacts 1.0.1

Plugin add artifacts with passive and active abilities

 PROMO

FEATURES

• 25+ passive and 5+ 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
• 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)

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)

"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

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

"Flora" - Everything starts to grow around you
Work with radius around player

PERMISSIONS ABILITIES

You can add permissions to artifact
Permissons 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

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

INFO VIDEO