LoL Comp Generator

Der LoL Comp Generator erstellt auf Knopfdruck zufällige Team-Kompositionen für League of Legends aus einer verwaltbaren Champion-Datenbank – inklusive Speichern, Teilen und einem zusätzlichen Challenge-Würfel-Modus.

Allgemein

Champions, Sets & Presets

Die Champion-Liste wird im Admin-Dashboard gepflegt. Champions werden zu Sets gruppiert (benannte Champion-Pools je Rolle), mehrere Sets wiederum zu Presets zusammengefasst – ein Preset bestimmt also, aus welchen Sets pro Rolle beim Generieren gezogen wird.

Generieren, Speichern, Teilen

Jede generierte Komposition erhält einen eindeutigen Hash und lässt sich als Link teilen – der Aufruf mit ?lol_session=HASH öffnet direkt die Detailansicht dieser Session, inklusive optionalem Ergebnis, Screenshot, Tags und Notizen.

Challenges

Über einen Umschalter im Generator lässt sich zusätzlich ein Challenge-Modus aktivieren: Aus konfigurierten Kategorien wird per Würfel-Button eine zufällige Challenge gezogen (Name, Beschreibung, optional beteiligte Champions). Ergebnisse lassen sich inklusive Screenshot direkt per Discord-Webhook posten.

Statistiken & Verlauf

Eine chronologische Verlaufsliste sowie Statistiken (Win-Rates, Top-Champions, Leaderboard, Hall of Shame) runden das Modul ab.

Shortcodes

Shortcode	Beschreibung
weinhold_lol_comp_generator	Der Hauptgenerator (3-Schritt-Flow) mit integriertem Challenge-Modus. Mit ?lol_session=HASH direkt zur Session-Detailansicht
weinhold_lol_comp_history	Chronologische Liste aller gespeicherten Sessions mit Tag-Filter
weinhold_lol_comp_stats	Statistiken: Win-Rates, Top-Champions, Leaderboard, Hall of Shame

Dateien

Datei	Inhalt
modules/lol_comp_generator.php	Lade-Stub: Init, Audit-Log- und Discord-Integration, alle AJAX-Registrierungen, Admin- und Cleanup-Einstiegspunkte
modules/lol_comp_generator/db.php	Datenbank-Installation (10 Tabellen) und alle Lese-/Schreibfunktionen
modules/lol_comp_generator/admin.php	Admin-Oberfläche: Champions, Sets, Presets, Sessions verwalten
modules/lol_comp_generator/frontend.php	Frontend-Shortcodes: Generator, Challenges, Verlauf, Statistiken

Für Entwickler

Datenbank (Auswahl)

Tabelle	Inhalt
weinhold_lol_champions	Champion-Stammdaten
weinhold_lol_sets,weinhold_lol_set_champions	Sets und ihre Champion-Zuordnung
weinhold_lol_presets,weinhold_lol_preset_sets	Presets und ihre Set-Zuordnung
weinhold_lol_sessions	Generierte/gespeicherte Kompositionen (hash, preset_id, mode, result, screenshot_path, tags, notes)
weinhold_lol_session_players	Pro Session: Spieler, Rolle, verwendetes Set, gezogener Champion
weinhold_lol_challenge_categories,weinhold_lol_challenges,weinhold_lol_challenge_champions	Challenge-Oberkategorien, einzelne Challenges und ihre Champion-Zuordnung

Berechtigungen

weinhold_lol_comp_generator_current_user_can_view()/_can_edit() setzen zusätzlich zur Modul-Berechtigung immer einen eingeloggten Nutzer voraus – anders als bei rein view-basierten Modulen ist hier auch das reine Ansehen nicht für Gäste vorgesehen.

Discord-Integration

Zwei getrennte Discord-Integrationen über den Filter weinhold_discord_module_integrations: lol_comp_generator (neue gespeicherte Session) und lol_comp_generator_challenge (manuell per Button gepostetes Challenge-Ergebnis). Der Challenge-Discord-Versand läuft dabei NICHT über die zentrale weinhold_discord_fire_module_event()-Funktion wie bei anderen Modulen, sondern baut den Webhook-Request inkl. optionalem Bild-Multipart-Upload (Screenshot als Anhang) direkt selbst zusammen.

AJAX-Endpunkte

Über 20 registrierte wp_ajax_*-Actions, grob in vier Gruppen: Admin-Verwaltung (Champions/Sets/Presets speichern, löschen, synchronisieren), Frontend-Generator (Daten laden, Session speichern, Ergebnis setzen, Screenshot hochladen/ausliefern, Tags/Notizen, Replay), Challenge-Verwaltung (Kategorien und Challenges speichern/löschen, Discord-Versand) sowie ein öffentlicher (nopriv) Endpunkt für Statistiken.

Besonderheiten

Statistik-Endpunkt (get_stats) und Screenshot-Auslieferung (serve_screenshot) sind bewusst auch für nicht eingeloggte Besucher freigegeben (wp_ajax_nopriv_*), obwohl der Rest des Moduls Login voraussetzt – Statistiken und geteilte Screenshots sollen auch ohne Konto einsehbar sein.

Sessions werden über einen eindeutigen hash (nicht die numerische ID) referenziert – verhindert das Erraten fortlaufender Session-IDs beim Teilen von Links.

Der Challenge-Discord-Versand baut den Multipart-Request für Bild-Uploads manuell zusammen (eigener Boundary-String), da WordPress‘ wp_remote_post() keine native Unterstützung für multipart/form-data mit Dateianhang bietet.

Versionshistorie

Version	Datum	Änderung
1.0.0	22.09.2026	Einführung der Versionierung.

LoL Comp Generator

The LoL Comp Generator creates random League of Legends team compositions at the click of a button from a manageable champion database — including saving, sharing, and an additional Challenges dice-roll mode.

General

Champions, Sets & Presets

The champion list is maintained in the admin dashboard. Champions are grouped into sets (named champion pools per role), and multiple sets are in turn combined into presets — a preset determines which sets are drawn from per role when generating.

Generate, Save, Share

Every generated composition gets a unique hash and can be shared as a link — visiting with ?lol_session=HASH opens that session’s detail view directly, including an optional result, screenshot, tags and notes.

Challenges

A toggle in the generator additionally enables a Challenges mode: a roll button draws a random challenge from configured categories (name, description, optionally involved champions). Results, including a screenshot, can be posted directly via Discord webhook.

Statistics & History

A chronological history list plus statistics (win rates, top champions, leaderboard, hall of shame) round out the module.

Shortcodes

Shortcode	Description
weinhold_lol_comp_generator	The main generator (3-step flow) with built-in Challenges mode. With ?lol_session=HASH, jumps straight to that session’s detail view
weinhold_lol_comp_history	Chronological list of all saved sessions with tag filtering
weinhold_lol_comp_stats	Statistics: win rates, top champions, leaderboard, hall of shame

Files

File	Content
modules/lol_comp_generator.php	Load stub: init, audit log and Discord integration, all AJAX registrations, admin and cleanup entry points
modules/lol_comp_generator/db.php	Database installation (10 tables) and all read/write functions
modules/lol_comp_generator/admin.php	Admin UI: manage champions, sets, presets, sessions
modules/lol_comp_generator/frontend.php	Frontend shortcodes: generator, challenges, history, statistics

For Developers

Database (Selection)

Table	Content
weinhold_lol_champions	Champion master data
weinhold_lol_sets,weinhold_lol_set_champions	Sets and their champion assignment
weinhold_lol_presets,weinhold_lol_preset_sets	Presets and their set assignment
weinhold_lol_sessions	Generated/saved compositions (hash, preset_id, mode, result, screenshot_path, tags, notes)
weinhold_lol_session_players	Per session: player, role, set used, champion drawn
weinhold_lol_challenge_categories,weinhold_lol_challenges,weinhold_lol_challenge_champions	Challenge top-level categories, individual challenges and their champion assignment

Permissions

weinhold_lol_comp_generator_current_user_can_view()/_can_edit() always require a logged-in user in addition to the module permission — unlike purely view-based modules, plain viewing isn’t intended for guests here either.

Discord Integration

Two separate Discord integrations via the weinhold_discord_module_integrations filter: lol_comp_generator (new saved session) and lol_comp_generator_challenge (challenge result posted manually via button). The challenge Discord send does NOT go through the central weinhold_discord_fire_module_event() function used by other modules — it builds the webhook request, including an optional multipart image upload (screenshot as attachment), itself.

AJAX Endpoints

Over 20 registered wp_ajax_* actions, roughly in four groups: admin management (save/delete/sync champions, sets, presets), frontend generator (load data, save session, set result, upload/serve screenshot, tags/notes, replay), challenge management (save/delete categories and challenges, Discord send), and one public (nopriv) endpoint for statistics.

Special Cases

The statistics endpoint (get_stats) and screenshot serving (serve_screenshot) are deliberately open to logged-out visitors too (wp_ajax_nopriv_*), even though the rest of the module requires login — statistics and shared screenshots should be viewable without an account.

Sessions are referenced by a unique hash (not the numeric ID) — prevents guessing sequential session IDs when sharing links.

The challenge Discord send builds the multipart request for image uploads manually (its own boundary string), since WordPress‘ wp_remote_post() has no native support for multipart/form-data with a file attachment.

Version History

Version	Date	Change
1.0.0	22.09.2026	Introduction of versioning.

lol-comp-generator

LoL Comp Generator

Champions, Sets & Presets

Generieren, Speichern, Teilen

Challenges

Statistiken & Verlauf

Datenbank (Auswahl)

Berechtigungen

Discord-Integration

AJAX-Endpunkte

LoL Comp Generator

Champions, Sets & Presets

Generate, Save, Share

Challenges

Statistics & History

Database (Selection)

Permissions

Discord Integration

AJAX Endpoints

Weitere Beiträge

jeopardy-auth

ppnp-game-auth

mcp-server-manager

rudelroots