Configuration

The main configuration file is located at plugins/SpContentQuests/config.yml.

General Settings

config-version: 1
update-checker: true
auto-save-interval: 5
gui-click-cooldown: 200

Setting	Default	Description
config-version	1	Internal config version (do not change)
update-checker	true	Check for updates on startup
auto-save-interval	5	Minutes between automatic database saves
gui-click-cooldown	200	Milliseconds between GUI clicks (anti-spam)

Database Settings

mysql-settings:
  enabled: false
  hostname: 0.0.0.0
  port: 0
  database-name: ''
  user-name: ''
  user-password: ''
  use-ssl: false
  connection-pool-size: 3

Setting	Default	Description
enabled	false	true = MySQL, false = SQLite
hostname	0.0.0.0	MySQL server address
port	0	MySQL server port
database-name	''	MySQL database name
user-name	''	MySQL username
user-password	''	MySQL password
use-ssl	false	Enable SSL for MySQL connection
connection-pool-size	3	Max connections in the pool

Messages

All messages use Minecraft color codes (&) and hex colors (<#HEX>). Placeholders use {} notation.

messages:
  prefix: '&7[<#FF843D>&lSpContentQuests&7] &r'
  usage: '&cUsage: /spcontentquests help'
  category-not-found: '&cCategory {category} not found.'
  player-not-found: '&cPlayer not found.'
  no-permission: '&cNo permission.'
  points-added: '&aAdded {amount} points to {player} for quest {quest}'
  quest-reset: '&aReset quest {quest} for {player}'
  config-reloaded: '&aConfiguration and quests reloaded.'
  # ... and more

Available Message Placeholders

Placeholder	Description
{category}	Category ID
{player}	Target player name
{quest}	Quest ID
{amount}	Objective progress amount
{time}	Cooldown remaining time

Quest Book Settings

quest-book:
  command-aliases: [quest, quests]
  enable: true
  auto-give-newbies: true
  give-cooldown: 10
  open-category: 'introduction'
  open-sound:
    id: ITEM_BOOK_PAGE_TURN
    pitch: 1.0
    volume: 1.0
  item:
    material: KNOWLEDGE_BOOK
    skullvalue: ''
    modeldata: 0
    amount: 1
    name: '&6Quest Book'
    lore:
      - ''
      - '&7Contains every quests'
      - '&7and your guide to play'
      - '&7in this server.'
      - ''
      - '&f➥ Right-click'

Setting	Default	Description
command-aliases	[quest, quests]	Additional aliases for /questbook (needs restart)
enable	true	Enable the quest book item system
auto-give-newbies	true	Auto-give the book to new players on first join
give-cooldown	10	Cooldown in seconds for /questbook command
open-category	'introduction'	Default category to open when using the book
open-sound	—	Sound played when opening the quest book GUI
item	—	The quest book item properties (material, name, lore, model data)