📢 Overview

Stop player boredom and ignite the competitive spirit on your server!

PulseQuest is a fully automated, server-wide micro-event system designed to keep players active and engaged. Instead of complex event plugins that require manual setup, PulseQuest runs quietly in the background and periodically challenges your players to quick, fun competitions.

"Who can mine the most blocks in 3 minutes?"
"Who can catch the most fish?"
"Who can run the furthest distance?"

With beautiful BossBars, real-time ActionBars, and a robust reward system, PulseQuest turns ordinary gameplay into an exciting event.

✨ Key Features

• 🎮 11 Unique Game Modes: Includes Mining, Fishing, Slayer, Traveler (Marathon), Gluttony, Crafter, Merchant, Harvester, Diver, Trash Hunter, and Demolition.
• 🤖 Fully Automated: The plugin starts random quests automatically based on your interval settings. No admin intervention required!
• 🎨 Stunning Visuals: Real-time BossBars (with color changes), ActionBars for personal score tracking, and Titles for event announcements. Uses MiniMessage for full RGB/Gradient support.
• 💾 Database Support: Built-in support for SQLite (local file) and MySQL (network sync). Perfect for both small SMPs and large Networks.
• 🎁 Flexible Rewards: Reward the winner AND participants. Execute any console command (give items, money, XP, crate keys, etc.).
• 🚀 Ultra Lightweight: Built with Kotlin and optimized for Paper 1.20+.

🎮 How It Works

1. Auto-Start: Every X minutes (configurable), if enough players are online, a random quest begins.
2. The Challenge: A BossBar appears at the top of the screen showing the remaining time and the current leader.
3. Gameplay: Players perform the action (e.g., breaking blocks, fishing). When they score, an ActionBar message confirms their point.
4. Victory: When time runs out, the winner is announced globally and rewards are automatically distributed.

📜 Commands & Permissions

Command Description Permission

/pq start Starts a random quest immediately. pulsequest.admin

/pq start Starts a specific quest for X seconds. pulsequest.admin

/pq stop Forces the current quest to end. pulsequest.admin

/pq reload Reloads the configuration and messages. pulsequest.admin

Aliases: /pulsequest, /quest, /pq

⚙️ Configuration

PulseQuest is designed to be "Plug & Play", but every aspect is configurable to fit your server's economy.

# =============================================================================
#   PulseQuest - Configuration
#   Version: 1.0.0
#
#   Engage your players with Instant Micro-Challenges!
# =============================================================================

# -----------------------------------------------------------------------------
# [Settings] General Plugin Settings
# -----------------------------------------------------------------------------
settings:
  # How many seconds between automatic quests?
  # (900 = 15 min)
  auto-start-interval: 900

  # Minimum players required to start an auto-quest.
  min-players: 2

# -----------------------------------------------------------------------------
# [Database] Storage Settings
# -----------------------------------------------------------------------------
database:
  # Storage Type: "sqlite" (Local file) or "mysql" (External DB)
  type: "sqlite"
  
  # MySQL Settings (Only if type is mysql)
  host: "localhost"
  port: 3306
  database: "minecraft"
  username: "root"
  password: "password"
  table-prefix: "pq_"

# -----------------------------------------------------------------------------
# [Rewards] Participation Rewards
# -----------------------------------------------------------------------------
# Rewards given to players who participated (score > 0) but didn't win.
participation-rewards:
  enabled: true
  commands:
    - "give %player% cookie 1"
    - "xp give %player% 50"

# -----------------------------------------------------------------------------
# [Quests] Game Configuration
# -----------------------------------------------------------------------------
quests:
  mining:
    enabled: true
    duration: 180
    rewards:
      - "give %player% diamond 3"
      - "eco give %player% 500"
      - "broadcast &a%player% won the Mining Rush!"

  fishing:
    enabled: true
    duration: 300
    rewards:
      - "give %player% cooked_cod 32"

  traveler:
    enabled: true
    duration: 180
    rewards:
      - "give %player% leather_boots 1"
      - "effect give %player% speed 300 1"

  # ... (All 11 quests are configurable)

📈 bStats