🥩 Mettbrötchen Clicker

Ein süchtig machendes Idle-Clicker-Spiel im Browser - funktioniert auf jedem PC ohne Installation!

🎮 Spielen

Option 1: Direkt im Browser öffnen (Empfohlen)

1. Lade das Repository herunter oder klone es
2. Öffne die Datei mettklicker.html mit einem beliebigen Browser (Chrome, Firefox, Edge, Safari)
3. Fertig! Das Spiel läuft komplett lokal

Option 2: Mit lokalem Webserver

# Python 3
python3 -m http.server 8000

# Python 2
python -m SimpleHTTPServer 8000

# Node.js (falls npx installiert)
npx http-server

# Dann öffne: http://localhost:8000

Option 3: Direkt von GitLab Pages (falls verfügbar)

• URL: https://deko.gitlab.eggert-md.de/mettklicker/ (falls GitLab Pages aktiviert)

💾 Installation & Systemanforderungen

Systemanforderungen

• Betriebssystem: Windows, macOS, Linux – egal!
• Browser: Jeder moderne Browser (Chrome, Firefox, Edge, Safari, Opera)
• Speicherplatz: einige MB
• Keine Installation nötig! Läuft direkt aus dem Ordner

Download

# Mit Git
git clone https://gitlab.eggert-md.de/deko/mettklicker.git
cd mettklicker

# Oder als ZIP
# Lade von GitLab herunter und entpacke

🚀 Features

• Idle-Gameplay: Mett sammeln durch Klicken und automatische Produktion
• 25+ Upgrades: Von Omas Hilfe bis zur Mett-Omnipotenz
• Prestige-System: Mett-Seelen für permanente Boni
• Booster: Temporäre Power-Ups für mehr Mett
• Achievements: Über 20 Erfolge zum Freischalten
• Auto-Kauf: Automatisiere deine Upgrades
• Dark Mode & Themes: Mehrere Themen; augenschonend bei Nacht
• PWA & Offline: Läuft auch ohne Internet (Service Worker, Manifest)
• Import/Export: Spielstände als Code oder Datei sichern
• Multi-Tab sicher: Nur ein Tab speichert aktiv, Konflikte werden vermieden

🎯 Spielziel

Klicke auf das Mettbrötchen, sammle Mett, kaufe Upgrades und werde zum ultimativen Mett-Herrscher!

💡 Tipps für Anfänger

1. Klicke schnell: 10+ Klicks pro Sekunde geben einen geheimen Erfolg
2. Combo aufbauen: Schnelle Klicks erhöhen den Combo-Multiplikator
3. Meilensteine: Upgrades werden bei 10, 25, 50, 100 und 200 Stück stärker
4. Prestige: Ab 1 Million Mett kannst du prestigieren für permanente Boni
5. Speichern: Das Spiel speichert automatisch alle 30 Sekunden

🔧 Entwicklung

Struktur

mettklicker/
├── mettklicker.html            # Hauptspiel (modular)
├── mettklicker-original.html   # Legacy-Snapshot (nicht bearbeiten)
├── styles.css                  # Alle Styles (Dark-Mode & Themes)
├── manifest.webmanifest        # PWA Manifest
├── sw.js                       # Service Worker (offline)
├── img/                        # Bilder/Assets
├── mettbroetchen.png           # Favicon
├── js/                         # JavaScript-Module
│   ├── gameState.js            # Spielzustand
│   ├── main.js                 # Einstieg, Events, Loops
│   ├── upgrades.js             # Upgrade-System
│   ├── achievements.js         # Erfolge
│   ├── boosters.js             # Booster
│   ├── prestige.js             # Prestige-System
│   ├── save.js                 # Speichern/Laden + Migrationen
│   ├── ui.js                   # UI/DOM-Updates
│   ├── utils.js                # Hilfsfunktionen (reine Logik)
│   ├── dimensions.js           # Dimensionale Features
│   ├── config.js               # Konstanten/Schalter
│   ├── dom.js                  # Selektoren/Helfer
│   ├── logger.js               # Konsolen-Logging (optional)
│   └── lzstring.min.js         # Kompakte Speicherung
├── CLAUDE.md                   # Claude Notizen
├── GEMINI.md                   # Gemini Notizen
└── README.md                   # Diese Datei

Keine Build-Tools nötig!

• Reines HTML/CSS/JavaScript
• Keine Dependencies
• Keine Installation
• Läuft direkt im Browser

Entwicklungsrichtlinien

• Sprache: Vanilla JS, Browser APIs; keine externen Abhängigkeiten.
• Einrückung: 4 Leerzeichen; mit Semikolons; Strings mit einfachen Anführungszeichen.
• Modulstruktur beibehalten; neue Module klein und in js/ ablegen.
• Reine Logik möglichst pure halten; DOM/UI-Updates in ui.js bündeln.
• UI-Texte auf Deutsch halten; konsistente Benennungen verwenden.

Lokal starten

# Variante 1: Direkt öffnen
# Doppelklicke auf `mettklicker.html` im Dateimanager

# Variante 2: Einfacher Webserver
python3 -m http.server 8000
# Dann in den Browser: http://localhost:8000/mettklicker.html

Manuelles Testen (ohne Framework)

• Klicken: Klick zählt, Crits/Combos funktionieren, Partikel/Feedback sichtbar.
• Passives Einkommen: Tick erhöht Mett, Booster/Meilensteine beeinflussen Rate.
• Upgrades/Booster: Kauf, Kostensteigerung, 10/25/50/100/200‑Meilensteine.
• Prestige: Reset mit Erhalt von Boni; Werte korrekt migriert.
• Autosave: Speichert regelmäßig; Reload lädt den Stand korrekt.
• Import/Export: Code und Datei funktionieren; ungültige Eingaben abgefangen.
• Multi‑Tab: Nur Primär‑Tab speichert (Hinweise erscheinen), keine Conflicts.

Stand zurücksetzen (zum Testen):

1. DevTools öffnen → Konsole
2. localStorage.removeItem('mettClickerSave')
3. Seite neu laden

Commits & Changelog

• Commit‑Nachrichten: kurz, imperativ, deutsch. Beispiele:
  • „Fixe Auto‑Kauf Toggle“
  • „Verbessere Maximum‑Upgrade‑Anzeige“
  • „Version 2.0: Balance & Bugfixes“
• Sichtbare Änderungen in CHANGELOG.md ergänzen.
• Scope klein halten; MR mit kurzer Beschreibung und ggf. Screenshots.

Sicherheit & Offline

• Keine Netzwerkanfragen hinzufügen (reines Client‑Spiel, localStorage‑basiert).
• Service Worker erlaubt Offline‑Nutzung bei Hosting über HTTP(S).
• Spielstände kompatibel halten; Schema‑Änderungen in save.js migrieren.

🌍 Browser-Kompatibilität

Browser	Version	Status
Chrome	90+	✅ Vollständig unterstützt
Firefox	88+	✅ Vollständig unterstützt
Edge	90+	✅ Vollständig unterstützt
Safari	14+	✅ Vollständig unterstützt
Opera	76+	✅ Vollständig unterstützt
IE	Alle	❌ Nicht unterstützt

📱 Mobil-Support

Das Spiel funktioniert auch auf Smartphones und Tablets! Öffne einfach mettklicker.html im mobilen Browser.

🔄 Spielstand übertragen

Auf einen anderen PC:

1. Klicke auf "Speichern" → "Als Code exportieren"
2. Kopiere den Code
3. Öffne das Spiel auf dem anderen PC
4. Klicke auf "Laden" → "Code importieren"
5. Füge den Code ein

Als Datei:

1. "Speichern" → "Als Datei exportieren"
2. Übertrage die .json Datei
3. "Laden" → "Datei importieren"

🐛 Fehlerbehebung

Spiel lädt nicht?

• Stelle sicher, dass JavaScript aktiviert ist
• Verwende einen modernen Browser
• Öffne die Browser-Konsole (F12) für Fehlermeldungen

Spielstand verloren?

• Check localStorage: Öffne Konsole und tippe localStorage.getItem('mettClickerSave')
• Der Spielstand wird alle 30 Sekunden automatisch gespeichert

Performance-Probleme?

• Schließe andere Tabs
• Deaktiviere Browser-Erweiterungen
• Nutze Chrome oder Firefox für beste Performance

📄 Lizenz

Dieses Projekt ist für Bildungszwecke. Mett ist eine eingetragene Marke der deutschen Fleischindustrie (Scherz! 😄)

🤝 Beitragen

Fehler gefunden oder Ideen für neue Features? Erstelle gerne ein Issue oder einen Merge Request!

📞 Kontakt

• GitLab: https://gitlab.eggert-md.de/deko/mettklicker
• Issues: https://gitlab.eggert-md.de/deko/mettklicker/-/issues

---

Viel Spaß beim Mett sammeln! 🥩