157 lines
No EOL
4 KiB
Text
157 lines
No EOL
4 KiB
Text
DashLeague Casting Tool — README
|
||
|
||
🎮 Caster Cheat Sheet (Quick Start)
|
||
1. Sync Stats
|
||
→ Press Sync Stats to pull the latest player data.
|
||
2. Build Career Database
|
||
→ Press Build Career Database
|
||
→ Wait for Career DB: ✓ Loaded (green)
|
||
3. Select Teams
|
||
→ Choose Team A and Team B from dropdowns
|
||
→ Optionally select specific players (or leave empty to auto‑select all)
|
||
4. Generate Player Slots
|
||
→ Press Generate Player Slots
|
||
→ Wait for Player Slots: ✓ Ready (green)
|
||
→ OBS now reads from –
|
||
5. Export Predictions
|
||
→ Button unlocks only when both ✓ are green
|
||
→ Press Export Predictions
|
||
→ Use for graphs/overlays
|
||
That’s it.
|
||
This is the entire casting workflow.
|
||
|
||
📘 Full Guide for First‑Time Users
|
||
1. Overview
|
||
The DashLeague Casting Tool is designed to:
|
||
• Prepare player slot folders (p0–p9) for OBS overlays
|
||
• Build and use a Career Database for advanced identity tags and predictions
|
||
• Export match predictions to JSON for downstream visuals
|
||
• Provide a caster‑friendly workflow with clear status indicators and safety prompts
|
||
You’ll mainly interact with:
|
||
• Toolbar buttons
|
||
• Team selectors
|
||
• Player lists
|
||
• Generate Player Slots
|
||
• Export Predictions
|
||
|
||
2. Prerequisites & Setup
|
||
Folder structure:
|
||
• — main script
|
||
• — generated by the tool
|
||
• – — OBS‑ready text files
|
||
• — teams + player data
|
||
Run the tool:
|
||
|
||
|
||
3. UI Layout
|
||
Top Toolbar
|
||
• Sync Stats — refresh raw stats
|
||
• Build Career Database — generate
|
||
• Player Spotlight — single‑player view
|
||
• Team Identity — team style summary
|
||
• Match Storyline — narrative hooks
|
||
• Rankings — player rankings & percentiles
|
||
Middle Section
|
||
• Team A / Team B selectors
|
||
• Player listboxes (multi‑select)
|
||
Bottom Section
|
||
• Generate Player Slots
|
||
• Export Predictions (locked until ready)
|
||
Status Indicators
|
||
• Career DB: ❌ / ✓
|
||
• Player Slots: ❌ / ✓
|
||
• Status bar text (bottom)
|
||
|
||
4. Recommended Workflow (Casting a Match)
|
||
Step 1 — Sync Stats
|
||
Click Sync Stats to refresh player data.
|
||
|
||
Step 2 — Build Career Database
|
||
Click Build Career Database.
|
||
You should see:
|
||
• Popup: “Career database has been built.”
|
||
• Status: Career DB: ✓ Loaded
|
||
This powers:
|
||
• Identity tags
|
||
• Slayer calculations
|
||
• League averages
|
||
|
||
Step 3 — Select Teams & Players
|
||
1. Choose Team A and Team B
|
||
2. Select players (or leave empty to auto‑select all)
|
||
|
||
Step 4 — Generate Player Slots
|
||
Click Generate Player Slots.
|
||
The tool writes:
|
||
•
|
||
•
|
||
• , ,
|
||
• ,
|
||
• , , etc.
|
||
• (from Career DB)
|
||
• , ,
|
||
You should see:
|
||
• Popup: “Player slots generated into p0–p9.”
|
||
• Status: Player Slots: ✓ Ready
|
||
OBS now reads from these folders.
|
||
|
||
Step 5 — Export Predictions
|
||
Button unlocks only when:
|
||
• Career DB: ✓ Loaded
|
||
• Player Slots: ✓ Ready
|
||
Click Export Predictions.
|
||
This generates:
|
||
|
||
Example:
|
||
|
||
Use this for:
|
||
• ASCII graphs
|
||
• Overlay widgets
|
||
• Automated visuals
|
||
|
||
5. Feature Details
|
||
Sync Stats
|
||
Refreshes raw stats from your source.
|
||
Build Career Database
|
||
Creates with:
|
||
• Identity tags
|
||
• League averages
|
||
• Historical stats
|
||
Generate Player Slots
|
||
Creates OBS‑ready text files for each player.
|
||
Export Predictions
|
||
Creates machine‑readable predictions for visuals.
|
||
Spotlight / Identity / Storyline / Rankings
|
||
Caster‑support tools for:
|
||
• Player deep dives
|
||
• Team style summaries
|
||
• Match narratives
|
||
• Percentiles & rankings
|
||
|
||
6. Status Indicators
|
||
• Career DB: ❌ Not Loaded
|
||
→ Build the DB first
|
||
• Player Slots: ❌ Not Ready
|
||
→ Generate slots
|
||
• Export Predictions disabled
|
||
→ One or both steps incomplete
|
||
|
||
7. Quick Reference Workflow
|
||
1. Sync Stats
|
||
2. Build Career Database
|
||
3. Select Team A / Team B
|
||
4. Generate Player Slots
|
||
5. Export Predictions
|
||
6. Use + in OBS
|
||
|
||
8. Troubleshooting
|
||
Export button greyed out
|
||
• Career DB must be ✓
|
||
• Player Slots must be ✓
|
||
Wrong players in OBS
|
||
• Check team selection
|
||
• Check listbox selection
|
||
• Regenerate slots
|
||
Empty predictions
|
||
• Build Career DB first
|
||
• Ensure player IDs match DB |