README: Match-Übersicht, Pausen und Turnierregeln dokumentiert

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>

README.md

@@ -75,14 +75,14 @@ Die Tests decken Veto-Engine und Ablaufvalidierung, RCON-Protokoll (gegen einen
 6. **Server konfigurieren:** Nach dem Veto wird der bereits laufende Server automatisch eingerichtet: Spielmodus, erste Map, Teamnamen und Startseiten, Match-Einstellungen, Server- und CSTV-Passwort. Die restliche Map-Reihenfolge ist gespeichert.
    - Spieler sehen danach den kopierbaren Konsolenbefehl `password …; connect host:port` und einen `steam://connect`-Link.
    - Zuschauer sehen den CSTV-Zugang (eigener Port, eigenes Passwort, Verzögerung).
-7. **Während der Serie:** Der Organisator kann die Aufwärmphase beenden (`mp_warmup_end`), die nächste Map laden, den Server stoppen und das Match abschließen oder abbrechen.
+7. **Während der Serie:** Der Organisator kann die Aufwärmphase beenden (`mp_warmup_end`), das laufende Match pausieren und fortsetzen (`mp_pause_match`, `mp_unpause_match`), die nächste Map laden, den Server stoppen und das Match abschließen oder abbrechen.
 8. **Fehlerfälle:** Startet der Server nicht, schlägt die Konfiguration fehl oder fällt der Server aus, zeigt die Seite den Grund. Der Organisator bekommt einen Knopf für den erneuten Versuch: „Server neu starten“ bzw. „Konfiguration wiederholen“.
 
 ### Rollen und Berechtigungen
 
 | Rolle | Zugang über | Darf |
 |---|---|---|
-| Organisator | Token beim Erstellen | Veto starten, Spieler entfernen, Captain setzen, Codes erneuern, Server neu starten/stoppen/konfigurieren, nächste Map, Match beenden; sieht Einladungen, Spieler- und CSTV-Verbindung |
+| Organisator | Token beim Erstellen | Veto starten, Spieler entfernen, Captain setzen, Codes erneuern, Server neu starten/stoppen/konfigurieren, pausieren/fortsetzen, nächste Map, Match beenden; sieht Einladungen, Spieler- und CSTV-Verbindung, die Match-Übersicht |
 | Captain | Teamcode (erster Spieler oder ernannt) | alles wie Spieler, dazu Veto-Aktionen seines Teams und Captain-Übergabe |
 | Spieler | Teamcode | bereit melden, Team verlassen; sieht die Spieler-Verbindungsdaten nach dem Veto |
 | Zuschauer | Zuschauercode | alles live verfolgen; sieht nur den CSTV-Zugang, nicht das Spielerpasswort |
@@ -201,9 +201,22 @@ Die Serververwaltung ist hinter [`server/src/servers/adapter.js`](server/src/ser
    - Wird alle `SERVER_STATUS_POLL_SECONDS` abgefragt, solange der Server startet, danach alle 30 s.
 3. **`configure(handle, plan)`**: in zwei Phasen.
    1. `game_type`, `game_mode`, `sv_password`, `tv_enable`, `tv_delay`, `tv_password`, dann `changelevel <map>`.
-   2. Warten, bis `status` die Map meldet (max. 2 Minuten), dann die Match-Einstellungen (`mp_teamname_1/2`, `mp_maxrounds`, `mp_overtime_enable`, `mp_match_can_clinch`, `mp_warmup_pausetimer 1`, `CS2_EXTRA_COMMANDS`).
+   2. Warten, bis `status` die Map meldet (max. 2 Minuten), dann die Match-Einstellungen (`mp_teamname_1/2`, `mp_maxrounds`, `mp_overtime_enable`, `mp_match_can_clinch`, `mp_warmup_pausetimer 1`, `CS2_EXTRA_COMMANDS`) und die Turnierregeln (siehe unten).
 
    Die zweite Phase kommt erst nach dem Mapwechsel, weil die `gamemode_*.cfg` des Spiels diese Werte beim Laden der Map sonst überschreibt.
+
+**Turnierregeln:** Jeder konfigurierte Server setzt außerdem diese Werte, die sich an FACEIT- und ESL-Richtwerten orientieren:
+
+| Befehl | Wert | Zweck |
+|---|---|---|
+| `sv_pausable` | `1` | erlaubt Pausen (`mp_pause_match`) |
+| `mp_halftime` | `1` | Seitenwechsel zur Halbzeit |
+| `mp_freezetime` | `20` | Freezetime in Sekunden |
+| `mp_buytime` | `20` | Kaufzeit in Sekunden |
+| `mp_startmoney` | `800` | Startgeld |
+| `mp_roundtime` | `1.92` | Rundenzeit in Minuten (1:55) |
+
+Die Werte stammen nicht aus einer Regel eines konkreten Turniers. Vor einem echten Turnier bitte mit dem Regelwerk des Veranstalters abgleichen und in `server/src/servers/cs2Config.js` anpassen. Ob `sv_pausable` und die Pause-Befehle am echten Server wirken, ist noch nicht getestet.
 4. **`stop(handle)`**: Server beenden bzw. freigeben.
 
 ### Option A: Docker (`SERVER_ADAPTER=docker`)
@@ -314,12 +327,15 @@ Unter `/stream` (in der Kopfzeile verlinkt) zeigt eine 1920×1080-Seite alle lau
 - **Raster:** passt sich der Anzahl an (1, 2, 4 oder 6 Karten). Bei mehr als 6 Matches blättert die Seite alle 12 Sekunden weiter.
 - **Unten:** offene Lobbys und die Ergebnisse der letzten drei Stunden.
 - **Datenschutz:** Codes und Verbindungsdaten erscheinen nicht.
+- **Einzelnes Match:** Ein Klick auf eine Karte oder einen Eintrag öffnet die Übersicht nur dieses Matches unter `/stream/match/<matchId>`. Der Link enthält keinen Zuschauercode, der Schlüssel `?key=` wird übernommen.
 - **Schlüssel:** Mit `STREAM_KEY` ist die Seite nur mit `/stream?key=<schlüssel>` erreichbar, sonst offen. `?bg=transparent` funktioniert ebenfalls.
 
 ### Stream-Übersicht eines Matches
 
 Unter `/stream/<Zuschauercode>` gibt es eine Vollbild-Übersicht für den Stream. Den Link findet der Organisator bei den Einladungen.
 
+Für die Übersicht eines einzelnen Matches ohne Zuschauercode gibt es `/stream/match/<matchId>`. Der Organisator findet den Link unter „Match-Übersicht“ im Bereich Einladungen. Ist `STREAM_KEY` gesetzt, hängt der Link den Schlüssel an, damit Organisatoren die Seite öffnen können.
+
 - **Format:** 1920×1080, skaliert auf jede Fenstergröße. In OBS als Browserquelle mit 1920×1080 einbinden. Mit `?bg=transparent` ist der Hintergrund durchsichtig.
 - **Ablauf:** Die Seite wechselt automatisch zwischen Lobby (Aufstellungen), Map-Veto (live) und Match (Spielstand, Rundenverlauf, Map-Leiste).
 - **Laufband:** zeigt das letzte für Zuschauer relevante Ereignis, keine technischen Servermeldungen.
@@ -392,6 +408,6 @@ Alle Aktionen laufen per `POST` mit `Authorization: Bearer <token>`. Der Token i
 | `…/ready`, `…/leave` | Spieler |
 | `…/veto/action` `{stepIndex, map?, side?}` | Captain am Zug |
 | `…/captain` `{playerId}` | Organisator, Captain des Teams |
-| `…/veto/start`, `…/kick`, `…/codes/regenerate`, `…/server/retry`, `…/server/stop`, `…/server/warmup-end`, `…/series/next`, `…/finish`, `…/cancel` | Organisator |
+| `…/veto/start`, `…/kick`, `…/codes/regenerate`, `…/server/retry`, `…/server/stop`, `…/server/warmup-end`, `…/server/pause`, `…/server/resume`, `…/series/next`, `…/finish`, `…/cancel` | Organisator |
 
 Socket.IO: `match:subscribe {matchId, token}` liefert `match:state` bei jeder Änderung; `overview:subscribe` liefert `overview`.

client/src/App.jsx

@@ -14,6 +14,7 @@ export default function App() {
     <Routes>
       {/* Stream-Übersicht ohne Kopfzeile, als Vollbild bzw. OBS-Browserquelle */}
       <Route path="/stream/:code" element={<StreamPage />} />
+      <Route path="/stream/match/:matchId" element={<StreamOverviewPage />} />
       <Route path="/stream" element={<StreamOverviewPage />} />
       <Route path="*" element={<MainLayout />} />
     </Routes>

client/src/components/OrganizerPanel.jsx

@@ -29,6 +29,8 @@ export default function OrganizerPanel({ state, act, busy, matchId, token }) {
             <div className="stream-link">
               <CopyField label="Stream-Übersicht (als Browserquelle in OBS, 1920×1080)" value={links.stream} />
               <a className="btn btn-sm" href={links.stream} target="_blank" rel="noreferrer">Stream-Ansicht öffnen</a>
+              <CopyField label="Match-Übersicht (nur dieses Match, ohne Zuschauercode)" value={links.overview} />
+              <a className="btn btn-sm" href={links.overview} target="_blank" rel="noreferrer">Match-Übersicht öffnen</a>
             </div>
           )}
         </div>

client/src/pages/AdminPage.jsx

@@ -217,6 +217,8 @@ function MatchAdminCard({ m, run, busy, token, reload, setNotice }) {
         <Link className="btn btn-sm" to={`/m/${id}`}>Ansehen</Link>
         {m.status === 'lobby' && btn('Veto starten', { path: '/veto/start' }, 'btn-primary')}
         {(m.server?.status === 'configured') && btn('Aufwärmphase beenden', { path: '/server/warmup-end' })}
+        {(m.server?.status === 'configured') && btn('Pausieren', { path: '/server/pause', confirm: 'Match pausieren?' })}
+        {(m.server?.status === 'configured') && btn('Fortsetzen', { path: '/server/resume' })}
         {(m.server?.status === 'configured') && hasNext && btn('Nächste Map', { path: '/series/next' })}
         {m.server && ['start_failed', 'failed', 'stopped', 'config_failed', 'ready'].includes(m.server.status) && !closed &&
           btn('Server neu starten / wiederholen', { path: '/server/retry' })}

client/src/pages/StreamOverviewPage.jsx

@@ -1,4 +1,5 @@
 import { useEffect, useState } from 'react';
+import { useParams } from 'react-router-dom';
 import { api } from '../lib/api.js';
 import { FORMAT_LABEL } from '../lib/labels.js';
 import { getSocket } from '../lib/useMatch.js';
@@ -14,11 +15,13 @@ const PAGE_SECONDS = 12;
 /**
  * Stream-Übersicht aller laufenden Vetos und Matches: /stream
  * Mit STREAM_KEY: /stream?key=<schlüssel>. Optional ?bg=transparent.
+ * Ein einzelnes Match: /stream/match/<matchId>, daraus führen die Karten der Übersicht.
  */
 export default function StreamOverviewPage() {
   const params = new URLSearchParams(window.location.search);
   const key = params.get('key') ?? '';
   const transparent = params.get('bg') === 'transparent';
+  const { matchId } = useParams();
   const { data, error } = useStreamOverview(key);
   const now = useClock();
   const [page, setPage] = useState(0);
@@ -29,8 +32,10 @@ export default function StreamOverviewPage() {
     return () => document.documentElement.classList.remove('stream-mode', 'stream-transparent');
   }, [transparent]);
 
+  const activeMatches = (data?.active ?? []).filter((m) => !matchId || m.id === matchId);
+
   // Mehr Matches als auf eine Seite passen: automatisch weiterblättern
-  const pages = data ? Math.max(1, Math.ceil(data.active.length / PER_PAGE)) : 1;
+  const pages = Math.max(1, Math.ceil(activeMatches.length / PER_PAGE));
   useEffect(() => {
     if (pages <= 1) { setPage(0); return undefined; }
     const t = setInterval(() => setPage((p) => (p + 1) % pages), PAGE_SECONDS * 1000);
@@ -49,7 +54,7 @@ export default function StreamOverviewPage() {
     );
   }
 
-  const active = data?.active ?? [];
+  const active = activeMatches;
   const shown = active.slice(page * PER_PAGE, page * PER_PAGE + PER_PAGE);
   const liveCount = active.filter((m) => m.status === 'live').length;
   const vetoCount = active.filter((m) => m.status === 'veto').length;
@@ -73,11 +78,24 @@ export default function StreamOverviewPage() {
           {!data && <div className="so-empty">Lade Matches …</div>}
           {data && shown.length === 0 && (
             <div className="so-empty">
-              <h2>Gerade läuft kein Match</h2>
-              <p>{data.upcoming.length ? 'Die nächsten Lobbys stehen unten.' : 'Sobald ein Veto beginnt, erscheint es hier.'}</p>
+              {matchId ? (
+                <>
+                  <h2>Dieses Match läuft gerade nicht</h2>
+                  <p>Es erscheint hier, sobald das Veto oder das Match beginnt.</p>
+                </>
+              ) : (
+                <>
+                  <h2>Gerade läuft kein Match</h2>
+                  <p>{data.upcoming.length ? 'Die nächsten Lobbys stehen unten.' : 'Sobald ein Veto beginnt, erscheint es hier.'}</p>
+                </>
+              )}
             </div>
           )}
-          {shown.map((m) => <MatchCard key={m.id} m={m} />)}
+          {shown.map((m) => (
+            <a key={m.id} className="so-link" href={matchHref(m.id, key)}>
+              <MatchCard m={m} />
+            </a>
+          ))}
         </main>
 
         <footer className="so-bottom">
@@ -87,8 +105,10 @@ export default function StreamOverviewPage() {
               <ul>
                 {data.upcoming.map((m) => (
                   <li key={m.id}>
-                    <span className="a">{m.teams.A}</span> <span className="vs">vs</span> <span className="b">{m.teams.B}</span>
-                    <small>{FORMAT_LABEL[m.format]}{m.ready.A && m.ready.B ? ', bereit' : ''}</small>
+                    <a className="so-link" href={matchHref(m.id, key)}>
+                      <span className="a">{m.teams.A}</span> <span className="vs">vs</span> <span className="b">{m.teams.B}</span>
+                      <small>{FORMAT_LABEL[m.format]}{m.ready.A && m.ready.B ? ', bereit' : ''}</small>
+                    </a>
                   </li>
                 ))}
               </ul>
@@ -100,9 +120,11 @@ export default function StreamOverviewPage() {
               <ul>
                 {data.results.map((m) => (
                   <li key={m.id}>
-                    <span className={`a ${winner(m) === 'A' ? 'won' : ''}`}>{m.teams.A}</span>
-                    <b>{resultScore(m)}</b>
-                    <span className={`b ${winner(m) === 'B' ? 'won' : ''}`}>{m.teams.B}</span>
+                    <a className="so-link" href={matchHref(m.id, key)}>
+                      <span className={`a ${winner(m) === 'A' ? 'won' : ''}`}>{m.teams.A}</span>
+                      <b>{resultScore(m)}</b>
+                      <span className={`b ${winner(m) === 'B' ? 'won' : ''}`}>{m.teams.B}</span>
+                    </a>
                   </li>
                 ))}
               </ul>
@@ -114,6 +136,11 @@ export default function StreamOverviewPage() {
   );
 }
 
+/** Link zur Stream-Übersicht eines einzelnen Matches. Der Zuschauercode bleibt geheim, daher nur die Match-ID. */
+function matchHref(id, key) {
+  return `/stream/match/${encodeURIComponent(id)}${key ? `?key=${encodeURIComponent(key)}` : ''}`;
+}
+
 function useStreamOverview(key) {
   const [data, setData] = useState(null);
   const [error, setError] = useState(null);
@@ -145,7 +172,6 @@ function winner(m) {
   const [a, b] = resultScore(m).split(':').map(Number);
   return a === b ? null : a > b ? 'A' : 'B';
 }
-
 function MatchCard({ m }) {
   const current = m.series.find((s) => s.number === m.currentMapNumber);
   const isBo1 = m.format === 'bo1';

client/src/stream-overview.css

@@ -114,3 +114,9 @@
 .so-strip li b { font-variant-numeric: tabular-nums; }
 .so-strip li .won { text-decoration: underline; text-underline-offset: 5px; }
 .so-none { color: var(--muted); font-size: 22px; margin: 0; }
+
+/* Klickbare Karten und Listeneinträge führen zur Übersicht des jeweiligen Matches */
+.so-link { display: block; color: inherit; text-decoration: none; }
+.so-strip li .so-link { display: flex; align-items: baseline; gap: 10px; color: inherit; text-decoration: none; }
+.so-link:hover { filter: brightness(1.15); }
+.so-link:focus-visible { outline: 3px solid var(--brand-red); outline-offset: 4px; }

server/src/adminRoutes.js

@@ -92,6 +92,8 @@ export function createAdminRouter({ service, manager, config }) {
   action('server/stop', (v) => manager.stopByOrganizer(v));
   action('server/retry', (v) => manager.retry(v));
   action('server/warmup-end', (v) => manager.endWarmup(v));
+  action('server/pause', (v) => manager.setPaused(v, true));
+  action('server/resume', (v) => manager.setPaused(v, false));
   action('series/next', (v) => manager.loadNextMap(v));
   action('veto/start', (v) => service.startVeto(v));
   action('veto/action', (v, b) => service.vetoAction(

server/src/matchService.js

@@ -796,6 +796,8 @@ export class MatchService extends EventEmitter {
           spectator: `${base}/watch/${formatCode(match.code_spectator)}`,
           // Vollbild-Übersicht für den Stream (OBS-Browserquelle), nutzt den Zuschauercode
           stream: `${base}/stream/${formatCode(match.code_spectator)}`,
+          // Stream-Übersicht nur für dieses Match, ohne Zuschauercode (Schlüssel nur wenn gesetzt)
+          overview: `${base}/stream/match/${match.id}${this.config.streamKey ? `?key=${encodeURIComponent(this.config.streamKey)}` : ''}`,
         },
       };
     }

server/src/servers/cs2Config.js

@@ -63,6 +63,13 @@ export function buildMapCommands({ match, pool, seriesMap, secrets, settings, lo
     'mp_limitteams 0',
     // Aufwärmphase läuft, bis der Organisator das Match startet (mp_warmup_end)
     'mp_warmup_pausetimer 1',
+    // Turnierregeln (FACEIT/ESL-Richtwerte): Pausen erlauben, feste Rundenzeiten, Halbzeit
+    'sv_pausable 1',
+    'mp_halftime 1',
+    'mp_freezetime 20',
+    'mp_buytime 20',
+    'mp_startmoney 800',
+    'mp_roundtime 1.92',
     ...settings.extraCommands,
   ];
 

server/src/servers/serverManager.js

@@ -391,6 +391,21 @@ export class ServerManager {
     this.service.changed(viewer.matchId);
   }
 
+  /** Admin: pausiert oder setzt das laufende Match auf dem Server fort (mp_pause_match / mp_unpause_match). */
+  async setPaused(viewer, paused) {
+    this.service.require(viewer, 'organizer');
+    const row = this.row(viewer.matchId);
+    if (row?.status !== 'configured') throw new HttpError(409, 'Der Server ist nicht bereit', 'wrong_state');
+    if (!this.adapter.sendCommands) throw new HttpError(501, 'Dieser Adapter unterstützt keine Befehle', 'unsupported');
+    try {
+      await this.adapter.sendCommands(JSON.parse(row.handle), [paused ? 'mp_pause_match' : 'mp_unpause_match']);
+    } catch (err) {
+      throw new HttpError(502, `Befehl konnte nicht gesendet werden: ${err.message}`, 'server_error');
+    }
+    this.service.log(viewer.matchId, 'server', paused ? 'Match pausiert (Admin)' : 'Match fortgesetzt (Admin)');
+    this.service.changed(viewer.matchId);
+  }
+
   /** Demo-Modus: simuliert einen Matchverlauf, indem echte CS2-Logzeilen erzeugt und ausgewertet werden. */
   startDemoSimulation(matchId) {
     const match = this.service.getMatch(matchId);

server/test/api.test.js

@@ -107,6 +107,9 @@ test('kompletter Ablauf: Lobby, Berechtigungen, Veto, Server-Konfiguration', asy
     const orgView = (await call('GET', `/matches/${id}`, { token: org })).body;
     assert.equal(orgView.viewer.role, 'organizer');
     const { codes } = orgView.organizer;
+    // Match-Übersicht nur für dieses Match, ohne Zuschauercode
+    assert.match(orgView.organizer.links.overview, new RegExp(`/stream/match/${id}$`));
+    assert.ok(!orgView.organizer.links.overview.includes(codes.spectator));
 
     // Zuschauer- und fremde Codes erlauben keinen Teambeitritt
     assert.equal((await call('POST', `/matches/${id}/join`, { body: { code: codes.spectator, nickname: 'spy' } })).status, 403);
@@ -398,6 +401,7 @@ test('Admin-Modus: Anmeldung, Verwaltung aller Matches, Sperre ohne Anmeldung',
 
     // Ein Match abbrechen wie ein Admin
     assert.equal((await call('POST', `/admin/matches/${id}/cancel`, { ...admin, body: {} })).status, 200);
+    assert.equal((await call('POST', `/admin/matches/${id}/server/pause`, { ...admin, body: {} })).status, 409, 'ohne Server keine Pause');
     assert.equal(app.service.getMatch(id).status, 'cancelled');
 
     // Endgültig löschen

server/test/rcon.test.js

@@ -64,6 +64,8 @@ test('Konsolentexte können keine Befehle einschleusen', () => {
   assert.ok(afterMapChange.includes('mp_teamname_1 "Bravo"'));
   assert.ok(afterMapChange.includes('mp_teamname_2 "Alphaquit"'));
   assert.ok(afterMapChange.includes('mp_maxrounds 16'));
+  assert.ok(afterMapChange.includes('sv_pausable 1'), 'Pausen-Knopf braucht sv_pausable');
+  assert.ok(afterMapChange.includes('mp_freezetime 20'));
 });
 
 test('Log-Weiterleitung wird vor dem Mapwechsel gesetzt, unsichere URLs nicht', () => {