UgagaQuests [Paper]

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

Quest Types:

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:

%ugagaquests_total_completed% - Player's total completed quests
%ugagaquests_rank% - Player's rank on the leaderboard

Server Stats:

%ugagaquests_server_total% - Total quests completed on the server

Top 10 Leaderboard:

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

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

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

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: