-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Have you ever had players complain that they spent a lot of $$$ on your server store and when they received the item(s) they bought they got killed or died and someone else took those items and they never end up getting them back.
I'm sure you have probably had that happen.
The idea behind ClaimDonation is that any commands that would be run straight from your store are now run when the player runs a command!
How this works is in your store instead of just giving the player the item straight away. For example: /give {name} diamond 64. You instead log the command in a waiting list. This command will then be executed by the player when they wish using: /claimdonation claim <therename>!
This allows a player to donate and then claim his/her donation items or ranks when they want. This is hand as the player may be in a PvP match or may die when they relieve there donation items which means they lose them. Instead here they can continue what they were doing and then claim the items later!
Has been tested on 1.11.2 and 1.10 but should work on older versions!
Great news! You won't loose any data on a crash as long as that data wasn't added before the last data auto save! Auto save time is configurable aswell
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
View the code on GitHub!
![[IMG]](//proxy.spigotmc.org/598dfe79d24cf9d1a720334368d400ea6f9df8d6?url=https%3A%2F%2Fwww.revive-adserver.com%2Fmedia%2FGitHub.jpg)
![[IMG]](http://proxy.spigotmc.org/598dfe79d24cf9d1a720334368d400ea6f9df8d6?url=https%3A%2F%2Fwww.revive-adserver.com%2Fmedia%2FGitHub.jpg)
Got a problem?
Just make a issue on the GitHub and ill get right back to you!
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
How to Use/Install:
Well its incredibly easy!
Download the plugin. Either drag and drop it into your servers plugins folder or copy and paste it!
If your using a hosting company go to their file access and find the plugins folder on there and upload this plugin to it.
Then simply either reload your server (/reload) or restart your server (/restart) and then customise the messages to fit your needs!
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Commands & Permissions:
COMMAND - PERMISSION
/cd for shorter use!
/claimdonation - cd (Enabled by default)
/claimdonation claim <player> - cd.claim
/claimdonation add <player> <command> - cd.add
/claimdonation addall <command> - cd.addall
/claimdonation remove <player> <number> - cd.remove
/claimdonation list <player> - cd.list
/claimdonation save - cd.save
/claimdonation reload - cd.reload
/claimdonation inv - NO PERMISSION
/claimdonation toggle - cd.toggle
/claim - cd.claim
All commands! - cd.*
Admin Perm for claim, add,remove - cd.admin
Ability to remove GUI Items - cd.gui.remove
For the add the <command> can be any command that you can run on your server that can be run through the CONSOLE! DO NOT INCLUDE A / (Forward Slash) or the command will not be run when claimed!
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Example:
In your store instead of having:
/give {name} diamond 64 (PLEASE NOTE SOME STORES DONT USE {NAME} AND MAY USE ANOTHER PLACEHOLDER!) THIS EXAMPE WAS FOR BUYCRAFT!
You would use:
/claimdonation add {name} give {name} diamond 64
Or for other commands:
/claimdonation add {name} pex user {name} group set VIP
Or:
/claimdonation add {name} broadcast I just got a new rank!
Remove Example:
If command I type /cd list NoahNok it may respond with:
Commands:
1. give NoahNok stone
2. kim NoahNok gah
The second command is wrong, to remove it you would use:
/claimdonation remove NoahNok 2 as 2 is the second command!
NEW: Recognisers
Recognisers are quite simple for you to use (but not for me to code xD)
To start one type the command you want recognised in the format below!
Any playernames or numbers/amount in the command should be replaced with %player% and %amount% otherwise it will not work!
EG: typing kill NoahNok 100 will only allow the recogniser to work for that exact command written exactly like that. It should be written like:
kill %player% %amount%
If you command uses materials for giving items please replace it with %material% otherwise the recogniser will not recognise it and use the default recogniser builtin!
Example layout:
command:
displayname: "name"
lore:
- "lore"
- "more lore"
- "etc"
The following are optional!
material: MATERIAL NAME EG: "DIAMOND_BLOCK"
colorvalue: (Doesnt work properly sometimes!
The following must be set to true for it to work!
customstacksize: true/false
customstacksizenumber: between 1 and 64 no bigger or smaller!
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Spoiler: Images
No change in 1.6.0
Spoiler: Up-to-date Config
# ClaimDonation is (C) Copyright Noah Hollowell and may be redistributed but NOT SOLD!
# %player% and %command% are placeholders and can only be used in SUBCMD_INCORRECT and PLAYER_OFFLINE
# If you translate the config into another language (all of this bit and below) please can you send me a copie so I can support other languages!
# Best to message me on Spigot or leave a comment on the plugins page saying that you have done this!
#
# About the 'players:' section
# Players will always be empty apart from during a server restart! It will store any donations that have not been claimed before a restart and will save them here and then load them into the plugin and then clear this section!
# Claimed item data will not be saved upon a crash! I am working on a way around this!
#
# PLACEHOLDERS CAN ONLY BE USED IN CERTAIN MESSAGES:
# %player%: PLAYER_OFFLINE, PLAYER_COMMAND_LIST, PLAYER_COMMAND_LIST_HEADER, REMOVE_COMMAND_NONUMBER, COMMAND_REMOVED
# %command%: SUBCMD_INCORRECT, PLAYER_COMMAND_LIST, COMMAND_REMOVED
# %cmdnumber%: CAN ONLY BE USED IN: PLAYER_COMMAND_LIST
#
# COLORS SECTION:
# Specifiying colors here will change the colors for the GUI Name. 1, 2, 3 & 4 associated themselves with each parth of the sentence!
# 1 = "Donation", 2 = "Claim" , etc
# Setting these using ESSENTIALS Color codes (& symbol) will change the color of each word of the inventory menu ingame!
#
# Player data is now saved in data.yml, it is recommended that you do not change anything in there as you could break someones donations! Only change things if you know what your doing!
#
# Please do not edit the value of firstRun! It is there to ensure messages are loaded the first time the plugin is ran!
# ---
# ---
prefix: "&7&l[&b&lClaimDONATION&7&l] "
messages:
BASE_COMMAND: "&cPlease use: /claimdonation <claim/add/remove/list/reload>"
CLAIM_COMMAND: "&cPlease use: /claimdonation claim <player>"
LIST_COMMAND: "&cPlease use: /claimdonation list <player>"
REMOVE_COMMAND: "&cPlease use: /claimdonation remove <player> <number> Use /cd list <player> to view a players commands!"
ADD_COMMAND: "&cPlease use: /claimdonation add <player> <command>"
ADD_COMMAND_NO_COMMAND: "&cPlease specify a command! for the <command>!"
SUBCMD_INCORRECT: "&cUnrecognised command: %command%"
PLAYER_OFFLINE: "&cPlayer %player% &cis either offline or could not be found, This may cause errors, but will still function correctly!"
PLAYER_NOITEM: "&cYou have no donation item(s) to claim!"
PLAYER_CMD_ONLY: "This command can only be run a player!"
DONATION_ITEM_ADDED: "&bA donation item was succesfully added!"
NO_PERM: "&cYou are not allowed to use this command! Please ask a staff member about it for more info!"
CONFIG_RELOAD: "&bConfig reloaded!"
DONATION_CLAIM: "&bHere are your items and other things you bought! Thanks for donating!"
QUICK_ADD_COMMAND: "&cPlease use: /add <player> <command>"
PLAYER_COMMAND_LIST: "&7%cmdnumber%. &b%command%"
PLAYER_COMMAND_LIST_HEADER: "&6%player%'s &bcurrent commands:"
PLAYER_COMMAND_LIST_NOCMDS: "&6%player% &bhas no Donations/Commands set!"
REMOVE_COMMAND_NONUMBER: "&cPlease provide the number of the command to remove! You can list them by typing: &d/claimdonation list &6%player%"
NUMBERS_ONLY: "&cYou can only use numbers! Only numbers are accepted!"
COMMAND_REMOVED: "&bRemoved command: &6%command% &bfrom &6%player%&d!"
INV_DISBALED: "&cThe Inventory/GUI has been disabled! You cannot use it!"
SAVE_COMMAND: "&2Donations have been saved to: data.yml"
ADDALL_COMMAND: "&cPlease use: /claimdonation addall <command>!"
ADDALL_CONFIRMATION: "&bYou have been given a donation/item by &6%player%&b, enjoy!"
ADD_NOTIFICATION: "&6A donation item/command has been added to your Claims! Thank you for donating!"
ADD_DISABLED: "&4Sorry the add command is currently disabled!"
CLAIM_DISABLED: "&4Sorry the claim command is disabled!"
INV_CMD_DISABLED: "&4Sorry the inventory command is disabled!"
toggles:
INV_CLAIM: TRUE
INV_REMOVE: TRUE
INVENTORY: TRUE
LOGGER_SAVE_MSG: TRUE
ADDALL_MESSAGE: FALSE
CMD_CLAIM: FALSE
CMD_ADD: TRUE
CMD_INV: FALSE
colors:
1: "&b&l"
2: "&b&l"
3: "&f&l"
4: "&6&l"
autoSaveTimeInSeconds: 300
firstRun: TRUE
5/6 lines to add with update 1.7.0:
Code (Text):
# ClaimDonation is (C) Copyright Noah Hollowell and may be redistributed but NOT SOLD!
# %player% and %command% are placeholders and can only be used in SUBCMD_INCORRECT and PLAYER_OFFLINE
# If you translate the config into another language (all of this bit and below) please can you send me a copie so I can support other languages!
# Best to message me on Spigot or leave a comment on the plugins page saying that you have done this!
#
# About the 'players:' section
# Players will always be empty apart from during a server restart! It will store any donations that have not been claimed before a restart and will save them here and then load them into the plugin and then clear this section!
# Claimed item data will not be saved upon a crash! I am working on a way around this!
#
# PLACEHOLDERS CAN ONLY BE USED IN CERTAIN MESSAGES:
# %player%: PLAYER_OFFLINE, PLAYER_COMMAND_LIST, PLAYER_COMMAND_LIST_HEADER, REMOVE_COMMAND_NONUMBER, COMMAND_REMOVED
# %command%: SUBCMD_INCORRECT, PLAYER_COMMAND_LIST, COMMAND_REMOVED
# %cmdnumber%: CAN ONLY BE USED IN: PLAYER_COMMAND_LIST
#
# COLORS SECTION:
# Specifiying colors here will change the colors for the GUI Name. 1, 2, 3 & 4 associated themselves with each parth of the sentence!
# 1 = "Donation", 2 = "Claim" , etc
# Setting these using ESSENTIALS Color codes (& symbol) will change the color of each word of the inventory menu ingame!
#
# Player data is now saved in data.yml, it is recommended that you do not change anything in there as you could break someones donations! Only change things if you know what your doing!
#
# Please do not edit the value of firstRun! It is there to ensure messages are loaded the first time the plugin is ran!
# ---
# ---
prefix: "&7&l[&b&lClaimDONATION&7&l] "
messages:
BASE_COMMAND: "&cPlease use: /claimdonation <claim/add/remove/list/reload>"
CLAIM_COMMAND: "&cPlease use: /claimdonation claim <player>"
LIST_COMMAND: "&cPlease use: /claimdonation list <player>"
REMOVE_COMMAND: "&cPlease use: /claimdonation remove <player> <number> Use /cd list <player> to view a players commands!"
ADD_COMMAND: "&cPlease use: /claimdonation add <player> <command>"
ADD_COMMAND_NO_COMMAND: "&cPlease specify a command! for the <command>!"
SUBCMD_INCORRECT: "&cUnrecognised command: %command%"
PLAYER_OFFLINE: "&cPlayer %player% &cis either offline or could not be found, This may cause errors, but will still function correctly!"
PLAYER_NOITEM: "&cYou have no donation item(s) to claim!"
PLAYER_CMD_ONLY: "This command can only be run a player!"
DONATION_ITEM_ADDED: "&bA donation item was succesfully added!"
NO_PERM: "&cYou are not allowed to use this command! Please ask a staff member about it for more info!"
CONFIG_RELOAD: "&bConfig reloaded!"
DONATION_CLAIM: "&bHere are your items and other things you bought! Thanks for donating!"
QUICK_ADD_COMMAND: "&cPlease use: /add <player> <command>"
PLAYER_COMMAND_LIST: "&7%cmdnumber%. &b%command%"
PLAYER_COMMAND_LIST_HEADER: "&6%player%'s &bcurrent commands:"
PLAYER_COMMAND_LIST_NOCMDS: "&6%player% &bhas no Donations/Commands set!"
REMOVE_COMMAND_NONUMBER: "&cPlease provide the number of the command to remove! You can list them by typing: &d/claimdonation list &6%player%"
NUMBERS_ONLY: "&cYou can only use numbers! Only numbers are accepted!"
COMMAND_REMOVED: "&bRemoved command: &6%command% &bfrom &6%player%&d!"
INV_DISBALED: "&cThe Inventory/GUI has been disabled! You cannot use it!"
SAVE_COMMAND: "&2Donations have been saved to: data.yml"
ADDALL_COMMAND: "&cPlease use: /claimdonation addall <command>!"
ADDALL_CONFIRMATION: "&bYou have been given a donation/item by &6%player%&b, enjoy!"
ADD_NOTIFICATION: "&6A donation item/command has been added to your Claims! Thank you for donating!"
ADD_DISABLED: "&4Sorry the add command is currently disabled!"
CLAIM_DISABLED: "&4Sorry the claim command is disabled!"
INV_CMD_DISABLED: "&4Sorry the inventory command is disabled!"
toggles:
INV_CLAIM: TRUE
INV_REMOVE: TRUE
INVENTORY: TRUE
LOGGER_SAVE_MSG: TRUE
ADDALL_MESSAGE: FALSE
CMD_CLAIM: FALSE
CMD_ADD: TRUE
CMD_INV: FALSE
colors:
1: "&b&l"
2: "&b&l"
3: "&f&l"
4: "&6&l"
autoSaveTimeInSeconds: 300
firstRun: TRUE
Code (Text):
# IN THE MESSAGES SECTION!
ADD_DISABLED: "&4Sorry the add command is currently disabled!"
CLAIM_DISABLED: "&4Sorry the claim command is disabled!"
INV_CMD_DISABLED: "&4Sorry the inventory command is disabled!"
# IN THE TOGGLES SECTION!
CMD_CLAIM: FALSE
CMD_ADD: TRUE
CMD_INV: FALSE
Features in Progress:
- Protection against crashes to save data for unclaimed items. (SOME WHAT DONE!)
- Optional GUI
- Command delays
- Admin GUI
- Main Framework recode
- Disable donations
- /remove command
- /list command
- %command% placeholder
- %player% placeholder for /cd add command to allow easier use!
- /claim command to provide a shorter alternative
- /add command for a shorter alternative to /cd add
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Thanks for using my plugin and I hope you find it useful!
You can leave ideas for the plugin below and can also put your servers IP below if you use my plugin and I will display your IP somewhere above!
DISCLAIMER: This plugin uses Metrics! You can OPT out of this in your Plugin-Metrics folder in your plugins folder! This is only to collect Data about who is using my Plugin! No personal data is collected!
Has been tested on 1.12, 1.11.*, 1.10.* and 1.8.*. It may work with 1.7.10 but it has not been tested and may not work!
Thanks
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.8, 1.10, 1.11
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
ClaimDonation is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.10, 1.11, 1.12. Downloaded 1,213 times (via Spigot). Download it and open it directly in the game.