🟧 O'DAILYQUESTS

CONTINUED

⚡ Daily, Weekly, and Monthly quests — active together, fully independent. ⚡

PAPER 26.2 • JAVA 25

SOURCE CODE • ISSUE TRACKER • WIKI

---

🟧 OVERVIEW

O'DailyQuests is a powerful, highly configurable quest system for survival, RPG, and network servers. Give every player short-term objectives, longer weekly challenges, and meaningful monthly goals — all from one plugin.

Run Daily, Weekly, and Monthly quests at the same time, or enable only the periods that fit your server. Each period is a complete quest system of its own, with separate quest pools, progress, reset schedules, rerolls, quest counts, and rewards.

For example, you can give players 3 Daily quests, 8 Weekly quests, and 4 Monthly quests simultaneously. Completing or resetting one period never affects another.

This resource is an independently maintained GPL-3.0 continuation of Ordwen's archived ODailyQuests. The original plugin and design were created by Ordwen. Version 4.5 is maintained by LucidAPs for modern Paper servers.

---

🟩 DAILY • WEEKLY • MONTHLY

Three independent quest periods in one familiar system

Every period has its own:

• ✅ Easy, Medium, Hard, Global, and custom quest pools
• ✅ Configurable number of active quests per category
• ✅ Player progress and active quest selection
• ✅ Reset timer and schedule
• ✅ Reroll allowance and reroll history
• ✅ Category-completion rewards
• ✅ All-quests-completed reward
• ✅ Lifetime completed-quest total

🔵 Independent Reset Schedules

• ✅ Daily — Choose the reset time and timezone
• ✅ Weekly — Choose the weekday, reset time, and timezone
• ✅ Monthly — Choose the day of the month, reset time, and timezone
• ✅ Supports global scheduled resets and player-relative renewal mode
• ✅ Short months automatically use their final valid day

🔵 Separate Quest Files

plugins/ODailyQuests/quests/
├── easy.yml
├── medium.yml
├── hard.yml
├── global.yml
├── weekly/
│   ├── easy.yml
│   ├── medium.yml
│   ├── hard.yml
│   └── global.yml
└── monthly/
    ├── easy.yml
    ├── medium.yml
    ├── hard.yml
    └── global.yml

Daily Easy and Weekly Easy are completely different pools. The same separation applies to every category, including Global quests.

Global quest behavior has not changed. Each period simply loads Global quests from its own folder, so Daily Global, Weekly Global, and Monthly Global remain fully independent.

---

✨ KEY FEATURES ✨

• ✅ Enable Daily, Weekly, and Monthly quests in any combination
• ✅ YAML, SQLite, or MySQL storage with UUID-based player tracking
• ✅ Easy, Medium, Hard, Global, and fully custom quest categories
• ✅ More than 20 built-in quest types with dynamic and random objectives
• ✅ Per-period quest counts, progress, rerolls, timers, and rewards
• ✅ Per-quest, per-category, all-completed, and lifetime milestone rewards
• ✅ Conditional and permission-based quests
• ✅ World, region, and category restrictions
• ✅ Anti-abuse checks for placed, broken, and dropped items
• ✅ Titles, subtitles, toasts, boss bars, action bars, chat feedback, and progress bars
• ✅ Period-aware player GUI with configurable Daily, Weekly, and Monthly navigation
• ✅ Custom heads, PlaceholderAPI content, Nexo items, model data, and item models
• ✅ Synchronized progression for matching objectives
• ✅ Safety mode, configurable command aliases, and storage conversion tools
• ✅ Multi-server friendly player-data delay and asynchronous SQL work
• ✅ Editable messages with HEX colors
• ✅ Custom quest types for manual or scripted completion with /dqa customcomplete

---

🟩 LIFETIME TOTALS & LEADERBOARDS

Keep the original overall total while tracking every period separately

Every player now has four lifetime completion totals:

• ✅ Overall total across Daily + Weekly + Monthly
• ✅ Daily lifetime total
• ✅ Weekly lifetime total
• ✅ Monthly lifetime total

Existing totals remain fully backwards compatible. %odailyquests_total%, existing total commands, and the all-time leaderboard continue to use the player's combined overall total.

Create holograms, scoreboards, menus, chat formats, or NPC displays without a separate leaderboard addon:

%odailyquests_total_1_alltime_name%

Returns the name of the player at rank 1. Replace 1 with any positive position.

%odailyquests_total_1_alltime_value%

Returns that ranked player's combined lifetime completed-quest total.

%odailyquests_total_position%

Returns the viewing player's current all-time rank.

• ✅ Works with YAML, SQLite, and MySQL
• ✅ Includes persisted offline-player totals and current active-player progress
• ✅ Uses a short cache so scoreboards can request rankings efficiently
• ✅ Deterministic ranking order for tied totals

---

🟧 PLACEHOLDERAPI

Use daily, weekly, or monthly in period-specific placeholders:

%odailyquests_daily_total%
%odailyquests_weekly_total%
%odailyquests_monthly_total%

%odailyquests_daily_achieved%
%odailyquests_weekly_drawin%
%odailyquests_monthly_name_1%
%odailyquests_weekly_progress_1%
%odailyquests_daily_progressbar_1%
%odailyquests_weekly_total_easy%

Period prefixes also work with quest status, completion, required amount, description, and category placeholders. Existing unqualified placeholders remain supported for backwards compatibility.

---

🟧 QUEST TYPES

🔵 Blocks & Items

• ✅ BREAK — Break blocks
• ✅ PLACE — Place blocks
• ✅ GET / PICKUP — Obtain or pick up items
• ✅ CRAFT — Craft items
• ✅ COOK — Extract cooked items
• ✅ ENCHANT — Enchant items
• ✅ FISH — Catch items while fishing
• ✅ FARMING — Harvest mature crops
• ✅ CONSUME — Eat, drink, or use consumables
• ✅ LAUNCH — Launch projectiles
• ✅ CARVE — Carve pumpkins

🔵 Entities & Player Actions

• ✅ KILL — Kill mobs or players
• ✅ TAME / BREED / SHEAR / MILKING — Animal objectives
• ✅ FIREBALL_REFLECT — Reflect a fireball
• ✅ VILLAGER_TRADE — Complete matching villager trades
• ✅ LOCATION — Reach configured coordinates
• ✅ EXP_POINTS / EXP_LEVELS — Earn experience
• ✅ PLAYER_DEATH — Track player deaths
• ✅ PLACEHOLDER — Compare a PlaceholderAPI value

🔵 Plugin Integration

• ✅ VOTIFIER_PLUS — Progress quests from votes

---

🟩 REWARDS

• ✅ COMMAND — Execute one or more console commands
• ✅ EXP_POINTS / EXP_LEVELS — Grant experience
• ✅ MONEY — Economy rewards through Vault
• ✅ POINTS — PlayerPoints rewards
• ✅ NONE — Completion without a direct reward

Quest rewards support dynamic values such as quest name, required amount, current progress, and reward amount.

Each period can have independent quest rewards, category-completion rewards, and an all-quests-completed reward. Daily rewards never trigger Weekly or Monthly rewards, and vice versa.

---

🟧 COMMANDS

🔵 Player Commands

• ✅ /dq me [daily|weekly|monthly] — Open your quests for a period
• ✅ /dq show [period] <category> — Browse a period's quest category
• ✅ /dq reroll [period] <index> — Reroll a quest within its period

🔵 Period-Aware Admin Commands

• ✅ /dqa complete <player> [period] <index>
• ✅ /dqa reroll <player> [period] <index>
• ✅ /dqa set <player> [period] <slot> <category> <quest-id>
• ✅ /dqa reset quests <player> [period|all]
• ✅ /dqa show <player> [period]
• ✅ /dqa open <player> [period]

🔵 Other Admin Tools

• ✅ /dqa reload
• ✅ /dqa add / remove / customcomplete
• ✅ /dqa convert — Convert supported storage formats

Existing command formats without a period continue to work. Command and subcommand aliases are configurable.

---

🟩 INTEGRATIONS

No dependency is required for the core quest system.

Install an optional plugin only when you use its related feature:

• ✅ PlaceholderAPI
• ✅ Vault
• ✅ PlayerPoints
• ✅ Citizens
• ✅ WorldGuard
• ✅ HeadDatabase
• ✅ Nexo
• ✅ VotifierPlus
• ✅ eco

Difference from the archived original:
Version 4.5 has a focused integration set. Legacy hooks for ItemsAdder, Oraxen, MMOItems, RoseStacker, WildStacker, FancyNPCs, MythicMobs, EliteMobs, custom fishing/crate plugins, TokenManager, CoinsEngine, and NuVotifier are not included. The former public Java API/event layer and Folia declaration are also not part of this release.

---

🟩 SAFE UPGRADING

Version 4.5 keeps existing Daily-only servers working while adding the new period system:

• ✅ Existing quest files remain your Daily quest pool
• ✅ Existing configuration is imported into the Daily period
• ✅ Existing YAML, SQLite, and MySQL player data is treated as Daily data and migrated automatically
• ✅ Existing overall lifetime totals and leaderboard behavior are preserved
• ✅ Weekly and Monthly are disabled by default until you choose to enable them
• ✅ Disabled-period data is preserved if that period is enabled again later

⚠️ Always back up the ODailyQuests folder and database before updating.

---

🟧 INSTALLATION & SUPPORT

1. Run Paper 26.2 with Java 25.
2. Place ODailyQuests-4.5.jar in your server's plugins folder.
3. Start once to generate the configuration and example quest files.
4. Stop the server, configure the files in plugins/ODailyQuests, then restart.
5. Enable and configure Weekly or Monthly under quest_periods when desired.

---

Need help?

Join the Discord support server or open a GitHub issue.

Originally developed by Ordwen from 2022 to 2026.

Maintained for modern Minecraft versions by LucidAPs.

MORE RESOURCES FROM LUCIDAPS