ContractLedger v0.3.0

VERSION 0.3.0 - DEADLINE & INSURANCE EXPANSION

Custom deadlines, insurance tiers, dispute tools, and cleaner configuration management.​

What's New in 0.3.0

This update expands the risk-management side of ContractLedger. Server owners now get more control over delivery deadlines, insurance coverage, dispute handling, and configuration upgrades.



New Features

Per-Contract Deadlines

Players can now choose a custom delivery deadline when creating a contract.

Code:

/cl delivery create <reward> <destination> [hours] [insuranceTier]

Examples:

Code:

/cl delivery create 500 spawn
/cl delivery create 500 spawn 4
/cl delivery create 500 spawn 4 premium

• Old command format still works
• Default deadline is used when hours are omitted
• Admins can set minimum and maximum allowed hours
• Delivery listings now show deadline information
• Expiration checks now correctly scan active accepted/in-transit contracts

Advanced Insurance Tiers

Insurance is now tier-based instead of a simple on/off option.

Code:

none
basic
standard
premium

Each tier can be configured with:

• Fee percent
• Payout percent
• Maximum payout
• Carrier bond percent

This gives server owners better control over risk, pricing, and carrier guarantees.



Dispute Resolution Tools

Players can now open disputes when a delivery needs staff review.

Code:

/cl dispute open <id> <reason>

Admins can resolve disputes with clear outcomes:

Code:

/cl admin dispute <id> requester [note]
/cl admin dispute <id> carrier [note]
/cl admin dispute <id> split [note]
/cl admin dispute <id> cancel [note]
/cl admin dispute <id> fail [note]

• requester - refunds requester according to reward/insurance logic
• carrier - pays carrier and releases bond
• split - splits reward 50/50 and releases bond
• cancel - cancels without carrier penalty
• fail - uses the normal failure/insurance penalty flow

Disputed contracts are locked from normal delivery/cancel actions until an admin resolves them.



Configuration Improvements

Cleaner files:

• config.yml now contains gameplay and system settings only
• messages.yml now contains all player-facing messages
• Both files are fully commented and easier to edit

Safe upgrade behavior:

• Old config is backed up as config.yml.old
• Old messages file is backed up as messages.yml.old when needed
• Existing values are preserved when matching keys still exist
• Older messages.* entries from config.yml are imported into messages.yml

Technical Changes

• Plugin version updated to 0.3.0
• New contract status: DISPUTED
• New dispute event history entries

Upgrade Notes

1. Stop your server
2. Replace the old jar with ContractLedger-0.3.0.jar
3. Start your server
4. The plugin backs up old config.yml to config.yml.old
5. The plugin creates/migrates messages.yml automatically
6. Review the new config.yml and messages.yml comments

Existing data is preserved through automatic.


Changelog Summary

Code:

Version 0.3.0 - Deadline & Insurance Expansion

Added:
+ Per-contract custom deadlines
+ Insurance tiers: none, basic, standard, premium
+ /cl dispute open <id> <reason>
+ /cl admin dispute <id> requester|carrier|split|cancel|fail [note]
+ DISPUTED contract status
+ Dispute event history
+ messages.yml for all player-facing text
+ Automatic config.yml and messages.yml migration

Changed:
* /cl delivery create now supports optional [hours] [insuranceTier]
* config.yml is now fully commented and focused on settings only
* /cl reload reloads both config and messages
* Delivery list shows deadline and insurance tier

Download

Version: 0.3.0
File: ContractLedger-0.3.0.jar
Compatibility: Spigot/Paper 1.21+
Dependencies: Vault + compatible economy plugin

Give your delivery economy better deadlines, safer insurance, and staff-ready dispute handling.​

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