Description

Works with Skill Tree

Skill Tree

Overview

• Luck Tracking: The plugin tracks each player’s luck, which can increase with the luck item use or decrease based on death if config is set to do so.
• Luck Items: Special items called “4 Leaf Clover” (Configurable) can be added to loot containers and collectables.
• These items affect the player’s luck positively when used.
• Loot Integration: Luck items can be configured to appear in various loot containers and collectable resources with specific probabilities.
• Minimum Luck Needed to even trigger a luck event can be set.
• Items loot table for loot containers or collectibles, can set a required min luck needed to even consider that item.
• You can set whatever prefab path you need, to provide items to get very specific with your loot table.

OPTIONAL UI DEMO / IMAGE LIBRARY REQUIRED

UI Demo

COMMANDS

Command: /checkluck

Description: Allows a player to check their current luck level.

Command: /checkplayerluck

Description: Allows players with luck.admin perm to check a certain players luck

Command: /resetplayerluck

Description: Allows players with luck.admin perm to reset a certain players luck

Command: /giveluckitems

Description: Allows an admin player to give themselves luck items.

Command: /resetallluck

Description: Allows an admin player to reset all player luck data via chat.

Command: resetallluck

Description: Allows an admin to reset all player luck data via Rcon.

CONFIG

{

“UI Config”: { “Enable UI”: true, “Image URL”: “https://www.dropbox.com/scl/fi/764qkv3764vn7tdcfh6zt/Clover.png?rlkey=1bdv2vqpn3jz5uydzsmq1xstq&st=28693fdf&dl=1” },

“Luck Item Settings”: {
“Luck Item Name”: “4 Leaf Clover”,
“Luck Item SkinID”: 3304398064,
“Add Item To Containers?”: true,
“Chance to add to Containers? (0-1)”: 1,
“Add Item To Collectables?”: true,
“Chance to add to Collectables? (0-1)”: 0.1,
“Min Amount to Add?”: 1,
“Max to Add?”: 2,
“Eligible Loot Containers”: [
“assets/bundled/prefabs/radtown/crate_elite.prefab”,
“assets/prefabs/npc/patrol helicopter/heli_crate.prefab”
],
“Eligible Collectables”: [
“assets/bundled/prefabs/autospawn/collectable/stone/sulfur-collectable.prefab”,
“assets/bundled/prefabs/autospawn/collectable/stone/metal-collectable.prefab”,
“assets/bundled/prefabs/autospawn/collectable/stone/stone-collectable.prefab”
]
},
“Notification Settings”: {
“Enable Notification on Luck Triggered?”: true,
“Found Effect Path”: “assets/prefabs/misc/easter/painted eggs/effects/eggpickup.prefab”,
“Enable Notification on Luck Added?”: true,
“Luck Added Effect Path”: “assets/bundled/prefabs/fx/item_unlock.prefab”,
“Enable Notification on Luck Lost?”: true,
“Luck Lost Effect Path”: “assets/prefabs/weapons/toolgun/effects/repairerror.prefab”
},
“Luck Settings”: {
“Max Luck”: 100,
“Lose Luck On Death?”: true,
“Amount of Luck Lost On Death?”: 5,
“Amount of Luck Gained On Item Use?”: 2,

“Award SkillTree XP on Successful Luck Trigger?”: true,

“Amount of XP awarded on Successful Luck Trigger”: 50
},
“Luck Buff Settings”: {
“Min Amount of Luck needed to find extra items?”: 30,
“Min Amount of Extra Items Found in Containers?”: 1,
“Max Amount of Extra Items Found in Containers?”: 5,
“Min Amount of Extra Items Found on Ground during Collectable Pickup?”: 1,
“Max Amount of Extra Items Found on Ground during Collectable Pickup?”: 3
},
“Container Loot Tables”: [
{
“Items”: [
{
“Shortname”: “rifle.ak”,
“SkinID”: 0,
“Eligible Loot Containers”: [
“assets/bundled/prefabs/radtown/crate_elite.prefab”,
“assets/prefabs/npc/patrol helicopter/heli_crate.prefab”
],
“Eligible Collectables”: null,
“Min Luck Needed for this Item”: 30,
“Probability (0-1)”: 0.1,
“Custom Name”: “Lucky Ak”,
“Minimum Amount”: 1,
“Maximum Amount”: 2
},
{
“Shortname”: “ammo.rifle”,
“SkinID”: 0,
“Eligible Loot Containers”: [
“assets/bundled/prefabs/radtown/crate_elite.prefab”,
“assets/prefabs/npc/patrol helicopter/heli_crate.prefab”
],
“Eligible Collectables”: null,
“Min Luck Needed for this Item”: 30,
“Probability (0-1)”: 0.2,
“Custom Name”: “Lucky Ammo”,
“Minimum Amount”: 10,
“Maximum Amount”: 30
}
]
}
],
“Collectable Loot Tables”: [
{
“Items”: [
{
“Shortname”: “wood”,
“SkinID”: 0,
“Eligible Loot Containers”: null,
“Eligible Collectables”: [
“assets/bundled/prefabs/autospawn/collectable/stone/sulfur-collectable.prefab”,
“assets/bundled/prefabs/autospawn/collectable/stone/metal-collectable.prefab”,
“assets/bundled/prefabs/autospawn/collectable/stone/stone-collectable.prefab”
],
“Min Luck Needed for this Item”: 30,
“Probability (0-1)”: 0.1,
“Custom Name”: “”,
“Minimum Amount”: 50,
“Maximum Amount”: 100
},
{
“Shortname”: “stones”,
“SkinID”: 0,
“Eligible Loot Containers”: null,
“Eligible Collectables”: [
“assets/bundled/prefabs/autospawn/collectable/stone/sulfur-collectable.prefab”,
“assets/bundled/prefabs/autospawn/collectable/stone/metal-collectable.prefab”,
“assets/bundled/prefabs/autospawn/collectable/stone/stone-collectable.prefab”
],
“Min Luck Needed for this Item”: 30,
“Probability (0-1)”: 0.1,
“Custom Name”: “”,
“Minimum Amount”: 20,
“Maximum Amount”: 50
}
]
}
]
}

LANG

{

“MAXLUCK”: “[<color=yellow>Luck</color>] You are at the maximum <color=yellow>Luck</color> cap of {0}.”,

“LUCKGAINED”: “[<color=yellow>Luck</color>] You have gained <color=yellow>{0}</color> <color=yellow>Luck</color> for a total of <color=yellow>{1}</color> <color=yellow>Luck</color>.”,

“LUCKLOST”: “[<color=yellow>Luck</color>] You have lost <color=yellow>{0}</color> <color=yellow>Luck</color> on death.”,

“CHECKLUCK”: “[<color=yellow>Luck</color>] Your total <color=yellow>Luck</color> is <color=yellow>{0}</color>.”

}