{"id":50965656,"url":"https://github.com/spotlightforbugs/webwoelfe","last_synced_at":"2026-06-18T20:01:47.967Z","repository":{"id":57751706,"uuid":"518828843","full_name":"SpotlightForBugs/webwoelfe","owner":"SpotlightForBugs","description":"Werwolf mit Freunden kostenlos online Spielen (Pre-Alpha!)","archived":false,"fork":false,"pushed_at":"2026-04-22T12:35:11.000Z","size":26338,"stargazers_count":4,"open_issues_count":55,"forks_count":3,"subscribers_count":0,"default_branch":"Pro","last_synced_at":"2026-04-22T14:27:42.773Z","etag":null,"topics":["browser-game","css","flask","free","gplv3","html","html5","javascript","python","werewolf","werewolf-game","werewolf-online","werewolves-of-millers-hollow","werwolf","werwolf-game","werwolf-online"],"latest_commit_sha":null,"homepage":"https://webwölfe.de","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SpotlightForBugs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-07-28T12:02:21.000Z","updated_at":"2026-04-22T12:34:02.000Z","dependencies_parsed_at":"2024-07-10T10:47:44.567Z","dependency_job_id":"75e16396-dbf4-49af-af62-40314a578c84","html_url":"https://github.com/SpotlightForBugs/webwoelfe","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/SpotlightForBugs/webwoelfe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpotlightForBugs%2Fwebwoelfe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpotlightForBugs%2Fwebwoelfe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpotlightForBugs%2Fwebwoelfe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpotlightForBugs%2Fwebwoelfe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SpotlightForBugs","download_url":"https://codeload.github.com/SpotlightForBugs/webwoelfe/tar.gz/refs/heads/Pro","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpotlightForBugs%2Fwebwoelfe/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34505423,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-18T02:00:06.871Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser-game","css","flask","free","gplv3","html","html5","javascript","python","werewolf","werewolf-game","werewolf-online","werewolves-of-millers-hollow","werwolf","werwolf-game","werwolf-online"],"created_at":"2026-06-18T20:01:42.431Z","updated_at":"2026-06-18T20:01:47.961Z","avatar_url":"https://github.com/SpotlightForBugs.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Webwölfe\n\n**Das klassische Werwolf-Partyspiel - jetzt digital!**\n\n[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://python.org)\n[![Flask](https://img.shields.io/badge/Flask-3.0+-green.svg)](https://flask.palletsprojects.com/)\n[![License](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](LICENSE)\n\nWebwölfe ist eine moderne, webbasierte Implementation des beliebten Gesellschaftsspiels \"Werwolf\" (auch bekannt als \"Mafia\" oder \"Werwölfe von Düsterwald\"). Spiele mit deinen Freunden - egal ob im selben Raum oder über das Internet verteilt!\n\n## Features\n\n- **Zwei Spielmodi**:\n  - Online (jeder auf eigenem Gerät mit 3D-Dorf, automatischer Erzähler)\n  - Gruppen-Modus (alle zusammen vor Ort, mit Erzähler-Unterstützung)\n- **Sitzordnung per Drag \u0026 Drop**: Spieler können ihre physische Sitzordnung im Kreis festlegen - wichtig für Nachbar-Mechaniken!\n- **3D-Dorfvisualisierung**: Interaktives 3D-Dorf zeigt alle Spieler im Kreis\n- **Echtzeit-Updates**: WebSocket-basierte Kommunikation für nahtloses Gameplay\n- **45+ Rollen**: Von Grundrollen bis Community-Kreationen ([Quelle](https://werwolf.fandom.com/de/wiki/Werwolf-Rollen-Sammlung))\n- **Anti-Cheat**: Schutz gegen DevTools/F12-Spicken\n- **Responsive Design**: Funktioniert auf Desktop und Mobilgeräten\n- **Atmosphärisches Design**: Dunkles Theme mit stimmungsvoller Gestaltung\n- **Erzähler-Texte**: Vorgefertigte Texte für den Gruppen-Modus\n\n## Verfügbare Rollen\n\n### Grundrollen\n\n- **Werwolf** - Töte jede Nacht einen Dorfbewohner\n- **Dorfbewohner** - Finde und eliminiere die Werwölfe\n- **Seherin** - Erfahre die wahre Identität eines Spielers\n- **Hexe** - Heiltrank \u0026 Gifttrank (je einmal nutzbar)\n- **Jäger** - Nimm jemanden mit in den Tod\n- **Heiler** - Schütze einen Spieler pro Nacht\n- **Amor** - Verliebe zwei Spieler\n\n### Erweiterte Rollen\n\n- **Weißer Wolf** - Gewinnt alleine, kann Mitwölfe töten\n- **Urwolf** - Kann Dorfbewohner infizieren\n- **Alter Mann** - Überlebt ersten Wolfsangriff\n- **Zwei Schwestern** - Kennen sich gegenseitig\n- **Vampir** - Verwandle Spieler in Vampire\n- **Flötenspieler** - Verzaubere alle zum Sieg\n- ... und viele mehr!\n\n## Installation\n\n### Voraussetzungen\n\n- Python 3.10 oder höher\n- pip\n\n### Schritte\n\n```bash\n# Repository klonen\ngit clone https://github.com/SpotlightForBugs/webwoelfe.git\ncd webwoelfe\n\n# Virtuelle Umgebung erstellen (empfohlen)\npython3 -m venv venv\nsource venv/bin/activate  # Linux/Mac\n# oder: venv\\Scripts\\activate  # Windows\n\n# Abhängigkeiten installieren\npip install -r requirements.txt\n\n# Anwendung starten\npython app.py\n```\n\n### Optionale Erzähler-Stimme über ElevenLabs\n\nWenn du die natürlich klingende ElevenLabs-Stimme nutzen möchtest, setze folgende Umgebungsvariablen:\n\n- `ENABLE_ELEVENLABS=true`\n- `ELEVENLABS_API_KEY=\u003cdein API Key\u003e`\n- `ELEVENLABS_VOICE_ID=g1jpii0iyvtRs8fqXsd1` (Standardstimme aus dem Beispiel)\n\nAlle erzeugten Audios werden im lokalen Cache (`static/audio/cache`) abgelegt, damit Ansagen nicht erneut generiert werden müssen.\n\nDie Anwendung läuft dann unter `http://localhost:5001`\n\n## Spielablauf\n\n1. **Raum erstellen**: Ein Spieler erstellt einen Raum und erhält einen 6-stelligen Code\n2. **Beitreten**: Andere Spieler treten mit dem Code bei\n3. **Spiel starten**: Bei mindestens 5 Spielern kann das Spiel gestartet werden\n4. **Rollen erhalten**: Jeder Spieler bekommt eine geheime Rolle zugeteilt\n5. **Tag \u0026 Nacht**: Das Spiel wechselt zwischen Tag- und Nachtphasen\n6. **Gewinnen**: Dorf gewinnt wenn alle Wölfe tot sind, Wölfe gewinnen bei Mehrheit\n\n## Spielmodi\n\n### Online-Modus\n\n- Jeder Spieler auf eigenem Gerät\n- **Kein Erzähler nötig** - das Spiel erzählt automatisch\n- Automatische Nachrichten und Anweisungen\n- Perfekt für Remote-Spielrunden\n\n### Gruppen-Modus\n\n- Alle zusammen vor Ort\n- Mit menschlichem Erzähler\n- **Erzähler erhält vorgefertigte Texte** zum Vorlesen\n- Klassisches Spielerlebnis\n- Perfekt für Partys und Spieleabende\n\n## Technologie-Stack\n\n- **Backend**: Python/Flask mit Flask-SocketIO\n- **Datenbank**: SQLite mit SQLAlchemy ORM\n- **Frontend**: Vanilla JS, CSS3, HTML5\n- **Echtzeit**: WebSockets via Socket.IO\n- **Icons**: FontAwesome 6\n- **Fonts**: Cinzel \u0026 Crimson Pro (Google Fonts)\n\n## Projektstruktur\n\n```\nwebwoelfe/\n|-- app.py              # Flask-Anwendung \u0026 WebSocket-Events\n|-- models.py           # SQLAlchemy-Modelle \u0026 Rollen-Definitionen\n|-- game_logic.py       # Spiellogik (Phasen, Abstimmungen, etc.)\n|-- requirements.txt    # Python-Abhängigkeiten\n|-- templates/          # Jinja2-Templates\n|   |-- struktur.html   # Basis-Template mit Anti-Cheat\n|   |-- index.html      # Startseite\n|   |-- lobby.html      # Warteraum\n|   |-- spiel.html      # Hauptspiel-Interface\n|   +-- rollen.html     # Rollenübersicht\n|-- static/\n|   +-- images/         # Favicon \u0026 Grafiken\n+-- instance/\n    +-- webwoelfe.db    # SQLite-Datenbank\n```\n\n## Sicherheit\n\nWebwölfe enthält Schutzmaßnahmen gegen Spicken:\n\n- DevTools-Erkennung (F12, Ctrl+Shift+I, etc.)\n- Rechtsklick deaktiviert\n- Console-Logging deaktiviert\n- Sensible Spielerinformationen werden serverseitig validiert\n\n## Beitragen\n\nBeiträge sind willkommen! Bitte lies [CONTRIBUTING.md](CONTRIBUTING.md) für Details.\n\n## Lizenz\n\nDieses Projekt steht unter der GNU General Public License v3.0 - siehe [LICENSE](LICENSE) für Details.\n\n## Autoren\n\n- [@SpotlightForBugs](https://www.github.com/SpotlightForBugs)\n- [@Heizkoerper](https://www.github.com/Heizkoerper)\n- [@BlackTesseract](https://www.github.com/BlackTesseract)\n- @Zora\n\n---\n\n_Inspiriert von \"Werwölfe von Düsterwald\" und der [Werwolf Wiki Rollen-Sammlung](https://werwolf.fandom.com/de/wiki/Werwolf-Rollen-Sammlung)_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspotlightforbugs%2Fwebwoelfe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspotlightforbugs%2Fwebwoelfe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspotlightforbugs%2Fwebwoelfe/lists"}