🎯 XP System – Overview

The XP system in LogBook is a modular point-based mechanism used to track driver activity across the VTC. It acts as a performance indicator and progression metric, enabling automated rank assignments and activity monitoring.

Core functionality

• Tracks and stores XP for each user (based on steamProfile)
• Handles automatic rank calculation based on total XP
• Supports manual XP assignment by admins or scripts
• Enables live progress bar display on driver profiles
• Stores history of XP changes in the xplog table

How XP is assigned

• 📦 Automatically: When a job is completed and saved in the system
• 🛠️ Manually: Via admin panel or internal triggers (e.g. support, event participation)
• 🔁 Bonus logic: Some jobs or events may provide extra XP based on distance or type

Data structure

The XP system typically uses these tables:

• vtc_xp – stores defined rank tiers (rank name + required XP)
• xplog – logs all XP changes (timestamp, title, XP, user)
• vtc_users – each user has a total XP value

Display & integration

• Progress bars shown on driver dashboards and profile pages
• XP and rank values pulled dynamically using PHP & SQL
• Admin interface available for manual changes

Example use cases

• Rank progression based on XP tiers
• Leaderboards sorted by total XP
• Motivational badges/unlocks (e.g. map markers unlocked at 100k XP)

← Back to Wiki Index