- Make a full backup of the Questborn plugin folder (especially player data and configs) before updating!

The New ROTATION Engine
Introducing the completely new ROTATION engine! It is perfect for creating daily, weekly, or other cyclical quests:

• Quest Pools: Automatic and randomized quest generation from pre-configured pools.
• Reset Timers: Flexible configuration for progress resets (daily, every few days, or at a specific time).
• Individual Generation: You can now configure it so every player gets their own unique set of quests from a pool, or keep it the same for everyone.
• GUI Display: Full support for configuring specific slots where selected quests will appear for each type (rotation-slots).
• Built-in Quests Updated: The default daily and weekly quests have been completely rewritten to utilize the new ROTATION engine features!

This is how it looks now ( daily.yml):
Global Database Update
The progress storage system has been written entirely from scratch to provide better performance and stability.

• Supported Databases: The plugin now supports H2, SQLite, MySQL, PostgreSQL, MongoDB, and YAML.
• New Standard: The default database type is now H2. This guarantees much faster, more stable, and reliable saves compared to regular .yml files.
• Automatic Migration: Don't worry about your old data! On the first launch of version 1.5.0, your old playerdata.yml file will be automatically recognized, and all player data will be seamlessly migrated to the new H2 format.

This is how it looks now ( config.yml):
Enjoy using the update!

IMPORTANT - BEFORE UPDATING:

• Make a full backup of the Questborn plugin folder (especially configs, player progress data, and player files) before updating!
• After the update, delete the old config.yml file — the plugin will automatically create a new one with all the latest settings.
• The old top.yml file is no longer used and can be completely deleted — everything has been moved to the new menus.yml.

New features and changes:

• New integration with ItemsAdder
  Added the ability to use custom ItemsAdder items in quests.
  Usage example:
  
  Code (YAML):

  
  objectives:
      type : ITEM_FISH
      amount : 6
      target-materials :
       - "itemsadder:iasurvival:blue_parrotfish"
   
• Full integration with PlaceholderAPI
  Added complete PlaceholderAPI support. Now you can display quest information in holograms, chat, tab list, Scoreboard, etc.
  Available placeholders:
  • Code (Text):

    %questborn_quests_completed%
    - total number of quests completed by the player
  • Code (Text):

    %questborn_status_<id>%
    - quest status (ACTIVE, COMPLETED, COOLDOWN, AVAILABLE, UNAVAILABLE)
  • Code (Text):

    %questborn_cooldown_<id>%
    - remaining cooldown time for a specific quest
  • Code (Text):

    %questborn_active_id%
    - ID of the current active quest
  • Code (Text):

    %questborn_active_name%
    - name of the current active quest
  • Code (Text):

    %questborn_active_description%
    - description of the current active quest
  • Code (Text):

    %questborn_active_stage_current%
    - current stage
  • Code (Text):

    %questborn_active_stage_total%
    - total number of stages
  • Code (Text):

    %questborn_active_progress_current%
    - current stage objective progress
  • Code (Text):

    %questborn_active_progress_target%
    - target stage objective progress
  • Code (Text):

    %questborn_active_progressbar%
    - graphical progress bar
  • Code (Text):

    %questborn_active_objective%
    - current objective text (first line)
  • Code (Text):

    %questborn_active_objective-<number>%
    - specific line (e.g. -0, -1, etc.)
  
  
• Quest display (Scoreboard & BossBar)
  Added convenient display of the current quest on screen via Scoreboard and BossBar. Fully configurable in config.yml.
  Configuration example:
  
  Code (YAML):

  
  bossbar:
    enabled : true
    title : "&e{quest_name} &7[{progress}/{target}]"
    color : AUTO
    mode : "STATIC"
    style : SOLID
  scoreboard:
    enabled : true
    lines :
     - "&fQuest:"
      - "{quest_name}"
      - "{objective_details}"
   
  
  
  
• New menu configuration system (menus.yml)
  The old top.yml file has been merged into a single menus.yml. Now you can freely customize the GUI size and exact element placement in each menu.
  Example for Top menu:
  
  Code (YAML):

  
  menus:
    top:
      rows : 5
      slots:
        players :
         - "10-16"
          - "19-25"
          - "28-34"
      mask :
       - "0-9"
        - "17, 18, 26, 27, 35, 36"
        - "36-44"
      rank-styles:
        1:
          prefix : "<#FFAA00>♛ "
          footer : "<#FFAA00> TOP 1 LEADER "
   
• Integration with SkinsRestorer
  Added small integration to improve skin display in the player leaderboard.
  
• ⚙️ Technical improvements
  • Updated and optimized configuration structure
  • Minor code refactoring and performance optimization

Enjoy using the update!

Updated library that caused ActionBar to not work on version 1.21.11

!!! IMPORTANT NOTE !!! Before using this version of the plugin, make a backup of your plugin data. Also, delete the existing configuration file, localization files, and effect presets so the plugin can generate fresh, updated versions of these files.

Update Log

New NPC Integration (Citizens & FancyNPCs)

Added full support for NPCs from the Citizens and FancyNPCs plugins!

- Players can now accept and complete quests by interacting with NPCs.
- An indicator above the NPC's head displays the status of available quests.

New supported versions
- 1.16
- 1.17
- 1.18
- 1.19
- 1.20

New settings in config.yml

Integration

Indicators above NPC head

Other new settings


New commands
- /quest npc link <typeID> <npcID> – link a quest type to an NPC
Examples:
• FancyNPCs: /quest npc link daily joe
• Citizens: /quest npc link daily 1

- /quest npc unlink <typeID> <npcID> – unlink a quest type from an NPC
Examples:
• FancyNPCs: /quest npc unlink daily joe
• Citizens: /quest npc unlink daily 1

- /quest details – open detailed view of the currently active quest

Note: Before linking an NPC, create it in Citizens or FancyNPCs and note its ID
(for Citizens – numeric ID, for FancyNPCs – name).

Improved quest details menu
The quest details interface has been completely redesigned – all elements are now arranged conveniently, beautifully, and informatively.

Updated documentation
Documentation has been updated to reflect the current plugin version:
https://questborn.gitbook.io/docs/

Thank you for using QuestBorn!

Fixed objectives:
- BREWING - Now correctly counts progress when picking up a brewed item.
- STRIP_LOG - Now it only counts when cutting a log, previously it could be obtained.
- PLANT_SEED - Now counts both various crop seeds and tree saplings.

Changed the active quest icon:
- An active quest is now marked with an enchantment.
- A completed one-time quest now shows the quest icon.

Fully updated built-in quests:
- 4 new quest types.
- 60+ total quests,
(These quests are made to demonstrate the plugin's capabilities).

Minor localization fix.

Fixes:

- Quests of the 'starter' type:
Problem: The progression chain for built-in quests of the 'starter' type was broken, preventing subsequent quests from activating.
Fix: Corrected the internal chain logic. Progression for 'starter' type quests now works correctly.

- Objective ITEM_CRAFT (Craft Item):
Problem: The objective failed to register a successful craft if the player immediately dropped the resulting item by hovering over it and pressing Q. Using Shift to craft multiple items also did not register.
Fix: Updated the tracking logic to record the crafting action as successful the moment the item is created, prior to any inventory management.
Pressing Q to drop the newly crafted item now correctly counts towards objective completion.
Crafting multiple items with Shift + Click is now also registered properly.

Before installing this update, you MUST:

1. Make a full backup of the plugin folder
2. Delete the following folders from the old plugin:
- config/
- languages/
3. These folders will be automatically regenerated when the updated version starts with the new structures

Version Changes

New Systems
- Added item transfer system for quests
Now you can configure receiving/turning in items during quest completion.
- Added quest stage system
Quests can have multiple sequential stages with different completion conditions.

Detailed documentation: See the documentation for how to properly use the new systems.

Quest Types and Examples
- Added new quest types with support for stages and item transfer.
- On first launch, the plugin automatically creates a demonstration quest type that illustrates:
- Stage functionality
- Item transfer mechanics

Localization Expansion
Added support for 5 new languages:
- pt-BR - Portuguese (Brazil)
- fr-FR - French
- tr-TR - Turkish
- kk-KZ - Kazakh
- pl-PL - Polish

Technical Changes
- Updated configuration file structure
- New localization file structure
- Improved data loading system

Notes
- Check plugin settings after updating
- Demonstration quests can be deleted after familiarization
- Recommended to test the update on a test server first

Before installing this update, you MUST:

1. Make a full backup of the plugin folder
2. Delete the following folders from the old plugin:
- config/
- languages/
3. These folders will be automatically regenerated when the updated version starts with the new structures

Version Changes

New Systems
- Added item transfer system for quests
Now you can configure receiving/turning in items during quest completion.
- Added quest stage system
Quests can have multiple sequential stages with different completion conditions.

Detailed documentation: See the documentation for how to properly use the new systems.

Quest Types and Examples
- Added new quest types with support for stages and item transfer.
- On first launch, the plugin automatically creates a demonstration quest type that illustrates:
- Stage functionality
- Item transfer mechanics

Localization Expansion
Added support for 5 new languages:
- pt-BR - Portuguese (Brazil)
- fr-FR - French
- tr-TR - Turkish
- kk-KZ - Kazakh
- pl-PL - Polish

Technical Changes
- Updated configuration file structure
- New localization file structure
- Improved data loading system

Notes
- Check plugin settings after updating
- Demonstration quests can be deleted after familiarization
- Recommended to test the update on a test server first

Fixed:
- disabled-for-types in config - now correctly accepts the type and disables it for display in ActionBar.
- ITEM_CRAFT objective - now correctly counts the number of crafted items.

Changed:
Distance-based objectives now only read the distance parameter.
- ELYTRA_FLY objective now uses distance instead of amount.
- MINECART_TRAVEL objective now uses distance instead of amount.

Major New Features
- Chain Quest System - Full support for sequential quest chains. New quests are auto-generated in the plugin folder on first launch.
- Quest Engine Selection - Added engine: setting (default or chain) to define quest behavior.
- Visual Customization - Set quest icons with icon-material: and arrange chain quests with slot: positioning.
- Optimization Setting - New performance tuning option in main configuration.
- Simplified GUI Mode - Use /quest open list daily --simple to hide back buttons (ideal for NPC menus).

Core Changes
- Permission System Overhaul - All permissions migrated from quest.* to questborn.*.
- Startup Log Revamp - Cleaner, more informative initialization messages.

⚠️ CRITICAL UPDATE NOTES
Before installing this update, you MUST DELETE these old files/folders:
- config.yml
- Entire language/ folder

These files have been completely restructured and will be regenerated automatically on startup with new defaults.

Update Summary
- ✅ Chain quest engine with automatic setup
- ✅ New permission namespace (questborn.*)
- ✅ Quest icon & slot customization
- ✅ Performance optimization options
- ✅ Simplified GUI for NPC integration
- ✅ Improved logging and configuration structure

Note: Backup your existing quest files before updating, as the configuration format has significantly changed.

⚠ IMPORTANT:
Before installing this update, you MUST delete the following old files:
- config.yml
- language/en_us.yml
- language/uk_ua.yml

These files were updated and will be regenerated automatically on startup.

New Features:
- Added plugin update checker.
Questborn now notifies server owners when a new version is available.

- Added new language localizations:
• es_es (Spanish)
• de_de (German)
• ru_ru (Russian)

Improvements:
- Updated and improved existing localizations:
• en_us
• uk_ua

- Fixed potion display in quest objective descriptions.
Potion names and types are now displayed correctly.

- Quest Effects localization update:
The plugin page now provides downloadable quest-effects versions
localized for all supported languages:
• en_us
• uk_ua
• es_es
• de_de
• ru_ru

Fixes:
- Minor GUI text rendering fixes.
- Localization consistency improvements across quests and objectives.