Achievements - xopherdeep/do-it-for-the-xp GitHub Wiki

Achievements

Achievements are milestones and accomplishments that players can earn throughout their journey in the XP app. The Game Master has tools to create, manage, and track these achievements.

Achievement System

Achievements function as:

  • Motivational tools for users
  • Progress markers in the experience
  • Rewards for completing specific tasks
  • Collections that players can showcase

Creating Achievements

Basic Components

  • Title - A catchy, descriptive name
  • Description - Clear explanation of how to earn the achievement
  • Icon - Visual representation of the achievement
  • Requirements - Specific criteria that must be met
  • Rewards - XP, GP, AP, or items granted upon completion
  • Rarity - Common, Uncommon, Rare, Epic, Legendary
  • Category - Type of achievement (Quest, Combat, Exploration, etc.)

Achievement Types

  • One-time achievements - Earned once by meeting specific criteria
  • Progressive achievements - Multiple tiers with increasing requirements
  • Hidden achievements - Secret accomplishments discovered through play
  • Daily/Weekly achievements - Regular tasks to encourage consistent engagement

Managing Achievements

Game Masters can:

  • Add Achievement
  • Edit existing achievement details
  • Track achievement completion rates
  • Feature specific achievements
  • Create achievement series and collections
  • Discover Achievements

Best Practices

When designing achievements:

  • Make requirements clear and measurable
  • Balance difficulty with reward value
  • Create a mix of easy and challenging achievements
  • Design achievements that encourage desired behaviors
  • Avoid requiring excessive grinding
  • Consider progressive achievement sequences

Related Pages

⚠️ **GitHub.com Fallback** ⚠️