Skip to content
Waiting Idly edited this page Apr 6, 2026 · 1 revision

BQu has many config options. While a few of these originate from BQ (Theme, Quest Notices, Use Quest Bookmark, and Max GUI Width/Height), all others are new to BQu.

You can access and edit all config options either in the file {minecraft_instance}/config/betterquesting.cfg or by navigating to Mod Options -> Better Questing Unofficial -> Config.

Player Configs

These options are intended for the player to change in-game. These can be changed via the BQu GUI, and in most cases a developer changing their default value is unintended.

  • Theme (default: betterquesting:light): This sets the theme used for the player. For a developer, it can be used to set a particular theme (or even a custom theme!) as the default. Otherwise, a player can change this setting by navigating to the Home page of the questbook and selecting the Theme option.
  • Quest Notices (default: true): This sets if the player sees popups on their screen when they complete a quest. A player can toggle this setting by navigating to the Home page and clicking the Quest Notification: On/Off button.
  • Claim all requires confirmation (default: true): When enabled, clicking the "Claim All" button on the right side of the questline GUI will open a prompt to confirm. This can be disabled by a button in said prompt.
  • Lock Tray (default: false): This controls if the sidebar, containing the questline tray and questline description tray, is always open, or if it needs to be re-enabled after leaving the page.
  • Skip Home (default: false): This controls if the player should see the Home GUI when opening the questbook. It shouldn't be changed manually - it is set to true when viewing the questline GUI, and set to false when the player visits the Home GUI again.
  • View mode (default: false): This controls if the player is in "View Mode", and is toggled via a button on the right side of the questline GUI. While in View Mode, the player can see almost all questlines and quests, and can enter any visible quest. The developer can override this by setting the "ignoresView" flag to true.

Interface Configs

These options are primarily to control minor things about how the player interacts and views the GUI.

  • Max GUI Width (default: -1): This controls the maximum width of the questbook GUI.
  • Max GUI Height (default: -1): This controls the maximum height of the questbook GUI.
  • Scroll Speed Multiplier (default: 1): This controls how much scroll movement occurs when scrolling, which includes both scrolling vertically and zooming in and out.
  • Zoom Speed (default: 1.25): This controls the speed the viewport moves when zooming in and out.
  • Zoom Smoothness (default: 100): This controls how long, in milliseconds, it takes to fully adjust the zoom level to the targeted amount.
  • Zoom In on Cursor (default: true): This controls if the zoom functionality of the scroll wheel zooms in on the cursor or on the center of the screen.
  • Zoom Out on Cursor (default: true): This controls if the zoom functionality of the scroll wheel zooms out on the cursor or on the center of the screen.
  • Limit Back (default: false): This controls if the player using the "Back" keybind can go to the Home GUI. When true, pressing the "Back" keybind will only return to the questline GUI.

Developer Configs

These configs are intended to be managed by the pack developer. In most cases, a player changing any of these will have no effect.

  • Automatically Open Separate Text Editor for Descriptions (default: false): When editing quest descriptions, you can use formatting codes to color or emphasize text. The edit GUI formats the text within it with the default Minecraft logic, which makes it so formatting codes are not rendered, and text is colored. You can open a separate window to edit descriptions which will render every character instead. Enabling this setting means that window is opened automatically, instead of requiring direct interaction.
  • Default Quest Visibility (default: NORMAL): When creating new quests, you can assign them a default visibility setting. The options here are HIDDEN, UNLOCKED, NORMAL, COMPLETED, CHAIN, and ALWAYS.
  • Spawn with Quest Book (default: true): When entering the world for the first time, give a questbook to the player. This item is not required to open the questbook, as a keybind can always be used.
  • DefaultQuests saves using Names (default: false): When saving the questbook, each quest and questline is saved to its own file. The name of that file is either the numerical id of the quest/questline, or the name of the quest/questline and the id. The names are trimmed to only the first 16 characters to avoid issues due to file path length.
  • Load DefaultQuests when an Update is Available (default: true): The questbook can be saved with a specific "pack name" and "version" When a world is loaded that has the same pack name and a lower version than the default quests, the game will automatically attempt to load those default quests. If this setting is disabled, an icon will appear in the top right of the home page of the questbook when an update is available, and that button can be clicked to update the questbook.

Performance Configs

  • Retrieval Task Detection Interval (default: 20): The time in ticks it takes for Retrieval Tasks to update. Must be between 1 and 200.

Clone this wiki locally