The Offering

$29.99

Sold by: Wrecks

The Offering – Get your Entire Server to Grind towards a Common Goal.

Categories: , ,

Description

Get your Entire Server to Grind towards a Common Goal.

With The Offering, Set Item Requirement amounts, either custom or vanilla.

REQUIRED FOR UI – IMAGELIBRARY

REQUIRED FOR MAPMARKER – MARKERMANAGER

Top Contributors can now be rewarded via Commands in Config.

What will you reward your Players with?

Skill Points? Unload TruePVE and let a purge play out? Or just run a command for Economics deposit and fill everyone’s account to congratulate everyone’s hard work.

At Offering Fulfilled you can run as many commands as you like to reward your Players.

You can also Utilize The Offering to get rid of excess items. Maybe Players have too much scrap at the end of the wipe, add scrap as a requirement and let the excess scrap serve a purpose.

Upon Valid Item Deposit, The Box shoots a flame and accepts The Offering, Invalid Items get tossed back out of the Box for the player to recollect.

Players can utilize an optional UI to track resources that are needed towards completion.

It can be toggled on via /OUI or disabled by clicking the x on the UI Tab.

UI position can be easily set via UI Location Config Option.

Update interval for multiple item requirements can be set, to update the UI to show the other unfulfilled items.

If there is a placeholder image and it doesn’t retrieve, you can use the custom URL for a PNG as well. This is also useful for custom items.

Skin for the box can be set in config.

Discord Tracking of the Offering Box Status can be set in config.

If an Offering is complete, you have the option to respawn the box at a certain time frame, or disable the respawn completely and have it a one off event, or an event whenever you feel like holding it.

 

MULTIPLIER INFORMATION

Default Multiplier in config can be used to quick modify your requirement amounts.

You can have this dynamically increase on Offering Completions by enabling this option.

Default Multiplier of 1 is a 1:1 of your current requirements.

If you increment by .5, Your multiplier becomes 1.5 on the next offering.

Keep in mind giving items with 1 value, you can’t issue half of an AK.

Requirements will round up or down depending on the amount when the math is done.

Max Multiplier will never be passed, and will always reset to this value upon it being hit.

A multiplier can dynamically effect your Global Commands and Top Contributor Rewards.

Use {x} to modify the amount, for example – a command for economics. “deposit * 1000{x}”

Use {x}{d} or {x}{u} to round a decimal value if needed. Some commands will not parse a float.

This will multiply that integer value by your current multiplier, More info can be seen in default config below.

This can also be used in your Rewards Description field, if you want to say, Everyone will get 100{x} SP.

Multiplier does not apply towards Rush Mode.

Multiplier Demonstration

 

The Offering The Offering

Rush Mode Info

Rush is an optional mode, it uses separate reward methods and requirements for a condensed version of The Offering for small events.

The player with the highest score (If point mode is on) Or Deposits.

Will win x Commands you issue.

If the plugin unloads an early end will trigger and issue commands to the winners you specify in config.

If the plugin is unloading during a server reboot, the plugin will save those commands to run on next boot due to some plugins being unloaded, by the time The Offering is unloaded.

The Item Amount in the Rush Requirement is a field you can ignore. Since highest deposits are what counts, item deposits are unlimited.

If discord logging is enabled, it will log your top contributors, and will also notify if an event ended during a shutdown.

NEW COMMANDS FOR RUSH MODE ARE FOUND BELOW IN THE COMMANDS SECTION

Video Demos

 

 

 

 

The Offering The Offering

 

https://youtube.com/clip/Ugkxz8_UG6AqGRZSrwF5JVippAvCPIgWfIHs?si=IKL6D46gwn5MHDrw

 

The Offering The Offering

 

COMMANDS

CONSOLE COMMAND – RESETMULTIPLIER – RESETS YOUR MULTIPLIER TO YOUR DEFAULT VALUE

/OUI – Toggles the UI on or off

/beginoffering – console or chat, To start an offering if one isnt pending respawn, or if one isnt ongoing in the world, only Works with Dynamic Spawn.

/ConvertToOffering – Allows you to convert an already placed Large Wooden Box, To an Offering Box – THEOFFERING.ADMIN – PERMISSION REQUIRED

/RemoveOffering – Removes The Offering Box you are looking at – THEOFFERING.ADMIN – PERMISSION REQUIRED

/givebox – Gives the player a placeable box that will convert to an offering box on placement – THEOFFERING.ADMIN – PERMISSION REQUIRED

/offeringstatus – Will print the offering status to the executing player

/offeringtop – Will print the top offering contributors to the executing player

/giveofferingitems – Will Send all your offering items to your inventory – admin

/myofferingstats – Will show the players current standings if any.

/offeringleaderboard – Will show the top standings via UI,, with different banner text depending on point mode or regular mode.

/rush on – Will reload the plugin with rush enabled, use beginoffering or place a box if you don’t have a dynamic pos enabled.

/rush off- Will reload with regular offering mode enabled

NOTE – IF RUSH ON / OFF IS RAN WHILE IT IS IN THAT MODE, IT WONT SWAP MODES

/offeringwhere – If an offering is active, it will ping the location to the player.

HOOKS

OnOfferingActive – Void

OnOfferingInactive – Void

OnOfferingSatisfiedReturns a StorageContainer to run custom code at container at end.

OnOfferingRushModeStartedVoid

OnOfferingRushModeEndedVoid

Support for ServerPanel by Mevent – To Set up – Type – “Plugin” – Hook – “OpenOfferingLeaderboard”

CONFIG

{
  "Box Options": {
    "Enable Incrementing Requirements on Regular Offering Completions?": true,
    "Starting Multiplier - Default 1 - This Value is used even if Increment Requirements is Disabled, it can be used to Quick Increase each needed Item totals": 1.0,
    "Increase Multiplier by This Value on Completion, A Starting Multiplier of 1 Incremented by 0.5 will be a 1.5 multiplier resulting in a 50% Requirement Increase": 0.5,
    "Maximum Offering Multiplier to Reach by Incrementing": 5.5,
    "Allow Multiplier to Multiply Global Commands? (Int Value must be followed with {x} - Ex:10{x})": true,
    "Allow Multiplier to Multiply Top Contributor Commands? (Int Value must be followed with {x} - Ex:10{x})": true,
    "Enable UI on Offering Box Open?": true,
    "Path for Image on Offering Box Opened": "https://www.dropbox.com/scl/fi/2zkykpsa05q2nn9xfhxlg/OfferingBox.png?rlkey=dmmropc8u5x2wqo1ot7ad00l1&st=qldojnor&dl=1",
    "Enable Effect on Box Open?": true,
    "Path for Effect on Offering Box Opened": "assets/content/vehicles/attackhelicopter/effects/pfx_flares_attackhelicopter.prefab",
    "Enable Point Mode for Leaderboard?": false,
    "Enable The Offering Rush Mode? (This mode does not Data Track, Is meant for quick, Contribution Competitions)": false,
    "Rush Mode Duration?": 600,
    "Dynamic Spawn Of The Box Enabled?": false,
    "Dynamic Spawn at this Monument (Requires your Position Input to be set to match Monument if Changing from Default.)": "assets/bundled/prefabs/autospawn/monument/medium/compound.prefab",
    "Dynamic Spawn Point (Relative to Monument)": {
      "x": -18.17,
      "y": 0.42,
      "z": 20.64
    },
    "Dynamic Spawn Rotation Correction": 90.0,
    "Offering Box Skin Id": 1900496901,
    "Placeholder SkinID for /givebox Command, Box Reverts to the above skin on placement.": 3174587477,
    "Respawn Offering Box a Few Seconds after Previous Box Completion?": true,
    "Respawn Delay in Seconds": 10,
    "Clear Data on Wipe?": false
  },
  "Rush Mode Options": {
    "Item Requirements": [
      {
        "Item Shortname": "blood",
        "Amount Of This Item Required": 0,
        "Point Value": 1,
        "Custom SkinID": 0,
        "Item Custom Name": "",
        "Item Image URL (For UI)": ""
      },
      {
        "Item Shortname": "sticks",
        "Amount Of This Item Required": 0,
        "Point Value": 1,
        "Custom SkinID": 0,
        "Item Custom Name": "",
        "Item Image URL (For UI)": ""
      }
    ],
    "Contributor Rewards": [
      {
        "Rank Rewards (1 for 1st place, 2 for 2nd, etc.)": 1,
        "Commands to Run for this Contributor": [
          "inventory.giveto {id} rifle.ak 1"
        ]
      },
      {
        "Rank Rewards (1 for 1st place, 2 for 2nd, etc.)": 2,
        "Commands to Run for this Contributor": [
          "inventory.giveto {id} rifle.ak 1"
        ]
      },
      {
        "Rank Rewards (1 for 1st place, 2 for 2nd, etc.)": 3,
        "Commands to Run for this Contributor": [
          "inventory.giveto {id} rifle.ak 1"
        ]
      }
    ],
    "Rush Mode Rewards Description": "Top Players Will Receive x Commands Upon Offering Rush Win"
  },
  "Items Needed For Fulfillment Message Cooldown Time in Seconds?": 30,
  "Items Added to Box Message Cooldown Time in Seconds?": 5,
  "Item Fulfilled Message Cooldown Time in Seconds?": 30,
  "Enable UI?": true,
  "UI Location (top right, lower top right, bottom right, top left, lower top left, bottom left": "lower top right",
  "UI Update Interval In Seconds": 30,
  "Announcement Interval In Seconds": 600,
  "Use Announcement FX?": false,
  "Broadcast Updates on Status To Discord?": false,
  "Broadcast Top Contributors To Chat?": false,
  "Amount of Players to Announce on Top Contributors?": 5,
  "Discord Webhook URL?": "",
  "Item Requirements": [
    {
      "Item Shortname": "blood",
      "Amount Of This Item Required": 100,
      "Point Value": 1,
      "Custom SkinID": 0,
      "Item Custom Name": "",
      "Item Image URL (For UI)": ""
    },
    {
      "Item Shortname": "sticks",
      "Amount Of This Item Required": 100,
      "Point Value": 1,
      "Custom SkinID": 0,
      "Item Custom Name": "",
      "Item Image URL (For UI)": ""
    }
  ],
  "Commands To Run On Offering Satisfied": {
    "Commands List": [
      "say The offering has been satisfied!",
      "say Another command goes here",
      "say Yet another command",
      "here you can unload TruePve",
      "say The Current Offering Multiplier is 1{x}",
      "say depositing 1000{x} to all",
      "deposit * 1000{x}"
    ]
  },
  "Rewards Description": "The server will award 1000{x} XP Upon Offering Satisfied",
  "Enable Top Contributor Rewards?": true,
  "Top Contributor Rewards": [
    {
      "Rank Rewards (1 for 1st place, 2 for 2nd, etc.)": 1,
      "Commands to Run for this Contributor": [
        "inventory.giveto {id} sulfur 10{x}"
      ]
    },
    {
      "Rank Rewards (1 for 1st place, 2 for 2nd, etc.)": 2,
      "Commands to Run for this Contributor": [
        "inventory.giveto {id} rifle.ak 1{x}"
      ]
    },
    {
      "Rank Rewards (1 for 1st place, 2 for 2nd, etc.)": 3,
      "Commands to Run for this Contributor": [
        "inventory.giveto {id} rifle.ak 1{x}"
      ]
    },
    {
      "Rank Rewards (1 for 1st place, 2 for 2nd, etc.)": 4,
      "Commands to Run for this Contributor": [
        "say Add More Like Me!",
        "say You can Run Multiple Commands!",
        "say Target players id with {id}",
        "say you can use 1{x} to multiply your reward by your multiplier"
      ]
    }
  ]
}

The Offering The Offering

 

 

Thank you to @Chill Roleplay for the help testing.

1 review for The Offering

  1. 5 out of 5

    lovepeaceanrust (verified owner)

    Love Plugins Made By wrecks offers Great Support!!.An this plugin is amazing its a server event plugin kept nice an discreet where the server has to work together to donate items that when filled you can make it call unlimited commands so the reward is endless you can do so much with this plugin and offers a rare type of game play a lot of plugins don’t do and that’s teamwork of the server!!!!
    10\10 Would Recommend!!!


Only logged in customers who have purchased this product may leave a review.

Version 1.2.81 | Updated March 27, 2025
  • Fixed Corrected Check to compensate for Multiplier on load.
Version 1.2.8 | Updated March 27, 2025
  • Fixed Error OnServerInitialized when using Rush Mode.
Version 1.2.7 | Updated March 26, 2025
  • Updated Various Fixes & Safety Checks. Added /OfferingWhere Command, Will Send a ping to the player who executes to locate the Offering Box Location.
Version 1.2.6 | Updated March 14, 2025
  • Updated Fixed initial announcement on load to pull values from what is remaining and not what was needed initially. Kill Offering Box a little earlier since It was sticking around until commands ran from the last refactor. Added a rounding option for commands that need an int value instead of a float. Use {x} to multiply your values normally, use {x}{u} to round up and {x}{d} to round down.
Version 1.2.5 | Updated March 8, 2025
  • Updated More null checks onlootentityend.
Version 1.2.4 | Updated March 3, 2025
  • Fixed global commands & Offering Complete being run inside the top contributors check.
Version 1.2.3 | Updated February 27, 2025
  • Updated Added a Multiplier to the config - Default is 1, allowing quick scaling of offering requirements without using the Increment feature. Added an Increment Enabler - When enabled, completing an offering increases the next offering’s multiplier by a set amount. Added Increment Amount - Ex - If the default multiplier is 1 and the increment is set to 0.5, the next offering multiplier becomes 1.5 (a 50% increase in requirements). Added Max Multiplier - Will prevent the multiplier from exceeding a specified maximum, resetting to the max value when reached. Multiplier will reset on wipe if wipe data is enabled. Added Console Command - resetmultiplier Resets the multiplier to your default value, requires admin permission. Added Config Options - Enables multiplier modifier to command values. Can be toggled for both Global and Top Contributor commands. Command Multiplier Ex - Allows reward commands like `deposit * 100{x}` to scale with the current multiplier, use the modifier to increase your amount values to match with multipliers. {x} modifier dynamically adjusts rewards in the Rewards Description field if used there and applies to global and top contributor commands if used beside a value. Added a safeguard to prevent the multiplier from incrementing if the plugin is unloaded before processing. Multiplier modifier does not apply towards rush mode. See Default config for modifier use. Added a video demo in description. Added a Multiplier Info Section in Description
Version 1.2.2 | Updated February 19, 2025
  • Updated Moved Leaderboard Banners and Announcements to Lang.
Version 1.2.1 | Updated February 15, 2025
  • Updated Tweaked effect pos to be consistent with position the player opens the box if using a visual effect. Added Discord Message of Top Contributors on Regular Offering Completion Similar to Rush Mode.
Version 1.2.0 | Updated February 11, 2025
  • Added Added new box options to config. Added option to show a custom UI on offering box open. Added option to insert your own image path. Added option to play an effect in front of the player, opening the box. Added option to insert your own effect path.
Version 1.1.9 | Updated February 11, 2025
  • Fixed Don't Show UI for rush mode on player connect if rush mode is on but not active.
Version 1.1.8 | Updated February 5, 2025
  • Added Adds The Offering Rush Mode Adds Config Option to Toggle this mode on, or use /rush on | off to toggle this mode. Data does not track in rush mode on, rush mode is meant for quick competition between players to see who can deposit the most of x items. Added Rush Mode Requirement Fields, Amount can be ignored as items needed are as much as the player can deposit, these items are a different requirement list than the standard offering requirements. Added Rush Mode Duration config option. Added Rush Mode Command Rewards, Enter as many ranks as you like, reward top players with commands. Added hook OnOfferingSatisfied - Returns a StorageContainer to run custom code at container at end. Added hook OnOfferingRushModeStarted - No return behavior. Added hook OnOfferingRushModeEnded - No return behavior. Rush Mode offerings can be started via beginoffering when rush mode is set to true, this works in chat or console. Regular offerings can be started this way too if Rush is off. Added Console and Chat command - endrush, this will end a rush mode event and reward contributors. If the plugin is unloaded/reloaded while rush mode is active, it will end the rush mode event and reward contributors. If the server is restarting and the rush event is ongoing, players are usually kicked before the plugin will unload. The plugin will check if the server is restarting, if the server is restarting, the commands will be ran at the next reboot. Example - Due to some plugins like economics will be unloaded before the command can be ran to issue that reward. Players steamid is still targeted with {id} in rush mode, ex - deposit {id} 1000 - for an eco deposit. Added Discord Log of rush mode winner, with a version for winners with an early end during shutdown.
Version 1.1.71 | Updated February 2, 2025
  • Fixed Added list pooling in a few areas. Added config option to enable "Points Mode", Some items can be worth more points than others, enabling better competition between players where offerings have easier to obtain items, use on a fresh offering for accuracy. Added points field to item requirements - Default is 1. Added chat command - /myofferingstats - Will show the players current standings if any. Added new lang keys for Points Mode on announcements, stat checking and item contribution. Added chat command - /offeringleaderboard - will show the top standings via UI, with different banner text depending on point mode or regular mode. Added support for ServerPanel by Mevent - To Set up - Type - "Plugin" - Hook - "OpenOfferingLeaderboard" HOTFIX - CORRECTED ITEM CALCULATION IF WHOLE STACK IS ADDED WHEN USING POINT MODE HOTFIX - CORRECTED TOP CONTRIBUTOR MESSAGE AT END OF OFFERING TO SHOW TOP POINT SCORER IF USING POINT MODE
Version 1.1.7 | Updated February 2, 2025
  • Updated Added list pooling in a few areas. Added config option to enable "Points Mode", Some items can be worth more points than others, enabling better competition between players where offerings have easier to obtain items, use on a fresh offering for accuracy. Added points field to item requirements - Default is 1. Added chat command - /myofferingstats - Will show the players current standings if any. Added new lang keys for Points Mode on announcements, stat checking and item contribution. Added chat command - /offeringleaderboard - will show the top standings, with different banner text depending on point mode or regular mode. Added support for ServerPanel by Mevent - To Set up - Type - "Plugin" - Hook - "OpenOfferingLeaderboard"
Version 1.1.6 | Updated December 12, 2024
  • Added Added config option to disable announcement Fx.
  • Fixed Minor Tweaks for repeated code.
Version 1.1.5 | Updated November 24, 2024
  • Fixed Top Contributor Calculation Correction.
Version 1.1.4 | Updated November 6, 2024
  • Updated Fixed Offering Top Contributor Rewards to issue to awake or sleeping by id.
Version 1.1.3 | Updated October 31, 2024
  • Updated ***USE ONLY ON A CLEAN OFFERING DATA FILE AS THE STRUCTURE HAS CHANGED / DO NOT USE ON AN ACTIVE OFFERING*** Removed Holiday Entities Various fixes Added Support for Multiple Items of the same shortname but different Skins. Removed Some Hook usage. Added Top Contributor Config Option Added Top Contributor Commands, Apply as many ranks and commands as you need per rank, target the player with {id}
Version 1.1.2 | Updated October 16, 2024
  • Updated OPTIONAL HALLOWEEN UPDATE - WILL SPAWN A CANDLESET, JACKOLANTERNS, AND A POOKIE ON BOX SPAWN.
Version 1.1.1 | Updated October 15, 2024
  • Updated Added Commands beginoffering for chat and console for authed players, To start an offering if one isn't pending respawn, or if one isn't ongoing in the world, only Works with Dynamic Spawn. Added Option to Enable Dynamic Spawns at a Preset Monument. Set your Coords Relative to The monument you choose. Custom URL is no longer needed for SkinID items unless you want to replace it with something other than what the SkinID shows for whatever reason.
Version 1.1.0 | Updated August 9, 2024
  • Fixed Made change to UI update not updating sometimes when toggled.
  • Updated Cleaned up code.
Version 1.0.9 | Updated July 1, 2024
  • Updated Improvements / Minor Fixes.
Version 1.0.8 | Updated May 26, 2024
  • Added Pending Offering Box Respawn Check on Unload.
Version 1.0.7 | Updated May 20, 2024
  • Added OnOfferingActive, OnOfferingInactive Hooks.
Version 1.0.6 | Updated March 10, 2024
  • Updated Added /offeringtop & /offeringstatus commands for individual players to check status.
Version 1.0.5 | Updated March 7, 2024
  • Updated Added Top Contributors to Announcement, Added /givebox command to create a box that will convert on placement. Adds various config options pertaining to these additions as well.
Version 1.0.4 | Updated February 25, 2024
  • Updated Added The Offering is fulfilled message output to Discord. Added Config Option to Clear Data on Wipe.
Version 1.0.31 | Updated February 21, 2024
  • Fixed Hotfix For null data.
Version 1.0.3 | Updated February 21, 2024
  • Updated Adds Lang For Customization.
Version 1.0.2 | Updated February 20, 2024
  • Updated Fixes Rotation on box Respawn, added check for box decay, added check for duped boxes to be destroyed.
Version 1.0.1 | Updated February 19, 2024
  • Updated Adds 3 Cooldown Config Options for Messages regarding to box progress.
Version 1.0.0 | Updated February 19, 2024
  • Added Initial Release.

2 thoughts on "The Offering"

Leave a reply

Your email address will not be published. Required fields are marked *

  1. How would one go about setting this in a particular monument and just having it respawn in said monument each wipe?

    Example being I want this to auto spawn in outpost each wipe

    • Hey this isnt a feature right now, but I can def look into doing it in the future when I get a chance.

      As it is right now, its just box conversion via command or placing the skinned offering box.

Plugin FAQ – How do I use this .zip/.7z file I just purchased on my server?

• First, you want to unzip the file. You can do so by just double-clicking it to open, then drag the contents to the desired location (you may need to install an external unzipping software if you don’t already have one such as 7zip or winrar)
• Next you will find either a structure of folders or just the .cs file itself (it’s the actual plugin file itself).
• After that just install the .cs (plugin file) into your …/oxide/plugins/ folder where you will install plugins you ever need to.

Additionally, here’s a great video that easily covers adding a plugin to your server if you need! https://youtu.be/yWC_p97FhQA

• Installation is not included with any products on the site, however, if needed we may assist if you reach out to our support.

Currently all products on Lone.Design will be contained within a zipped file which is the .7z or .zip that you see. I believe windows 10 and up can unzip on its own without 3rd party tools, but in that case, if you’re unfamiliar with zipped files here are 2 programs I recommend to easily unzip zipped files.

Video On How to Zip and Unzip: https://youtu.be/Ep-L3PjBPCk (TechInsider Youtube Channel)

Zipping/Unzipping Tools
Winrar https://www.rarlab.com (I used to use for years, but works great!)
7zip https://www.7-zip.org/a/7z2107-x64.exe (the one I use currently)

Product Enquiry

Please Login to make enquiry about this product