feat(soccer): World Cup support + ET/penalty fix + config UI titles (v1.7.1)

plugins.json

@@ -1,6 +1,6 @@
 {
   "version": "1.0.0",
-  "last_updated": "2026-05-31",
+  "last_updated": "2026-06-02",
   "plugins": [
     {
       "id": "7-segment-clock",
@@ -579,7 +579,7 @@
     {
       "id": "soccer-scoreboard",
       "name": "Soccer Scoreboard",
-      "description": "Live, recent, and upcoming soccer games across multiple leagues including Premier League, La Liga, Bundesliga, Serie A, Ligue 1, MLS, Liga Portugal, and more",
+      "description": "Live, recent, and upcoming soccer games across multiple leagues including Premier League, La Liga, Bundesliga, Serie A, Ligue 1, MLS, Liga Portugal, Champions League, Europa League, and FIFA World Cup",
       "author": "ChuckBuilds",
       "category": "sports",
       "tags": [
@@ -591,6 +591,8 @@
         "serie-a",
         "ligue-1",
         "mls",
+        "world-cup",
+        "fifa",
         "sports",
         "scoreboard",
         "live-scores"
@@ -600,10 +602,10 @@
       "plugin_path": "plugins/soccer-scoreboard",
       "stars": 0,
       "downloads": 0,
-      "last_updated": "2026-05-20",
+      "last_updated": "2026-06-02",
       "verified": true,
       "screenshot": "",
-      "latest_version": "1.6.3"
+      "latest_version": "1.7.1"
     },
     {
       "id": "static-image",

plugins/soccer-scoreboard/README.md

@@ -13,9 +13,7 @@
 
 # Soccer Scoreboard Plugin
 
-### This version is still under development. It should be mostly functional but the custom league upload module is not working. 
-
-A plugin for LEDMatrix that displays live, recent, and upcoming soccer games across multiple leagues including Premier League, La Liga, Bundesliga, Serie A, Ligue 1, MLS, and more.
+A plugin for LEDMatrix that displays live, recent, and upcoming soccer games across multiple leagues including Premier League, La Liga, Bundesliga, Serie A, Ligue 1, MLS, and FIFA World Cup.
 
 ## Features
 
@@ -175,8 +173,27 @@ The plugin supports the following soccer leagues:
 - **ita.1**: Serie A (Italy)
 - **fra.1**: Ligue 1 (France)
 - **usa.1**: MLS (USA)
+- **por.1**: Liga Portugal (Portugal)
 - **uefa.champions**: UEFA Champions League
 - **uefa.europa**: UEFA Europa League
+- **fifa.world**: FIFA World Cup
+
+Additional leagues can be added via the **Custom Leagues** setting using any ESPN soccer league code (e.g. `mex.1`, `arg.1`, `bra.1`, `ned.1`).
+
+## FIFA World Cup
+
+Enable the **FIFA World Cup** league from the plugin settings to track World Cup 2026 (June 11 – July 19, USA/Canada/Mexico).
+
+**To follow all games:** Enable `fifa.world` and leave `Show Favorite Teams Only` off.
+
+**To follow just your country:** Enable `fifa.world`, set `Favorite Teams` to your country's ESPN abbreviation (e.g. `USA`, `ENG`, `BRA`), and enable `Show Favorite Teams Only`.
+
+During knockout rounds, the status area shows:
+- **ET1** / **ET2** — Extra Time first / second half
+- **ETH** — Halftime of Extra Time
+- **PEN** — Penalty Shootout in progress
+- **F/ET** — Final, decided in Extra Time
+- **F/Pen** — Final, decided on Penalties
 
 ## Team Names & Abbreviations
 

plugins/soccer-scoreboard/TEAMS.md

@@ -212,6 +212,58 @@ Same as Champions League — use the club's domestic abbreviation from the table
 
 ---
 
+## FIFA World Cup 2026 (fifa.world)
+
+> **⚠️ Verify abbreviations via debug logs.** ESPN's internal abbreviations for national teams are not always the same as FIFA country codes. Enable debug logging and check the `home_abbr`/`away_abbr` values logged for each game to confirm the exact codes the ESPN feed uses before setting `favorite_teams`.
+
+The table below lists high-confidence ESPN abbreviations based on prior international tournament data. Entries marked with `*` should be treated as approximate until confirmed from the live feed.
+
+| Country | Abbreviation |
+|---------|-------------|
+| Argentina | ARG |
+| Australia | AUS |
+| Belgium | BEL |
+| Brazil | BRA |
+| Cameroon | CMR |
+| Canada | CAN |
+| Chile | CHI |
+| Colombia | COL |
+| Costa Rica | CRC |
+| Croatia | CRO |
+| Czech Republic | CZE |
+| Ecuador | ECU |
+| Egypt | EGY |
+| England | ENG |
+| France | FRA |
+| Germany | GER |
+| Ghana | GHA |
+| Hungary | HUN |
+| Iran | IRN |
+| Japan | JPN |
+| Mali | MLI * |
+| Mexico | MEX |
+| Morocco | MAR |
+| Netherlands | NED |
+| New Zealand | NZL |
+| Nigeria | NGA |
+| Panama | PAN |
+| Paraguay | PAR |
+| Portugal | POR |
+| Saudi Arabia | KSA |
+| Senegal | SEN |
+| Serbia | SRB |
+| Slovakia | SVK |
+| South Korea | KOR |
+| Spain | ESP |
+| Switzerland | SUI |
+| Tunisia | TUN |
+| United States | USA |
+| Uruguay | URU |
+
+To find your team's abbreviation: enable the plugin, set `debug` log level, then look for lines like `Extracted: USA@MEX` in the logs — those are the exact codes ESPN returns.
+
+---
+
 ## Tips
 
 - **Abbreviations are case-sensitive** — use uppercase as shown (e.g. `"LIV"` not `"liv"`)