Muehle-API

Deutsche Mühle-API für Python

Version: 20-Feb-2026 20:00

📋 Inhaltsverzeichnis

• Verfügbare Funktionen
• Anleitung
• Wichtige Hinweise
• Variableninfo
• Technische Details

Verfügbare Funktionen

• visual_farbe
  Visualisiert die Farbnummer als Farbnamen
• visual_farbenkürzel
  Visualisiert die Farbnummer als Farbkürzel
• visual_figur
  Visualisiert die Figurnummer als Figurennamen
• visual_figurkürzel
  Visualisiert die Figurnummer als Figurenkürzel
• neues_spiel
  Herstellen der Variablen für ein neues Spiel
• fstatus_func
  Herstellen der Statusvariable - Sortierung: Feld > Farbe
• farbe_auf_feld
  Ausgabe der Farbe auf dem übermittelten Feld
• figurfelder_final
  Berechnet alle möglichen Zielfelder der Figur auf dem entsprechenden Startfeld unter Berücksichtigung von Brettbegrenzung und Figurenblockaden
• armeefiguren_final
  Gibt final für die übergebene Farbe die Liste der bewegungsfähigen Figuren anhand deren Felder aus. Alle Funktionen wurden darin berücksichtigt.
• freie_steine Gibt eine Liste von Steinen aus, die entfernbar sind, von der angegebenen Farbe.
• stein_setzen Setzt einen Stein für die angegebene Farbe auf das angegebene Feld neu aufs Brett und prüft zusätzlich, ob eine Mühle geschlossen wurde und ob der Gegner zugfähig ist.
• stein_nehmen Entfernt den Stein auf dem angegebenen Feld und gibt zusätzlich aus, ob die Farbe schon verloren hätte.
• zug_final
  Führt den angegebenen Zug aus und aktualisiert kstatus und gibt zusätzlich die Mühle und Sieg als bool aus.

Anleitung

1. Spielstart:
   Zum Spielstart muss 1 Variable lokal angelegt werden mit der Funktion neues_spiel():

   kstatus = mühle_api.neues_spiel()

2. Spielfeldvisualisierung:
   kstatus ist ein Dictionary für jede Farbe, deren besetzte Felder anzeigt, aufgebaut ist, man kann davon immer mit der Funktion fstatus_func ein Dictionary herleiten, bei dem das Spielfeld die Referenz ist.

3. Setzphase: Mit der Funktion stein_setzen setzt du einen Stein für die angegebene Farbe auf das angegebene Feld neu aufs Brett und prüft zusätzlich, ob eine Mühle geschlossen wurde und ob der Gegner zugfähig ist (sollte das der letzte gesetzte Stein sein).

4. Zugphase: Mit der Funktion armeefiguren_final erhältst du eine Liste der Figuren anhand ihrer Felder, die ziehen können und dürfen. Mit der Funktion figurfelder_final erhältst du eine Liste, welche Felder die ausgewählte Figur besetzen kann und darf. Mit der Funktion zug_final setzt du den kstatus neu anhand der angegebenen Figurbewegung

5. Sonderfälle: zug_final gibt zusätzlich Informationen aus: 4.1. Mühle: Wenn eine Mühle geschlossen wurde. Mit der Funktion freie_steine erhältst du eine Liste von Steinen aus, die entfernbar sind, von der angegebenen Farbe. Mit der Funktion stein_nehmen entfernst du den Stein auf dem angegebenen Feld und gibt zusätzlich aus, ob die Farbe schon verloren hätte. 4.2. Gewonnen: Wenn der Gegner nicht mehr ziehen kann.

⚠️ Wichtige Hinweise

• Die Funktion zug_final() prüft nicht alle Validitätsregeln für Züge. Ein korrektes Spiel ist nur gewährleistet, wenn die richtigen Werte (gültige Start- und Zielfelder) ordentlich weitergereicht werden. 💎

Variableninfo

• kstatus
  Allgemeine Statusvariable - beinhaltet so die Startsituation - Sortierung: Farbe >> Liste der Felder. Beispielhafte Struktur: {farbe: [liste_felder]}

Technische Details

Spielfeld

    1315 | ---- | ---- | 1000 | ---- | ---- | 1045
    ---- | 2315 | ---- | 2000 | ---- | 2045 | ----
    ---- | ---- | 3315 | 3000 | 3045 | ---- | ----
    1270 | 2270 | 3270 | ---- | 3090 | 2090 | 1090
    ---- | ---- | 3225 | 3180 | 3135 | ---- | ----
    ---- | 2225 | ---- | 2180 | ---- | 2135 | ----
    1225 | ---- | ---- | 1180 | ---- | ---- | 1135

(Anzeigefehler beim Hovertext kann auftreten)

Farbe

• 10 = w / Weiß ⚪
• -10 = s / Schwarz ⚫
• 0 = leer