Chronicle

Solo quests. Community goals. Shared glory.

Chronicle is a feature-rich quest plugin for Paper servers that brings players together through solo quests, collective community goals, and distributed weekly challenges — all with persistent progress, reward systems, and live leaderboards.

---

✦ Features

Solo Quests

• Kill mobs, mine blocks, craft items, fish, smelt, trade, breed, and more
• Quest chains — complete quest A before unlocking B
• Daily & weekly resets with configurable rewards
• Streak system — play every day for bonus rewards at day 3, 7, 30+

Community Quests — Collective Goal

• Server-wide target (e.g. kill 1,000,000 zombies together)
• Global progress bar visible to all players
• Contributor leaderboard — who helped the most?
• Milestone broadcasts at 50%, 75%, and 90%
• Rewards go to everyone who contributed (configurable minimum %)

Community Quests — Distributed

• Total goal divided by active weekly players
• Each player gets a small personal share
• Quest completes when enough players (configurable threshold) finish their part
• Auto-starts every Monday based on last week's active player count

Quality of Life

• Full inventory GUI — Quest Journal with Daily / Weekly / Story tabs
• Community Board GUI with live progress bars
• In-game Quest Editor — create quests without editing YML
• Pending rewards — offline players receive rewards on next login
• PlaceholderAPI support for scoreboards
• Discord webhook integration for quest events
• MySQL & SQLite support

---

⌨ Commands

Command	Description
/chronicle quests	Open Quest Journal (GUI)
/chronicle community	Open Community Board (GUI)
/chronicle stats [player]	View stats & streak
/chronicle top	Global leaderboard
/chronicle leaderboard	Quest contributor ranking
/chronicle admin startcommunity	Start a community quest
/chronicle admin stopcommunity	Stop a community quest
/chronicle admin createquest	In-game quest editor
/chronicle admin reset [id]	Reset player progress
/chronicle admin reload	Reload configs

---

🔑 Permissions

Permission	Default	Description
chronicle.use	Everyone	Use all player commands
chronicle.admin	OP	Access admin commands

---

📦 Dependencies

Required: Paper 1.21.11+ Optional: Vault (money rewards), PlaceholderAPI (scoreboards)

---

⚙ Configuration

All quest types, targets, amounts, rewards, and reset intervals are fully configurable in quests.yml and community_quests.yml. All messages are editable in messages.yml. Database (SQLite or MySQL), Discord webhook, streak rewards, and reminder intervals are set in config.yml.