![Logo](/images/logo.png)

[📄 CHANGELOG.md](CHANGELOG.md) · [📄 INSTALL.md](INSTALL.md) · [📄 ROADMAP.md](ROADMAP.md)

# Twitch PHP Bot 🇩🇰 / 🇬🇧

En letvægts **Twitch Chat Bot** skrevet i **PHP**, der kører direkte på en webserver som **XAMPP** eller **Apache**, uden Node.js eller eksterne services.  
Webinterface til styring af kommandoer, timers, polls, giveaways, loyalty points og brugere.

---

## ✨ Features

- Twitch IRC chat-bot (PHP socket)
- Dashboard med login og rettigheder
- Kommandoer med placeholders (`@$user`, `@$target`, `{uptime}`, `!points`, …)
- Live log (SSE + WebSocket fallback)
- Timers, Polls, Giveaways
- Loyalty points + Bets, Slots, Raffle
- Helix API-integration (subs, mods, VIPs, cheerers, uptime, osv.)
- Rettighedsstyring (Admin / Mod / User)
- SQLite database – ingen ekstern DB
- Dansk/Engelsk dokumentation

---

## ⚙️ Krav / Requirements

- PHP **8.1+**
- Extensions: `pdo_sqlite`, `curl`, `mbstring`, `json`
- Webserver (XAMPP, Apache, Nginx …)
- Twitch OAuth-token: [https://twitchapps.com/tmi/](https://twitchapps.com/tmi/)
- (Valgfrit) Node.js + `ws` for WebSocket-live-log

---

## 🚀 Installation

Se [INSTALL.md](INSTALL.md) for komplette trin.

---

## 🔐 Login

Efter første installation:
- Brugernavn: `admin`
- Adgangskode: `lan2025`  
(kan ændres under **Indstillinger**)

---

## 📁 Struktur

/bot
├── /data
│ ├── app.db
│ ├── bot.log
│ └── settings.json
├── /web
│ ├── index.php # Dashboard
│ ├── settings.php # Indstillinger + brugere
│ ├── commands.php # Kommandoer
│ ├── timers.php # Timers
│ ├── poll.php # Polls
│ ├── points.php # Loyalty Points
│ ├── db.php, guard.php, api.php …
├── bot.php # PHP-socket bot
├── ws_server.js # WebSocket server
├── .env # Twitch credentials

yaml
Kopier kode

---

## 📄 Filer

- [CHANGELOG.md](CHANGELOG.md) – versionshistorik  
- [ROADMAP.md](ROADMAP.md) – planlagte funktioner  
- [LICENSE](LICENSE) – MIT-licens

---

## 🧡 Credits

Udviklet af **Thomas / DjGulvBasS**  
Med hjælp fra **ChatGPT (OpenAI)**  
MIT Licenseol that runs directly on your Windows server alongside Mix It Up Bot.
