The configuration of BetonQuest is mainly done in the
config.yml file. All of its options are described on this page.
There is also additional information about backups, updates and database transfers.
If you fail to understand options just keep their default values. You can always change them when
you have gained a more complete understanding of this plugin.
Do not touch
version: option! It may corrupt your files!
In order to use a MySQL Database for saving all the data you need to fill out the mysql config section.
1 2 3 4 5 6 7 8
Migrating a database from SQLite to MySQL and back🔗
Follow these few simple steps to migrate your database easily:
- Create a backup with /q backup command.
- Extract database backup from it.
- Turn the server off.
- Place the database-backup.yml file inside the plugin's directory.
- Edit which database type you want to use by setting the
enabledoption in the
mysqlsection to true or false.
- Start the server.
- Check for errors.
- If there are no errors, enjoy your migrated database.
- If there are any errors, post them to the developer or try to fix them if you know how.
language: is the default translation of the plugin for every new player. Currently, there are 9 languages available:
English (en), Polish (pl), German (de), French (fr), Spanish (es), Chinese (cn), Dutch (nl), Italian (it) and Hungarian (hu).
update section controls the Auto-Updater. It has the following settings:
true). Enables or disables the Updater. If set to false, it is not possible to update with the updater and no version checks are executed.
MINOR). The update strategy is the most important feature of the Auto-Updater. An explanation is available here.
true). If true the updater will download new Versions automatically. Otherwise, the updater will only download new versions when the update command is executed. Advice is available here.
default_journal_slot is the inventory slot in which the journal will appear after using the
BetonQuest will try to move items out of the way if the slot is occupied. If the inventory is full the journal will not
be added. You can disable this behaviour by setting the option to
-1. BetonQuest will then just use any free slot.
citizens_npcs_by_name sets whether NPCs from Citizens 2 should be identified in package.yml by their name instead of
their id. This is a dangerous setting as two different NPC's at the opposite edges of your world that share the same
name by accident will trigger the same quest.
Citizens left click🔗
acceptNPCLeftClick activates that a conversation with an NPC can also be started by left clicking the NPC and not only
by right clicking the NPC.
Citizens interact limit🔗
npcInteractionLimit prevents NPC / BetonQuest conversation click spamming. The time's unit is milliseconds. Default
Conversation End Distance🔗
max_npc_distance is the distance you need to walk away from the NPC for the conversation to end (in the case of using
chat-based conversation interface).
Default conversation style🔗
default_conversation_IO is a comma-separated list of conversation interfaces with the first valid one used.
Read this page for more information about conversation interfaces.
Default Chat interceptor🔗
default_interceptor is a comma-separated list of chat interceptors with the first valid one used.
Read this page for more information about chat interceptors.
Default Hologram Plugin🔗
The holograms related features work with multiple plugins.
You can use the
default_hologram option to set which plugin should be used.
default_hologram: DecentHolograms,HolographicDisplays will make DecentHolograms the default hologram plugin. If it is not installed,
HolographicDisplays will be used instead. If you want to use HolographicDisplays as the default, you can use
Conversation Chat Display options🔗
display_chat_after_conversation this will prevent all chat messages from displaying during a conversation and it will show them once it's finished.
combat_delay is a delay (in seconds) the player must wait before starting a conversation after combat.
Conversation pullback message🔗
notify_pullback will display a message every time the player is pulled back by the
stop option in conversations (in the case of chat-based conversations).
It notifies players that they are in a conversation, and the pullback is not a bug.
Adjusting the backpack to the KeepInventory gamerule🔗
remove_items_after_respawn option should be turned on if "keepInventory" gamerule is not being used.
It prevents other plugins from duplicating quest items after death.
When a player dies, their quest items are removed from drops and stored in the backpack, but some plugins may try to restore all items to the player (for example WorldGuard custom flag keep-inventory). That is why BetonQuest removes the quest items that are in a player's inventory after they respawn again, to be sure they were not re-added. The "keepInventory" gamerule, however, works differently - the items are never dropped, so they cannot be added to backpack. Removing them from the inventory would destroy them forever. Sadly, Bukkit does not allow for gamerule checking, so it is up to you to decide.
Once again, if you have "keepInventory" gamerule true, this setting has to be false and vice versa.
Quest Items break behaviour🔗
quest_items_unbreakable controls whether quest items can be broken by using them.
This was used in the past when the
unbreakable tag couldn't be added to items.
Turn it off and make your quest items unbreakable by vanilla means.
Player Hider interval🔗
player_hider_check_interval the interval in which the PlayerHider checks the conditions and updates the player's visibility.
Cannot be disabled currently. If you want this to be semi-disabled set a very high value.
NPC Hider interval🔗
npc_hider_check_interval is the interval in which the NPCHider checks the conditions and updates the NPC's visibility.
Cannot be disabled currently. If you want this to be semi-disabled set a very high value.
This section defines what sounds will be played on these occasions:
endrefer to start and end points of conversations.
journalis played upon updating the journal.
updateis played when there is a changelog file, used to draw your attention.
fullis played when the player executes
/journalbut his inventory is full.
A list of all possible sounds for the latest Minecraft version can be found here.
Conversation Command Banlist🔗
cmd_blacklist is a list of commands that cannot be used during a conversation. Remember that you can only type single words (command names) here!
hook controls compatibility with other plugins. You can turn off each hook here.
journal controls various settings of the journal:
chars_per_pageis the number of characters before a page break. If it is set too high, the text on a journal page can overflow and become invisible. This was replaced by
lines_per_pageand is only required if you don't like the new behaviour.
chars_per_lineis the number of characters before a line break. If it is set too high, the text on a journal page can overflow and become invisible. If this is not set, BQ will fall back on the old page wrapping behaviour configured through
lines_per_pageis the number of lines before a new page. If it is set too high, the text on a journal page can overflow and become invisible. This is only required if
one_entry_per_pagemakes each entry take a single page. Note that it will not expand to other pages even if it overflows, so keep your entries short.
reversed_ordercontrols the chronological order of entries in the journal. By default, the entries are ordered from newest to oldest. It is reversible, but this will force players to click through many pages to get to the most recent entry.
hide_datehides the date of each entry. Set it to true if you don't want this functionality.
full_main_pagemakes the main page always take a full page. If a lot of information is being displayed, it is advised to make this true. If you use the main page only for small notifications, set it to false, so the entries can follow immediately.
show_separatorshows a separator between journal entries (default: true). Customize the separator in
messages.ymlwith the key
show_in_backpackwhether to display the journal in the backpack when there is no journal in the player's inventory.
lock_default_journal_slotlocks the journal to the
give_on_respawnadds the journal to the player inventory.
custom_model_datasets the custom model data of the journal item.
journal_colors controls the colors used in the journal. It takes color codes without the
date.dayis the day number
date.houris the hour number
lineis the delimiter between entries
textis the text of the entry
conversation_colors controls the colors of the conversation. It takes color names.
If you want to add a font style (bold, italic etc.) do so after placing a comma.
npcis the name of the NPC
playeris the name of the player
textis the NPC's text
answeris the text of player's answer (after choosing it)
numberis the option number
optionis the text of an option
Conversation Settings: ChestIO🔗
conversation_IO_configmanages settings for individual conversation IO's:
chestmanages settings for the chest conversation IO
show_numberwill show the player number option if true (default: true)
show_npc_textwill show the npc text in every player option if true (default: true)
download controls security restrictions for the
/q download command:
pullrequestsdefines if pull requests may be downloaded. Only enable this if you really know what you are doing! Everyone can open pull requests that could contain malicious files and if a permission misconfiguration occurs this will make your server vulnerable to attacks.
repo_whitelistis a list of trusted github repositories from which quests and templates can be downloaded.
By default only or official tutorial repo BetonQuest/Quest-Tutorials is on this list.
The items section allows you to override the default items that are displayed across BetonQuest's GUIs. All items you specify here need to be defined in a package. You need to reference the item with a full path.
compass_button can be removed from the backpack by setting their values to
items: backpack: #(1)! previous_button: "my_package.backpack_previous_button" #(2)! next_button: "my_package.backpack_next_button" #(3)! cancel_button: "my_package.backpack_cancel_button" #(4)! compass_button: "my_package.backpack_compass_button" #(5)!
- All items that are used by the backpack.
- The button to go to the previous backpack page.
- The button to go to the next backpack page.
- The quest cancelers. Can be removed from the backpack by setting the value to
- The quest compass. Can be removed from the backpack by setting the value to
date_formatis the Java date format used in journal dates. It needs to have a space between the day and hour.
debugis responsible for logging the plugin's activity to debug.log file in logs directory. Turning this on can slow your server down. However, if you experience any errors, turn this on and let the plugin gather the data and send logs to the developer. Note that the first run of the plugin will be logged anyway, just as a precaution.