[dispatcharr-ranked-matchups]: release v1.27.1 - language preferences, provenance ordering, per-group stream policy

plugins/dispatcharr-ranked-matchups/README.md

@@ -1,14 +1,33 @@
 # Ranked Matchups (Top Games)
 
-A cross-sport "interestingness" curator for Dispatcharr. It pulls upcoming games for each sport you enable, scores every matchup on how interesting it is (rankings, standings, rivalries, betting lines, playoff/knockout stakes), matches the worthwhile games to your existing Dispatcharr channels via EPG, and renames + groups them into a dedicated **Top Matchups** channel profile. Your guide ends up showing the games worth watching instead of the full firehose.
+A cross-sport "interestingness" curator for Dispatcharr. It pulls upcoming games for each sport you enable, scores every matchup on how interesting it is (rankings, standings, rivalries, betting lines, playoff/knockout stakes), matches the worthwhile games against your lineup, and renames + groups them into a dedicated **!Top Matchups** channel group. Your guide ends up showing the games worth watching instead of the full firehose.
 
 ## What it does
 
 - Per-sport adapters (college football/basketball, NFL, NBA, MLB, NHL, WNBA, NWSL, MLS, top-flight soccer leagues, internationals/friendlies, World Cup, and more), each toggleable.
 - Scores matchups with a transparent model (see `SCORING.md` in the source repo): ranked-vs-ranked, standings importance, rivalries, and betting-line signal where available.
-- Matches scored games to your channels through EPG and builds a curated **Top Matchups** profile with clean, renamed entries.
+- Matches scored games against your lineup and builds a curated **!Top Matchups** channel group with clean, renamed entries.
 - Runs on demand from the plugin UI or on a schedule.
 
+## How games are matched
+
+Three independent paths, all of which can contribute (results merge and stack as
+fallback streams):
+
+- **EPG programme title, sub-title or description** inside the game's window.
+- **Channel name**, for providers that name the fixture on the channel.
+- **Stream name, whether or not that stream is attached to a channel.** This is
+  what lets a large M3U produce per-match feeds without curating them into
+  channels first, and it is why a matchup channel can pick up feeds you never
+  added yourself.
+
+Because that third path sweeps your whole M3U, three settings decide what
+happens to feeds you did not curate, and none of them removes a stream unless
+you say so: **Preferred languages** (an ordered list like `en` or `de, en`),
+**Demote stream groups** (used only as a last resort, still playable), and
+**Exclude stream groups** (never attached at all). Streams you have attached to
+a channel of your own always sort ahead of ones found only by the sweep.
+
 ## Requirements
 
 - Most sources need a free API key (e.g. CollegeFootballData / CollegeBasketballData, Football-Data.org, The Odds API). Each sport's setting documents which key it needs; sports you do not enable need no key.

plugins/dispatcharr-ranked-matchups/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "Ranked Matchups (Top Games)",
-  "version": "1.26.0",
+  "version": "1.27.1",
   "description": "Never miss a good game. Scores every upcoming game across 39 leagues, tours and competitions (22 of them soccer, plus NFL, NBA, MLB, NHL, NCAA D1 football and basketball, UFC, boxing, tennis, golf and motorsport), then builds a Top Matchups group holding only the ones worth watching and shows why each game ranked where it did in its EPG description. Finished games can clear themselves out and be replaced from a bench of the next-best fixtures.",
   "author": "Jacob-Lasky",
   "license": "MIT",