Ever wanted a plugin that makes voucher items harder to get for your players? Want to put more fun and PvP into your server? Fret not, for the plugin is *finally* here!
Warning: 2.0.2 IS THE LAST VERSION WITH 1.20.6 AND BELOW SUPPORT. Feature updates will now exclude versions 1.20.6 and below.
How to load To use this plugin, simply pop it into your plugins folder, and restart your server or load it with plugman! The config file will be auto generated!
To Give a Voucher If you want to give the one time voucher to the player immediately, add Voucher to the end of type. For example, if the type is VIP, then the voucher would be VIPVoucher.
How to Use To start a quest, simply right click on the quest item. To use the voucher, simply right click the voucher item. To add a new rank quest, simply list it under VIP, with the same exact format. The VIP quest is there as an example, and can be deleted if you want to rename it. Please make sure to use Spigot item names as well!
Other info This plugin requires either Factions, FactionsUUID or WorldGuard. It will not work without at least 1 of them! This works on 1.7.10 through 1.13.2!
For WorldGuard, all regions that are listed in the config will allow the quest to be used!
Code (Text):
###################
# General options #
###################
#Whether to drop the item on disconnect.
#If not dropped, the rank quest will simply be put back into the player's inventory.
DropOnDC: true
#Whether to prevent players from flying when they are doing the rank quest.
DisableFly: true
Code (Text):
#Placeholders:
#- %player% for player's display name
#- %rank% for rank name with colour codes
#- %amount% for amount of items received.
####################
# General messages #
####################
#Prefix before all messages.
#Bukkit colour codes supported.
Prefix: '&bRank&eQuests&f >> &7'
#Message sent if player's inventory is full when receiving an item from the plugin.
Full: '&cYour inventory is full! Please empty out a slot, then use /rankquest redeem!'
#Whether to use player nicknames instead of real names.
UseNicks: true
##################
# Quest messages #
##################
Quest:
#Message sent when player receives a rank quest.
#usable placeholders: %rank%, %amount%
Receive: '&7You have received %amount% %rank% &bQuest Item(s)&7.'
#Warnings for when the player cannot start rank quests or when player tries to move the rank quest item.
#Start, Stack, Region warnings will be checked in the order as shown here in the config.
Warnings:
#Message sent if player tries to start a rank quest while another is ongoing.
Start: '&cYou may only start 1 &bRank Quest&c at a time.'
#Message sent if player has more than 1 stacked RankQuest in hand.
Stack: '&cPlease only have 1 &bRank Quest&c in your hand!'
#Message sent if player is not in the correct region when starting quest.
Region: '&cYou need to be in the &bWarzone&r&c to use this item!'
#Message sent if player tries to move quest item in their inventory while doing the quest.
Move: '&cYou may not move the &bRank Quest&c in your inventory while the quest is ongoing!'
#Message sent if player tries to drop the quest item while doing the quest.
Drop: '&cYou may not drop the &bRank Quest&c while the quest is ongoing!'
#Message sent if player tries to fly while doing the quest.
#Only sent if DisableFly option is true in Config.yml.
Fly: '&cYou may not fly while the quest is ongoing!'
#########################
# Announcement messages #
#########################
Announcement:
#Message sent to the player that starts the quest.
#usable placeholders: %rank%, %player%
Begin:
- ''
- '&b&l*** &l%rank% &b&lQUEST STARTED ***'
- '&7You have started a %rank% &bQuest&7! Survive until the'
- '&7timer on your &bRank Quest Item &7reaches &c<0s> &7to claim your'
- '%rank% &bVoucher&7!'
- ''
#Message broadcast to all other players when quest starts.
#usable placeholders: %rank%, %player%
BeginAll:
- ''
- '&b&l*** &l%rank% &b&lQUEST STARTED BY %player%***'
- '&7%player% has started a %rank% &bQuest&7! Find him/her in the'
- '&c&lWARZONE&r&7 before the &bRank Quest Item &7reaches &c<0s> to have a'
- '&7shot at getting his %rank% &bQuest Item&7!'
- ''
#Message sent to the player when quest is completed.
#usable placeholders: %rank%
Complete:
- '&aYou have completed a %rank% quest! Congratulations!'
#Message broadcast to all other players when quest is completed.
#usable placeholders: %rank%, %player%
CompleteAll:
- '&a%player% has completed a %rank% &bRank Quest&a! Congratulations!'
####################
# Voucher messages #
####################
Voucher:
#Message sent when player receives a voucher.
#usable placeholders: %rank%, %amount%
Receive: '&7You have received %amount% %rank% &bVoucher(s)&7.'
#Message sent when voucher is used.
#usable placeholders: %rank%
Use: 'You have used a %rank% &bVoucher&7!'
Code (Text):
#This is the file where you include info for all the quest items when split.
#Placeholders:
#- %player% for player's display name
#- %rank% for rank name with colour codes
#- %time% for time left on the quest item
VIP:
###################
# General Options #
###################
#Used for %rank% placeholder.
RankName: '&fVIP'
#Time of the quest in seconds.
Time: 30
######################
# Quest item options #
######################
#Item type of quest item. Please use bukkit item names for this.
ItemType: 'SLIME_BALL'
#Name of item to start quest.
#usable placeholders: %rank%
Name: '%rank% &bQuest &7(Right Click)'
#Lore to be added to the quest item that is given to the player.
#usable placeholders: %rank%, %player%
Lore:
- '&7Survive in the &cWarzone &7long enough'
- '&7to complete this Rank Quest and'
- '&7receive a %rank% &bRank.'
- ''
- '&f&lUSE: &r&7To begin this rank quest,'
- '&f&lright-click &r&7this item inside the &cWarzone&7.'
- '&7You must survive until the quest timer'
- '&7runs out to receive your %rank% &bRank.'
- ''
- '&c&lWARNING: &r&7If you leave the &cWarzone&7'
- '&7at any time, the quest timer resets.'
# - '&fGiven to player: %player%'
##########################
# Countdown item options #
##########################
#Name of item while doing quest.
#usable placeholders: %time%, %rank%, %player%
CdName: '%rank% &bQuest <%time%s>'
#Lore for item while it is counting down.
#usable placeholders: %time%, %rank%, %player%
CdLore:
- '&b&lRank Quest Started!'
- '&7Survive in the &cWarzone&7 long enough'
- '&7to complete this Rank Quest and'
- '&7receive a %rank% &bRank Voucher!'
- ''
- '&7You must survive until the quest timer'
- '&7runs out to receive your %rank% &bRank.'
- ''
- '&c&lWARNING: &r&7If you leave the &cWarzone&7'
- '&7at any time, the quest timer resets.'
########################
# Voucher item options #
########################
#Settings for reward voucher.
Voucher:
#item name for rank voucher (usable placeholders: %rank%)
Name: '&b&lRANK &e"&l%rank%&r&e" &7(Right Click)'
#Number of vouchers given to the player when quest is completed.
Amount: 1
#The item you want to use as the Voucher. Please use bukkit item names for this.
ItemType: 'PAPER'
#Commands to run when voucher is clicked. Make sure this is a console compatible command!
Commands:
- 'manuadd %player% VIP'
#Lore to be added to the voucher item
#usable placeholders: %rank%
Lore:
- '&7Use this item to'
- '&7get the &fVIP Rank'
- '&7on the server!'
MVP:
RankName: '&aMVP'
Time: 60
CheckWarzone: true
CheckWorldGuard: true
CheckBlacklist: true
PvPFlag: false
Regions:
- 'pvp'
- 'warzone'
RegionBlacklist:
- 'safezone'
- 'spawn'
ItemType: 'MAGMA_CREAM'
Name: '%rank% &bQuest &7(Right Click)'
Lore:
- '&7Survive in the &cWarzone &7long enough'
- '&7to complete this Rank Quest and'
- '&7receive a %rank% &bRank.'
- ''
- '&f&lUSE: &r&7To begin this rank quest,'
- '&f&lright-click &r&7this item inside the &cWarzone&7.'
- '&7You must survive until the quest timer'
- '&7runs out to receive your %rank% &bRank.'
- ''
- '&c&lWARNING: &r&7If you leave the &cWarzone&7'
- '&7at any time, the quest timer resets.'
CdName: '%rank% &bQuest <%time%s>'
CdLore:
- '&b&lRank Quest Started!'
- '&7Survive in the &cWarzone&7 long enough'
- '&7to complete this Rank Quest and'
- '&7receive a %rank% &bRank Voucher!'
- ''
- '&7You must survive until the quest timer'
- '&7runs out to receive your %rank% &bRank.'
- ''
- '&c&lWARNING: &r&7If you leave the &cWarzone&7'
- '&7at any time, the quest timer resets.'
Voucher:
Name: '&b&lRANK &e"&l%rank%&r&e" &7(Right Click)'
Amount: 1
ItemType: 'MAP'
Commands:
- 'manuadd %player% MVP'
Lore:
- '&7Use this item to'
- '&7get the &fMVP Rank'
- '&7on the server!'
Description: Gives the player his/her unredeemed rank quests.
/rankquest list
Permission: rankquest.list, rankquest.admin
Description: Gives the user a list of all quests.
I live in Singapore, so if I don't answer your queries, I may be asleep! I also have school so my support time is incredibly limited too!
Do be patient!
http://goo.gl/forms/l0eGKwryPEUzcx7A2
Big Thanks To
@Kicjow aka BadBones69:
https://www.spigotmc.org/members/kicjow.9719/ (This is the master who taught me basically everything I know by way of Java and Spigot coding.)
Donor List: 1.
@armyman25 aka FrontierGames: My first donor and ardent supporter!
THANK YOU TO EVERY SINGLE ONE OF YOU! OVER 8000 DOWNLOADS FOR MY FIRST PLUGIN! WHO WOULD'VE THOUGHT! YOU ALL DESERVE A COOKIE, IF I COULD AFFORD IT ;-;