🏅 Badge Collector: Showcasing Your Achievements¶

"Deeds in the dark matter not. Display your triumphs for all to see." — The Trophy Keeper

🎯 Quest Objectives¶

Understand the achievement system and how badges are earned
Identify which badges you've already earned
Pin your top badges to the Featured section
Verify the pinned badges display correctly

📖 The Achievement System¶

Badges are auto-earned by the stats generator when you hit contribution milestones. You don't claim them manually — they appear when you've done the work.

Achievement Catalog¶

Badge ID	Icon	Name	How to Earn
`first_blood`	🩸	First Blood	Make your first commit
`centurion`	💯	Centurion	Reach 100 commits
`thousand_cuts`	⚔️	Thousand Cuts	Reach 1,000 commits
`team_player`	🤝	Team Player	Get your first PR merged
`pr_machine`	🔄	PR Machine	Get 50 PRs merged
`quest_forger`	📜	Quest Forger	Author your first quest
`quest_master`	🏰	Quest Master	Author 10 quests
`scribe`	✍️	Scribe	Write your first post
`prolific_author`	📚	Prolific Author	Write 20 posts
`marathon_runner`	🏃	Marathon Runner	Achieve a 7-day contribution streak
`polyglot`	🌐	Polyglot	Contribute in 5+ languages
`guild_founder`	🏛️	Guild Founder	Reserved for project founders

How Badges Work¶

The stats generator (scripts/generation/generate_contributor_stats.rb) checks thresholds after counting your contributions:

commits >= 1          → first_blood
commits >= 100        → centurion
commits >= 1000       → thousand_cuts
prs_merged >= 1       → team_player
prs_merged >= 50      → pr_machine
quests_authored >= 1   → quest_forger
quests_authored >= 10  → quest_master
posts_authored >= 1    → scribe
posts_authored >= 20   → prolific_author
current_streak >= 7    → marathon_runner
top_languages.size >= 5 → polyglot

Badges include an earned_on date that's preserved across regeneration — your achievements are permanent.

🗺️ Quest Steps¶

Step 1: Check Your Current Badges¶

_data/contributors/YOUR_USERNAME.yml is created by the Forge Your Character prerequisite quest and kept up to date by the stats generator — you don't create it here; run the generator (or check your data file after it's been auto-updated):

make contributor-stats USERNAME=YOUR_USERNAME
cat _data/contributors/YOUR_USERNAME.yml

(YOUR_USERNAME is your GitHub handle, e.g. octocat.)

Your file should already contain an achievements array like this — that's your ground truth for what you've earned so far:

achievements:
  - id: first_blood
    earned_on: '2026-01-05'
  - id: quest_forger
    earned_on: '2026-02-14'

Look at the achievements section to see what badges you've earned.

Step 2: Pin Your Favorites¶

Edit _data/contributors/YOUR_USERNAME.yml and add up to 3 badge IDs to the pinned array:

profile:
  badges_pinned:
    - first_blood
    - quest_forger
    - marathon_runner

Rules: - Maximum 3 pinned badges - Must be badges you've actually earned - Order matters — first badge is displayed most prominently

Step 3: Verify the Display¶

Build and check your profile:

bundle exec jekyll serve

On your profile page, you should see:

Featured Badges section with your pinned badges at the top
All Achievements section below with every earned badge
Pinned badges appear in Featured section
All earned badges display correctly with earned dates

Step 4: Earn More Badges¶

Want to fill your trophy wall? Here are quickest paths:

Badge	Fastest Path
First Blood 🩸	Any commit (you probably have this!)
Scribe ✍️	Write a blog post in `pages/_posts/`
Quest Forger 📜	Create a quest in `pages/_quests/`
Marathon Runner 🏃	Commit something 7 days in a row

🏆 Reward: Badge Collector 🏅¶

Once you've pinned at least one badge to your Featured section, you've earned the Badge Collector badge (+75 XP).

"A well-curated trophy wall speaks louder than a thousand commits."

🕸️ Knowledge Graph¶

Structured wiki-links connect this quest to the IT-Journey knowledge graph. Open the Obsidian Graph View to explore connections.

Level hub: [[Level 001 - Journeyman Challenges]] Overworld: [[🏰 Overworld - Master Quest Map]] Prerequisites: [[Forge Your Character: Crafting Your Contributor Identity]] Recommended: [[Avatar Forge: Crafting Your Digital Portrait]] Obsidian docs: [[Obsidian Knowledge Graph and Wiki Links]]