# 2You Mod Control — Walkthrough Guide & Changelog

Copy the sections below into the **Walkthrough Guide and Change Log** field when submitting for review in the Twitch Developer Console.

Review channel URL example: `https://www.twitch.tv/YOUR_CHANNEL`

---

## Backend, source code & allowlists

**Extension name:** 2You Mod Control  
**Version:** 1.0.0  
**Client ID:** nlnyvxnysrs29n9gfjvuwmrlx51k4m  

**Technology:** Plain HTML, CSS, and JavaScript (human-readable, not minified or obfuscated). No external JS libraries except the official Twitch Extension Helper (`twitch-ext.min.js` from Twitch CDN).

**Backend (EBS):** `https://2you.pro`  
- API routes: `/api/twitch-extension/catalog`, `/api/twitch-extension/action`, `/api/twitch-extension/me`  
- Authentication: Twitch Extension JWT (Bearer token from `onAuthorized`), verified server-side with Extension Secret  
- CORS enabled for extension origins  

**Capabilities — Allowlist for URL Fetching Domains:**  
`https://2you.pro`

**No additional allowlists required** for images or media (assets are bundled in the extension ZIP or served from the Testing Base URI).

**No test account credentials required** for Twitch login. The extension uses the viewer’s Twitch Extension JWT. Only users with role **broadcaster** or **moderator** on the channel can use the controls.

**Streamer requirement:** The channel owner must have a linked account on 2you.pro (same Twitch channel). The backend maps `channel_id` from the JWT to the streamer’s 2you.pro tools (Werbung, Poll, Death Counter, Wheel, etc.). If the channel is not linked, moderators see an error message.

**No chat interaction, no Bits, no Identity Link, no user-generated content.**

**Panel-only + Video Component** — no continuously live stream required for review if the reviewer can activate the extension on the review channel as broadcaster/moderator.

**Optional live review times (PT):** Mon–Fri 9:00–17:00 PT — channel can be offline; extension works without live stream.

---

## Changelog v1.0.0

- Initial public release of **2You Mod Control**
- **Panel view:** Mod/streamer tool buttons under the channel (Werbung, Poll, Subathon, Soundboard, etc.)
- **Video Component view:** Same mod controls accessible from the player taskbar icon (compact layout)
- Access restricted to **moderators and broadcaster** only; viewers see no controls (video component stays empty for viewers)
- Secure backend on `https://2you.pro` with JWT verification
- Configuration page (`config.html`) for streamer setup reference (Asset Hosting values)
- Complements existing 2you.pro mod control links and Stream Deck plugin (optional, not required)

---

## Steps for testing the extension

### A. Install & activate (broadcaster)

1. Open the Twitch Developer Console and ensure the extension version is in **Local Test** (or Hosted Test with assets uploaded).
2. On the **review channel**, open **Creator Dashboard → Settings → Extensions** (or Stream Manager → Extensions).
3. Find **2You Mod Control** and click **Install**, then **Activate**.
4. Enable both integration points if prompted: **Panel** and **Video Component**.
5. Open **Configure** — the config page shows setup notes only; no mandatory fields. Save/close.

### B. Test as broadcaster or moderator (Panel)

6. On the channel page, scroll to the **Panel** area below the player.
7. Open the **2You Mod Control** panel.
8. Confirm the header shows the channel name and status **“X Aktionen bereit”** (green).
9. Tool groups appear (e.g. Werbung, Poll, Death Counter) with action buttons.
10. Click a low-impact test action (e.g. Werbung **Ausblenden** or Poll **Close** if configured).
11. Confirm status shows **“OK · …”** and the corresponding overlay/tool on 2you.pro responds.

### C. Test Video Component

12. On the live channel page, locate the **extension icon in the player taskbar** (right side of the video player).
13. Click the icon to open the **Video Component**.
14. As broadcaster/mod: same tool buttons as the panel (compact grid).
15. Run one test action and confirm success status.

### D. Test viewer access (optional)

16. Open the channel in a **logged-out** or **non-mod viewer** account (or incognito without mod rights).
17. **Panel:** should show **“Nur für Moderatoren und den Streamer.”**
18. **Video Component:** should appear **empty** (no controls visible).

### E. Backend not linked (optional edge case)

19. If testing on a channel **without** a 2you.pro link, moderators may see **“Kanal ist nicht mit 2you.pro verknüpft.”** — expected behavior.

---

## Optional: Video walkthrough

*(Not required — add a YouTube/unlisted link here if you record one)*

---

## Additional information for the review team

- **Purpose:** Lets moderators and the streamer trigger pre-configured 2you.pro stream tools (overlays, polls, counters) without leaving Twitch.
- **Privacy:** No viewer data is stored by the extension; JWT is used only for role check and channel mapping per request.
- **Support / Privacy / EULA:** https://2you.pro/impressum.html (site operator: Joel2You Games / 2you.pro)
- **Contact:** support via 2you.pro portal (streamer account)
- Extension does **not** link out to signup pages, competing platforms, or ads.

---

## Store Listing (Deutsch)

### Zusammenfassung (max. 140 Zeichen — 137)

Steuere 2you.pro Stream-Tools (Werbung, Poll, Wheel & mehr) in Twitch — Panel + Video, nur Mods & Streamer.

### Beschreibung (max. 1024 Zeichen — 784)

2You Mod Control bringt deine 2you.pro Stream-Tools direkt in Twitch — ohne Tab wechseln, ohne extra Links.

Als Moderator oder Streamer steuerst du Werbung, Polls, Death Counter, Wheel, Soundboard, Subathon und weitere Tools über übersichtliche Buttons. Verfügbar als Panel unter dem Stream und als Video-Komponente am Player (Taskleisten-Icon).

Zuschauer sehen keine Steuerung. Die Extension prüft die Twitch-Rolle (Mod/Broadcaster) und löst Aktionen sicher über das 2you.pro-Backend aus.

Voraussetzung: Dein Kanal ist mit einem 2you.pro-Konto verknüpft (gleicher Twitch-Login). Mod-Control-Links und Stream Deck funktionieren weiterhin parallel.

Ideal für Streams mit aktivem Mod-Team, das Overlays und Interaktionen schnell auslösen soll — ohne OBS oder Dashboard zu verlassen.

---

# Deutsch — Kurzfassung für dich

**Walkthrough:** Reviewer installiert Extension auf Review-Kanal → Panel + Video-Komponente aktivieren → als Mod/Streamer Buttons testen → Zuschauer sehen nichts.

**Changelog 1.0.0:** Erstveröffentlichung mit Panel + Video-Komponente, Mod-Only, Anbindung an 2you.pro Backend.

**Wichtig für Review:** Kanal muss bei 2you.pro verknüpft sein, sonst Fehlermeldung beim Laden der Tools.
