RankQuestsX - Extremely Configurable!
2.0.3A plugin that adds timed quests for players to complete before giving them one time use items.
2.0.3latest1.21 UpdateSep 7, 2024 Fixed: Errors in version 1.21 and above. Added: Support for SaberFactions Added: Support for latest version of WorldGuard Removed: Support for FactionsUUID Removed: Support for older versions of WorldGuard Support for versions 1.20.6 and below will cease from this point onwards. Blame spigot dev team for it, it was not my choice to drop support since I do love supporting more versions where possible as long as it only takes 1 jar file.2.0.2Error FixDec 18, 2022 Fixed: %player% placeholder not being replaced for voucher commands.2.0.1Permission Check FixMay 10, 2022 Added: Permission check for commands.2.0.0I'm back! (Also recoded!)May 10, 2022 Hey, it's been a while but I've managed to find time this holidays to recode this plugin from scratch using what I've learnt from university. Every single bug has been tested and fixed, and I will be clearing the responses for bug submissions. Of course I may have missed some so if you do still encounter them feel free to resubmit them! Major reworks of the configuration files have also been made so make sure to BACKUP YOUR OLD FILES AND RELOAD THE PLUGIN so that you get new config files generated for you. The new files are also available for copying on the main plugin page if you need them. What's changed about the plugin, then? Well, it should be bug free now, and will also not support WorldGuard for any version below 1.13 now. FactionsUUID and WorldGuard will also be the only region checking plugins supported by the plugin for now. Any version that is below 1.9 will also NOT WORK AT ALL with no plans to add support for those versions, so please DO NOT REPORT BUGS FOR THESE VERSIONS. Why, you ask? Well, so that the plugin will almost certainly work with all future versions of Spigot without any more work from me. Sounds good doesn't it Maybe one day if I'm feeling REALLY good about myself I'll attempt to do a version of the plugin for legacy users, but don't bet on it.1.2.0bBug FixesMay 24, 2020 Fixed: Error when using quests on versions older than 1.9. (Reported by @OnlyTheBest)1.2.0aPrivated ValuesApr 27, 2020 Changed: Made some values private instead of public to make editing them less confusing for developers. (and more controlled)1.2.0OOP recode, FactionsX supportApr 21, 2020 I've basically recoded the whole plugin with 2 new objects, the RankQuest and Rank objects. Developers looking to hook into the plugin should find it way easier to do things now. If you have any issues please report them on the google forms. Added: Support for FactionsX by prosavage. Fixed: Miscellaneous errors and bugs here and there. Fixed: Reload command not working as intended. Fixed: Messy, unnecessary and old code. Fixed: WorldGuard 7 and up version of the plugin still telling you that it's a legacy plugin. Changed: WarzoneName field is now not required. The plugin will automatically check if the territory is the warzone.1.1.1Reload fixesFeb 28, 2020 Fixed: Messages not reloading properly when reload command is used. Changed: Reload command now regenerates config files for you if they do not exist.1.1.0a%time% placeholder fixJan 12, 2020 Fixed: %time% placeholder not working properly.1.1.0Loading error fixJan 10, 2020 Fixed: Plugin not being able to start. Please read previous update for important info regarding the actual update.1.0.1aWGv7 version region checking errorJan 6, 2020 Fixed: Using worldguard regions in the WGv7 version of the plugin throwing errors. Please use the file from the previous update if you're running WGv6.1.0.1FactionsUUID support update, new command, new permissionJan 5, 2020 Added: Support for latest version of FactionsUUID. Added: New command /rankquest list. Gives you a list of the displaynames of all the rankquests. (Suggested by @ArcaneVoid) If you find the name of the quest that you use in a command is more useful, do tell me and I'll change that in the next update Added: New permission node "rankquest.admin". Gives access to all commands.1.0.0b1.15 update!Jan 2, 2020 Added: Actual working worldguard support for Minecraft versions 1.14 and above. Please use the correct jar file according to your worldguard version (WorldGuard 6 or 7). Added: Support for versions 1.14 and 1.15 Fixed: Errors being thrown when trying to load plugin.1.0.0xaMinor Bug with Offhand Quest StartingNov 11, 2018 Fixed: Errors thrown when player tries to start a quest with the quest item in the off hand. Fixed: Player unable to start quest when quest item is in the off hand.1.0.0x1.13 and above support, dupe fixes, logger fixes, complete recodeNov 11, 2018 Fixed: All known and unknown dupe glitches. (Thread: https://www.spigotmc.org/threads/players-able-to-move-ite… Fixed: Logger system not working. Added: Forced disabling of flight when doing rank quests. Added: Support for 1.12.2 through 1.13.2. No config changes, pop this plugin into your plugins folder and you're ready to go! Woot!1.0.25eError fixAug 17, 2017 Fixed: Plugin error/not working when it tries to return the rankquest to the player on rejoin/when it tries to remove the rankquest from player on rejoin. (Reported by @geo4574 - dude wtf this man is a bug finding machine give me a break XD)1.0.25d%time% placeholder fixAug 16, 2017 Fixed: %time% placeholder not working for items handled when player disconnects (Reported by @geo4574)1.0.25cFull fix of DC stuffAug 15, 2017 Fixed: Disconnect handling errors, not working, messing up your configs, etc. Sorry guys! (I love stupid beginner's mistakes it took me a while night to FIX BEGINNER'S MISTAKES KMS)1.0.25bONE LETTER ERROR WHYAug 15, 2017 Fixed: I didn't capitalize the first letter of "Logger" in my code, breaking the saving mechanism for quest loggers. I'm such a genius. (reported by @geo4574)1.0.25aCombat logger handling changesAug 14, 2017 THIS UPDATE HAS CONFIG.YML CHANGES Removed: Old disconnect system to reset item automatically when logging out, as that doesn't work. Added: New way to handle CombatLoggers. If they combat log, they will have their items removed if DropOnDC is set to true, and a clean quest will drop where they disconnected, if DropOnDC is set to false, they will be refunded a clean quest in the item slow when they relog. You can either make this change yourself, or let the plugin regenerate the config for you by deleting the config Config.yml addition: 1. Add this under Lore under Quest Item Options .SpoilerTarget">Spoiler: Addition Code (Text): #Whether to drop the item on disconnect. DropOnDC: "true"1.0.25LegacyFactions SupportAug 14, 2017 Added: Support for LegacyFactions. ( https://www.spigotmc.org/resources/legacyfactions.40122/) (Requested by @dan330) Removed: Useless code.1.0.241.11.2 and above support, code cleanupAug 9, 2017 Added: Support for 1.11.2 through 1.12.1 Removed: Redundant NMS code that does nothing1.0.23Region checking disabling and %time% placeholderJan 8, 2017 Added: %time% placeholder can be used in quest item name to display the maximum time of the quest before it starts! Added: Turning off both warzone and worldguard checking allows quest to be used anywhere! Config.yml: Change line 5 to this: .SpoilerTarget">Spoiler: Config.yml Changes Code (Text): #- %time% for time left on the quest item -- usable in CdName and quest item name.1.0.22dVoucher fix (again)Jan 8, 2017 Fixed: Vouchers breaking if the %player% placeholder is used in its lore. Now vouchers can be made player specific again. (Only the player whose name is in the lore can use it.) No config changes yay1.0.22cVouchers problemJan 5, 2017 Fixed: Vouchers not checking through the whole lore of the voucher. Potentially game breaking (as I found on my own damn server) No need to change anything, just reload1.0.22bConfig trash removal.Jan 1, 2017 Removed: Old option for enabling combattagplus support (The support doesn't work so I removed the code. Might try again later, but for now, if you have the lines below in your config, remove them.) Config.yml: .SpoilerTarget">Spoiler: Config.yml removal Code (Text): ################### # General Options # ################### #Whether to combat tag the player. (Requires CombatTagPlus) TagPlayer: 'false'1.0.22aError fixDec 29, 2016 Fixed: Error when player clicks in inventories while doing quest. (Reported by @AJ844FB) No changes to anything, just pop in and reload1.0.22Wrong uploadNov 25, 2016 Compiled to the wrong jar, sorry!1.0.21aTemporary (hopefully) removal of CombatTagPlus supportNov 21, 2016 Removed: Ctplus support, couldn't get the tagging to work. I'll contact the author, but not sure if I can fix this. You can either leave the CombatTag option in your config, or remove it, it doesn't really matter.1.0.21CombatTagPlus SupportNov 21, 2016 Added: Option to tag players when they start the quest. Do report any bugs! Add this to the Config.yml right under RankQuestOptions: .SpoilerTarget">Spoiler: Config.yml additions Code (Text): ################### # General Options # ################### #Whether to combat tag the player. (Requires CombatTagPlus) TagPlayer: 'false1.0.20f1.11 supportNov 18, 2016 Added: Support for version 1.11.1.0.20eOff hand support and aliasesNov 17, 2016 Added: Players can click with the quest item in their off hand for versions 1.9 and above. Added: 2 command aliases (/rq and /quest) You can now use those instead of having to type out /rankquest.1.0.20dFactions checking fixNov 2, 2016 Fixed: Factions check not working if only factions checking is turned on. Apparently my code got corrupted a little between versions, and 1 method got changed to another. Sorry about that!1.0.20cPlugin reload fixOct 29, 2016 Added: When plugin is reloaded or server resets, any ongoing quests reset. (Reported/suggested by @Sallinx)1.0.20bError when player clicks Quest Item in inventoryOct 29, 2016 Fixed: Error from not using a null check. My bad. (Reported by @Sallinx)1.0.20aPrefix before Quest CompleteOct 29, 2016 Added: Prefix before QuestComplete and QuestAllComplete Message.1.0.20Regions/warzone checking fix/recodeOct 29, 2016 Fixed: Region and Warzone checking. (Found by @Sallinx) Added: /rankquest redeem when you do /rankquest to see the commands usage. This update fixes region and warzone checking. Now regions and warzone are given equal priority. If a player is either in a whitelisted region or warzone, the quest will work. If blacklist is turned on, the quest will work when the player is either in a whitelisted region or warzone, and when he is NOT in a blacklisted region. If pvp flag is enabled, it will be required for the quest to start as well.1.0.19dDebug code left in and version number not updatedOct 28, 2016 Left a line of debug code in, and did not update version number. Sorry! For a fancier config.yml, check out the previous update!1.0.19cFancy config I guessOct 28, 2016 This update just makes the config file a little fancier, a little more organised. I moved some things around, that's about all. It's your choice whether to update, as no code has been changed. (Requested by @Sallinx) Config: .SpoilerTarget">Spoiler: Config.yml Code (Text): #Config Version 2 by Yukun #Placeholders: #- %player% for player's display name -- usable in quest item lores and names, and messages for beginning and completing the quest. #- %rank% for rank name with colour codes -- usable in quest item lores and names, and messages for beginning and completing the quest. #- %time% for time left on the quest item -- usable in CdName. RankQuestOptions: ########################### # Region checking options # ########################### CheckWarzone: 'true' CheckWorldGuard: 'true' CheckBlacklist: 'true' WarzoneName: 'Warzone' PvPFlag: 'false' Regions: - 'pvp' - 'warzone' RegionBlacklist: - 'safezone' - 'spawn' ###################### # Quest item options # ###################### #Item type of quest. Please use bukkit item names for this. QuestItemType: 'MAGMA_CREAM' #Name of item to start quest. 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.' ########################## # 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: %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.' ############################ # Rank and voucher options # ############################ #List your ranks under this. Ranks: VIP: #Used for %rank% placeholder. RankName: '&fVIP' #Time of the quest in seconds. Time: '30' #Settings for rank 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. VoucherItemType: 'PAPER' #Commands to run when voucher is clicked. Make sure this is a console compatible command! Commands: - 'manuadd %player% VIP' Lore: #Lore to be added to the voucher item (usable placeholders: %rank%, %player%) - '&7Use this item to' - '&7get the &fVIP Rank' - '&7on the &cFactions &7server!' - '&7Given to: %player%'1.0.19aQuick fix for Rank Quests and Vouchers, typo in Messages.ymlOct 25, 2016 Last update broke rank quests and vouchers, this update fixes that. There was also a placeholder typo in Messages.yml under BeginAllMessage, %player% was typed as %player. Do remember to read the previous update to know what to do for 1.0.19 and above! Fixed: Rank Quests not working (Reported by @CoreyplaysYT) Fixed: Vouchers not working (Found by me and @CoreyplaysYT) Fixed: Spelling error for %player% placeholder in messages. Fixed: Duplicate listener for PlayerQuitEvent causing errors. (Reported by @CoreyplaysYT and @croderdai)
Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
26.2MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
Emotecraft
Create your own emotes in Minecraft.
7.9MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
4.7MSueta
Set Home
A lightweight plugin for players to set their homes.
3.8MSueta