Modify

A Guidance how to modify things...

Things to notice is this Product uses PlayerPoints, to Unlock the Upgrade Perks!

I DO NOT RECOMMEND YOU TO /AV RELOAD!, PLEASE FULLY RESTART YOUR SERVER FOR AN OPTIMIZED RESULT.

📁 1. Plugin Folder Location

After you install Quests (the JAR file you download from Spigot), run your server at least once. Once it loads, it will create a folder here:

/plugins/Quests/

Inside this folder you will find several directories and files. This is the main place you will be working.

---

📝 How To Edit

1. Open “config.yml” in a text editor: Recommended editors:

   • Notepad++

   • Notepad (Windows Default Apps)

2. Change values carefully — incorrect YAML formatting will break the plugin. Debuging Tools

3. Save the file.

4. Restart the server (or use /q a reload if supported) to apply changes.

---

💬 2. Language / Localization Files

📂 Default Path

Quests uses a language system where all messages can be translated.

Look here:

/plugins/Quests/config.yml

Inside this config.yml folder you’ll see language formats contains:

# -----------------------------------------------------------
#  Titles and messages
#  -------------------
#
#  Please refer to the source code for the default messages.
# -----------------------------------------------------------
titles:
  quest-start:
    title: "&cQuest Started"
    subtitle: "&7{quest}"
  quest-complete:
    title: "&cQuest Complete"
    subtitle: "&7{quest}"

messages:
  time-format: "{hours}h {minutes}m"
  quest-start: "&7Quest &c{quest} &7started!"
  quest-complete: "&7Quest &c{quest} &7completed!"
  quest-cancel: "&7Quest &c{quest} &7cancelled!"
  quest-expire: "&7Quest &c{quest} &7has expired."
  quest-track: "&7Tracking quest &c{quest}&7."
  quest-track-stop: "&7No longer tracking quest &c{quest}&7."
  quest-random-none: "&cYou have no quests which you can start."
  quest-start-limit: "&7Players are limited to &c{limit} &7started quests at a time."
  quest-start-disabled: "&7You cannot repeat this quest."
  quest-start-locked: "&7You have not unlocked this quest yet."
  quest-start-cooldown: "&7You have recently completed this quest. You have to wait &c{time} &7until you are able to restart it."
  quest-start-started: "&7You have already started this quest."
  quest-start-permission: "&7You do not have permission to start this quest."
  quest-category-permission: "&7You do not have permission to view this category."
  quest-category-quest-permission: "&7You do not have permission to start this quest since it is in a category you do not have permission to view."
  quest-cancel-notstarted: "&7You have not started this quest."
  quest-cancel-notcancellable: "&7You cannot cancel this quest."
  quest-updater: "&cQuests > &7A new version &c{newver} &7was found on Spigot (your version: &c{oldver}&7). Please update me! <3 - Link: {link}"
  command-data-not-loaded: "&4Your quests progress file has not been loaded; you cannot use quests. If this issue persists, contact an admin."
  command-sub-doesntexist: "&7The specified subcommand '&c{sub}' &7does not exist."
  command-no-permission: "&7You do not have permission to use this command."
  command-quest-cancel-specify: "&7You must specify a quest to cancel."
  command-quest-start-doesntexist: "&7The specified quest '&c{quest}&7' does not exist."
  command-quest-general-doesntexist: "&7The specified quest '&c{quest}&7' does not exist."
  command-category-open-disabled: "&7Categories are disabled."
  command-category-open-doesntexist: "&7The specified category '&c{category}&7' does not exist."
  command-quest-admin-playernotfound: "&7Player '&c{player}&7' could not be found."
  command-quest-openquests-admin-success: "&7Opened Quest GUI for player &c{player}&7."
  command-quest-openstarted-admin-success: "&7Opened started Quest GUI for player &c{player}&7."
  command-quest-opencategory-admin-success: "&7Opened category &c{category} &7for player &c{player}&7."
  command-taskview-admin-fail: "&7Task type '&c{task}&7' does not exist."
  beta-reminder: "&cQuests > &7Reminder: you are currently using a &cbeta &7version of Quests. Please send bug reports to https://github.com/LMBishop/Quests/issues and check for updates regularly using &c/quests admin update&7!"
  command-quest-admin-loaddata: "&7Quest data for '&c{player}&7' is being loaded."
  command-quest-admin-nodata: "&7No data could be found for player &c{player}&7."
  command-quest-admin-fullreset: "&7Data for player &c{player}&7 has been fully reset."
  command-quest-admin-start-faillocked: "&7Quest '&c{quest}&7' could not be started for player &c{player}&7. They have not yet unlocked it."
  command-quest-admin-start-failcooldown: "&7Quest '&c{quest}&7' could not be started for player &c{player}&7. It is still on cooldown for them."
  command-quest-admin-start-failcomplete: "&7Quest '&c{quest}&7' could not be started for player &c{player}&7. They have already completed it."
  command-quest-admin-start-faillimit: "&7Quest '&c{quest}&7' could not be started for player &c{player}&7. They have reached their quest start limit."
  command-quest-admin-start-failstarted: "&7Quest '&c{quest}&7' could not be started for player &c{player}&7. It is already started."
  command-quest-admin-start-failpermission: "&7Quest '&c{quest}&7' could not be started for player &c{player}&7. They do not have permission."
  command-quest-admin-start-failcategorypermission: "&7Quest '&c{quest}&7' could not be started for player &c{player}&7. They do not have permission for the category which the quest is in."
  command-quest-admin-start-failother: "&7Quest '&c{quest}&7' could not be started for player &c{player}&7."
  command-quest-admin-start-success: "&7Quest &c{quest} &7started for player &c{player}&7."
  command-quest-admin-category-permission: "&7Category &c{category} &7 could not be opened for player &c{player}&7. They do not have permission to view it."
  command-quest-admin-complete-success: "&7Quest &c{quest} &7completed for player &c{player}&7."
  command-quest-admin-reset-success: "&7Successfully reset quest '&c{quest}&7' for player &c{player}&7."
  command-quest-admin-random-none: "&7Player &c{player}&7 has no quests which they can start."
  command-quest-admin-random-success: "&7Successfully started random quest '&c{quest}&7' for player &c{player}&7."
  command-quest-admin-random-category-none: "&7Player &c{player}&7 has no quests in category '&c{category}&7' which they can start."
  command-quest-admin-random-category-success: "&7Successfully started random quest '&c{quest}&7' from category '&c{category}&7' for player &c{player}&7."
  ui-placeholder-completed-true: "true"
  ui-placeholder-completed-false: "false"
  ui-placeholder-truncated: " +{amount} more"
  ui-placeholder-no-time-limit: "No time limit"
  placeholderapi-true: "true"
  placeholderapi-false: "false"
  placeholderapi-no-tracked-quest: "No tracked quest"
  placeholderapi-quest-not-started: "Quest not started"
  placeholderapi-no-time-limit: "No time limit"
  placeholderapi-data-not-loaded: "Data not loaded"

Furthermore for the categories.yml:

# -----------------------------------------------------------
#  Categories
#  ----------
#
#  Categories are a way of grouping quests.
#  When a player uses /quests, a menu of categories will be presented to them.
#  When a player clicks on a category, a list of quests under that category will show.
#  If categories are disabled, all quests will be shown under one big GUI.
#  Players can access specific categories by command using /quests c [category].
#  If a quest does not have a category, it will not be shown.
# -----------------------------------------------------------
categories:
  examples:
    display:
      name: "&cExample Quests"
      lore:
        - "&7This category contains example quests"
        - "&7which are commented in the config."
        - "&7The comments should guide you with"
        - "&7how the config works."
        - ""
        - "&cIt is highly recommended you read this"
        - "&csection and all the comments so you can"
        - "&cmake the most of this plugin."
      type: "WATER_BUCKET"
  permissionexample:
    display:
      name: "&cPermission Example"
      lore:
        - "&7This category is an example of one which"
        - "&7requires a permission to open."
        - ""
        - "&cIt is highly recommended you read this"
        - "&csection and all the comments so you can"
        - "&cmake the most of this plugin."
      type: "WATER_BUCKET"
    # This category needs the permission "quests.category.permissionexample", because the category ID is 'permissionexample'.
    # The permission for other categories is: "quests.category.<id>".
    permission-required: true

---

📂 3. Quest Files (Where the quests themselves are stored)

This plugin stores the individual quests in a separate folder:

/plugins/Quests/quests/

Inside this folder you will see .yml files — one file per quest, or organized into subfolders.

Each quest file defines:

• Quest name (ID)

• Objective(s)

• Rewards

• Descriptions

• Conditions

The wiki has detailed documentation on how to format these quests.

---

📝 4. Best Practices When Editing

💡 Backup First

Before editing anything:

1. Make a copy of the original config and language files. Example:

   config.yml → config_backup.yml
   strings.yml → strings_backup.yml

2. If something breaks, restore the backup.

---

🧹 YAML Formatting Rules

✔ Use spaces, not tabs. ✔ Each level of indentation must be consistent. ✔ Always match colons (:) with the correct indentation.

Example bad vs good:

❌ Incorrect

options:
 categories-enabled: true
trim-gui-size:true

✅ Correct

options:
  categories-enabled: true
  trim-gui-size: true

---

📘 6. Useful Wiki Resources

The official wiki contains detailed guides on many parts of Quests:

📌 Configuration basics ➡ https://quests.leonardobishop.com/configuration/basic-options.html

📌 Tips for creating/editing quests ➡ https://quests.leonardobishop.com/tips.html

📌 Full documentation homepage ➡ https://quests.leonardobishop.com/

It's best to ask the author of the Plugin or the Config, if you need some furthermore explanation regarding of how to modify some stuff around.