Basketball Subs Planner

1. 1. Configure Game Settings: Adjust the "Max Players On Court," "Total Game Minutes," "Number of Periods," "Substitution Interval," "Max Subs per Rotation," and "Minimum On-Court Stint" to match your game's rules.
2. 2. Manage Players:
   • Add player names one by one.
   • For each player, check the "Absent for this game" box if they are not playing in the *current* game. Their playtime will not be updated for this game.
3. 3. Set Season Target: Enter the "Total games anticipated in season." This is for general context in the Season Playtime Summary. Individual player targets are now based on games *they actually play*.
4. 4. Generate Schedule: Click the "Generate Full Game Schedule" button. The planner will create a detailed substitution schedule for the entire game, prioritizing even playtime across your *present* roster for *this specific game*.
5. 5. Review Game Playtime: The "Current Game Playtime & Substitutions" will show how many minutes each player is scheduled to play in *this game*, and the total number of substitutions they had.
6. 6. Track Season Playtime: The "Season Playtime Management" section uses your browser's **IndexedDB** to automatically track cumulative playtime across multiple games.
   • The "Season Mins" column shows each player's total accumulated playtime.
   • "Games Played" shows how many games that player has been marked as "present" for.
   • "Target Mins" shows the calculated ideal total playtime for each player based *only on the games they were present for*. This means players who miss games will have a lower target and **will not** be prioritized to "catch up" on playtime from games they missed.
   • "Deviation" indicates how far each player is from their target (positive means over, negative means under) *for the games they actually played*.
   • Players highlighted in **red** are significantly below their target, while **green** indicates they are significantly above. Yellow is for slight deviations.
   • **Important for Absences:** If a player is marked "Absent for this game", their "Season Mins" and "Games Played" will *not* increase for this game.
7. 7. Plan Next Game: When you generate a schedule for your next game, the system will automatically factor in the accumulated season playtime, aiming to give more minutes to players who have played less overall.
8. 8. Manage Season Data:
   • Click "Load Previous Season Playtime" to manually refresh the season playtime display (though it updates automatically after generating a schedule).
   • Click "Clear All Season Playtime" to reset all historical playtime data. Use this when starting a new season or if you want to clear all accumulated data.

**Note:** This tool strives for fair distribution, but exact equality might not always be possible due to game constraints (e.g., specific number of players, minimum stint durations, substitution intervals). The system will prioritize players with the least *overall* playtime to ensure balance over time.