This plugin adds a progress bar ui that shows players when their next random gift is coming. The bar fills up over time, and the text updates to keep players informed. You can customize the time between gifts, items that can be received, and the effect that plays when gifts are given.
Permissions
randomgifts.use- Allows players to receive gifts.
Configuration
JSON:
{
"Version": "1.0.0",
"Time Between Gifts Seconds": 60.0,
"Gift Timer Ui Visibility Duration Seconds": 60.0,
"Gift Effect": "",
"Ui": {
"Text": "Next Random Gift",
"Text Color": "#ECD646",
"Progress Background Color": "#3A0D03",
"Progress Background Border Color": "#190503",
"Progress Fill Color": "#D23811"
},
"Gifts": [
{
"Weight": 1.0,
"Items": [
{
"Short Name": "minicrossbow",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 1,
"Maximum Amount": 1,
"Spawn As Blueprint": false
},
{
"Short Name": "arrow.wooden",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 4,
"Maximum Amount": 6,
"Spawn As Blueprint": false
}
]
},
{
"Weight": 1.0,
"Items": [
{
"Short Name": "ammo.rifle",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 12,
"Maximum Amount": 12,
"Spawn As Blueprint": false
},
{
"Short Name": "syringe.medical",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 1,
"Maximum Amount": 1,
"Spawn As Blueprint": false
},
{
"Short Name": "metalspring",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 1,
"Maximum Amount": 1,
"Spawn As Blueprint": false
}
]
},
{
"Weight": 1.0,
"Items": [
{
"Short Name": "ammo.pistol",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 30,
"Maximum Amount": 30,
"Spawn As Blueprint": false
},
{
"Short Name": "riflebody",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 1,
"Maximum Amount": 1,
"Spawn As Blueprint": false
}
]
},
{
"Weight": 1.0,
"Items": [
{
"Short Name": "ammo.pistol",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 15,
"Maximum Amount": 15,
"Spawn As Blueprint": false
},
{
"Short Name": "furnace.large",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 1,
"Maximum Amount": 1,
"Spawn As Blueprint": false
},
{
"Short Name": "syringe.medical",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 1,
"Maximum Amount": 1,
"Spawn As Blueprint": false
},
{
"Short Name": "metalpipe",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 1,
"Maximum Amount": 1,
"Spawn As Blueprint": false
}
]
},
{
"Weight": 1.0,
"Items": [
{
"Short Name": "ammo.rocket.mlrs",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 1,
"Maximum Amount": 1,
"Spawn As Blueprint": false
},
{
"Short Name": "scrap",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 25,
"Maximum Amount": 25,
"Spawn As Blueprint": false
},
{
"Short Name": "riflebody",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 1,
"Maximum Amount": 1,
"Spawn As Blueprint": false
},
{
"Short Name": "metalpipe",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 5,
"Maximum Amount": 5,
"Spawn As Blueprint": false
},
{
"Short Name": "smgbody",
"Display Name": null,
"Skin Id": 0,
"Minimum Amount": 1,
"Maximum Amount": 1,
"Spawn As Blueprint": false
}
]
}
]
}Time Between Gifts Seconds- Time interval between each random gift.Gift Timer Ui Visibility Duration Seconds- Determines how long the gift timer ui is shown before a gift is awarded. Set it equal toTime Between Gifts Secondsto display the timer for the full interval, a shorter value to show it only shortly before the gift is given, or 0 to hide the timer entirely.Gift Effect- Optional effect that plays when a player receives a gift.Ui- Ui settings for displaying the next gift timer.Text- Text displayed on the ui.Text Color- Color of the text.Progress Background Color- Background color of the progress bar.Progress Background Border Color- Border color of the progress bar.Progress Fill Color- Color of the progress bar fill.
Gifts- List of possible gift sets, each with a weight and list of items.Weight- Determines how likely a particular gift set is to be chosen compared to others. Higher values make a gift set more likely to be selected, while lower values decrease its chances.Items- A list of items included in the gift set.Short Name- The item's short name.Display Name- Optional custom name for the item.Skin Id- The skin id to use for the item.Minimum Amount- The minimum quantity given.Maximum Amount- The maximum quantity given.Spawn As Blueprint- Whether the item spawns as a blueprint.
