Quests icon

Quests 3.15.2

Allow your players to do quests in return for rewards

Overview     Reviews     Updates     Discussion     Materials
Page 1 2 3
Fix categories.yml not generating
  1. Fix categories.yml not generating (lol)
    1. categories.yml will always be generated now rather than only on a clean install, however it won't be read if categories are still configured in the main config.yml

Quest start commands, more papi support, new configuration file
  1. Quests can now have quest start commands
    1. https://github.com/LMBishop/Quests/wiki/Creating-a-quest#start-commands-startcommands
  2. PlaceholderAPI can now be used within rewards, rewardstrings, startstrings and startcommands
    1. https://github.com/LMBishop/Quests/wiki/Basic-options#quests-use-placeholderapi-optionsquests-use-placeholderapi
  3. Categories can now be defined in [icode]categories.yml[/icode]. This helps separate the config.yml from the quests configuration
    1. Quests will only reflect this change if you create a categories.yml file yourself, if not then it will read categories from config.yml (as it has always done) instead
    2. categories.yml will be autogenerated only on a clean install
    3. See the new directory structure: https://github.com/LMBishop/Quests/tree/master/bukkit/src/main/resources/resources/bukkit

Add task type exclusions & fix ui placeholders
  1. Add task type exclusions if you don't want specific task types to enable
  2. Fix ui placeholder customisation
Fix incorrect/swapped commands
  1. Fixed issue where [icode]/q a moddata start[/icode] and [icode]/q a moddata reset[/icode] did the wrong action and start would in fact reset and vice versa
New task types & fixes
  1. Added fabledskyblock task type
  2. Added farming task type and farmingcertain task type #207
    1. Wiki link: https://github.com/LMBishop/Quests/wiki/Task-Types
  3. Fixed fishing task type #205
  4. Fixed bentobox task type
  5. Refactored command system internally
Skull item support, papi customisation, bentobox fix
  1. Skulls with specific playerdata can now be defined anywhere within Quests where an item stack is accepted #201
    1. See the wiki on how to define it
  2. Specific PlaceholderAPI strings can now be changed #203
    1. See config diff
  3. BentoBox task type has been recoded to try and avoid reflection due to their interesting api
  4. Implemented item caching on task types which have configured items to help with performance

Configuration changes: https://github.com/LMBishop/Quests/compare/v3.3...v3.4#diff-c957ec11571360042942f142fec931c2334db434131c4dd3138cd4dcd8759203
Toggle cancel menu, autotrack improvements, more customisation
  1. Added toggleable cancel menu #199 
    1. options:
  ...
  # Confirm quest cancellation with a separate menu
  gui-confirm-cancel: true
  2. Improved quest autotrack to automatically choose the next started quest
  3. Added ability to configure certain UI elements
    1. This involves changing the placeholder text for 'true' and 'false' for {task:completed} placeholders
  4. Truncated the quest requirements list if there is more than one quest needed
    1. The plugin will now show "Quest 1 +X more" as the requirement, rather than saying "Quest 1, Quest 2, Quest 3, ..." to stop enormous lores
  5. Changed quest logging to not spam the console with (potentially) hundereds of registrations, instead only showing totals at the end
  6. Internal code improvements


Config updates: https://github.com/LMBishop/Quests/compare/v3.2...v3.3#diff-c957ec11571360042942f142fec931c2334db434131c4dd3138cd4dcd8759203
Add sounds & bug fixes
  1. Quests can now play sounds when interacted with 
    1. options:
  ...
  sounds:
    quest-start: "ENTITY_PLAYER_LEVELUP:2:3"
    quest-cancel: "UI_TOAST_OUT:2:3"
    quest-complete: "UI_TOAST_CHALLENGE_COMPLETE:1.25:3"
    gui:
      open: "ITEM_BOOK_PAGE_TURN:1:3"
      interact: "ITEM_BOOK_PAGE_TURN1:3"
    2. See the wiki for more info:
      https://github.com/LMBishop/Quests/wiki/Basic-Options#sounds
Fixed a bug where the plugin would throw an NPE if UI titles, messages etc were not defined in the configAdded JetBrains annotations and more javadoc for developers

See this link for configuration changes
Fix fishingcertain task
  1. Fixed fishingcertain task increasing progress if the fished item was not the item in the config
Fix infinite recursion
  1. Fixed StackOverflowError if quest autostart was enabled
Improve version checker
  1. Improved the version checker to not show if the plugin is on a newer version then that returned by Spigot
Add data codes to fishingcertain
  1. Added data codes to the fishingcertain task type
    1. Wiki: https://github.com/LMBishop/Quests/wiki/Task-Configuration-Layout#fishingcertain

Fix GUI bug
  1. Fixed a GUI bug where quests were displayed on the GUI as ready to start if the player had reached their quest limit
Specific quest autostart, hex colour support
  1. Specific quests can now have quest autostart enabled #125 #188
    1. See the wiki for more info: https://github.com/LMBishop/Quests/wiki/Creating-A-Quest-Or-Category#autostart-optionsautostart
  2. Hex colour support has been added #171
    1. A colour is defined by the following: 
      &
    2. For example, the following two are equivalent 
      &cThis is a red message

FF5555This is a red message
    3. This will only work on 1.16+, and will work anywhere in the plugin where a message can be colour translated
    4. Wiki page: https://github.com/LMBishop/Quests/wiki/Colour-Codes
Added fishingcertain task type #182
  1. This was added in version 3.0.2, but I forgot to document it
  2. See wiki for more info: https://github.com/LMBishop/Quests/wiki/Task-Configuration-Layout#fishingcertain

Fix quest cancel & broken time formatting
  1. Fixed inability to cancel quests through GUI #187
  2. Fixed broken time formatting #186
Fix placeholders
  1. PlaceholderAPI placeholders have been fixed
Crafting task type, API changes, network synchronisation workaround
Quests has had significant internal changes, hence the new major version, 3.0. There are no major configuration changes, your quests and configs are be fully compatible with this version.
  1. Add new crafting task type #174, #179
    1. See the wiki for usage
  2. Quests can now delay the loading of playerdata as a workaround to the problem which is described here. #180
    1. For usage instructions, see here
    2. This should help prevent servers in a bungeecord network from loading stale data from a MySQL server when a player switches servers
    3. Once again, this does not fully solve the issue, but should help mitigate it
There have been significant API changes, which are best described by simply looking at the code yourself: https://github.com/LMBishop/Quests
  1. The TaskType class (along with a LOT of other stuff) has been moved to a common module, for custom task types you should extend the BukkitTaskType class instead
  2. Events have moved package and are now located in [icode]com.leonardobishop.quests.bukkit.api.event[/icode]
    1. This means if you have followed the guide on getting quests up on your scoreboard, you must change your AnimatedScoreboard config to match this
  3. The QuestsAPI class has been removed as it served little purpose, you can obtain a Quests plugin instance as you would with any other plugin: https://github.com/LMBishop/Quests/wiki/API

MySQL support
  1. Quests now supports MySQL
    1. Please read the following page in full before using, and for instructions on how to use it: https://github.com/LMBishop/Quests/wiki/Storage-Providers
    2. Report issues to: https://github.com/LMBishop/Quests/issues
    3. See end of updates notes for full config changes
The clean command and options have been removed
  1. It has been replaced by a new validation system instead, where the server checks if each loaded quest exists before adding it to their progress file
  2. This is default to true
  3. options:
  ...
  verify-quest-exists-on-load: true
Quest auto track will now automatically track the next started quest when a quest is completedmythicmobs_killing task type now supports exact levels
  1. See the wiki


For full configuration changes, see this link: https://github.com/LMBishop/Quests/compare/master@{2021-06-05}...master#diff-58cdd3d308ccba6c594e040ff9c065bb11eeb6e30f35ba87694ea45d5ae6096c
MythicMobs min-level, mobkillingcertain multiple name support & info on MySQL
  1. mythicmobs_killing task types can now have a minimum level requirement
    1. See the wiki
    2. tasks:
  killing:
    type: "mythicmobs_killing"
    amount: 1
    name: SkeletonKing
    min-level: 2
The standard mobkillingcertain now has support for multiple name
  1. See alternative layout


A version of Quests which features MySQL support is currently in works. If you have a GitHub account, you can download builds of this version for testing by heading to this page, clicking on any run on the sql branch (NOT master) and downloading the JARs near the bottom of the page. (Example build).

If you want to use these builds, please note the following:
  1. The sql branch is based on version 2.16.8 (the version before this)
  2. There is no documentation available, other than the comments in config.yml
  3. This is an experimental version for testing and development; do not use on production servers
Fix problem with unloaded players
  1. Fixed an issue where the autosave function would also unload players (whoops)
Page 1 2 3
(1)
304

Supported MC versions

1.17, 1.16, 1.15, 1.14, 1.13, 1.12, 1.11, 1.10, 1.9, 1.8

Supported server software

Spigot, Paper

Supported languages

All by self-translation

Optional Dependencies

PlaceholderAPI, CoreProtect

Links