ContractLedger v0.2.0

Major update with carrier progression, achievements, enhanced statistics, and remote destinations!​

What's New in 0.2.0

This is a massive update that transforms the carrier experience with progression systems, achievements, detailed statistics, AND fixes the delivery flow to make logical sense!



NEW FEATURES

DESTINATION REGISTRY SYSTEM

The biggest UX improvement - remote contract creation that makes sense:

The Problem We Fixed:

• OLD: Player had to be AT the destination to create a delivery TO that destination
• This made no logical sense - why deliver to where you already are?
• NEW: Register destinations once, create contracts from anywhere
• Makes perfect sense - you're at your base, sending items to spawn

How It Works:

1. Admin/player places a sign at spawn with text "Spawn"
2. Register it once: /cl destination register spawn
3. Now ANYONE can create contracts to "spawn" from ANYWHERE
4. Visual delivery zone appears at the registered destination
5. Carriers travel there to complete delivery

New Commands:

Code:

/cl destination register <name> - Register a sign as a named destination
/cl destination unregister <name> - Remove a registered destination
/cl destination list - View all registered destinations

Updated Command:

Code:

/cl delivery create <reward> <destination> - Now requires destination name

CARRIER LEVEL SYSTEM

Carriers now progress through 5 distinct levels based on their total deliveries:

• Bronze Level - Starting level (0-9 deliveries)
• Silver Level - 10+ deliveries
• Gold Level - 50+ deliveries
• Platinum Level - 150+ deliveries
• Diamond Level - 1000+ deliveries (Elite!)

Features:
• Automatic level calculation based on performance
• Level badges displayed in leaderboard: [Bronze], [Silver], [Gold], etc.
• Track progress with new /cl carrier level command
• Visual progression system keeps carriers engaged



SPECIALIZATION SYSTEM

Carriers can now choose a specialization to receive bonus ratings:

• Fast Delivery - Quick deliveries specialist
• Valuable Cargo - High-value shipments expert
• Long Distance - Far destinations master
• Bulk Transport - Large quantities handler

Benefits:
• +25% rating bonus for specialized deliveries
• Unique identity for your carrier
• Choose with /cl carrier specialize <type>
• Configurable change rules



ACHIEVEMENT SYSTEM

Unlock 14 achievements as you progress:

Delivery Milestones:

• First Delivery - Complete your first delivery
• Rookie - 10 deliveries
• Experienced - 50 deliveries
• Veteran - 100 deliveries
• Master - 500 deliveries
• Legend - 1000 deliveries

Perfect Streaks:

• Perfect 10 - 10 on-time deliveries in a row
• Flawless - 50 on-time deliveries in a row
• Perfectionist - 100% success rate (min 100 deliveries)

Earnings Milestones:

• Wealthy - Earn $10,000 total
• Rich - Earn $100,000 total
• Millionaire - Earn $1,000,000 total

Special Achievements:

• Marathon Runner - 10 deliveries in one day
• Reliable - 100 deliveries with zero failures

Features:
• Automatic unlock notifications
• View all achievements with /cl carrier achievements
• Persistent tracking across sessions
• Motivates consistent performance



ENHANCED STATISTICS

Carriers now have access to detailed performance metrics:

New Stats Tracked:

• Success Rate - Percentage of on-time deliveries
• Current Streak - Consecutive on-time deliveries
• Best Streak - Highest streak achieved
• Total Distance - Blocks traveled for deliveries
• Average Rating - From customer feedback (1-5 stars)
• Detailed Breakdown - On-time, late, and failed percentages

Commands:
• /cl carrier stats - View your detailed statistics
• /cl carrier stats <player> - View another carrier's stats
• Enhanced /cl carrier profile with all new fields



FAILURE COOLDOWN SYSTEM

Prevents spam and encourages quality over quantity:

How It Works:

• First failure: 30 minute cooldown (configurable)
• Consecutive failures: Exponential increase (2x multiplier)
• Maximum cooldown: 24 hours cap
• Cooldown displayed in carrier profile
• Automatic enforcement when accepting contracts

Benefits:
• Discourages reckless contract acceptance
• Protects requesters from unreliable carriers
• Gives carriers time to improve
• Fully configurable by server admins



STREAK TRACKING

Build consistency with the new streak system:

Features:

• Current Streak - Tracks consecutive on-time deliveries
• Best Streak - Records your highest achievement
• Automatic increment on successful delivery
• Resets on late or failed delivery
• Displayed in profile and stats
• Unlocks streak achievements

Why It Matters:
• Rewards consistent performance
• Visible proof of reliability
• Competitive element for carriers
• Encourages quality service



FEEDBACK & RATING SYSTEM

Requesters can now rate their carriers:

Features:

• 1-5 star rating system
• Optional comments
• Average rating calculation
• Displayed in carrier profile
• Influences reputation

Coming Soon:
Commands to submit and view feedback will be added in a future update.



NEW COMMANDS

Destination Management:

Code:

/cl destination register <name> - Register a destination sign
/cl destination unregister <name> - Remove a destination
/cl destination list - List all destinations

Carrier Progression:

Code:

/cl carrier level - View your level and progress to next tier
/cl carrier stats [player] - View detailed statistics and success rate
/cl carrier achievements - View all unlocked achievements
/cl carrier specialize [type] - Choose or view specializations

Enhanced Commands:

• /cl delivery create - Now requires destination name for remote creation
• /cl carrier profile - Now shows level, specialization, streaks, and more
• /cl carrier top - Now displays level badges next to carrier names

BY THE NUMBERS

Version 0.2.0 adds:

• 11 major new features (including destination registry)
• 7 new commands (4 carrier + 3 destination)
• 14 achievements
• 7 new statistics tracked
• 25+ new configuration options
• 2,000+ lines of new code
• 3 new database tables (including destinations)
• 5 new documentation files
• 2 new permissions

GAMEPLAY IMPACT

For Carriers:

• Clear progression path from Bronze to Diamond
• Goals to work towards (achievements)
• Visible proof of expertise (level badges)
• Specialization for unique identity
• Detailed stats to track improvement
• Streak system for consistency rewards

For Requesters:

• Easy identification of experienced carriers
• Level badges show carrier expertise
• Success rates help choose reliable carriers
• Create contracts from anywhere (no need to travel)
• Named destinations are intuitive
• Feedback system coming soon

For Server Owners:

• Increased player engagement
• Longer player retention
• Competitive leaderboard
• Anti-abuse cooldown system
• Highly configurable
• Professional progression system
• Better UX with remote contract creation
• Centralized destination management

BUG FIXES & IMPROVEMENTS

• Fixed illogical delivery flow (major UX issue)
• Added remote contract creation
• Improved carrier profile display
• Enhanced leaderboard formatting