Quest Log — Gamified Task Tracker for Obsidian

Quest Log Screenshot

Overview

Quest Log is a gamified task tracker for Obsidian that turns your completed tasks into XP, levels, and progress bars.

Track completed tasks across specific notes or folders
Gain XP per task and level up as you complete more
Fully customizable progress bars with colors, size, and radius
Easy-to-use codeblocks — no DataviewJS required

Turn your notes into a fun quest system and stay motivated while tracking your tasks!

Features

✅ Tracks completed tasks (- [x] Task) across specified notes or folders
✅ Calculates XP and levels automatically
✅ Fully customizable defaults via plugin settings
✅ Override defaults per codeblock for specific quests
✅ Renders progress bars and XP info in notes automatically
✅ No coding knowledge required — just write a simple codeblock

Installation

Clone or download the plugin into your Obsidian vault under:

.obsidian/plugins/questlog

Enable Quest Log in Obsidian: Settings → Community Plugins → Installed Plugins → Quest Log → Enable

Usage

Basic Codeblock Example

Add a codeblock in any note:

<pre> ```questlog quest: Quest 1 paths: ["Folder/File1", "Folder2", "Folder/File2"] questXP: 20 levelXP: 100 startXP: 1000 progressColor: "#00b4d8" background: "#222" radius: 12 ``` </pre>

Field Explanation

| Field | Description | Default | | --------------- | --------------------------------------------- | ----------------------- | | quest | Display name of this quest | "Quest" | | paths | Array of folders or note paths to track tasks | [""](the whole vault) | | questXP | XP gained per completed task | plugin setting | | levelXP | Increment per level | plugin setting | | startXP | XP needed for level 1 | plugin setting | | progressColor | Color of the filled progress bar | plugin setting | | background | Background color of the progress bar | plugin setting | | radius | Border radius of the progress bar (px) | plugin setting |

Tip: Only include the fields you want to override. All others will use plugin defaults.

Example With Minimal Fields

<pre> ```questlog quest: Quest 1 paths: ["Folder/FileName"] ``` </pre>

Uses plugin default XP and progress bar settings
Only scans tasks in "Personal/Today"

Example codeblock from screenshot

<pre> ```questlog quest: Energy paths: [""] questXP: 20 levelXP: 100 startXP: 1000 progressColor: "#a8dadc" background: "#1d3557" radius: 0 ``` ```questlog quest: Agility paths: [""] questXP: 15 levelXP: 80 startXP: 800 progressColor: "#ffb4a2" background: "#6d6875" radius: 5 ``` ```questlog quest: Focus paths: [""] questXP: 25 levelXP: 120 startXP: 1200 progressColor: "#ffd6a5" background: "#1a1a2e" radius: 10 ``` ```questlog quest: Creativity paths: [""] questXP: 30 levelXP: 150 startXP: 1500 progressColor: "#cdb4db" background: "#2a2d43" radius: 10 ``` </pre>

Plugin Settings

Go to: Settings → Community Plugins → Quest Log → Options

Default Quest XP per Task
Level XP Increment
Starting XP for Level 1
Progress Bar Color
Progress Bar Background
Progress Bar Radius

All defaults can be overridden per codeblock in a note.

Feel free to reach out

Bug reports, and feature requests are welcome!

Questlog

Install / Use

README