diff options
| author | LMBishop <13875753+LMBishop@users.noreply.github.com> | 2023-07-06 13:57:32 +0100 |
|---|---|---|
| committer | LMBishop <13875753+LMBishop@users.noreply.github.com> | 2023-07-06 13:57:32 +0100 |
| commit | 7a2a45691068db51ba4e7dc851f44a17f545f0ae (patch) | |
| tree | 4613842f6cd175965dc0920c7e210f417be8f574 | |
| parent | 467715dcb3ee23e05e8fe445d9e2a2416a26a8e0 (diff) | |
Fix wiki linksmigrate-docs
| -rw-r--r-- | docs/Common-Configuration-Issues.md | 13 | ||||
| -rw-r--r-- | docs/Default-configuration.md | 1 | ||||
| -rw-r--r-- | docs/Task-configuration-layout.md | 3 | ||||
| -rw-r--r-- | docs/_Footer.md | 3 | ||||
| -rw-r--r-- | docs/_Sidebar.md | 87 | ||||
| -rw-r--r-- | docs/_Templates.md | 29 | ||||
| -rw-r--r-- | docs/_config.yml | 19 | ||||
| -rw-r--r-- | docs/_includes/incomplete.md | 3 | ||||
| -rw-r--r-- | docs/commands-and-permissions.md | 2 | ||||
| -rw-r--r-- | docs/configuration/basic-options.md | 94 | ||||
| -rw-r--r-- | docs/configuration/colour-codes.md | 56 | ||||
| -rw-r--r-- | docs/configuration/configuration-problems.md | 4 | ||||
| -rw-r--r-- | docs/configuration/creating-a-quest.md | 56 | ||||
| -rw-r--r-- | docs/configuration/custom-gui-items.md | 4 | ||||
| -rw-r--r-- | docs/configuration/defining-items.md | 51 | ||||
| -rw-r--r-- | docs/configuration/global-configurations.md | 10 | ||||
| -rw-r--r-- | docs/configuration/gui-configuration.md | 42 | ||||
| -rw-r--r-- | docs/configuration/storage-providers.md | 12 | ||||
| -rw-r--r-- | docs/contributing-to-the-wiki.md | 53 | ||||
| -rw-r--r-- | docs/developer/api.md | 3 | ||||
| -rw-r--r-- | docs/developer/new-task-type.md | 4 | ||||
| -rw-r--r-- | docs/download.md | 8 | ||||
| -rw-r--r-- | docs/getting-started.md | 5 | ||||
| -rw-r--r-- | docs/guides/quest-progress-in-scoreboard.md | 6 | ||||
| -rw-r--r-- | docs/index.md | 102 | ||||
| -rw-r--r-- | docs/task-types/askyblock_level-(task-type).md (renamed from docs/task-type/askyblock_level-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/bentobox_level-(task-type).md (renamed from docs/task-type/bentobox_level-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/blockbreak-(task-type).md (renamed from docs/task-type/blockbreak-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/blockplace-(task-type).md (renamed from docs/task-type/blockplace-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/breeding-(task-type).md (renamed from docs/task-type/breeding-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/brewing-(task-type).md (renamed from docs/task-type/brewing-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/bucketempty-(task-type).md (renamed from docs/task-type/bucketempty-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/bucketfill-(task-type).md (renamed from docs/task-type/bucketfill-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/citizens_deliver-(task-type).md (renamed from docs/task-type/citizens_deliver-(task-type).md) | 4 | ||||
| -rw-r--r-- | docs/task-types/citizens_interact-(task-type).md (renamed from docs/task-type/citizens_interact-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/command-(task-type).md (renamed from docs/task-type/command-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/consume-(task-type).md (renamed from docs/task-type/consume-(task-type).md) | 2 | ||||
| -rw-r--r-- | docs/task-types/crafting-(task-type).md (renamed from docs/task-type/crafting-(task-type).md) | 2 | ||||
| -rw-r--r-- | docs/task-types/dealdamage-(task-type).md (renamed from docs/task-type/dealdamage-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/distancefrom-(task-type).md (renamed from docs/task-type/distancefrom-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/enchanting-(task-type).md (renamed from docs/task-type/enchanting-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/essentials_balance-(task-type).md (renamed from docs/task-type/essentials_balance-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/essentials_moneyearn-(task-type).md (renamed from docs/task-type/essentials_moneyearn-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/expearn-(task-type).md (renamed from docs/task-type/expearn-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/fabledskyblock_level-(task-type).md (renamed from docs/task-type/fabledskyblock_level-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/farming-(task-type).md (renamed from docs/task-type/farming-(task-type).md) | 2 | ||||
| -rw-r--r-- | docs/task-types/fishing-(task-type).md (renamed from docs/task-type/fishing-(task-type).md) | 2 | ||||
| -rw-r--r-- | docs/task-types/index.md (renamed from docs/task-type/index.md) | 0 | ||||
| -rw-r--r-- | docs/task-types/inventory-(task-type).md (renamed from docs/task-type/inventory-(task-type).md) | 2 | ||||
| -rw-r--r-- | docs/task-types/iridiumskyblock_value-(task-type).md (renamed from docs/task-type/iridiumskyblock_value-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/milking-(task-type).md (renamed from docs/task-type/milking-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/mobkilling-(task-type).md (renamed from docs/task-type/mobkilling-(task-type).md) | 18 | ||||
| -rw-r--r-- | docs/task-types/mythicmobs_killing-(task-type).md (renamed from docs/task-type/mythicmobs_killing-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/permission-(task-type).md (renamed from docs/task-type/permission-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/placeholderapi_evaluate-(task-type).md (renamed from docs/task-type/placeholderapi_evaluate-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/playerkilling-(task-type).md (renamed from docs/task-type/playerkilling-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/playtime-(task-type).md (renamed from docs/task-type/playtime-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/position-(task-type).md (renamed from docs/task-type/position-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/shearing-(task-type).md (renamed from docs/task-type/shearing-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/shopguiplus_buy-(task-type).md (renamed from docs/task-type/shopguiplus_buy-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/shopguiplus_sell-(task-type).md (renamed from docs/task-type/shopguiplus_sell-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/smelting-(task-type).md (renamed from docs/task-type/smelting-(task-type).md) | 14 | ||||
| -rw-r--r-- | docs/task-types/superiorskyblock_level-(task-type).md (renamed from docs/task-type/superiorskyblock_level-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/superiorskyblock_worth-(task-type).md (renamed from docs/task-type/superiorskyblock_worth-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/taming-(task-type).md (renamed from docs/task-type/taming-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/uskyblock_level-(task-type).md (renamed from docs/task-type/uskyblock_level-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/votingplugin_vote-(task-type).md (renamed from docs/task-type/votingplugin_vote-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/task-types/walking-(task-type).md (renamed from docs/task-type/walking-(task-type).md) | 0 | ||||
| -rw-r--r-- | docs/tools/data-migration-tool.md | 2 |
69 files changed, 283 insertions, 435 deletions
diff --git a/docs/Common-Configuration-Issues.md b/docs/Common-Configuration-Issues.md deleted file mode 100644 index 515c4c5c..00000000 --- a/docs/Common-Configuration-Issues.md +++ /dev/null @@ -1,13 +0,0 @@ -*** - -### ๐๏ธ ***This page is subject to removal*** -*This page has been superseded, is unmaintained, or is not required. The information contained here may be inaccurate or incomplete.* - -*** - -# Common Configuration Issues - -### My items are showing up as stone blocks! -Make sure you are using the correct item namesfor your version. **Quests is pre-configured with the names for 1.13+ items - you MUST change them for 1.8!**. - -//todo finish me
\ No newline at end of file diff --git a/docs/Default-configuration.md b/docs/Default-configuration.md deleted file mode 100644 index bb04edc8..00000000 --- a/docs/Default-configuration.md +++ /dev/null @@ -1 +0,0 @@ -Click [here](https://github.com/LMBishop/Quests/tree/master/bukkit/src/main/resources/resources/bukkit)
\ No newline at end of file diff --git a/docs/Task-configuration-layout.md b/docs/Task-configuration-layout.md deleted file mode 100644 index 6a541dd7..00000000 --- a/docs/Task-configuration-layout.md +++ /dev/null @@ -1,3 +0,0 @@ -### ๐ This information has moved - -Each task type now has its own individual page. Please see the sidebar or [this page](https://github.com/LMBishop/Quests/wiki/Task-types) to get to them. diff --git a/docs/_Footer.md b/docs/_Footer.md deleted file mode 100644 index cfdd9fd8..00000000 --- a/docs/_Footer.md +++ /dev/null @@ -1,3 +0,0 @@ -*This wiki serves as a manual for Quests, however there is no guarantee that the information is up-to-date or complete. As per the license, this software provides absolutely no warranty, nor are the maintainers liable for any damages. Please see the license text for more information.* - -[๐ Home page](https://github.com/LMBishop/Quests/wiki/) ~ [๐ป Source code](https://github.com/LMBishop/Quests/) ~ [๐ค Contributing to the wiki](https://github.com/LMBishop/Quests/wiki/Contributing-to-the-wiki) ~ [๐ Full license text](https://github.com/LMBishop/Quests/blob/master/LICENSE.txt)
\ No newline at end of file diff --git a/docs/_Sidebar.md b/docs/_Sidebar.md deleted file mode 100644 index fc25c8c6..00000000 --- a/docs/_Sidebar.md +++ /dev/null @@ -1,87 +0,0 @@ -<p align="center"> -<img src="https://leonardobishop.com/~/artwork/questcompass2-256.png" width="100" height="100"><br> -</p> - -## [Home / FAQs](https://github.com/LMBishop/Quests/wiki) - -[Getting started](getting-started) - -[Downloading](download) - -[Tips](tips) - -[Commands and permissions](commands-and-permissions) -### **Configuration** -* [Basic options](configuration/basic-options.md) -* [Creating a quest](configuration/creating-a-quest.md) -* [Creating a category](configuration/creating-a-category.md) -* [Global configurations](Global-Configurations) -* [GUI configuration](configuration/gui-configuration.md) -* [Custom GUI items](configuration/custom-gui-items.md) -* [Configuration problems](configuration/configuration-problems.md) -* [Storage providers](configuration/storage-providers.md) -* [Defining items](configuration/defining-items.md) -* [Colour (color) codes](configuration/colour-codes.md) -* [Default configuration](Default-configuration) - -### **Task Types** - -* [Task types](Task-types) - * [blockplace](blockplace-(task-type)) - * [blockbreak](blockbreak-(task-type)) - * [breeding](breeding-(task-type)) - * [brewing](brewing-(task-type)) - * [bucketempty](bucketempty-(task-type)) - * [bucketfill](bucketfill-(task-type)) - * [command](command-(task-type)) - * [consume](consume-(task-type)) - * [crafting](crafting-(task-type)) - * [dealdamage](dealdamage-(task-type)) - * [distancefrom](distancefrom-(task-type)) - * [enchanting](enchanting-(task-type)) - * [expearn](expearn-(task-type)) - * [farming](farming-(task-type)) - * [fishing](fishing-(task-type)) - * [inventory](inventory-(task-type)) - * [milking](milking-(task-type)) - * [mobkilling](mobkilling-(task-type)) - * [permission](permission-(task-type)) - * [playerkilling](playerkilling-(task-type)) - * [playtime](playtime-(task-type)) - * [position](position-(task-type)) - * [shearing](shearing-(task-type)) - * [taming](taming-(task-type)) - * [walking](walking-(task-type)) - * [smelting](smelting-(task-type)) - * [askyblock_level](askyblock_level-(task-type)) - * [bentobox_level](bentobox_level-(task-type)) - * [citizens_deliver](citizens_deliver-(task-type)) - * [citizens_interact](citizens_interact-(task-type)) - * [essentials_balance](essentials_balance-(task-type)) - * [essentials_moneyearn](essentials_moneyearn-(task-type)) - * [fabledskyblock_level](fabledskyblock_level-(task-type)) - * [iridiumskyblock_value](iridiumskyblock_value-(task-type)) - * [mythicmobs_killing](mythicmobs_killing-(task-type)) - * [placeholderapi_evaluate](placeholderapi_evaluate-(task-type)) - * [shopguiplus_buy](shopguiplus_buy-(task-type)) - * [shopguiplus_sell](shopguiplus_sell-(task-type)) - * [superiorskyblock_level](superiorskyblock_level-(task-type)) - * [superiorskyblock_worth](superiorskyblock_worth-(task-type)) - * [votingplugin_vote](votingplugin_vote-(task-type)) - * [uskyblock_level](uskyblock_level-(task-type)) - -### **API** - -* [API](developer/api.md) -* [New task type](developer/new-task-type.md) - -### **Guides** - -* [Quest progress in scoreboard](guides/quest-progress-in-scoreboard.md) - -### **Other** - -* [PlaceholderAPI](tools/placeholderapi.md) -* [Quest debugger](tools/quest-debugger.md) -* [Data migration tool](tools/data-migration-tool.md) -* [Contributing to the wiki](contributing-to-the-wiki)
\ No newline at end of file diff --git a/docs/_Templates.md b/docs/_Templates.md deleted file mode 100644 index 01781df3..00000000 --- a/docs/_Templates.md +++ /dev/null @@ -1,29 +0,0 @@ -This page contains wikicode templates for use through the -wiki. GitHub does not support page transclusion so instead they should -be simply copied from here. - -## Dev build - - -**โ๏ธ This section describes a feature currently only available in a -[development build](https://github.com/LMBishop/Quests/actions) of -quests.** - -## Under construction - ------------------------------------------------------------------------- - -### ๐จ **This page is under construction** - -*The information contained here may be inaccurate or incomplete. You can -help by [contributing information to the -wiki](https://github.com/LMBishop/Quests/wiki/Contributing-to-the-wiki).* - ------------------------------------------------------------------------- - -## Removed option - - -โ๏ธ **This option has been removed in version and this wiki entry is -subject to removal.** *Please see [{{{other}}}]({{{other}}} "wikilink") -instead.* diff --git a/docs/_config.yml b/docs/_config.yml index f41d5a4e..88b190a2 100644 --- a/docs/_config.yml +++ b/docs/_config.yml @@ -2,7 +2,9 @@ title: Quests description: Documentation for the Quests plugin theme: just-the-docs -url: https://lmbishop.github.io +url: "https://quests.leonardobishop.com" +baseurl: "" +repository: LMBishop/Quests callouts_level: quiet callouts: @@ -27,6 +29,21 @@ callouts: title: Warning color: red +back_to_top: true +back_to_top_text: "Back to top" + +gh_edit_link: true +gh_edit_link_text: "Edit this page on GitHub" +gh_edit_repository: "https://github.com/LMBishop/Quests" +gh_edit_branch: "master" +gh_edit_source: docs +gh_edit_view_mode: "tree" + +footer_content: > + This wiki serves as a manual for Quests however there is no guarantee that the information is up-to-date or complete. + As per the license, this software provides absolutely no warranty, nor are the maintainers liable for any damages. + Please see the license text for more information. + nav_external_links: - title: Quests on GitHub url: https://github.com/LMBishop/Quests diff --git a/docs/_includes/incomplete.md b/docs/_includes/incomplete.md new file mode 100644 index 00000000..9eddf0b7 --- /dev/null +++ b/docs/_includes/incomplete.md @@ -0,0 +1,3 @@ +{: .highlight } +**This page is under construction.** The information contained here may be inaccurate or incomplete. +You can help by [contributing information to the wiki](/contributing-to-the-wiki). diff --git a/docs/commands-and-permissions.md b/docs/commands-and-permissions.md index 8e10b845..351bffd7 100644 --- a/docs/commands-and-permissions.md +++ b/docs/commands-and-permissions.md @@ -45,7 +45,7 @@ also be viewed in-game by simply running `/quests`. - **/quests a/admin items give \<player\> \<id\> \[amount\]** - give a player a quest item. - **/quests a/admin debug** - view help for the [quest - debugger](quest_debugger "wikilink"). + debugger](tools/quest-debugger). - **/quests a/admin debug report** - generate a debug report. - **/quests a/admin debug quest \<quest/\*\> \<all/self\>** - enable debug messages for a specific quest, or all of them. diff --git a/docs/configuration/basic-options.md b/docs/configuration/basic-options.md index 24927b12..0a2dbdc0 100644 --- a/docs/configuration/basic-options.md +++ b/docs/configuration/basic-options.md @@ -39,7 +39,7 @@ only helping determine the order they are sorted. ``` yaml options: - ... + # ... categories-enabled: true ``` @@ -53,7 +53,7 @@ of rows) so that there are not any empty rows. ``` yaml options: - ... + # ... trim-gui-size: true ``` @@ -67,7 +67,7 @@ quests. ``` yaml options: - ... + # ... titles-enabled: true ``` @@ -77,18 +77,18 @@ options: {: .warning } **This option has been removed in version 3.8 and this wiki entry is -subject to removal.** Please see [quest limit](#quest-limit "wikilink") +subject to removal.** Please see [quest limit](#quest-limit) instead. Choose the number of quests players can start at one time. This will include quests which have [quest-specific -autostart](Creating_a_quest#Autostart "wikilink") enabled, however this +autostart](creating-a-quest#autostart) enabled, however this value will be ignored if [global -`quest-autostart`](Basic_options#Quest_autostart "wikilink") is enabled. +`quest-autostart`](#quest-autostart) is enabled. ``` yaml options: - ... + # ... quest-started-limit: 2 ``` @@ -99,9 +99,9 @@ options: Choose the number of quests players can start at one time. This will include quests which have [quest-specific -autostart](Creating_a_quest#Autostart "wikilink") enabled, however this +autostart](creating-a-quest#autostart) enabled, however this value will be ignored if [global -`quest-autostart`](Basic_options#Quest_autostart "wikilink") is enabled. +`quest-autostart`](#quest-autostart) is enabled. Each key is called a **limit group** (sometimes referred to as a quest rank), and players can start the set number of quests depending on their @@ -111,7 +111,7 @@ to everybody, however the rest can be granted through the permission ``` yaml options: - ... + # ... quest-limit: default: 2 group1: 5 @@ -120,7 +120,7 @@ options: ``` Group permissions are also documented in [Commands and permissions ยง -Permissions](commands-and-permissions#permissions "wikilink"). +Permissions](../commands-and-permissions#permissions). ## Allow quest cancel @@ -131,11 +131,11 @@ Choose whether or not players can cancel quests themselves via command or by right-clicking in the GUI. If this is set to false, consider removing the right-click cancel instruction from the [global quest display -configuration](Global_configurations#Global_quest_display_configuration "wikilink"). +configuration](global-configurations#global-quest-display-configuration). ``` yaml options: - ... + # ... allow-quest-cancel: true ``` @@ -148,11 +148,11 @@ Choose whether or not players can track quests themselves via command or by middle-clicking in the GUI. If this is set to false, consider removing the middle-click track instruction from the [global quest display -configuration](Global_configurations#Global_quest_display_configuration "wikilink"). +configuration](global-configurations#global-quest-display-configuration). ``` yaml options: - ... + # ... allow-quest-track: true ``` @@ -168,7 +168,7 @@ leading to errors. ``` yaml options: - ... + # ... task-type-exclusions: [] ``` @@ -176,7 +176,7 @@ options: ``` yaml options: - ... + # ... task-type-exclusions: - "blockbreak" - "blockbreakcertain" @@ -191,7 +191,7 @@ Change and define specific GUI names for localization. ``` yaml options: - ... + # ... guinames: quests-category: "Quests Categories" quests-menu: "Quests" @@ -209,7 +209,7 @@ Choose which sounds play at certain events. ``` yaml options: - ... + # ... sounds: quest-start: "ENTITY_PLAYER_LEVELUP:2:3" quest-cancel: "UI_TOAST_OUT:2:3" @@ -230,7 +230,7 @@ for example: ``` yaml options: - ... + # ... sounds: quest-start: "" ``` @@ -254,7 +254,7 @@ or not. ``` yaml options: - ... + # ... gui-hide-locked: false ``` @@ -269,7 +269,7 @@ screen. ``` yaml options: - ... + # ... gui-confirm-cancel: true ``` @@ -283,7 +283,7 @@ have permission for the quest. ``` yaml options: - ... + # ... gui-hide-quests-nopermission: false ``` @@ -297,7 +297,7 @@ have permission for the category. ``` yaml options: - ... + # ... gui-hide-categories-nopermission: false ``` @@ -311,7 +311,7 @@ is disabled by default for performance reasons. ``` yaml options: - ... + # ... gui-use-placeholderapi: false ``` @@ -327,7 +327,7 @@ the requirement, rather than listing each quest "Quest 1, Quest 2, Quest ``` yaml options: - ... + # ... gui-truncate-requirements: true ``` @@ -342,7 +342,7 @@ page](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/event/inventory/ClickT ``` yaml options: - ... + # ... gui-actions: start-quest: "LEFT" track-quest: "MIDDLE" @@ -356,12 +356,12 @@ options: Choose whether or not players need to start quests themselves. This will ignore the configured [quest started -limit](#Quest_started_limit "wikilink"), and is different from the -[autostart](#Autostart "wikilink") option. +limit](#quest-started-limit), and is different from the +[autostart](#quest-autostart) option. ``` yaml options: - ... + # ... quest-autostart: false ``` @@ -377,7 +377,7 @@ quest. ``` yaml options: - ... + # ... quest-autotrack: true ``` @@ -392,7 +392,7 @@ output based on the following options: 0 = errors only, 1 = warnings, 2 ``` yaml options: - ... + # ... verbose-logging-level: 2 ``` @@ -407,7 +407,7 @@ default for performance reasons. ``` yaml options: - ... + # ... quests-use-placeholderapi: false ``` @@ -426,7 +426,7 @@ progress. ``` yaml options: - ... + # ... verify-quest-exists-on-load: true ``` @@ -451,7 +451,7 @@ These options are measured in ticks, 1 second = 20 ticks. ``` yaml options: - ... + # ... performance-tweaking: quest-queue-executor-interval: 1 quest-autosave-interval: 12000 @@ -470,7 +470,7 @@ permission.) ``` yaml options: - ... + # ... tab-completion: enabled: true ``` @@ -482,13 +482,13 @@ options: Configure how Quests handles errors in your configuration. By default, Quests will not allow quests to be loaded if they contain an -[error](Configuration_problems#Types_of_problem "wikilink"), since this +[error](configuration-problems#types-of-problem), since this could lead to undefined behaviour. The option `override-errors` will ignore this behaviour and forcibly allow the quest to be registered. ``` yaml options: - ... + # ... error-checking: override-errors: false ``` @@ -496,16 +496,16 @@ options: ## Placeholder cache time -''`options.placeholder-cache-time`" +*`options.placeholder-cache-time`* Set how long Quests will retain parsed PlaceholderAPI strings in the cache, in seconds. See [PlaceholderAPI ยง Caching -placeholders](PlaceholderAPI#Caching_placeholders "wikilink") for more +placeholders](../tools/placeholderapi#caching-placeholders) for more information. ``` yaml options: - ... + # ... placeholder-cache-time: 10 ``` @@ -515,12 +515,12 @@ options: *`options.global-task-configuration-override`* Choose whether or not options set in the [global task -configuration](Global_configurations#Global_task_configuration "wikilink") +configuration](global-configurations#global-task-configuration) will override per-quest specific options. ``` yaml options: - ... + # ... global-task-configuration-override: false ``` @@ -530,12 +530,12 @@ options: *`options.global-quest-display-configuration-override`* Choose whether or not the [global quest display -configuration](Global_configurations#Global_quest_display_configuration "wikilink") +configuration](global-configurations#global-quest-display-configuration) will override per-quest specific options. ``` yaml options: - ... + # ... global-quest-display-configuration-override: false ``` @@ -545,11 +545,11 @@ options: *`options.storage`* Configure how Quests will store playerdata. See [storage -providers](Storage_providers "wikilink") for more info. +providers](storage-providers) for more info. ``` yaml options: - ... + # ... storage: provider: "yaml" synchronisation: diff --git a/docs/configuration/colour-codes.md b/docs/configuration/colour-codes.md index 6c7339c0..0d3de95d 100644 --- a/docs/configuration/colour-codes.md +++ b/docs/configuration/colour-codes.md @@ -9,38 +9,38 @@ You can use colour codes anywhere the plugin accepts a message (plugin messages, The following table shows the colour capabilities of specific server versions: -| | Before 1.16 | 1.16+ | -| ---- | ---- | ---- | -| Colour Codes | โ๏ธ | โ๏ธ | -| Hexadecimal | โ | โ๏ธ | +| | Before 1.16 | 1.16+ | +|--------------|-------------|-------| +| Colour Codes | โ๏ธ | โ๏ธ | +| Hexadecimal | โ | โ๏ธ | ## Colour codes The plugin will automatically translate colour codes from '&' to 'ยง' for you. -| Name | Chat Code | Hex Equivalent | -| ---- | ---- | ---- | -| Black | `&0` | #000000 | -| Dark Blue | `&1` | #0000AA | -| Dark Green | `&2` | #00AA00 | -| Dark Aqua | `&3` | #00AAAA | -| Dark Red | `&4` | #AA0000 | -| Dark Purple | `&5` | #AA00AA | -| Gold | `&6` | #FFAA00 | -| Gray | `&7` | #AAAAAA | -| Dark Gray | `&8` | #555555 | -| Blue | `&9` | #5555FF | -| Green | `&a` | #55FF55 | -| Aqua | `&b` | #55FFFF | -| Red | `&c` | #FF5555 | -| Light Purple | `&d` | #FF55FF | -| Yellow | `&e` | #FFFF55 | -| White | `&f` | #FFFFFF | -| Obfuscated | `&k` | - | -| Bold | `&l` | - | -| Strikethrough | `&m` | - | -| Underline | `&n` | - | -| Italic | `&o` | - | -| Reset | `&r` | - | +| Name | Chat Code | Hex Equivalent | +|---------------|-----------|----------------| +| Black | `&0` | #000000 | +| Dark Blue | `&1` | #0000AA | +| Dark Green | `&2` | #00AA00 | +| Dark Aqua | `&3` | #00AAAA | +| Dark Red | `&4` | #AA0000 | +| Dark Purple | `&5` | #AA00AA | +| Gold | `&6` | #FFAA00 | +| Gray | `&7` | #AAAAAA | +| Dark Gray | `&8` | #555555 | +| Blue | `&9` | #5555FF | +| Green | `&a` | #55FF55 | +| Aqua | `&b` | #55FFFF | +| Red | `&c` | #FF5555 | +| Light Purple | `&d` | #FF55FF | +| Yellow | `&e` | #FFFF55 | +| White | `&f` | #FFFFFF | +| Obfuscated | `&k` | - | +| Bold | `&l` | - | +| Strikethrough | `&m` | - | +| Underline | `&n` | - | +| Italic | `&o` | - | +| Reset | `&r` | - | ## Hexadecimal colour For compatible Minecraft versions, the plugin will also translate hex colour codes for you. diff --git a/docs/configuration/configuration-problems.md b/docs/configuration/configuration-problems.md index a55bbfde..8457a785 100644 --- a/docs/configuration/configuration-problems.md +++ b/docs/configuration/configuration-problems.md @@ -89,8 +89,8 @@ tasks: type: "inventory" amount: 10 item: DIAMOND -... +# ... options: # requirements section removed - ... + # ... ```
\ No newline at end of file diff --git a/docs/configuration/creating-a-quest.md b/docs/configuration/creating-a-quest.md index 6e3b7283..4e7353a6 100644 --- a/docs/configuration/creating-a-quest.md +++ b/docs/configuration/creating-a-quest.md @@ -37,7 +37,7 @@ Simalar to quest IDs, there are task IDs. They can be identical to the quest ID but must be unique to each other. For help on adding the tasks, refer to [task configuration -layout](Task_configuration_layout "wikilink") +layout](../task-types) ## Display @@ -93,7 +93,7 @@ is complete. ``` yaml display: - ... + # ... lore-started: - "" - "&7Your current progression:" @@ -109,7 +109,7 @@ The type (material name) of item. ``` yaml display: - ... + # ... type: "WOODEN_PICKAXE" ``` @@ -187,7 +187,7 @@ placeholders: ``` These placeholders will be called using PlaceholderAPI. See [quest -progress in scoreboard](Quest_progress_in_scoreboard "wikilink") for a +progress in scoreboard](../guides/quest-progress-in-scoreboard) for a guide which utilises this feature. ## Options @@ -207,7 +207,7 @@ of the category here. ``` yaml options: - ... + # ... category: "example" ``` @@ -221,7 +221,7 @@ able to start this quest. ``` yaml options: - ... + # ... requires: - "quest-id" ``` @@ -236,7 +236,7 @@ start. The permission will be `quests.quest.<id>`. ``` yaml options: - ... + # ... permission-required: false ``` @@ -251,7 +251,7 @@ then this option is ignored. ``` yaml options: - ... + # ... cancellable: false ``` @@ -266,7 +266,7 @@ effect as quest limits are disabled. ``` yaml options: - ... + # ... counts-towards-limit: false ``` @@ -279,7 +279,7 @@ options: ``` yaml options: - ... + # ... repeatable: false ``` @@ -293,7 +293,7 @@ immediately replayable. ``` yaml options: - ... + # ... cooldown: enabled: true time: 1440 # minutes @@ -310,7 +310,7 @@ reset. ``` yaml options: - ... + # ... time-limit: enabled: true time: 1440 # minutes @@ -326,7 +326,7 @@ come first. ``` yaml options: - ... + # ... sort-order: 1 ``` @@ -341,12 +341,12 @@ specific only to this quest, meaning it cannot be cancelled and counts towards the players quest started limit. See [ยง counts towards -limit](Creating_a_quest#Counts_towards_limit "wikilink") if you do not +limit](#counts-towards-limit) if you do not want autostart quests to count towards the quest started limit. ``` yaml options: - ... + # ... autostart: true ``` @@ -357,14 +357,14 @@ options: **Optional.** The display item this quest should take if it is completed. This accepts the standard ItemStack definition format -described in [Defining items](Defining_items "wikilink"). If this option +described in [defining items](defining-items.md). If this option is not specified, the display item [defined in the main -config.yml](gui-configuration#quest-completed-display "wikilink") will +config.yml](gui-configuration#quest-completed-display) will be used. ``` yaml options: - ... + # ... completed-display: type: "STEAK" ``` @@ -376,14 +376,14 @@ options: **Optional.** The display item this quest should take if it is on cooldown. This accepts the standard ItemStack definition format -described in [Defining items](Defining_items "wikilink"). If this option +described in [defining items](defining-items). If this option is not specified, the display item [defined in the main -config.yml](gui-configuration#quest-cooldown-display "wikilink") will be +config.yml](gui-configuration#quest-cooldown-display) will be used. ``` yaml options: - ... + # ... cooldown-display: type: "STEAK" ``` @@ -395,15 +395,15 @@ options: **Optional.** The display item this quest should take if the player does not have permission to start it. This accepts the standard ItemStack -definition format described in [Defining -items](Defining_items "wikilink"). If this option is not specified, the +definition format described in [defining +items](defining-items). If this option is not specified, the display item [defined in the main -config.yml](gui-configuration#quest-permission-display "wikilink") will +config.yml](gui-configuration#quest-permission-display) will be used. ``` yaml options: - ... + # ... permission-display: type: "STEAK" ``` @@ -415,14 +415,14 @@ options: **Optional.** The display item this quest should take if the player has not unlocked it. This accepts the standard ItemStack definition format -described in [Defining items](Defining_items "wikilink"). If this option +described in [defining items](defining-items). If this option is not specified, the display item [defined in the main -config.yml](gui-configuration#quest-locked-display "wikilink") will be +config.yml](gui-configuration#quest-locked-display) will be used. ``` yaml options: - ... + # ... locked-display: type: "STEAK" ``` diff --git a/docs/configuration/custom-gui-items.md b/docs/configuration/custom-gui-items.md index 3ce97b15..f7a2bbac 100644 --- a/docs/configuration/custom-gui-items.md +++ b/docs/configuration/custom-gui-items.md @@ -62,7 +62,7 @@ instead: ``` yaml custom-elements: "c:<category-name>": # apply to <category-name> menu - ... + # ... "quests": # apply to whole quests menu if categories are disabled - ... + # ... ``` diff --git a/docs/configuration/defining-items.md b/docs/configuration/defining-items.md index fddec792..a32bb689 100644 --- a/docs/configuration/defining-items.md +++ b/docs/configuration/defining-items.md @@ -35,17 +35,17 @@ item: ## Options -| Field | Optional | Minecraft Version | More Information | -|----------------------|-----------------|-------------------|-----------------------------------------| -| `item` | โ | \- | [Jump](#item "wikilink") | -| `name` | โ
<sup>\*</sup> | \- | [Jump](#name "wikilink") | -| `lore` | โ
| \- | [Jump](#lore "wikilink") | -| `enchantments` | โ
| \- | [Jump](#enchantments "wikilink") | -| `itemflags` | โ
| 1.8+ | [Jump](#item-flags "wikilink") | -| `unbreakable` | โ
| 1.13+ | [Jump](#unbreakable "wikilink") | -| `attributemodifiers` | โ
| 1.13+ | [Jump](#attribute-modifiers "wikilink") | -| `custommodeldata` | โ
| 1.14+ | [Jump](#custom-model-data "wikilink") | -| `owner-[...]` | โ
| 1.8+ | [Jump](#owner "wikilink") | +| Field | Optional | Minecraft Version | More Information | +|----------------------|-----------------|-------------------|------------------------------| +| `item` | โ | \- | [Jump](#item) | +| `name` | โ
<sup>\*</sup> | \- | [Jump](#name) | +| `lore` | โ
| \- | [Jump](#lore) | +| `enchantments` | โ
| \- | [Jump](#enchantments) | +| `itemflags` | โ
| 1.8+ | [Jump](#item-flags) | +| `unbreakable` | โ
| 1.13+ | [Jump](#unbreakable) | +| `attributemodifiers` | โ
| 1.13+ | [Jump](#attribute-modifiers) | +| `custommodeldata` | โ
| 1.14+ | [Jump](#custom-model-data) | +| `owner-[...]` | โ
| 1.8+ | [Jump](#owner) | <sup>\*: The name must be defined for the display item of Quests.</sup> @@ -65,7 +65,7 @@ the end with a colon `:<code>`. ``` yaml item: item: "WHEAT" - ... + # ... ``` ### Name @@ -79,7 +79,7 @@ above the hotbar when selected. ``` yaml item: name: "&2&lSuper Cool Name" - ... + # ... ``` ### Lore @@ -95,7 +95,7 @@ item: lore: - "Line 1" - "Line 2" - ... + # ... ``` ### Enchantments @@ -114,7 +114,7 @@ names](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/enchantments/Enchantm item: enchantments: - "minecraft:infinity:1" - ... + # ... ``` ### Item flags @@ -127,7 +127,7 @@ javadocs](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/inventory/ItemFlag item: itemflags: - "HIDE_ATTRIBUTES" - ... + # ... ``` ### Unbreakable @@ -137,7 +137,7 @@ item: ``` yaml item: unbreakable: true - ... + # ... ``` ### Attribute modifiers @@ -166,7 +166,7 @@ item: operation: ADD_NUMBER amount: 0.01 equipmentslot: OFF_HAND - ... + # ... ``` ### Custom model data @@ -176,7 +176,7 @@ item: ``` yaml item: custommodeldata: 12345 - ... + # ... ``` ### Owner @@ -201,19 +201,19 @@ You can specify each type by the following: ``` yaml item: owner-base64: "base64 encoded string" - ... + # ... ``` ``` yaml item: owner-username: "username" - ... + # ... ``` ``` yaml item: owner-uuid: "uuid" - ... + # ... ``` ## Quest items @@ -239,7 +239,9 @@ run `/q a items import <id>`, where `<id>` is the desired name of the item. Your item will be saved to file items/\<id\>.yml, **with the type 'raw**'. -<https://i.imgur.com/6lsld61.png> <https://i.imgur.com/Pg2eO9a.png> +<img src="https://i.imgur.com/6lsld61.png" height=20> + +<img src="https://i.imgur.com/Pg2eO9a.png" height=40> ### Defining items @@ -250,8 +252,7 @@ items/ directory. You must specify a `type` and the item itself under #### Defined **Defined quest items** are regular ItemStacks and follow the format -defined under [ยง Configurable -options](Defined_items#Configurable_options "wikilink"). +defined under [ยง options](#options). items/testitem.yml diff --git a/docs/configuration/global-configurations.md b/docs/configuration/global-configurations.md index 6be6b744..65066d31 100644 --- a/docs/configuration/global-configurations.md +++ b/docs/configuration/global-configurations.md @@ -36,7 +36,7 @@ if they are coming from individual quests. Quest-level configurations will override anything set here. To change this behaviour, modify the [global task configuration -override](Basic_options#Global_task_configuration_override "wikilink"). +override](basic-options#global-task-configuration-override). ## Global quest display configuration @@ -77,7 +77,7 @@ You can define macros in your `config.yml`, under the `global-macros` section: global-macros: - ... + # ... # <name of macro>: <string value of macro> top-bar: "&6---&7---&6---" @@ -88,13 +88,13 @@ For example, to use the `top-bar` macro in `example-quest.yml`: ``` yaml tasks: - ... + # ... display: - ... + # ... lore-normal: - "<$m top-bar $>" - "..." - ... + # ... ``` {: .caution } diff --git a/docs/configuration/gui-configuration.md b/docs/configuration/gui-configuration.md index 6a40629a..5b5b5ed0 100644 --- a/docs/configuration/gui-configuration.md +++ b/docs/configuration/gui-configuration.md @@ -6,13 +6,13 @@ nav_order: 6 # GUI configuration -*See also [Custom GUI items](Custom_GUI_items "wikilink") and [Defining -items](Defining_items "wikilink").* +*See also [Custom GUI items](custom-gui-items) and [Defining +items](defining-items).* The **GUI configuration** is defined in the `config.yml`. These define the static UI elements such as the back button, quest locked display etc. All options accept the standard ItemStack definition format -described in [Defining items](Defining_items "wikilink"). +described in [defining items](defining-items). ## Back button @@ -23,7 +23,7 @@ The back button displayed within sub menus. ``` yaml gui: - ... + # ... back-button: name: "&cReturn" lore: @@ -40,7 +40,7 @@ The previous page button displayed on paiginated menus. ``` yaml gui: - ... + # ... page-prev: name: "&7Previous Page" lore: @@ -60,7 +60,7 @@ The next page button displayed on paiginated menus. ``` yaml gui: - ... + # ... page-next: name: "&7Next Page" lore: @@ -80,7 +80,7 @@ item will automatically update on the page number. ``` yaml gui: - ... + # ... page-desc: name: "&7Page &c{page}" lore: @@ -96,11 +96,11 @@ The `{page}` variable represents the page number for the current page. *`gui.quest-locked-display`* The item is used to represent locked quests. A quest is locked if its -[requirements](Creating_a_quest#Requirements "wikilink") are not met. +[requirements](creating-a-quest#requirements) are not met. ``` yaml gui: - ... + # ... quest-locked-display: name: "&c&lQuest Locked" lore: @@ -113,7 +113,7 @@ gui: ``` The `{quest}` variable represents the quest [display -name](Creating_a_quest#name "wikilink"), with its formatting stripped. +name](creating-a-quest#name), with its formatting stripped. The `{questid}` variable represents the quest ID. @@ -121,7 +121,7 @@ The `{requirements}` variable represents the display names of the quests needed to unlock this quest. By default, this name is truncated to show only the first quest, with a number after (e.g. "Example II +4 more"). This behaviour is defined at [Basic options ยง GUI-truncate -requirements](basic-options.md#GUI-truncate-requirements "wikilink") +requirements](basic-options#gui-truncate-requirements) ## Quest permission display @@ -133,7 +133,7 @@ permission to start. ``` yaml gui: - ... + # ... quest-permission-display: name: "&6&lNo Permission" lore: @@ -143,7 +143,7 @@ gui: ``` The `{quest}` variable represents the quest [display -name](Creating_a_quest#name "wikilink"), with its formatting stripped. +name](creating-a-quest#name), with its formatting stripped. The `{questid}` variable represents the quest ID. @@ -157,7 +157,7 @@ has completed, but are on cooldown. ``` yaml gui: - ... + # ... quest-cooldown-display: name: "&e&lQuest On Cooldown" lore: @@ -168,7 +168,7 @@ gui: ``` The `{quest}` variable represents the quest [display -name](Creating_a_quest#name "wikilink"), with its formatting stripped. +name](creating-a-quest#name), with its formatting stripped. The `{questid}` variable represents the quest ID. @@ -185,7 +185,7 @@ repeatable. ``` yaml gui: - ... + # ... quest-completed-display: name: "&a&lQuest Complete" lore: @@ -196,7 +196,7 @@ gui: ``` The `{quest}` variable represents the quest [display -name](Creating_a_quest#name "wikilink"), with its formatting stripped. +name](creating-a-quest#name), with its formatting stripped. The `{questid}` variable represents the quest ID. @@ -210,7 +210,7 @@ has not started any quests. ``` yaml gui: - ... + # ... no-started-quests: name: "&c&lNo Started Quests" lore: @@ -227,7 +227,7 @@ Confirmation item in the quest cancel menu. ``` yaml gui: - ... + # ... quest-cancel-yes: name: "&a&lConfirm Cancel" lore: @@ -246,7 +246,7 @@ Cancellation item in the quest cancel menu. ``` yaml gui: - ... + # ... quest-cancel-no: name: "&c&lAbort Cancel" lore: @@ -263,7 +263,7 @@ Background item in the quest cancel menu. ``` yaml gui: - ... + # ... quest-cancel-background: type: "GRAY_STAINED_GLASS_PANE" ``` diff --git a/docs/configuration/storage-providers.md b/docs/configuration/storage-providers.md index f8d68886..8aad7a55 100644 --- a/docs/configuration/storage-providers.md +++ b/docs/configuration/storage-providers.md @@ -37,7 +37,7 @@ Quests, and is a type of 'flatfile' storage. ``` yaml options: - ... + # ... storage: provider: "yaml" ``` @@ -58,7 +58,7 @@ consistency issues. > server loading player data before the old server has saved it. > > Quests offers a workaround, which is to [delay the loading of player -> data](#delay-loading "wikilink"). You may also want to +> data](#delay-loading). You may also want to > consider forcing players to switch servers through a hub server, or > decreasing the autosave period. In either case, the race condition still > exists; there is not an easy way to coordinate the loading/saving due to @@ -73,7 +73,7 @@ player data. ``` yaml options: - ... + # ... storage: provider: "mysql" ``` @@ -112,7 +112,7 @@ README](https://github.com/brettwooldridge/HikariCP). ### Delay loading Quests offers a workaround to the [race -condition](Storage_providers#Network "wikilink"), which is to delay the +condition](#network), which is to delay the loading of player data in hopes that the server before has enough time to save the data. @@ -120,12 +120,12 @@ You can enable this in your config here: ``` yaml options: - ... + # ... storage: provider: "mysql" synchronisation: delay-loading: 0 # (ticks - change to any value above 0) - ... + # ... ``` A value of 50 (2.5 seconds) should be enough for most servers, however diff --git a/docs/contributing-to-the-wiki.md b/docs/contributing-to-the-wiki.md index 7a7a3c52..47f918bc 100644 --- a/docs/contributing-to-the-wiki.md +++ b/docs/contributing-to-the-wiki.md @@ -5,32 +5,23 @@ nav_order: 10 # Contributing to the wiki -{: .caution } -This information is out of date since the wiki migration. - If you spot any errors in the wiki, or want to add more information of -you own, then we would be happy to review potential changes. Due to the -restrictions of the GitHub wiki pages, it is not possible to open pull -requests to the wiki repository, instead changes will have to be -submitted through the [on the issue -tracker](https://github.com/LMBishop/Quests/issues/new?assignees=&labels=docs%2Cstatus%3A+needs+investigating&template=documentation.yml). +you own, then we would be happy to review changes. This documentation +is built directly from +[the `docs` directory on the `master` branch on GitHub](https://github.com/LMBishop/Quests/tree/master/docs), +using GitHub pages. ## Submitting edits -If you want to add information or edit the wiki, it would be beneficial -if you submitted the source code of the page within backticks to make it -easy to change the wiki. - -You can view the raw source code of a wiki page by adding `.mediawiki` -to the url, for example: -[`https://github.com/LMBishop/Quests/wiki/Storage-providers.mediawiki`](https://github.com/LMBishop/Quests/wiki/Storage-providers.mediawiki). -**Note that some pages are edited using Markdown, if `.mediawiki` does -not resolve then use `.md` instead. These pages do not use Wikitext but -will soon be converted to it.** - -Please make your edits to the page there, and submit the **full page** -in the issue tracker. Due to constraints of the GitHub wiki, there is no -way to easily submit revisions for review. +{: .new } +It is no longer necessary to submit edits through the issue tracker, +as documentation is now maintained within the repository itself. + +If you want to add information or edit the wiki, please fork this +repository and make your changes. + +If you need guidance, check out the [CONTRIBUTING.md](https://github.com/LMBishop/Quests/blob/master/CONTRIBUTING.md) +file in the main repository. ## Editing guidelines @@ -43,15 +34,15 @@ The Quests wiki loosely follows some conventions: with a short description at the top, they should never start with another heading. - British English should be used. -- Top-level headings should start at H2 (`## Heading` or - `== Heading ==`). H1 (`# Heading` or `= Heading =`) is never used as - this conflicts with the article title. The only exception to this is - on the home page, where the plugin name is displayed. -- Longer articles should have their contents listed at the top, with - wikilinks to each section of the page. -- Incomplete pages should have a warning at the top saying so. GitHub - wikis have no support for templates, or for transclusion, so you must - copy it manually from a different wiki page. +- Top-level headings should start at H2 (`## Heading`). H1 (`# Heading`) + is reserved for the article title itself. +- Longer articles should have a table of contents. +- Incomplete pages should have a warning at the top stating so. + You can transclude a pre-made banner by adding + `{% raw %}{% include incomplete.md %}{% endraw %}` to the page. +- Most files have an 80 character line limit, to assist with readability + in a split view, except links or source code / + configuration files. These conventions may or may not be wholly followed throughout the wiki, though it would be beneficial for new pages and new revisions to follow diff --git a/docs/developer/api.md b/docs/developer/api.md index 5bc91ff2..4ab49017 100644 --- a/docs/developer/api.md +++ b/docs/developer/api.md @@ -5,8 +5,7 @@ parent: Developer # API -{: .highlight } -**This page is under construction.** The information contained here may be inaccurate or incomplete. You can help by [contributing information to the wiki](https://github.com/LMBishop/Quests/wiki/Contributing-to-the-wiki). +{% include incomplete.md %} Quests provides an API for other people to use. **This API is experimental and may be subject to change.** For usages, it is best to take a look into the plugin itself. diff --git a/docs/developer/new-task-type.md b/docs/developer/new-task-type.md index cedc3711..3a054984 100644 --- a/docs/developer/new-task-type.md +++ b/docs/developer/new-task-type.md @@ -5,9 +5,7 @@ parent: Developer # New task type -{: .highlight } -**This page is under construction.** The information contained here may be inaccurate or incomplete. You can help by [contributing information to the wiki](https://github.com/LMBishop/Quests/wiki/Contributing-to-the-wiki). - +{% include incomplete.md %} The following information is for developers who are interested in integrating Quests into their own plugin. diff --git a/docs/download.md b/docs/download.md index 799cf804..c7bad947 100644 --- a/docs/download.md +++ b/docs/download.md @@ -1,6 +1,6 @@ --- title: Download -nav_order: 3 +nav_order: 2 --- # Download @@ -12,11 +12,11 @@ outdated versions. - [SpigotMC (preferred)](https://www.spigotmc.org/resources/quests-1-8-1-19-set-up-goals-for-players.23696/) +- [Hangar](https://hangar.papermc.io/LMBishop/Quests) - [Modrinth](https://modrinth.com/mod/quests) +- [GitHub](https://github.com/LMBishop/Quests/releases) - [Polymart](https://polymart.org/resource/quests.938) - [Songoda](https://songoda.com/marketplace/product/quests-quests.544) -- [GitHub](https://github.com/LMBishop/Quests/releases) -- <s>[Hangar (testing)](https://hangar.benndorf.dev/LMBishop/Quests)</s> Please note Hangar is still in active development and testing. It may be removed at any time. @@ -25,7 +25,7 @@ removed at any time. Some platforms may not be up-to-date yet. -<img src="https://mcbadges.leonardobishop.com/quests.svg"/> +<img src="https://mcbadges.leonardobishop.com/quests.svg"> ## Development builds diff --git a/docs/getting-started.md b/docs/getting-started.md index c25ba9cc..2eafec15 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -1,11 +1,10 @@ --- title: Getting started -nav_order: 2 +nav_order: 3 --- # Getting started -{: .highlight } -**This page is under construction.** The information contained here may be inaccurate or incomplete. You can help by [contributing information to the wiki](https://github.com/LMBishop/Quests/wiki/Contributing-to-the-wiki). +{% include incomplete.md %} Welcome to Quests! This wiki should help you with creating your own custom quests on your server. diff --git a/docs/guides/quest-progress-in-scoreboard.md b/docs/guides/quest-progress-in-scoreboard.md index aa429dac..801e1088 100644 --- a/docs/guides/quest-progress-in-scoreboard.md +++ b/docs/guides/quest-progress-in-scoreboard.md @@ -44,7 +44,7 @@ These placeholders will be called using PlaceholderAPI using the AnimatedScoreboard plugin. For example, using the placeholder `%quests_q:example1_p:description%` with PlaceholderAPI will return `&7Break &f30 blocks &7of any type.`. These are known as [local quest -placeholders](../tools/placeholderapi.md#Quest_details "wikilink"). +placeholders](../tools/placeholderapi#quest-details). Our `description` placeholder provides a description of the quest. The \`progress\` placeholder will show the players progression with the @@ -62,7 +62,7 @@ To see the full quest (with comments), click {: .note } This guide assumes you have a basic understanding of the plugin -[<https://www.spigotmc.org/resources/animatedscoreboard.20848/>](AnimatedScoreboard "wikilink"). +[AnimatedScoreboard](https://www.spigotmc.org/resources/animatedscoreboard.20848/). For our config with AnimatedScoreboard, we will create two seperate scoreboards: one with tracked quest information and one informing the @@ -185,4 +185,4 @@ quest placeholders for every quest. ## Further reading -- [Creating a quest](Creating_a_quest "wikilink") +- [Creating a quest](../configuration/creating-a-quest) diff --git a/docs/index.md b/docs/index.md index 84855e52..a64b6f84 100644 --- a/docs/index.md +++ b/docs/index.md @@ -3,123 +3,102 @@ title: Home nav_order: 1 --- <div style="float: right"> -<img src="https://leonardobishop.com/~/artwork/questcompass2-256.png" width="200" height="200"><br> +<img src="https://leonardobishop.com/~/artwork/questcompass2-256.png" width="140" height="140"><br> </div> # Quests documentation Welcome to the Quests Wiki! Please use the sidebar for navigation around the wiki. +{: .fs-6 .fw-300 } -**๐ New & Highlighted Articles** +--- -- [Tips](tips "wikilink") -- [Basic options](Basic_options "wikilink") -- [Creating a quest](Creating_a_quest "wikilink") -- [Creating a category](Creating_a_category "wikilink") -- [Custom GUI items](Custom_GUI_items "wikilink") -- [Task types](Task_types "wikilink") -- [PlaceholderAPI](tools/placeholderapi.md "wikilink") +{: .important } +The information on this wiki documents the most recent version of Quests, +and is built directly from the `docs` directory in the `master` branch on +GitHub. It may contain documentation for features not yet released. -Spot a mistake or ambiguous information? Please consider [contributing -to the wiki](contributing_to_the_wiki "wikilink"). +## New and highlighted articles -## FAQs +- [Tips](tips) +- [Basic options](configuration/basic-options) +- [Creating a quest](configuration/creating-a-quest) +- [Creating a category](configuration/creating-a-category) +- [Custom GUI items](configuration/custom-gui-items) +- [Task types](task-types) +- [PlaceholderAPI](tools/placeholderapi) -Q. What task types are there? +Spot a mistake or ambiguous information? Please consider [contributing +to the wiki](contributing-to-the-wiki). -<!-- --> +## FAQs +**Q. What task types are there?** -Many different [task types](task_types "wikilink") are provided. Follow +Many [task types](task-types) are provided with the plugin. Follow the links there to see how to format them. -<!-- --> - -Q. Can I use this plugin on a BungeeCord network/use MySQL? +Some task types require another plugin to activate. <!-- --> +**Q. Can I use this plugin on a BungeeCord network/use MySQL?** -Yes, refer to [storage providers](storage_providers "wikilink"). - -<!-- --> - -Q. Players are able to place blocks then break them to advance tasks! How do I stop this? +Yes, refer to [storage providers](configuration/storage-providers). <!-- --> +**Q. Players are able to place blocks then break them to advance tasks! How do I stop this?** -Take a look at the [Task configuration layout ยง -blockbreakcertain](Task_configuration_layout#blockbreakcertain "wikilink"). +Take a look at the options for +[blockbreakcertain](task-types/blockbreak-(task-type)). You can enable CoreProtect functionality to detect if a player has placed a block, or enable the `reverse-if-broken` flag which will subtract from task progress if a block is placed. <!-- --> -Q. How do I limit a quest to a certain world? - -<!-- --> - +**Q. How do I limit a quest to a certain world?** Most task types support world restrictions. Take a look at the task -configuration in [task configuration -layout](task_configuration_layout "wikilink") to see if your task does. - -<!-- --> - -Q. How do I organise quests in the GUI? +configuration in [task types](task-types) to see if your task does. <!-- --> +**Q. How do I organise quests in the GUI?** Quests can have a `sort-order`, which organises them within the GUI. You -can see it at [creating a quest](creating_a_quest "wikilink"). - -<!-- --> - +can see it at [creating a quest](configuration/creating-a-quest). If you want to add custom elements to a quest GUI, you can refer to -[custom GUI items](custom_GUI_items "wikilink"). - -<!-- --> - -Q. How to I only let specific players do specific quests? +[custom GUI items](configuration/custom-gui-items). <!-- --> +**Q. How to I only let specific players do specific quests?** Specific quests can have permissions enabled for them. Take a look at -[creating a quest](creating_a_quest "wikilink") for more information. +[creating a quest](configuration/creating-a-quest) for more information. Alternatively, entire categories can have permissions enabled. <!-- --> -Q. Does this plugin support PlaceholderAPI? +**Q. Does this plugin support PlaceholderAPI?** -<!-- --> - - -Yes, see [PlaceholderAPI](tools/placeholderapi.md "wikilink"). +Yes, see [PlaceholderAPI](tools/placeholderapi). <!-- --> -Q. How do I get quest progress on a scoreboard? +**Q. How do I get quest progress on a scoreboard?** -<!-- --> - - I have written a guide for this: [Quest progress in -scoreboard](Quest_progress_in_scoreboard "wikilink") +scoreboard](guides/quest-progress-in-scoreboard) <!-- --> -Q. I found a bug or have a feature request! Where do I report it? - -<!-- --> +**Q. I found a bug or have a feature request! Where do I report it?** - Great! Go to the [issue tracker](https://github.com/LMBishop/Quests/issues) to report bugs or create feature requests. Please avoid using Spigot's discussion pages or @@ -127,11 +106,8 @@ Discord for requests as I will most likely forget about it! <!-- --> -Q. I have a sizeable portion of money and I feel the need to donate it to you, where do I go? - -<!-- --> +**Q. I have a sizeable portion of money and I feel the need to donate it to you, where do I go?** - Consider giving your money to [Mind](https://www.mind.org.uk/donate); [Help for Heroes](https://www.helpforheroes.org.uk/donate-online/); [Cancer Research UK](https://www.cancerresearchuk.org/); or, any other diff --git a/docs/task-type/askyblock_level-(task-type).md b/docs/task-types/askyblock_level-(task-type).md index 823a79a6..823a79a6 100644 --- a/docs/task-type/askyblock_level-(task-type).md +++ b/docs/task-types/askyblock_level-(task-type).md diff --git a/docs/task-type/bentobox_level-(task-type).md b/docs/task-types/bentobox_level-(task-type).md index 933ee21d..933ee21d 100644 --- a/docs/task-type/bentobox_level-(task-type).md +++ b/docs/task-types/bentobox_level-(task-type).md diff --git a/docs/task-type/blockbreak-(task-type).md b/docs/task-types/blockbreak-(task-type).md index 66595b5a..66595b5a 100644 --- a/docs/task-type/blockbreak-(task-type).md +++ b/docs/task-types/blockbreak-(task-type).md diff --git a/docs/task-type/blockplace-(task-type).md b/docs/task-types/blockplace-(task-type).md index e39538c8..e39538c8 100644 --- a/docs/task-type/blockplace-(task-type).md +++ b/docs/task-types/blockplace-(task-type).md diff --git a/docs/task-type/breeding-(task-type).md b/docs/task-types/breeding-(task-type).md index 66459f7d..66459f7d 100644 --- a/docs/task-type/breeding-(task-type).md +++ b/docs/task-types/breeding-(task-type).md diff --git a/docs/task-type/brewing-(task-type).md b/docs/task-types/brewing-(task-type).md index 312e3dfb..312e3dfb 100644 --- a/docs/task-type/brewing-(task-type).md +++ b/docs/task-types/brewing-(task-type).md diff --git a/docs/task-type/bucketempty-(task-type).md b/docs/task-types/bucketempty-(task-type).md index 49806d17..49806d17 100644 --- a/docs/task-type/bucketempty-(task-type).md +++ b/docs/task-types/bucketempty-(task-type).md diff --git a/docs/task-type/bucketfill-(task-type).md b/docs/task-types/bucketfill-(task-type).md index 3648d06e..3648d06e 100644 --- a/docs/task-type/bucketfill-(task-type).md +++ b/docs/task-types/bucketfill-(task-type).md diff --git a/docs/task-type/citizens_deliver-(task-type).md b/docs/task-types/citizens_deliver-(task-type).md index 14f56f20..bc3cb6f3 100644 --- a/docs/task-type/citizens_deliver-(task-type).md +++ b/docs/task-types/citizens_deliver-(task-type).md @@ -19,7 +19,7 @@ Deliver a set of items to a Citizens NPC. | Key | Description | Type | Required | Default | Notes | |------------------------------|------------------------------------------------------------------|------------------------|----------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `amount` | The number of items to deliver. | Integer | Yes | \- | \- | -| `item` | The specific item to deliver. | Material, or ItemStack | Yes | \- | Accepts standard [item definition](defining_items "wikilink"). Please see [this list](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html) (1.13+) or [this list](https://helpch.at/docs/1.12.2/org/bukkit/Material.html) (1.8-1.12) for material names. | +| `item` | The specific item to deliver. | Material, or ItemStack | Yes | \- | Accepts standard [item definition](defining_items). Please see [this list](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html) (1.13+) or [this list](https://helpch.at/docs/1.12.2/org/bukkit/Material.html) (1.8-1.12) for material names. | | `data` | The data code for the item. | Integer | No | 0 | This field is not used in Minecraft versions 1.13+, nor is it compatible with ItemStack definitions. | | `remove-items-when-complete` | Whether the items should be taken from the player when complete. | Boolean | No | false | If `allow-partial-completion` is true, then this will also be set to true. | | `allow-partial-completion` | Whether any number of items counts towards the task progress. | Boolean | No | true | Setting to true will force `remove-items-when-complete` to true as well. If a player obtains any matching item, it will be immediately taken away from them and added towards the quest progress. | @@ -62,7 +62,7 @@ beef: - "world" ``` -Deliver 8 of [quest item](Defining-items#quest-item "wikilink") +Deliver 8 of [quest item](../configuration/defining-items#quest-items) `special_beef` to an NPC named Gerald: ``` yaml diff --git a/docs/task-type/citizens_interact-(task-type).md b/docs/task-types/citizens_interact-(task-type).md index f25e9844..f25e9844 100644 --- a/docs/task-type/citizens_interact-(task-type).md +++ b/docs/task-types/citizens_interact-(task-type).md diff --git a/docs/task-type/command-(task-type).md b/docs/task-types/command-(task-type).md index 4e2d426f..4e2d426f 100644 --- a/docs/task-type/command-(task-type).md +++ b/docs/task-types/command-(task-type).md diff --git a/docs/task-type/consume-(task-type).md b/docs/task-types/consume-(task-type).md index 4b748c89..a5e23d13 100644 --- a/docs/task-type/consume-(task-type).md +++ b/docs/task-types/consume-(task-type).md @@ -49,7 +49,7 @@ beef: - "world" ``` -Consume 8 of [quest item](Defining-items#quest-items "wikilink") +Consume 8 of [quest item](../configuration/defining-items#quest-items) `special_beef`: ``` yaml diff --git a/docs/task-type/crafting-(task-type).md b/docs/task-types/crafting-(task-type).md index 1622c502..14c9e8fb 100644 --- a/docs/task-type/crafting-(task-type).md +++ b/docs/task-types/crafting-(task-type).md @@ -49,7 +49,7 @@ compass: - "world" ``` -Craft 5 of [quest item](Defining-items#quest-item "wikilink") +Craft 5 of [quest item](../configuration/defining-items#quest-items) `super_compass`: ``` yaml diff --git a/docs/task-type/dealdamage-(task-type).md b/docs/task-types/dealdamage-(task-type).md index 426f76e2..426f76e2 100644 --- a/docs/task-type/dealdamage-(task-type).md +++ b/docs/task-types/dealdamage-(task-type).md diff --git a/docs/task-type/distancefrom-(task-type).md b/docs/task-types/distancefrom-(task-type).md index 5c0e8305..5c0e8305 100644 --- a/docs/task-type/distancefrom-(task-type).md +++ b/docs/task-types/distancefrom-(task-type).md diff --git a/docs/task-type/enchanting-(task-type).md b/docs/task-types/enchanting-(task-type).md index 1e2b6c80..1e2b6c80 100644 --- a/docs/task-type/enchanting-(task-type).md +++ b/docs/task-types/enchanting-(task-type).md diff --git a/docs/task-type/essentials_balance-(task-type).md b/docs/task-types/essentials_balance-(task-type).md index 6d246376..6d246376 100644 --- a/docs/task-type/essentials_balance-(task-type).md +++ b/docs/task-types/essentials_balance-(task-type).md diff --git a/docs/task-type/essentials_moneyearn-(task-type).md b/docs/task-types/essentials_moneyearn-(task-type).md index eba692fa..eba692fa 100644 --- a/docs/task-type/essentials_moneyearn-(task-type).md +++ b/docs/task-types/essentials_moneyearn-(task-type).md diff --git a/docs/task-type/expearn-(task-type).md b/docs/task-types/expearn-(task-type).md index 86cbf5ca..86cbf5ca 100644 --- a/docs/task-type/expearn-(task-type).md +++ b/docs/task-types/expearn-(task-type).md diff --git a/docs/task-type/fabledskyblock_level-(task-type).md b/docs/task-types/fabledskyblock_level-(task-type).md index eecf2dc0..eecf2dc0 100644 --- a/docs/task-type/fabledskyblock_level-(task-type).md +++ b/docs/task-types/fabledskyblock_level-(task-type).md diff --git a/docs/task-type/farming-(task-type).md b/docs/task-types/farming-(task-type).md index 57406c00..4207f903 100644 --- a/docs/task-type/farming-(task-type).md +++ b/docs/task-types/farming-(task-type).md @@ -12,7 +12,7 @@ Since v3.5 Minecraft 1.13+ required {: .label .label-purple } -*For previous versions, use [blockbreak](blockbreak_(task_type) "wikilink").* +*For previous versions, use [blockbreak](blockbreak-(task-type)).* Farm a set amount of crops. diff --git a/docs/task-type/fishing-(task-type).md b/docs/task-types/fishing-(task-type).md index 0143bbe4..659a6521 100644 --- a/docs/task-type/fishing-(task-type).md +++ b/docs/task-types/fishing-(task-type).md @@ -46,7 +46,7 @@ fishingcertain: - "world" ``` -Fish 10 of [quest item](Defining-items#Quest-items "wikilink") +Fish 10 of [quest item](../configuration/defining-items#quest-items) `super_fish`: ``` yaml diff --git a/docs/task-type/index.md b/docs/task-types/index.md index 4b0e657f..4b0e657f 100644 --- a/docs/task-type/index.md +++ b/docs/task-types/index.md diff --git a/docs/task-type/inventory-(task-type).md b/docs/task-types/inventory-(task-type).md index 67354434..a240207a 100644 --- a/docs/task-type/inventory-(task-type).md +++ b/docs/task-types/inventory-(task-type).md @@ -57,7 +57,7 @@ beef: - "world" ``` -Obtain 8 of [quest item](Defining-items#quest-item "wikilink") +Obtain 8 of [quest item](../configuration/defining-items#quest-items) `special_beef`: ``` yaml diff --git a/docs/task-type/iridiumskyblock_value-(task-type).md b/docs/task-types/iridiumskyblock_value-(task-type).md index 40ca8a8c..40ca8a8c 100644 --- a/docs/task-type/iridiumskyblock_value-(task-type).md +++ b/docs/task-types/iridiumskyblock_value-(task-type).md diff --git a/docs/task-type/milking-(task-type).md b/docs/task-types/milking-(task-type).md index 75c2ed86..75c2ed86 100644 --- a/docs/task-type/milking-(task-type).md +++ b/docs/task-types/milking-(task-type).md diff --git a/docs/task-type/mobkilling-(task-type).md b/docs/task-types/mobkilling-(task-type).md index 8ad286a3..f0a5c50b 100644 --- a/docs/task-type/mobkilling-(task-type).md +++ b/docs/task-types/mobkilling-(task-type).md @@ -17,14 +17,14 @@ merged into one. Both names can be used to refer to this task. ## Options -| Key | Description | Type | Required | Default | Notes | -|-----------|--------------------------------------------------|----------------------------------|----------|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `amount` | The number of mobs to kill. | Integer | Yes | \- | \- | -| `mob` | The specific mob(s) to kill. | Entity type, or list of entities | No | \- | Not specifying this field will allow all mob types to count towards the task. Please see [this list](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html) for entity types. | -| `name` | The specific name(s) of mobs to kill. | String, or list of strings | No | \- | Not specifying this field will allow mobs with any names to count towards the task. Ensure any colour codes in the name of the entity are specified, otherwise the match will not work. | -| `hostile` | Whether the mob must be hostile. | Boolean | No | \- | If specified and set to false, only non-hostile mobs will count. | -| `item` | Specific item which should be used to kill mobs. | ItemStack | No | \- | Accepts standard [item definition](defining_items "wikilink"). | -| `worlds` | Worlds which should count towards the progress. | List of world names | No | \- | \- | +| Key | Description | Type | Required | Default | Notes | +|------------------|--------------------------------------------------|----------------------------------|----------|---------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `amount` | The number of mobs to kill. | Integer | Yes | \- | \- | +| `mob` | The specific mob(s) to kill. | Entity type, or list of entities | No | \- | Not specifying this field will allow all mob types to count towards the task. Please see [this list](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html) for entity types. | +| `name` / `names` | The specific name(s) of mobs to kill. | String, or list of strings | No | \- | Not specifying this field will allow mobs with any names to count towards the task. Ensure any colour codes in the name of the entity are specified, otherwise the match will not work. | +| `hostile` | Whether the mob must be hostile. | Boolean | No | \- | If specified and set to false, only non-hostile mobs will count. | +| `item` | Specific item which should be used to kill mobs. | ItemStack | No | \- | Accepts standard [item definition](defining_items "wikilink"). | +| `worlds` | Worlds which should count towards the progress. | List of world names | No | \- | \- | ## Examples @@ -83,7 +83,7 @@ mobkillingblazemultiple: ``` Kill 10 of a blaze or creeper named either (red) "Inferno" or (orange) -"Furnace" with [quest item](Defining-items#Quest-items "wikilink") +"Furnace" with [quest item](../configuration/defining-items#quest-items) "super_sword": ``` yaml diff --git a/docs/task-type/mythicmobs_killing-(task-type).md b/docs/task-types/mythicmobs_killing-(task-type).md index 4862f66d..4862f66d 100644 --- a/docs/task-type/mythicmobs_killing-(task-type).md +++ b/docs/task-types/mythicmobs_killing-(task-type).md diff --git a/docs/task-type/permission-(task-type).md b/docs/task-types/permission-(task-type).md index aa55c00a..aa55c00a 100644 --- a/docs/task-type/permission-(task-type).md +++ b/docs/task-types/permission-(task-type).md diff --git a/docs/task-type/placeholderapi_evaluate-(task-type).md b/docs/task-types/placeholderapi_evaluate-(task-type).md index 87079d7f..87079d7f 100644 --- a/docs/task-type/placeholderapi_evaluate-(task-type).md +++ b/docs/task-types/placeholderapi_evaluate-(task-type).md diff --git a/docs/task-type/playerkilling-(task-type).md b/docs/task-types/playerkilling-(task-type).md index 4aee13bf..4aee13bf 100644 --- a/docs/task-type/playerkilling-(task-type).md +++ b/docs/task-types/playerkilling-(task-type).md diff --git a/docs/task-type/playtime-(task-type).md b/docs/task-types/playtime-(task-type).md index 649b0db4..649b0db4 100644 --- a/docs/task-type/playtime-(task-type).md +++ b/docs/task-types/playtime-(task-type).md diff --git a/docs/task-type/position-(task-type).md b/docs/task-types/position-(task-type).md index bf990ca8..bf990ca8 100644 --- a/docs/task-type/position-(task-type).md +++ b/docs/task-types/position-(task-type).md diff --git a/docs/task-type/shearing-(task-type).md b/docs/task-types/shearing-(task-type).md index 5c81e1e7..5c81e1e7 100644 --- a/docs/task-type/shearing-(task-type).md +++ b/docs/task-types/shearing-(task-type).md diff --git a/docs/task-type/shopguiplus_buy-(task-type).md b/docs/task-types/shopguiplus_buy-(task-type).md index 85c03ae9..85c03ae9 100644 --- a/docs/task-type/shopguiplus_buy-(task-type).md +++ b/docs/task-types/shopguiplus_buy-(task-type).md diff --git a/docs/task-type/shopguiplus_sell-(task-type).md b/docs/task-types/shopguiplus_sell-(task-type).md index a1c94a10..a1c94a10 100644 --- a/docs/task-type/shopguiplus_sell-(task-type).md +++ b/docs/task-types/shopguiplus_sell-(task-type).md diff --git a/docs/task-type/smelting-(task-type).md b/docs/task-types/smelting-(task-type).md index 6a6f3f49..721740c5 100644 --- a/docs/task-type/smelting-(task-type).md +++ b/docs/task-types/smelting-(task-type).md @@ -17,12 +17,12 @@ into one. Both names can be used to refer to this task. ## Options -| Key | Description | Type | Required | Default | Notes | -|----------|-------------------------------------------------|------------------------|----------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `amount` | The number of items to smelt. | Integer | Yes | \- | \- | -| `item` | The specific item to smelt. | Material, or ItemStack | No | \- | Accepts standard [item definition](defining_items "wikilink"). Please see [this list](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html) (1.13+) or [this list](https://helpch.at/docs/1.12.2/org/bukkit/Material.html) (1.8-1.12) for material names. If this is not specified, any item will count. | -| `mode` | The specific mode of smelting. | String | No | \- | One of: `smoker`, `blast_furnace`, `furnace`. If this is not specified, any furnace will count. | -| `worlds` | Worlds which should count towards the progress. | List of world names | No | \- | \- | +| Key | Description | Type | Required | Default | Notes | +|----------|-------------------------------------------------|------------------------|----------|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `amount` | The number of items to smelt. | Integer | Yes | \- | \- | +| `item` | The specific item to smelt. | Material, or ItemStack | No | \- | Accepts standard [item definition](../configuration/defining-items). Please see [this list](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html) (1.13+) or [this list](https://helpch.at/docs/1.12.2/org/bukkit/Material.html) (1.8-1.12) for material names. If this is not specified, any item will count. | +| `mode` | The specific mode of smelting. | String | No | \- | One of: `smoker`, `blast_furnace`, `furnace`. If this is not specified, any furnace will count. | +| `worlds` | Worlds which should count towards the progress. | List of world names | No | \- | \- | ## Examples @@ -62,7 +62,7 @@ smeltingcertain: - "world" ``` -Cook 10 of [quest item](Defining-items#quest-item "wikilink") +Cook 10 of [quest item](../configuration/defining-items#quest-items) `special_beef`: ``` yaml diff --git a/docs/task-type/superiorskyblock_level-(task-type).md b/docs/task-types/superiorskyblock_level-(task-type).md index c23996b6..c23996b6 100644 --- a/docs/task-type/superiorskyblock_level-(task-type).md +++ b/docs/task-types/superiorskyblock_level-(task-type).md diff --git a/docs/task-type/superiorskyblock_worth-(task-type).md b/docs/task-types/superiorskyblock_worth-(task-type).md index a47d50fe..a47d50fe 100644 --- a/docs/task-type/superiorskyblock_worth-(task-type).md +++ b/docs/task-types/superiorskyblock_worth-(task-type).md diff --git a/docs/task-type/taming-(task-type).md b/docs/task-types/taming-(task-type).md index 1847bda4..1847bda4 100644 --- a/docs/task-type/taming-(task-type).md +++ b/docs/task-types/taming-(task-type).md diff --git a/docs/task-type/uskyblock_level-(task-type).md b/docs/task-types/uskyblock_level-(task-type).md index 729ca5c6..729ca5c6 100644 --- a/docs/task-type/uskyblock_level-(task-type).md +++ b/docs/task-types/uskyblock_level-(task-type).md diff --git a/docs/task-type/votingplugin_vote-(task-type).md b/docs/task-types/votingplugin_vote-(task-type).md index 6a17abac..6a17abac 100644 --- a/docs/task-type/votingplugin_vote-(task-type).md +++ b/docs/task-types/votingplugin_vote-(task-type).md diff --git a/docs/task-type/walking-(task-type).md b/docs/task-types/walking-(task-type).md index 4c38fc27..4c38fc27 100644 --- a/docs/task-type/walking-(task-type).md +++ b/docs/task-types/walking-(task-type).md diff --git a/docs/tools/data-migration-tool.md b/docs/tools/data-migration-tool.md index 891862c7..7c456f8e 100644 --- a/docs/tools/data-migration-tool.md +++ b/docs/tools/data-migration-tool.md @@ -6,7 +6,7 @@ parent: Tools # Data migration tool The **data migration tool** is a tool that allows you to migrate your -data from one [storage provider](Storage_providers "wikilink") to +data from one [storage provider](../configuration/storage-providers) to another. This can also be used as a backup tool. The tool can be accessed using `/quests admin migratedata`, which will generate a file [migrate_data.yml](https://github.com/LMBishop/Quests/blob/master/bukkit/src/main/resources/resources/bukkit/migrate_data.yml), |
