Search the Community

Introduction CustomRewards is a turnkey solution to reward player engagement. This plugin allows you to give a player any type of reward based on conditions you'll be able to configure. Whether you're a server admin aiming to boost player engagement or a developer creating complex reward systems, CustomRewards is your go-to solution. Main Features: Diversity of Rewards: Set up a huge variety of rewards for your players, ranging from items to special permissions, including server command execution. Reward Templates: Create different reward models for various events or scenarios, providing maximum flexibility to meet your server's needs. Award Conditions: Ensure only eligible players receive certain rewards by setting conditions based on groups, permissions, and more. Integration with Other Plugins: CustomRewards isn't just a standalone, it can also be seamlessly integrated with other externals plugins such as VoteSystem or PlaytimeTracker : Vote System : By using Custom Reward with VoteSystem, your players will be able to obtain rewards by voting. PlayTime Reward (free) : By using CustomRewards with PlaytimeTracker, your players will be able to obtain rewards based on their playtime. Interface Customization Provide your players with an appealing visual experience with a fully customizable user interface, custom reward images, and colorful themes. Expandability for Developers For those looking to delve deeper, CustomRewards offers a robust API, allowing you to integrate your own point system or even other plugins ! Plugin's Future: We always listen to the community! If you have a specific plugin you'd like to see integrated with CustomRewards, please let us know. Our goal is to make CustomRewards as versatile and useful as possible for all users. Support : I am very often available and will respond as quickly as possible to all your questions, here or on my Discord: https://discord.gg/JJnxFgP27G. Full Documentation : Feel free to check out the complete documentation here. Commands (chat) : - /CustomRewards_Give <type> <player name or id> <quantity> : available only for administrators or with permission CustomRewards.Admin - The commands to show the UI need to be implemented in the configuration. Permissions : - CustomRewards.Admin : enable admin commands if not administrator - CustomRewards.<Type>.Use : Permission linked to the type (rewards template), users without the permission will not be able to use the command to display the UI. Therefore, it's important to add the permission to your groups once the template is created! How To use API : private void Give_API(string rewardType, ulong playerId, int quantity) // Add quantity points for player (for referenced rewardType) private int Get_API(string rewardType, ulong playerId) // Get quantity points for player (for referenced rewardType) CustomRewards Configuration Tutorial Step 1: Initial Setup : - Ensure the CustomRewards_rewards folder is present in Oxide/Data. If not, the plugin will attempt to create it automatically, but it's good to check. - Ensure - For each reward type you want to configure, create a .json file in the CustomRewards_rewards folder. For instance, for a reward type called "VIP", you might have a VIP.json file. Step 2: Basic Configuration In your .json file: - "Enabled": Set this value to true to activate this reward type. - "Commands for show UI": List of commands that will display the user interface for this reward type. For example: ["rewards_vip", "vip_rewards"]. Step 3: User Interface Configuration Under "UI Settings": - Configure the appearance and layout of the user interface with properties like "Max Reward By Page", "Window Rect", etc. - Set the theme colors under "Theme" using properties like "Colors". Each color is defined by an RGBA value. - Configure rarity colors under "Rarity Colors". - To modify the window title or description (above the rewards), go through the lang files (Oxide/Lang/<lang>/CustomRewards_<type>). Example Lang file : { "Messages": { "Title": "Rewards", "Description": "Every time you earn points, you can claim your rewards here." } } Step 4: Reward Configuration Under "Rewards Settings": - "Rewards List": Here, you'll define each individual reward for this type. - "Rarity (Common - Rare - Epic - Legendary)": Set the reward's rarity. - "Quantity": If the reward is an item, set the quantity here. - "Item Shortname (optional)": If the reward is an item, set its short name here. - "Custom image URL (optional)": For a custom image for the reward. - "Server command (optional)": Commands to execute when this reward is claimed. - "Grant Permissions ": Permissions to grant when this reward is claimed. - "Grant Groups": Groups to grant when this reward is claimed. - "Nedded Permissions": Permissions needed to claim this reward. - "Nedded Group ": Groups needed to claim this reward. Step 5: Plugin Extensions Under PluginExtensions, you can configure integration with other plugins: - For PlaytimeTracker, use properties under "PlayTimeTracker" like "Count Afk Time?", "Added points", and "Add point every (in seconds)". Step 6: Save and Reload After completing your configuration, save the .json file and reload the plugin on your server. Here's a sample configuration file to help you get started:

Custom Advent Calendar allows you to customize advent callendar on your server. From 2.0.0 version you can fully customize your advent calendar rewards. Features SQL Support. Supports more daily rewards than one. Supports custom names, skins and random amounts of rewards. Player-based day counter. (Global still available in config) Support for command rewards. Configuration (Version 2.0.0) { "Count Rewards Per Player (true) or Count Rewards Per Day of Month (false)": true, "Enable Console Logs": true, "Use SQL Database": false, "SQL Credentials": { "IP": "127.0.0.1", "Port": 3306, "Database Name": "CustomAdventCalendarPro", "Username": "admin", "Password": "YourSuperSecretPassword" }, "Reward List": [ { "Max Daily Redeems": 1, "Cooldown (in minutes, works only if Max Daily Redeems more than 1)": 360, "Item Rewards": [ [ { "Command (Ignored if empty)": "", "Shortname": "metal.fragments", "Minimum Amount": 10000, "Maximum Amount": 10000, "Skin": 0, "Display Name": "" }, { "Command (Ignored if empty)": "", "Shortname": "wood", "Minimum Amount": 15000, "Maximum Amount": 15000, "Skin": 0, "Display Name": "" } ], [ { "Command (Ignored if empty)": "", "Shortname": "stones", "Minimum Amount": 10000, "Maximum Amount": 10000, "Skin": 0, "Display Name": "" }, { "Command (Ignored if empty)": "", "Shortname": "sulfur", "Minimum Amount": 10000, "Maximum Amount": 15000, "Skin": 0, "Display Name": "" } ] ] }, { "Max Daily Redeems": 1, "Cooldown (in minutes, works only if Max Daily Redeems more than 1)": 0, "Item Rewards": [ [ { "Command (Ignored if empty)": "oxide.grant user {userId} permission.here", "Shortname": "", "Minimum Amount": 1, "Maximum Amount": 1, "Skin": 0, "Display Name": "" }, { "Command (Ignored if empty)": "say Player {userName} redeemed an reward!", "Shortname": "", "Minimum Amount": 1, "Maximum Amount": 1, "Skin": 0, "Display Name": "" } ] ] }, { "Max Daily Redeems": 1, "Cooldown (in minutes, works only if Max Daily Redeems more than 1)": 0, "Item Rewards": [ [ { "Command (Ignored if empty)": "", "Shortname": "box.repair.bench", "Minimum Amount": 1, "Maximum Amount": 1, "Skin": 2795785961, "Display Name": "Recycler" } ] ] } ] }

Reward Gifts is a playtime gift reward system that utilizes a UI for delivery and administration for daily gifts. Easy to use, easy to create, add or delete rewards. ** Requires Image Library installed on server. ** Features No AFK Mode, so players can't try and trick the system to claim gifts for playtime, if they are AFK, the clock stops for them till they resume playing. Support for Server Rewards and Economics as gifts that can be added. Reward Gift Icon on the bottom left side of the screen (pre-programmed location) Enabled by default can be disabled in the config file. Data Files for both the Reward Gifts and Player Data Auto Reset timers in Days for players. Default is set to 1 day to reset the player play time. 90% Complete Customization of the UI Interface Theme thru the config file. Complete UI Reward Gift Claim Menu System. Once a player has played during a set amount of time, that defined reward gift can be claimed. Complete UI Admin Creation Tool for adding or removing reward gifts thru the UI System. Ability for Admins/Owners to add their own Logo to the Top of the UI System for more complete Customization feel. Option to have Sound Effect on redeeming rewards Option to have popup notification on redeeming rewards Commands /gifts - Chat command to call the Reward Gifts System Claim Menu (If enabled Gift Icon Button will do the same) /giftswipe - For admins only, this will wipe and reset all player data Permissions rewardgifts.admin - For admins to be able to administrate the Rewards rewardgifts.vip - If you want to allow VIP reward gifts as well, players will need a VIP permission in order to claim special VIP Gifts Configuration Thru the config file admin can almost completely customize the look and feel for coloring the theme of the system itself. Localization

Simple plugin that will spawn a gift for your players when a npc is killed player cooldown can be configured to suit your server chance of the gift to be spawn can be configured per each gift each gift can be enabled/disabled in the config default config is set up with 3 Christmas themed gifts, but you can change these to your liking or add more Personalised message to the player when the gift is spawned, supports 2 placeholders {player.name} & {server.name} Unlooted gifts will despawn after 5 minutes or on plugin unload DEFAULT CONFIG { "ContainerReceivedMessage": " :santahat: Merry Christmas <color=#4A95CC>{player.name}</color> from <color=#4A95CC>{server.name}</color> :santahat:", "Containers": [ { "IsEnabled": true, "Permission": "npcgifts.example1", "Prefab": "assets/prefabs/misc/xmas/sleigh/presentdrop.prefab", "SpawnChance": 0.5 }, { "IsEnabled": true, "Permission": "npcgifts.example2", "Prefab": "assets/prefabs/missions/portal/proceduraldungeon/xmastunnels/loot/xmastunnellootbox.prefab", "SpawnChance": 0.5 }, { "IsEnabled": true, "Permission": "npcgifts.example3", "Prefab": "assets/prefabs/misc/xmas/giftbox/giftbox_loot.prefab", "SpawnChance": 0.5 } ], "CooldownDurationMinutes": 60.0 }

Features: Adds behavioral points for each player. The player gains or loses his behavior points for various actions (configurable in the config). Santa will cyclically give gifts to the player (the interval is configured in the config). The gift, as well as its content, depends on the behavior of the player. (All of the above is configured in the config). The plugin has a standard, playable configuration. Config: { "Command for open UI": "gifts", "SteamID for icon in chat messages": 0, "The interval for giving out gifts from Santa.(In seconds)": 86400, "Behaviors": [ { "The minimum number of behavior points to achieve this behavior": 0, "Name of behavior": "<color=red>UNSATISFACTORY</color>", "List of gifts for this behavior with random drop chance": [ { "Behavior name": "COMMON GIFT", "Minimum number of items to be given out": 1, "Maximum number of items to be given out": 2, "Item list": [ { "Shortname": "coal", "Amount": 1, "SkinID": 0 }, { "Shortname": "coal", "Amount": 1, "SkinID": 0 }, { "Shortname": "coal", "Amount": 1, "SkinID": 0 }, { "Shortname": "giantcandycanedecor", "Amount": 1, "SkinID": 0 } ] }, { "Behavior name": "UNCOMMON GIFT", "Minimum number of items to be given out": 2, "Maximum number of items to be given out": 3, "Item list": [ { "Shortname": "coal", "Amount": 1000, "SkinID": 0 }, { "Shortname": "coal", "Amount": 1000, "SkinID": 0 }, { "Shortname": "sulfur", "Amount": 1000, "SkinID": 0 }, { "Shortname": "metal.fragments", "Amount": 1000, "SkinID": 0 }, { "Shortname": "shotgun.waterpipe", "Amount": 1, "SkinID": 0 }, { "Shortname": "ladder.wooden.wall", "Amount": 1, "SkinID": 0 }, { "Shortname": "candycaneclub", "Amount": 1, "SkinID": 0 }, { "Shortname": "bow.compound", "Amount": 1, "SkinID": 0 }, { "Shortname": "door.double.hinged.metal", "Amount": 1, "SkinID": 0 } ] } ] }, { "The minimum number of behavior points to achieve this behavior": 500, "Name of behavior": "<color=yellow>SATISFACTORY</color>", "List of gifts for this behavior with random drop chance": [ { "Behavior name": "RARE GIFT", "Minimum number of items to be given out": 3, "Maximum number of items to be given out": 4, "Item list": [ { "Shortname": "scrap", "Amount": 200, "SkinID": 0 }, { "Shortname": "metal.fragments", "Amount": 1000, "SkinID": 0 }, { "Shortname": "gunpowder", "Amount": 500, "SkinID": 0 }, { "Shortname": "metalpipe", "Amount": 5, "SkinID": 0 }, { "Shortname": "riflebody", "Amount": 1, "SkinID": 0 }, { "Shortname": "smgbody", "Amount": 1, "SkinID": 0 }, { "Shortname": "pistol.m92", "Amount": 1, "SkinID": 0 }, { "Shortname": "grenade.f1", "Amount": 4, "SkinID": 0 }, { "Shortname": "jackhammer", "Amount": 1, "SkinID": 0 }, { "Shortname": "ammo.pistol", "Amount": 100, "SkinID": 0 } ] }, { "Behavior name": "EPIC GIFT", "Minimum number of items to be given out": 3, "Maximum number of items to be given out": 4, "Item list": [ { "Shortname": "scrap", "Amount": 500, "SkinID": 0 }, { "Shortname": "lowgradefuel", "Amount": 300, "SkinID": 0 }, { "Shortname": "metal.refined", "Amount": 100, "SkinID": 0 }, { "Shortname": "ammo.pistol", "Amount": 100, "SkinID": 0 }, { "Shortname": "ammo.pistol", "Amount": 28, "SkinID": 0 }, { "Shortname": "workbench2", "Amount": 1, "SkinID": 0 }, { "Shortname": "explosive.satchel", "Amount": 4, "SkinID": 0 }, { "Shortname": "smg.thompson", "Amount": 1, "SkinID": 0 }, { "Shortname": "oretea.advanced", "Amount": 3, "SkinID": 0 }, { "Shortname": "wall.frame.garagedoor", "Amount": 1, "SkinID": 0 }, { "Shortname": "supply.signal", "Amount": 100, "SkinID": 0 } ] } ] }, { "The minimum number of behavior points to achieve this behavior": 1000, "Name of behavior": "<color=green>SANTA'S FAVORITE</color>", "List of gifts for this behavior with random drop chance": [ { "Behavior name": "LEGENDARY GIFT", "Minimum number of items to be given out": 2, "Maximum number of items to be given out": 3, "Item list": [ { "Shortname": "ammo.rifle", "Amount": 100, "SkinID": 0 }, { "Shortname": "ammo.rifle", "Amount": 28, "SkinID": 0 }, { "Shortname": "ammo.rifle.explosive", "Amount": 100, "SkinID": 0 }, { "Shortname": "ammo.rifle.explosive", "Amount": 28, "SkinID": 0 }, { "Shortname": "hazmatsuit", "Amount": 1, "SkinID": 0 }, { "Shortname": "easter.silveregg", "Amount": 1, "SkinID": 0 }, { "Shortname": "door.hinged.toptier", "Amount": 1, "SkinID": 0 }, { "Shortname": "door.hinged.toptier", "Amount": 1, "SkinID": 0 }, { "Shortname": "metal.refined", "Amount": 100, "SkinID": 0 }, { "Shortname": "rifle.lr300", "Amount": 1, "SkinID": 0 }, { "Shortname": "workbench3", "Amount": 1, "SkinID": 0 }, { "Shortname": "syringe.medical", "Amount": 2, "SkinID": 0 }, { "Shortname": "gunpowder", "Amount": 1000, "SkinID": 0 }, { "Shortname": "gunpowder", "Amount": 1000, "SkinID": 0 }, { "Shortname": "gunpowder", "Amount": 1000, "SkinID": 0 }, { "Shortname": "gunpowder", "Amount": 1000, "SkinID": 0 } ] }, { "Behavior name": "SUPERIOR GIFT", "Minimum number of items to be given out": 2, "Maximum number of items to be given out": 3, "Item list": [ { "Shortname": "scrap", "Amount": 1000, "SkinID": 0 }, { "Shortname": "explosives", "Amount": 100, "SkinID": 0 }, { "Shortname": "explosive.timed", "Amount": 2, "SkinID": 0 }, { "Shortname": "jackhammer", "Amount": 1, "SkinID": 0 }, { "Shortname": "chainsaw", "Amount": 1, "SkinID": 0 }, { "Shortname": "metal.refined", "Amount": 100, "SkinID": 0 }, { "Shortname": "lmg.m249", "Amount": 1, "SkinID": 0 }, { "Shortname": "weapon.mod.small.scope", "Amount": 1, "SkinID": 0 }, { "Shortname": "weapon.mod.silencer", "Amount": 1, "SkinID": 0 }, { "Shortname": "weapon.mod.lasersight", "Amount": 1, "SkinID": 0 }, { "Shortname": "metal.facemask", "Amount": 1, "SkinID": 0 }, { "Shortname": "metal.plate.torso", "Amount": 1, "SkinID": 0 } ] } ] } ], "Behaivor Points per player kill": 20.0, "Behaivor Points per NPC kill": 20.0, "Behavior points per chat message": 0.1, "Behavior Points for Learning a Recipe": 1.5, "Behavior points per broken stone/ore/wood/corpse": 4.0, "The interval for giving the player 1 behavior point for being on the server": 300, "Behavior score for object destruction": { "assets/bundled/prefabs/autospawn/resource/loot/loot-barrel-1.prefab": 0.5, "assets/bundled/prefabs/autospawn/resource/loot/loot-barrel-2.prefab": 0.5, "assets/bundled/prefabs/radtown/loot_barrel_1.prefab": 1.0, "assets/bundled/prefabs/radtown/loot_barrel_2.prefab": 0.5, "assets/bundled/prefabs/radtown/oil_barrel.prefab": 1.0, "assets/rust.ai/agents/bear/bear.prefab": 1.0, "assets/rust.ai/agents/boar/boar.prefab": 1.0, "assets/rust.ai/agents/stag/stag.prefab": 1.0, "assets/rust.ai/agents/stag/wolf.prefab": 1.0 }, "Behavior points for the presence of certain words in the chat": { "dick": -0.5, "bitch": -0.5, "fuck": -1.0, "prick": -0.5, "bastard": -1.0, "bellend ": -0.5, "cunt": -0.5, "balls": -0.5, "shit": -1.0, "fucker": -0.5, "asshole": -1.0, "slave": -5.0, "nigger": -5.0, "best server": 5.0, "sorry": 1.0, "good": 0.5, "well done": 1.0, "cool": 0.5, "pretty": 0.5, "cute": 0.5 } } Lang: { "CM_TAKEGIFT": "Received a {0} gift from Santa", "UI_BEHAVIOR": "YOUR BEHAVIOR " }