BUCKETS – Basketball Stat Battle

BUCKETS is a simple, browser‑based card game inspired by classic Quartett and Top Trumps. In each round, you draw two random NBA or WNBA player cards and pick the stat that gives your team (the Home team) the edge. Points are awarded as outlined in the Scoring Table below. Whoever has the higher total after four quarters wins the game.

---

📖 License and usage

This project is source-available, not open source.

You may view and modify the code for personal, educational, and non-commercial purposes.

If you publicly redistribute this project or a modified version of it, you must:

• link to the original project repository
• include a visible attribution to the original project and author, where technically and contextually appropriate
• clearly mark your version as modified and unofficial

Commercial use, paid hosting, resale, and misleading rebranding are not allowed without prior written permission.

---

🎮 How to Play

1. Deck Setup – Each round you draw a random player card for the Home team.
   You can switch between NBA and WNBA in the Settings; switching changes the player pool immediately but keeps your score and clock.
   The CPU’s card is picked dynamically based on the current score to keep the game balanced.
2. Select a Stat – Click one stat on your card (e.g. PTS, REB, AST).
3. Compare & Score – Your value is compared with the opponent’s. Points are awarded as shown in the scoring table below.
4. Quarters & Timer – Each comparison ticks the amount set in the Settings (default = 1 minute) off the game clock. After four quarters the game is over.
5. Result – A win/lose message shows the final score.

---

🏀 Scoring Table

Stat	Points
FT%, FTM, GP, MIN	1
3PM, 3PP	3
All others	2

Tip: A made three can swing the momentum, but missing costs you 3 points – pick wisely!

---

🚀 Play Online

Play instantly at https://tehes.github.io/buckets/ – no installation required.

Supports both NBA and WNBA rosters.

---

🛠️ For Developers

├── index.html        # Game UI
├── js/
│   └── app.js        # Game logic
├── css/
│   └── style.css     # Styling
├── fetchAPI-nba.js    # Deno script – fetches NBA stats from the JSON API
├── fetchAPI-wnba.js   # Deno script – fetches WNBA stats from the JSON API
├── legacy/
│   ├── fetchData-nba.js   # Legacy Puppeteer fallback
│   └── fetchData-wnba.js  # Legacy Puppeteer fallback
├── data-nba.json      # NBA player statistics
├── data-wnba.json     # WNBA player statistics
└── deno.json         # Deno task configuration

Game Logic (app.js)

• Loads data.json and shuffles the deck once at game start—every draw is fully random for you; the CPU card is selected by the handicap algorithm.

• Dynamic handicap: Depending on the score, the game allows the CPU card to beat yours in 0 – N categories (N shrinks when you lead, grows when you trail).
  The algorithm increases or decreases this limit in ±1 steps until it finds a matching card, so games stay close without feeling scripted.

• Configurable clock decrement: Players can choose in the Settings whether each matchup shortens the game clock by 1, 2, or 4 minutes.

• Optional CPU reveal: In the Settings, players can enable an option to reveal all CPU stats during comparisons (default = off). When enabled, stats remain visible until you click to continue.

• setCard(side, data) renders the player card on the board.

• compareValues() compares stats and applies the 1 / 2 / 3‑point scoring, then updates the scoreboard and animations.

• The loop runs until the clock hits 0 : 00 in the 4th quarter, then shows the final result.

• The active league (NBA/ WNBA) is selected via Settings. Switching leagues changes the player pool immediately but keeps the current score and clock.

Styling (style.css)

• CSS variables for team colours and layout.

• Fully responsive with vmin units.

• CSS variables are namespaced by league (e.g. --nba-den, --wnba-nyl).

Data Fetch (fetchAPI-nba.js, fetchAPI-wnba.js)

• API scripts refresh data-nba.json and data-wnba.json from stats.nba.com and stats.wnba.com.
• Filters for rotation-level players in each league, applies league-specific thresholds, then ranks and trims by EFF.
• Adds player image URLs.
• Run with deno task fetchNBA or deno task fetchWNBA.
• Legacy Puppeteer scrapers are kept in legacy/ as a fallback if the stats API breaks.

---

🙏 Credits

Colour palettes courtesy of NBA Colors.

WNBA team colours and logos courtesy of the official WNBA website.