UgagaQuests [Paper] icon

UgagaQuests [Paper] -----

Low setup randomized and customizable quests plugin [Points and money rewards]



upload_2025-12-2_12-13-43.png
UgagaQuests
A simple, powerful daily quest system for your Minecraft server with leaderboards and PlaceholderAPI support!

UgagaQuests gives players money and point rewards for completing automatically generated quests, no setup headaches, barely any manual configuration required!
Everything is fully customizable, from quest objectives and rewards to messages, GUI titles, and progress bars.
Every few hours, players receive a fresh batch of random quests to complete for rewards.
No need to design your own quest list, the plugin handles it all dynamically!

NEW: Leaderboard System!
  • Track total completed quests per player
  • Top 10 leaderboard GUI with gold/silver/bronze displays
  • Full PlaceholderAPI integration (16+ placeholders)
  • Optimized caching system for high performance
  • /quests leaderboard command
  • SQLite database for persistent stats
Rewards:
Points plugin: PlayerPoints
Money plugin: EssentialsX
Optional: PlaceholderAPI (for leaderboards in scoreboard, tab, chat, etc.)

image2.png

Quest Types:
Code (Text):

Planter
Plant a certain amount of crops.

Traveller
Travel a set number of blocks.

Jumper
Jump a certain number of times.

Foodie
Eat a specific type of food multiple times.

Risk Taker
Take a certain amount of damage.

Sneaky
Sneak (shift) a number of times.

Hunter
Kill a specific type of mob.

Miner
Mine a specific block type.

Farmer
Harvest crops.

Fisher
Catch fish with a fishing rod.

Builder
Place blocks in the world.

Archer
Shoot mobs with a bow.

Breeder
Breed a certain animal (cow, pig, chicken, etc.).

Shearer
Shear sheep a set number of times.

Milk
Milk cows.

Thrower
Throw items such as snowballs, eggs, or ender pearls.

XP Grinder
Gain a set amount of experience.

Portal Traveler
Use portals (Nether/End) a certain number of times.

Rider
Mount and ride a specific animal.

Smelter
Smelt specific items in a furnace.
 
Leaderboard Features:
Leaderboard GUI
  • Click the ⭐ Leaderboard button in the quest GUI
  • Beautiful display with gold/silver/bronze blocks for top 3
  • Shows top 10 quest completers
  • Your personal stats at the bottom (rank, quests completed, server total)
  • Real-time data from database

PlaceholderAPI Integration
Use these placeholders in your scoreboard, tab list, chat, holograms, and more:

Player Stats:
Code (Text):

%ugagaquests_total_completed% - Player's total completed quests
%ugagaquests_rank% - Player's rank on the leaderboard
 
Server Stats:
Code (Text):

%ugagaquests_server_total% - Total quests completed on the server
 
Top 10 Leaderboard:
Code (Text):

%ugagaquests_top_1_name% to %ugagaquests_top_10_name% - Top player names
%ugagaquests_top_1_quests% to %ugagaquests_top_10_quests% - Top player quest counts
%ugagaquests_top_1_uuid% to %ugagaquests_top_10_uuid% - Top player UUIDs
 
Example Usage:
Code (Text):

# In your TAB plugin
- "&7Quest Rank: &e#%ugagaquests_rank%"
- "&aQuests: %ugagaquests_total_completed%"
# In DeluxeMenus
- "&e1. &f%ugagaquests_top_1_name% &7- &a%ugagaquests_top_1_quests% quests"
# In scoreboard
- "&6Server Quests: &e%ugagaquests_server_total%"
 
Performance:
  • Intelligent caching system updates every 10 seconds
  • Thread-safe operations
  • No impact on server TPS
Commands:
Code (Text):

/quests — Open the quest GUI
/quests info — View your quests in chat
/quests leaderboard — View top 10 quest completers
/quests reload — Reload the configuration
/questadmin assign <player> — Force assign new quests to a player
 
Permissions:
Code (Text):

ugagaquests.use — Allows use of /quests (default: true)
ugagaquests.reload — Allows reloading the config (default: op)
ugagaquests.admin — Allows use of admin commands (default: op)
 
Configuration Example:
Code (YAML):

# =========================
# UgagaQuests Configuration
# =========================
# Complete daily quest system with points and economy rewards
# =========================
settings
:
  prefix
: "&6[Quests]&r "
  daily_quests_min
: 6
  daily_quests_max
: 19   # Can go up to 19 quests max (GUI supports it)
  quest_expiry_hours
: 8
  quest_check_interval_seconds
: 60   # How often to check if quests expired
  # Currency names for rewards display
  currency_names
:
    points
: "Points" #Tokens or points
    economy
: "Dollars"
# =========================
# UI Text Customization
# =========================
ui
:
  title
: "&6&lDaily Quests"
  timer
:
    name
: "&b⏰ Time Remaining"
    lore
:
     - ""
      - "&7New quests in:"
      - "&f{time}"
      - ""
      - "&7You have {hours} hours to"
      - "&7complete your quests!"
      - ""
  info
:
    name
: "&6✦ Quest Info"
    lore
:
     - ""
      - "&7Complete daily quests to"
      - "&7earn rewards!"
      - ""
      - "&e• New quests every {hours} hours"
      - "&e• Complete for rewards"
      - "&e• Progress is saved"
      - ""
  # NEW: Leaderboard UI
  leaderboard
:
    name
: "&e★ Leaderboard"
    lore
:
     - ""
      - "&7See who completed"
      - "&7the most quests!"
      - ""
      - "&eClick to view leaderboard"
      - ""
  leaderboard_title
: "&6&lQuest Leaderboard"
 
  leaderboard_entry
:
   - ""
    - "&7Total Quests
: &f{quests}"
    - ""
  leaderboard_info
:
    name
: "&bℹ Your Stats"
    lore
:
     - ""
      - "&7Your Stats:"
      - "&f• Rank
: &e#{rank}"
      - "&f• Quests Completed
: &a{quests}"
      - ""
      - "&7Server Total:"
      - "&f• &e{server_total} &7quests completed"
      - ""
  quest_lore
:
   - ""
    - "&7{description}"
    - ""
    - "&6Progress
: &f{current}/{target}"
    - "{progressbar}"
    - ""
    - "{status}"
    - ""
    - "&6Rewards:"
    - "{rewards}"
  status
:
    completed
: "&a✓ COMPLETED!"
    in_progress
: "&e⚡ In Progress"
  progressbar
:
    filled
: "&a█"
    empty
: "&8█"
    format
: "&7[{bar}&7] &f{percent}%"
# =========================
# Messages
# =========================
messages
:
  new_quests
: "&aYou have received new quests!"
  quest_completed
: "&a&lQUEST COMPLETED! &f{name}"
  config_reloaded
: "&aConfiguration reloaded!"
  no_permission
: "&cYou don't have permission!"
  player_not_found
: "&cPlayer not found!"
  quests_assigned
: "&aQuests assigned to {player}!"
  info_header
: "&6━━━━━━━ &eYour Quests &6━━━━━━━"
  info_footer
: "&6━━━━━━━━━━━━━━━━━━━━━━━━━━━"
  info_no_quests
: "&7No quests available."
  info_time_remaining
: "&7New quests in: &f{time}"
 
  # NEW: Leaderboard messages
  leaderboard_header
: "&6━━━━━ &eTop 10 Quest Leaders &6━━━━━"
  leaderboard_footer
: "&6━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
  leaderboard_entry
: "&e{rank}. &f{player} &7- &a{quests} &7quests"
  leaderboard_your_stats
: "&7Your Rank: &e#{rank} &7| &7Quests: &a{quests}"
  leaderboard_server_total
: "&7Server Total: &e{total} &7quests completed"
# =========================
# Quest Lists (Mobs / Blocks / Crops / Foods etc.)
# =========================
lists
:
  mobs
:
   - ZOMBIE
    - SKELETON
    - SPIDER
    - CREEPER
    - ENDERMAN
    - COW
    - PIG
    - CHICKEN
    - BLAZE
    - SLIME
  blocks
:
   - STONE
    - COBBLESTONE
    - COAL_ORE
    - IRON_ORE
    - DIAMOND_ORE
    - DEEPSLATE
    - OAK_LOG
    - DIRT
    - GRASS_BLOCK
    - SAND
    - GRAVEL
  crops
:
   - WHEAT
    - CARROTS
    - POTATOES
    - BEETROOTS
    - NETHER_WART
    - MELON
    - PUMPKIN
  foods
:
   - BREAD
    - APPLE
    - COOKED_BEEF
    - COOKED_CHICKEN
    - COOKED_PORKCHOP
    - GOLDEN_APPLE
    - BAKED_POTATO
    - BEETROOT_SOUP
  breedables
:
   - COW
    - PIG
    - CHICKEN
    - SHEEP
    - HORSE
  throwables
:
   - SNOWBALL
    - EGG
    - ENDER_PEARL
  smeltables
:
   - IRON_INGOT
    - GOLD_INGOT
    - COPPER_INGOT
    - COOKED_BEEF
    - COOKED_CHICKEN
    - GLASS
    - STONE
    - BRICK
  rideables
:
   - HORSE
    - PIG
    - DONKEY
# =========================
# Quest Pool (Rewards: Points & Economy)
# =========================
quest_pool
:
  plant
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&2Planter"
    description
: "Plant {amount} {crop}."
    min_amount
: 5
    max_amount
: 40
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 1
        max_amount
: 3
      - command
: "economy give {player} {amount}"
        min_amount
: 1000
        max_amount
: 5000
  travel
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&bTraveller"
    description
: "Travel {amount} blocks."
    min_amount
: 100
    max_amount
: 1000
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 3
        max_amount
: 5
      - command
: "economy give {player} {amount}"
        min_amount
: 5000
        max_amount
: 15000
  jump
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&aJumper"
    description
: "Jump {amount} times."
    min_amount
: 20
    max_amount
: 200
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 1
        max_amount
: 2
      - command
: "economy give {player} {amount}"
        min_amount
: 1000
        max_amount
: 3000
  eat
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&6Foodie"
    description
: "Eat {amount} {food}."
    min_amount
: 3
    max_amount
: 10
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 1
        max_amount
: 3
      - command
: "economy give {player} {amount}"
        min_amount
: 1000
        max_amount
: 5000
  take_damage
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&cRisk Taker"
    description
: "Take {amount} damage."
    min_amount
: 5
    max_amount
: 50
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 3
        max_amount
: 6
      - command
: "economy give {player} {amount}"
        min_amount
: 5000
        max_amount
: 15000
  shift
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&7Sneaky"
    description
: "Shift {amount} times."
    min_amount
: 10
    max_amount
: 200
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 1
        max_amount
: 2
      - command
: "economy give {player} {amount}"
        min_amount
: 1000
        max_amount
: 3000
  kill
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&cHunter"
    description
: "Kill {amount} {mob}."
    min_amount
: 10
    max_amount
: 30
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 8
        max_amount
: 10
      - command
: "economy give {player} {amount}"
        min_amount
: 20000
        max_amount
: 50000
  mine
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&8Miner"
    description
: "Mine {amount} {block}."
    min_amount
: 1
    max_amount
: 30
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 3
        max_amount
: 6
      - command
: "economy give {player} {amount}"
        min_amount
: 5000
        max_amount
: 15000
  harvest
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&eFarmer"
    description
: "Harvest {amount} {crop}."
    min_amount
: 10
    max_amount
: 50
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 2
        max_amount
: 5
      - command
: "economy give {player} {amount}"
        min_amount
: 5000
        max_amount
: 15000
  catch_fish
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&9Fisher"
    description
: "Catch {amount} fish."
    min_amount
: 3
    max_amount
: 20
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 8
        max_amount
: 10
      - command
: "economy give {player} {amount}"
        min_amount
: 15000
        max_amount
: 40000
  place_blocks
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&fBuilder"
    description
: "Place {amount} blocks."
    min_amount
: 10
    max_amount
: 60
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 3
        max_amount
: 7
      - command
: "economy give {player} {amount}"
        min_amount
: 5000
        max_amount
: 15000
  shoot
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&dArcher"
    description
: "Shoot {amount} mobs with a bow."
    min_amount
: 5
    max_amount
: 25
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 8
        max_amount
: 10
      - command
: "economy give {player} {amount}"
        min_amount
: 20000
        max_amount
: 50000
  breed
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&dBreeder"
    description
: "Breed {amount} {animal}."
    min_amount
: 3
    max_amount
: 15
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 3
        max_amount
: 6
      - command
: "economy give {player} {amount}"
        min_amount
: 5000
        max_amount
: 15000
  shear
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&fShearer"
    description
: "Shear {amount} sheep."
    min_amount
: 5
    max_amount
: 20
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 1
        max_amount
: 3
      - command
: "economy give {player} {amount}"
        min_amount
: 2000
        max_amount
: 8000
  milk
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&eFarmer"
    description
: "Milk {amount} cows."
    min_amount
: 3
    max_amount
: 15
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 1
        max_amount
: 3
      - command
: "economy give {player} {amount}"
        min_amount
: 2000
        max_amount
: 8000
  throw
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&bThrower"
    description
: "Throw {amount} {item}."
    min_amount
: 10
    max_amount
: 50
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 1
        max_amount
: 3
      - command
: "economy give {player} {amount}"
        min_amount
: 2000
        max_amount
: 8000
  gain_xp
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&aXP Grinder"
    description
: "Gain {amount} experience."
    min_amount
: 50
    max_amount
: 300
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 5
        max_amount
: 10
      - command
: "economy give {player} {amount}"
        min_amount
: 10000
        max_amount
: 30000
  use_portal
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&5Portal Traveler"
    description
: "Use {amount} portals."
    min_amount
: 1
    max_amount
: 5
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 3
        max_amount
: 7
      - command
: "economy give {player} {amount}"
        min_amount
: 5000
        max_amount
: 15000
  ride
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&6Rider"
    description
: "Mount {amount} {animal}."
    min_amount
: 3
    max_amount
: 15
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 1
        max_amount
: 3
      - command
: "economy give {player} {amount}"
        min_amount
: 2000
        max_amount
: 8000
  smelt
:
    enabled
: true
    fixed_amount
: false
    fixed_rewards
: false
    name
: "&cSmelter"
    description
: "Smelt {amount} {item}."
    min_amount
: 5
    max_amount
: 32
    rewards
:
      - command
: "points give {player} {amount}"
        min_amount
: 3
        max_amount
: 6
      - command
: "economy give {player} {amount}"
        min_amount
: 5000
        max_amount
: 15000
 
Dependencies:
  • Required: Paper 1.21+
  • Required: PlayerPoints (for point rewards)
  • Required: EssentialsX (for money rewards)
  • Optional: PlaceholderAPI (for leaderboard placeholders in other plugins)
Technical Details:
  • SQLite database for quest and stats storage
  • Intelligent caching system
  • Thread-safe operations
  • Async database queries
  • Per-player quest timers
  • Dynamic GUI sizing based on quest count
  • Fully customizable rewards and quest types
Support:
For issues, suggestions, or questions, please use the discussion section or create an issue on GitHub.

Enjoy UgagaQuests!
Resource Information
Author:
----------
Total Downloads: 23
First Release: Nov 12, 2025
Last Update: Dec 7, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings