Salary Contracts - Player Compensation

1. Base Salary

1.1. Multiple Salary Tiers

A player's base salary rarely stays the same for the entire length of their contract. The system allows for Multiple Base Salaries within a single contract.

• The Logic: You can define a different salary for each season (e.g., Year 1: £20k/week; Year 2: £25k/week).

• Cover Seasons: Each salary entry specifies which Season Start Years it applies to. The system automatically "switches" the player to the new salary as the seasons change.

1.2. Salary Periods 

The system supports different ways of defining the "Headline" amount:

• Weekly / Monthly / Annual: You can enter the player's salary in the way it is most commonly talked about (e.g., £50,000 per week).

• The Conversion: The system can automatically calculate the Current Gross Salary (the total yearly value) for frontend display, making it easy to see the "Big Picture" cost of a player.

1.3. Installments & Frequency

Clubs don't always pay salary in 12 equal monthly chunks. The system is flexible:

• Installment Count: You can define how many actual payments are made (e.g., 4 quarterly payments).

• Frequency: You can set the frequency (e.g., Monthly, Weekly, Every 2 Months).

• Initial Payment Date: You can set exactly when the first payment is due.

1.4. Competition-Specific Salaries

In some leagues (like MLS or certain European top divisions), a player might have a different base salary depending on which competition the team is playing in.

• The system can link a specific base salary to a list of Competition IDs.

 

2. Fixed Payments

A Fixed Payment in ContingencyAI (specifically in the player's salary contract) is a one-time or scheduled lump sum that is guaranteed, but isn't part of the regular weekly or monthly "Base Salary." Common examples include Sign-on Bonuses and Loyalty Bonuses.

2.1. Payment Schedule

A single fixed payment can be split into a Schedule.

• The Logic: Instead of paying a £1 million sign-on bonus at once, the club might pay £500k in 2025 and £500k in 2026.

• The Check: Each payment in the schedule has a specific Payment Date and (optionally) a Qualifying Date.

2.2. Qualifying Date & Registration

• The Rule: A club can set a Qualifying Date and turn on "Require Registration on Qualifying Date."

• How it works: If this is enabled, the system automatically checks the player's official registration data. If the player has left the club before that qualifying date, the payment is automatically cancelled.

2.3. Payment Types & Amount Types

The system uses "Types" to organize these fees:

• Types: Sign-on Fee, Loyalty Bonus, or Other Fixed Payment.

• Amount Logic: Amounts can be a simple lump sum or calculated as a percentage of the base salary.

 

3. Match Bonuses

3.1. Milestone Match Bonuses

A Milestone Match Bonus is a "One-Time" reward for reaching a specific career goal with the club.

• The Logic: "Pay £50,000 when the player reaches 50 appearances for the club."

• The Check: As soon as the 50th game is recorded in the data feed, the system generates a Triggered Event.

• Support Tip: Once this is paid, it's done. It is a one-time "Milestone."

3.2. Recurring Match Bonuses

A Recurring Match Bonus is an ongoing payment triggered every time the player participates in a match that meets the contract's criteria.

Appearance Definition:

• Appearance Bonus: A set amount for every game played.

• Start Bonus: A higher amount if the player is in the Starting XI.

• Substitute Bonus: A smaller amount if they come off the bench.

• Unused Sub Bonus: A fee for being on the bench without playing.

Match Result Conditions:

The system looks at the official final score to determine if the bonus is owed:

• Win Only: Bonus is £0 if the team loses or draws.

• Win or Draw: Player gets paid if the team avoids defeat.

• Any Result: The player gets the bonus regardless of the score.

3.3. Match Bonus Payment Logic

• Monthly (Most Common): All bonuses earned during a calendar month are grouped into a "Monthly Batch" to match payroll cycles.

• Cumulative Lump Sum: Bonuses are tracked as a running total but triggered as one large sum on a specific date (e.g., June 30th).

• Bonus Schedules: For Milestones, the payment can be split (e.g., half upon hitting the milestone, half six months later).

 

4. Goal Contributions

A Goal Contribution Bonus is a financial reward given for a player's direct impact on the scoreline (Goals and Assists).

4.1. Full vs. Fractional Contributions

The user can assign a Specific Weight to goals and assists to treat them differently in the same calculation:

• Contribution Per Goal: (e.g., 1.0)

• Contribution Per Assist: (e.g., 0.5)

Example Calculation:

• Target: 10 total contributions.

• Weights: Goal = 1.0, Assist = 0.5.

• Performance: 8 goals (8 times 1.0 = 8.0) + 3 assists (3 times 0.5 = 1.5) = 9.5 Total Score.

• Result: The bonus is NOT triggered yet as the score is below the 10.0 threshold.

4.2. Types of Bonuses

• Recurring Bonus (Per Contribution): "Pay £1,000 for every goal or assist." Each action triggers a new payment immediately.

• Milestone Bonus (Total Contributions): "Pay £50,000 if the player reaches 20 goal contributions in a season." The system tracks a "Running Total" and triggers one payment once the threshold is crossed.