Falkenmoor – Technische Spieldokumentation

Version 1.2.20 · Stand: 11. September 2026 · Python 3.12, Flask, WebSocket

Überblick & Architektur

Falkenmoor ist ein Multi-User-Dungeon (MUD): ein textbasiertes Online-Rollenspiel, das per WebSocket im Browser gespielt wird. Der Server ist in Python geschrieben und besteht aus vier Bausteinen:

Die Welt wird beim Start einmal geladen und von allen Spielern geteilt („shared world"): Türen, Bodenitems und Monster-Zustände sind für alle gleich. Persönliche Daten (Inventar, Quests, Position) leben im Spielerobjekt und werden nach jedem Befehl in players.db gesichert.

Sprache der Befehle

Befehle sind deutsche Verben im Imperativ, groß- und kleinschreibungsunabhängig, mit Umlaut-Toleranz (knueppel findet „Holzknüppel“). Richtungen akzeptieren Abkürzungen.

Spielmechaniken im Detail

Kampf

Rundenbasiert je Befehlseingabe: Der Spielerenschaden ist Basis(3) + Waffe + (Level−1) ± Zufall(−1..+3) − Verteidigung des Gegners, der Gegenschlag analog mit der Rüstung des Spielers. Stirbt der Spieler, wacht er mit 10 HP auf dem Marktplatz auf und verliert die Hälfte seines Bargelds — Gold auf der Bank (Stadtkasse im Rathaus) bleibt immer sicher. Besiegte Monster hinterlassen ihre beute im Raum und erscheinen nach 5 Minuten neu (Respawn-Konstante RESPAWN_SEKUNDEN = 300).

Charakterentwicklung

Jede Stufe benötigt Level × 100 XP und bringt +10 Max-HP (und vollständige Heilung). XP gibt es für Kills (10 + halbe Gegner-HP) und Quests. Der Beutel fasst 20 Gegenstände + 2 pro Stufe (Spiele-NPC zeigt INVENTAR); die Truhe im Haus bietet zusätzliche 100 Fächer.

Haus & Truhe

Am Marktplatz liegt der Ausgang haus zum Haus am Markt: Dort steht die Eichentruhe jedes Helden mit 100 Fächern — TRUHE zeigt den Inhalt, LEGE <x> lagert ein, HOL <x> nimmt zurück. Der Truheninhalt ist Teil des Spielstands und bleibt Tod, Logout und Server-Neustarts erhalten. Ausgerüstete Gegenstände müssen vor dem Einlagern abgelegt werden.

Rassen

Jeder Held wählt einmalig eine Rasse: RASSE <name> (wählbar: zwerg/dwarf, elf, ork/orc, mensch/human). Die Boni/Nachteile wirken sofort und stapeln sich mit der Gildenwahl:

RASSE ohne Argument zeigt die Wahl, danach die Herkunfts-Lore. Die Entscheidung ist endgültig — Charaktere bleiben, was sie sind.

Quests

Eine Quest ist ein JSON-Objekt am NPC: gesprochen wird sie angenommen (sprich), mit gib wird der geforderte Gegenstand abgegeben (mehrfach bei anzahl > 1). Belohnungen: Items, Gold, XP.

Welt: Räume, Türen, Händler

Räume sind ein Dictionary mit Ausgängen. Ausgänge sind entweder einfache IDs oder verschlossene Türen mit Schlüsselanforderung:

"exits": {
  "norden": "wald_2",
  "sueden": {"raum": "gruft", "verschlossen": true,
             "tuer": "die Steinpforte", "schluessel": "i_schluessel_gruft"}
}

Händler sind NPCs mit laden-Objekt; Preise pro Item, Verkauf zum halben Item-wert. Kneipen (Goldener Falke, Anker-Krug) tragen zusätzlich das Flag "nacht": true und sind damit rund um die Uhr geöffnet: Getränke kosten 1 Gold (Bier +5 HP, Kaffee +5 Mana, Soda +3 HP, Wein +4 HP, Kräutertee +4 Mana), Essen 2 Gold (Suppe +6 HP, Eintopf +8 HP, Braten +10 HP). Sich treffen und sag-en ist selbstverständlich gratis.

Codebeispiele

Befehl registrieren (engine.py)

tabelle = {
    ...
    "post": (self.cmd_post, True),   # (Methode, braucht Argument?)
}

eintrag = tabelle.get(befehl)
if not eintrag:
    return f"Was meinst du mit '{eingabe}'?"
fn, braucht_arg = eintrag
ergebnis = fn(arg) if braucht_arg else fn()
self.save()                     # Spielstand sichern
return ergebnis

Neuen Raum in world.json anlegen

"lichtung_99": {
  "id": "lichtung_99",
  "name": "Verwunschene Lichtung",
  "beschreibung": "Pilze leuchten bläulich zwischen den Bäumen.",
  "region": "wald",
  "exits": {"sueden": "wald_5"},
  "items": ["i_heiltrank"],
  "npcs": []
}

Das WebSocket-Protokoll

Client und Server reden reinen Text: Die erste Nachricht ist die Anmeldung, danach entspricht jede Zeile einem Befehl, jede Antwort einer Zeile.

// Anmeldung
> LOGIN hugo geheimnis        // oder: REGISTER hugo geheimnis
< Willkommen zurück in Falkenmoor …

// Spielschleife
> nimm knueppel
< Du nimmst Holzknüppel.
> greif wolf an
< ⚔ Du triffst Hungriger Wolf für 5 Schaden. …

Statistik-API

GET /api/stats  →  {"online": 2, "registriert": 7}

Datenschutz & Konten

Passwörter werden ausschließlich als bcrypt-Hash gespeichert, Spielstände in SQLite. Keine Cookies, kein Tracking, keine E-Mail-Pflicht – Details in der Datenschutzerklärung.

Tag und Nacht

Ein Spieltag dauert 2 echte Stunden (5 Minuten je Spielstunde). Die Uhrzeit steht in jeder Raumansicht. Nachts (21–6 Uhr) sind die Läden geschlossen – ausgenommen sind die Kräuterhexe in Falkenmoor und alle Kneipen, die rund um die Uhr ausschenken.

Emotes & Anschlagbrett

Emotes sind Rollenspiel-Gesten für den Raum: LACH, WEINE, TANZ, SEUFZ, JAUCHZ … gezielt mit Ziel: VERBEUGE hugo, ZWINKERE maren, GRUESS (alle). Das Anschlagbrett am Marktplatz ist ein öffentliches Schwarzes Brett:

BRETT                    # letzte 15 Notizen lesen
BRETT Suche Gruppe für die Katakomben!
BRETT LOESCHE 3          # eigene Notiz entfernen (Gott darf alle)

Magie & Gilden

Zauber kosten Mana (Start: 20, +5 pro Stufe, Regeneration: +1 je Raumwechsel). Fünf Zauber, freigeschaltet nach Stufe:

Drei Gilden (Anmeldung bei der Gildenmeisterin im Rathaus): Krieger (+3 Schaden, +10 HP), Magier (+10 Mana, alle Zauber −1 Mana), Dieb (Gold aus jeder Beute). Wechsel kostet 100 Gold. Gilden-Chat: GILDENRUF <text>.

ZAUBER                    # verfügbare Zauber + Mana anzeigen
ZAUBER feuerball ork      # Zauber im Kampf (ohne Ziel: erstbester Gegner)
GILDE BEITRETEN magier    # im Rathaus, bei der Gildenmeisterin

Geheimnisse

Es gibt verborgene Befehle, die nicht in der Hilfe stehen. Wer gut hinschaut (oder Klugen Rat sucht), mag sie finden …

Änderungshistorie

← Zurück zum Spiel

Dieses Projekt wächst – die Dokumentation wird mit jeder Versionsänderung aktualisiert.