Questborn

🚨 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):

# Unique identifier for this quest type
id: daily

# Directory where quests of this type are stored
folder: quests/daily

# Display name in the GUI
display-name: "<#fffb99>☀ Daily Quests"

# Optional: Overrides the default GUI title for this quest type.
# gui-type-title: "<#fffb99>☀ Daily Quests &8| &f{page}/{total}"

# Optional: Overrides the default quest details GUI title.
# gui-quest-title: "<#fffb99>☀ Daily - {quest}"

# Optional: Overrides the default item transfer GUI title.
# gui-transfer-title: "<#fffb99>☀ Transfer - {quest}"

# Lore displayed in the GUI
lore:
- "<#cccccc>Fresh tasks available every day."
- "<#cccccc>Complete them to earn"
- "<#cccccc>useful rewards."
- ""
- "<#fffb99>Today's Progress:"
- " <#a7ff99>✔ <#ffffff>{cooldown}/{total} <#cccccc>completed"
- ""
- "<#7dd3ff>Click to open"

# Icon material in the GUI
material: CREEPER_SPAWN_EGG
# Slot position in the Main Menu GUI
slot: 20

# Quest engine operation mode
# Choose how quests in this category behave:
# - DEFAULT: All quests are always available, handled individually.
# - CHAIN: Players unlock the next quest only after finishing the previous one.
# - ROTATION: Players get N random quests that reset periodically.
engine: ROTATION

# Number of quests from each pool to include in the rotation
# If not specified, a 'default' pool is created matching the number of rotation-slots
rotation-pools:
  common: 3
  rare: 2

# GUI slots where assigned quests will appear
rotation-slots:
  - 20
  - 21
  - 22
  - 23
  - 24

# Reset every 1 day
reset-period: "1d"
# Optional: Set a specific time of day for global reset
reset-time: "00:00"
# Optional: 1=Mon, 2=Tue...7=Sun. Anchor day for global reset.
# reset-anchor-day: 1

# Optional: Requirements to unlock this quest type
# requirements:
#   permission: "questborn.type.daily"
#   quest-completed: "starter_chain_01_wood_call"
#   type-completed: "starter_chain"

# Optional: Description of requirements displayed in GUI when locked
# requirements-lore:
#   - "<#ff5555>Requires completion of:"
#   - " <#ff5555>• <#ffffff>Starter Chain"

# Set to false to completely disable this quest type (it won't be loaded by the plugin)
enabled: true

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):

# ------------------------------
#   STORAGE
# ------------------------------

storage:
  # Storage backend to use for player data.
  # Options:
  #   H2 - H2 file-based database (fast alternative to SQLite, recommended default)
  #   YAML  - Individual YAML files per player (legacy)
  #   MYSQL - MySQL / MariaDB database (recommended for networks with multiple servers)
  #   POSTGRESQL - PostgreSQL database (alternative to MySQL)
  #   SQLITE - SQLite file-based database (good middle-ground for single servers)
  #   MONGODB - MongoDB via official driver (requires internet or local server)
  type: H2

  # MySQL / MariaDB settings (used only when type: mysql)
  mysql:
    host: localhost
    port: 3306
    database: questborn
    username: root
    password: ""
    # Connection pool size
    pool-size: 5
    # Connection timeout in milliseconds
    connection-timeout: 30000
    # Use SSL for connection
    use-ssl: false

  # PostgreSQL settings (used only when type: postgresql)
  postgresql:
    host: localhost
    port: 5432
    database: questborn
    username: postgres
    password: ""
    # Connection pool size
    pool-size: 5
    # Use SSL for connection
    use-ssl: false

  # MongoDB settings (used only when type: mongodb)
  mongodb:
    uri: "mongodb://localhost:27017"
    database: questborn
    collection: player_data
    # Timeouts in milliseconds
    connect-timeout: 5000
    read-timeout: 5000

  # SQLite settings (used only when type: sqlite)
  # The database file is located in the plugin's data folder.
  sqlite:
    file: questborn.db

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:

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:

%questborn_quests_completed% - total number of quests completed by the player %questborn_status_% - quest status (ACTIVE, COMPLETED, COOLDOWN, AVAILABLE, UNAVAILABLE) %questborn_cooldown_% - remaining cooldown time for a specific quest %questborn_active_id% - ID of the current active quest %questborn_active_name% - name of the current active quest %questborn_active_description% - description of the current active quest %questborn_active_stage_current% - current stage %questborn_active_stage_total% - total number of stages %questborn_active_progress_current% - current stage objective progress %questborn_active_progress_target% - target stage objective progress %questborn_active_progressbar% - graphical progress bar %questborn_active_objective% - current objective text (first line) %questborn_active_objective-% - 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:

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}"

https://i.ibb.co/27hCNJ4h/Scoreboard-1.png https://i.ibb.co/DD6qf4FZ/Boss-Bar-1.png

🎨 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:

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

integration:
  enabled: false               # Enable or disable NPC integration
  npc-plugin: FANCYNPCS        # Choose plugin: CITIZENS or FANCYNPCS
  mode: MIXED                  # Modes:
                               # MIXED – both commands and NPCs work
                               # NPC_ONLY – only NPCs (commands disabled)
                               # MENU_ONLY – only commands (NPCs disabled)
  interaction-button: RIGHT    # Button used to interact with NPC (LEFT / RIGHT)

Indicators above NPC head

npc-indicators:
  enabled: true
  view-distance: 20.0
  offset-y: 0.6
  icons:
    available: "&6&l!"
    in-progress: "&a&l▣"
    completed: "<#00ff94>&l✔"
    cooldown: "&b⏳"
    locked: "&c&l"
    reward-available: "<#00ff66>&l"

Other new settings

gameplay:
  allowed-gamemodes:           # Game modes allowed for quest progression
    - SURVIVAL
    - ADVENTURE

chat:
  show-details: true           # Show detailed info (objectives + clickable link) in activation/stage messages

rewards:
  # If true, rewards are automatically given upon quest completion (bypassing NPC claim).
  # If false, player must claim rewards (via NPC interaction or GUI).
  auto-claim: false

New commands

• /quest npc link – link a quest type to an NPC Examples: • FancyNPCs: /quest npc link daily joe • Citizens: /quest npc link daily 1

• /quest npc unlink – 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.