KaroMUSKEL: Unterschied zwischen den Versionen

Aus KaroWiki
Zur Navigation springen Zur Suche springen
(V2.7 hinzugefügt)
 
(64 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 5: Zeile 5:
 
== Hintergrundinformationen ==
 
== Hintergrundinformationen ==
  
'''KaroMUSKEL''' wird seit Anfang 2008 von {{Benutzer|ultimate}} entwickelt. Anfangs habe ich das Skript nur für den Eigenbedarf geschrieben, später habe ich es auf Anfrage aber auch an andere Spieler weitergegeben. Nach der Fertigstellung der Version 1.0 Mitte 2008 hat sich lange nichts beim Skript getan. Es wurden einzig zwischendurch mal ein paar Anpassungen auf Neuerungen von karopapier.de eingebaut, damit das Skript weiter Funktionsfähig bleibt. Im März 2010 habe ich mich dann mal ran gesetzt das ganze rund zu erneuern. Das Ergebnis wird es hier bald zu sehen geben...
+
'''KaroMUSKEL''' wird seit Anfang 2008 von {{Benutzer|ultimate}} entwickelt. Anfangs habe ich das Skript nur für den Eigenbedarf geschrieben, später habe ich es auf Anfrage aber auch an andere Spieler weitergegeben. Nach der Fertigstellung der Version 1.0 Mitte 2008 hat sich lange nichts beim Skript getan. Es wurden einzig zwischendurch mal ein paar Anpassungen auf Neuerungen von karopapier.de eingebaut, damit das Skript weiter Funktionsfähig bleibt. Im März 2010 habe ich mich dann mal ran gesetzt das ganze rund zu erneuern. Danach gab es dann mehr oder weniger Regelmäßig Anpassungen, Erweiterungen und Bug-Fixes.
  
== Benutzung ==
+
Auch wenn alte Versionen größtenteils nicht mehr funktionsfähig sind, hier mal aus Nostalgie-Gründen eine kleine Versionsübersicht mit den wesentlichen Unterschieden. Zur aktuellen Version geht es dann weiter unten...
  
Die Benutzung sollte eigentlich selbsterklärend sein und wird durch viele Erklärungen innerhalb des Programms verdeutlicht. Dabei ist die Spielerstellung in mehrere Schritt gegliedert, um eine übersichtliche Definition aller Einstellungen zu ermöglichen. Das Programm unterstützt zudem verschiedene Spielmodi, die ebenfalls in Programm selbst genauer erläutert werden.
+
== Versionsübersicht ==
  
Um das Programm benutzen zu können musst du dich bei Programmstart mit deinen Login-Daten für Karopapier anmelden. Nur so ist natürlich gewährleistet, dass du auch Spiele erstellen kannst und nur so ist auch der Zugriff auf die teilweise für die Initialisierung benötigten Seiten möglich. Es werden dann später bei der Spielerstellung alle Spiele im Namen des angemeldeten Spielers erstellt, d.h. du nimmst natürlich auch an allen Spielen teil.
+
{| class="wikitable sortable"
 +
! Version !! Beschreibung & Key-Features !! Screenshots !! Technologie !! Karo-Schnittstelle !! Speichern & Laden !! Status
 +
|-
 +
|| 4.x || Um den Nutzerkreis zu erweitern und die Benutzung zu vereinfachen, hatte ich mich vor einiger Zeit entschlossen für die Version 4 auf HTML5/JavaScript zu setzen. Das bedeutete eine komplette Neuentwicklung mit vielen neuen Funktionen. Die Entwicklung dieser Version ist jedoch aus Zeitgründen auf Eis gelegt und stattdessen habe ich Version 3 weiter verbessert... || ? || HTML + JavaScript || API ||  JSON || Entwicklung pausiert
 +
|- style="background:#AAFFAA"
 +
|| 3.x || Die aktuelle Version des KaroMUSKELs! Optisch, also bei der GUI, gleicht Version 3 der Version 2. Unter der Haube wurde sie jedoch vollständig überarbeitet. Ziel war eigentlich nur die vollständige Umstellung aller Funktionen auf die KaroAPI. Im Zuge Umbauten wurden aber gleich noch einige andere Verbesserungen vorgenommen. Die grundsätzlichen Funktionen sind aber gleich geblieben: <li>Spieleserien: "einfach", "Liga", "KO", "Jeder gegen Jeden", "KLC"</li><li>GUI: Erstellung in mehreren Teilschritten: Einstellungen, Regeln, Spieler, Karten, Zusammenfassung</li><li>Spieler- & Kartenauswahl abhängig vom Typ der Serie</li><li>Regeln: fix oder Zufall</li><li>Unterstützung von Teams</li><li>Speichern und Laden</li><li>Batch-Edit in der Zusammenfassung</li><li>Hilfreiche Extras wie Autosave, Logs, Supercreatormodus, uvm.</li><li>Unterstützung von Kartengeneratoren</li> || [[Datei:KaroMUSKEL-3.x (1).png|150px]] [[Datei:KaroMUSKEL-3.x (2).png|150px]] [[Datei:KaroMUSKEL-3.x (3).png|150px]] [[Datei:KaroMUSKEL-3.x (4).png|150px]] [[Datei:KaroMUSKEL-3.x (5).png|150px]] [[Datei:KaroMUSKEL-3.x (6).png|150px]] || Java || API ||  JSON<br/>+ Rückwärtskompatibilität zu muskel2 Dateien || Aktuelle Version<br/>+ Kontinuierliche Weiterentwicklung
 +
|-
 +
|| 2.x || In Version 2 wurden verschiedene neue Spieleserien-Typen eingeführt und auch sonst viele neue Funktionen eingebajt, die noch flexiblere Spieleserien ermöglichen. Aufgrund des steigenden Funktionsumfangs war es nötig die Spielerstellung im mehrere Schritte zu unterteilen: <li>Spieleserien: "einfach", "Liga", "KO", "Jeder gegen Jeden", "KLC"</li><li>GUI: Erstellung in mehreren Teilschritten: Einstellungen, Regeln, Spieler, Karten, Zusammenfassung</li><li>Spieler- & Kartenauswahl abhängig vom Typ der Serie</li><li>Regeln: fix oder Zufall</li><li>Unterstützung von Teams</li><li>Speichern und Laden</li><li>Batch-Edit in der Zusammenfassung</li> || [[Datei:KaroMUSKEL-2.x (1).png|150px]] [[Datei:KaroMUSKEL-2.x (3).png|150px]] [[Datei:KaroMUSKEL-2.x (2).png|150px]] || Java || newgame.php || Binär-Dateien || veraltete Version,<br/>vermutlich nicht mehr lauffähig
 +
|-
 +
|| 1.x || Dies war die erste richtige verfügbare Version. Damals waren die Funktionen noch so übersichtlich, dass alles auf eine einzelne Ansicht gepasst hat:<li>Spieleserien: nur "einfach"</li><li>GUI: Erstellung in einem Schritt</li><li>Spielerauswahl: in 3 Kategorien (immer dabei, dabei solange einladbar, auffüllen)</li><li>Streckenauswahl: fix oder Zufall</li> || [[Datei:KaroMUSKEL-1.x.png|150px]] || Java || newgame.php ||  nicht möglich || veraltete Version,<br/>vermutlich nicht mehr lauffähig
 +
|-
 +
|| 0.x || Bevor ich angefangen habe das ganze vernünftig in Java zu programmieren gab es noch eine ganz einfache, schnell zusammengetippte HTML/JavaScript-Version. Die wurde aber überhaupt nicht weiterverfolgt und ist nur durch Zufall mal wieder auf meiner Festplatte aufgetaucht... || [[Datei:KaroMUSKEL-0.1-HTML.png|150px]] || HTML + JavaScript || newgame.php ||  nicht möglich || veraltete Version,<br/>vermutlich nicht mehr lauffähig
 +
|}
  
== Benutzerkontrolle und Freischaltung ==
+
== Changelog ==
  
'''KaroMUSKEL''' verfügt seit Version 2.0 über eine einfache, zusätzliche Benutzerkontrolle. Ich möchte damit erreichen, dass Leute mit dem Skript keinen Blödsinn betreiben und/oder ohne nachzudenken hunderte oder tausende Spiele erstellen, ich das Skript aber trotzdem frei verteilen kann, ohne dass die Leute es immer bei mir erfragen müssen.
+
Hier geht es zum kompletten [[KaroMUSKEL/Changelog|Changelog]].
  
Wenn du dich ganz normal beim Start des Programms anmeldest kannst du das Programm zwar (fast) in vollen Funktionsumfang nutzen, bist jedoch bei der Anzahl der maximal erstellbaren Spiele etwas eingeschränkt. Zusätzlich kannst du die Einladbarkeit nicht ignorieren und das Skript nicht zum Aussteigen aus Spielen benutzen. Es ist jedoch über eine Schlüsseldatei ganz einfach diese Begrenzung aufzuheben (das Limit ist danach aber trotzdem nicht unendlich). Diese Schlüsseldatei für die Anhebung der maximalen Spielezahl kann ausschließlich bei mir ({{Benutzer|ultimate}}) angefragt werden und wird nur an "bewährte" Karomitspieler vergeben. Die Schlüsseldatei ist dann auch immer nur für diesen einen Benutzer gültig und einzigartig und ist nicht übertragbar.
+
= Benutzung & FAQ =
  
Wenn du eine Schlüsseldatei für dein Benutzerkonto besitzt, dann musst du diese einfach nur in das Verzeichnis des Programmes kopieren und das Programm neu starten. Anschließend kannst du dich ganz normal wieder im Programm anmelden und die verbesserten Funktionen nutzen. Wenn du mehrere Konten besitzt, dann kannst du auch mehrere Schlüsseldateien in dem Ordner ablegen, um alle diese Konten freizuschalten.
+
Die Benutzung sollte eigentlich selbsterklärend sein und wird durch viele Erklärungen innerhalb des Programms verdeutlicht.
  
== FAQ ==
+
=== Wie funktioniert die Spielerstellung? ===
  
* Gibt es ein Log?
+
Die Spielerstellung ist in mehrere Schritt gegliedert, um eine übersichtliche Definition aller Einstellungen zu ermöglichen. Das Programm unterstützt zudem verschiedene Spielmodi, die ebenfalls in Programm selbst genauer erläutert werden. Um zu beginnen wähle einen Spieleserien-Typ aus. Ab dort leitet sich der KaroMUSKEL durch die verschiedenen Schritte...
** Ja, seit der Version 2.6 legt der KaroMUSKEL bei jeder Spielerstellung und bei jedem Aussteigen ein Log an, in dem alle Anfragen an den Server protokolliert werden.
 
** Die Datei liegt im KaroMUSKEL-Ordner und ist wie folgt benannt: "yyyy-MM-dd HH-mm-ss action.log" (z.B. "2017-08-20 20-01-20 create.log" oder "2017-08-20 20-30-12 leave.log")
 
* Warum lädt der KaroMUSKEL am Anfang so lange?
 
** Beim ersten Start muss der KaroMUSKEL die Bilder zu allen Karten runterladen, dass kann je nach Internetverbindung und Serverlast ein paar Minuten dauern. Dabei werden die Vorschaubilder aber für alle nachfolgenden Starts gecached, so dass diese dann schneller ablaufen.
 
** Hinweis: Bei einem Update auf eine neue Version kann durch kopieren des Ordners "cache" der Ladevorgang auch in der neuen Version beschleunigt werden.
 
** Hinweis: Das Löschen des "cache" Ordners löscht die Vorschaubilder und sorgt dafür, dass diese beim nächsten Mal neu runtergeladen werden.
 
  
= Wie kriege ich KaroMUSKEL? =
+
=== Warum muss ich mich einloggen? ===  
  
== Systemvoraussetzungen & Installation ==
+
Um das Programm benutzen zu können musst du dich bei Programmstart mit deinen Login-Daten für Karopapier anmelden. Nur so ist natürlich gewährleistet, dass du auch Spiele erstellen kannst und nur so ist auch der Zugriff auf die teilweise für die Initialisierung benötigten Seiten möglich. Es werden dann später bei der Spielerstellung alle Spiele im Namen des angemeldeten Spielers erstellt, d.h. du nimmst natürlich auch an allen Spielen teil.
  
'''KaroMUSKEL''' ist in Java geschrieben und benötigt daher für die Ausführung lediglich eine installierte Java Runtime Environment (mindesten Java 1.6). Der Download muss lediglich in einen beliebigen Ordner entpackt werden. Das Programm kann dann einfach über die mitgelieferten Skripte gestartet werden (DOS-Batch-File oder Shell-Script). Schlüsseldateien müssen ebenfalls einfach nur in dieses Verzeichnis kopiert werden.
+
=== Muss ich mich für bestimmte Funktionen freischalten lassen? ===
  
Kurz und knapp bedeutet das:
+
'''KaroMUSKEL''' verfügt seit Version 3.0 über keine Benutzerkontrolle mehr. Stattdessen wird das Server-Flag "supercreator" ausgewertet. Unabhängig davon gibt es eine Konfiguration, die die maximalzahl der Spiele beschränkt. Wenn dich dies zu sehr einschränkt komm auf mich zu und ich zeige dir, wie man das anpasst ;-)
  
* JRE 1.6 oder höher
+
=== Gibt es ein Log? ===
* ein Programm zum entpacken des Downloads
 
* Internet für die Verbindung zu karopapier.de
 
* Maus und Tastatur für die Bedienung ;-)
 
  
 +
Ja, seit der Version 2.6 legt der KaroMUSKEL bei jeder Spielerstellung und bei jedem Aussteigen ein Log an, in dem alle Anfragen an den Server und andere wichtige Ereignisse protokolliert werden. Die Datei liegt im Unterordner logs unterhalb des Ordners wo das JAR-File ausgeführt wurde: "logs/karomuskel yyyy-MM-dd HH-mm-ss.log"
  
== Download ==
+
=== Warum lädt der KaroMUSKEL am Anfang so lange? ===
  
Hier gibt es eine komplette Liste aller verfügbaren Versionen zum Download:
+
Beim ersten Start muss der KaroMUSKEL die Bilder zu allen Karten runterladen, dass kann je nach Internetverbindung und Serverlast ein paar Minuten dauern. Dabei werden die Vorschaubilder aber für alle nachfolgenden Starts gecached, so dass diese dann schneller ablaufen.
  
<table width="100%">
+
* Hinweis: Bei einem Update auf eine neue Version kann durch kopieren des Ordners "cache" der Ladevorgang auch in der neuen Version beschleunigt werden.
<tr>
+
* Hinweis: Das Löschen des "cache" Ordners löscht die Vorschaubilder und sorgt dafür, dass diese beim nächsten Mal neu runtergeladen werden.
<td width="10%">'''Datum:'''</td>
 
<td width="45%">'''Kommentar:'''</td>
 
<td width="45%">'''Download-Link:'''</td>
 
</tr>
 
<tr valign="top">
 
<td>25.05.2020</td>
 
<td>'''Version 2.7 released'''<br/>
 
KaroLigaCup-Update<br/>
 
Fixed: Verschiedene kleinere Fehler</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.7.zip KaroMUSKEL-2.7.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>27.12.2018</td>
 
<td>'''Version 2.6b released'''<br/>
 
Fixed: Vorschau für User-Karten ermöglicht</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.6b.zip KaroMUSKEL-2.6b.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>27.12.2018</td>
 
<td>'''Version 2.6a released'''<br/>
 
Fixed: Fehler beim Laden von Karten mit Name "(unbekannt)", weil Didi mal wieder was an der newGame.php geändert hat ;-) (Danke {{Benutzer|Sayri}} für den Hinweis auf den Bug!)</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.6a.zip KaroMUSKEL-2.6a.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>20.08.2017</td>
 
<td>'''Version 2.6 released'''<br/>
 
Fixed: Problem mit Umlauten im Spieltitel<br/>
 
Logging eingebaut & Debugging durch User-Agent vereinfacht</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.6.zip KaroMUSKEL-2.6.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>28.12.2016</td>
 
<td>'''Version 2.5 released'''<br/>
 
Performance- & Usability-Update<br>
 
Fixed: Verschiedene kleinere Fehler</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.5.zip KaroMUSKEL-2.5.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>09.12.2016</td>
 
<td>'''Version 2.4a released'''<br/>
 
Fixed: Fehler behoben, der zur Mehrfacherstellung von Spieleserien führt (Danke {{Benutzer|aristarch}} für das finden des Bugs!)<br>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.4a.zip KaroMUSKEL-2.4a.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>29.11.2015</td>
 
<td>'''Version 2.4 released'''<br/>
 
Neuer Serientyp "Jeder-gegen-Jeden"<br>
 
Batch-Update in der Zusammenfassung</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.4.zip KaroMUSKEL-2.4.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>16.02.2013</td>
 
<td>'''Version 2.3a released'''<br/>
 
Fixed: Fehler beim Login mit Sonderzeichen<br>
 
Fixed: Fehler bei ungültigen Farbangaben in der Spielerseite</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.3a.zip KaroMUSKEL-2.3a.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>18.11.2012</td>
 
<td>'''Version 2.3 released'''<br/>
 
Fixed: Verbesserung der Liga-Planung</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.3.zip KaroMUSKEL-2.3.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>23.09.2011</td>
 
<td>'''Version 2.2b released'''<br/>
 
Fixed: Starten nicht möglich, weil Karte 186 auf der alten Erstellen-Seite fehlt, aber auf der BETA-Erstellen-Seite vorhanden ist</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.2b.zip KaroMUSKEL-2.2b.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>25.06.2011</td>
 
<td>'''Version 2.2a released'''<br/>
 
Fixed: Starten nicht möglich, wenn Spielerzahl für Karte nicht bekannt</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.2a.zip KaroMUSKEL-2.2a.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>15.12.2010</td>
 
<td>'''Version 2.2 released'''<br/>
 
Fixed: Anpassungen an die KaroAPI vorgenommen</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.2.zip KaroMUSKEL-2.2.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>03.10.2010</td>
 
<td>'''Version 2.1 released'''</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.1.zip KaroMUSKEL-2.1.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>28.04.2010</td>
 
<td>Fixed: Fehler beim Speichern und Laden von Spieleserien behoben<br/>
 
Fixed: Darstellungsprobleme mit Umlauten in Kartennamen</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.0-20100428.zip KaroMUSKEL-2.0-20100428.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>27.04.2010</td>
 
<td>Fixed: Zufallsrichtung war nicht möglich</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.0-20100427.zip KaroMUSKEL-2.0-20100427.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>26.04.2010</td>
 
<td>'''Version 2.0 released'''</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.0-20100426.zip KaroMUSKEL-2.0-20100426.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>??</td>
 
<td>'''Version 2.0-beta released'''</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-2.0-beta.zip KaroMUSKEL-2.0-beta.zip]</td>
 
</tr>
 
<tr valign="top">
 
<td>??</td>
 
<td>'''Version 1.1 released'''</td>
 
<td>[http://ultimate.github.com/karopapier/KaroMUSKEL-1.1.zip KaroMUSKEL-2.0-20100426.zip]</td>
 
</tr>
 
</table> 
 
  
Dazu noch ein paar Anmerkungen:
+
=== Sind die Serien-Typen hard-coded? ===
* Da ich hier im Wiki ja leider keine Zip-Datei hochladen kann musste ich auf eine andere Möglichkeit ausweichen und die Dateien sind extern verlinkt.
 
* Danke an {{Benutzer|Madeleine}} die lange Zeit die Downloads bereit gestellt hat.
 
* Mich gibt es jetzt auch bei Github, worüber nun auch die Downloads bereit gestellt werden: [http://ultimate.github.com ultimate.github.com]
 
* Es kann gut sein, dass einige Versionen nicht mehr funktionieren, sie sind eigentlich nur für Nostalgiker da ;-)
 
  
== Kontakt (Bugs, Fragen, Benutzerfreischaltung) ==
+
Ja und nein: Also grundsätzlich ist das Verhalten der verschiedenen Typen fest programmiert. Aber gewisse Randparameter sind über eine Konfigurations-Datei "karomuskel.properties" innerhalb des Jar-Files (KaroMUSKEL-3.x.x-bin.jar).
  
Wenn du irgendeine Frage an mich ({{Benutzer|ultimate}}) hast, dann nutze bitte das folgende Formular [http://www.karopapier.de/mailer.php?to=1411 "Mail an Mitspieler"] oder erstelle einfach ein Spiel mit mir und sprich mich dort an...
+
Bei Bedarf sollte man über einen vernünftigen Zip-Editor das Jar-File öffnen und die "karomuskel.properties" bearbeiten und aktualisieren können und somit die Einstellung ändern können, ohne eine neue Version des KaroMUSKELs erzeugen zu müssen.
  
Bitte beachte dabei in der Nachricht folgendes:
+
* Achtung: hier nur was ändern, wenn du weißt was du tust. Andere Werte sind nicht getestet und können zu Fehlern führen!
  
'''Benutzerfreischaltung''': Kurze Begründung, warum du die Freischaltung haben möchtest! ;-)
+
=== Wohin mit Fragen, Anmerkungen und Bugs? ===
  
'''Bug-Melden''': Wie kann ich den Fehler reproduzieren? Wann ist er aufgetreten? Was hast du davor gemacht? Je mehr Informationen, desto einfacher ist es für mich das Problem zu beheben! Wenn das Problem während der Spielerstellung auftritt bitte das Log (ab Version 2.6) zur Spielerstellung mitschicken.
+
Gerne schicke deine Fragen an mich ({{Benutzer|ultimate}}) auf einem der bekannten Wege ([http://www.karopapier.de/mailer.php?to=1411 Mail an Mitspieler], Zettel, App-Nachricht, Spiel erstellen) oder erstelle auch gerne ein Issue auf [https://github.com/ultimate/KaroToolsCollection/issues Github KaroToolsCollection]. :)
  
'''Frage stellen''': Hast du zuvor das Wiki und alle Hilfestellungen im Programm durchgelesen und gibt es dort vielleicht eine Antwort auf deine Frage? ;-)
+
= Wie kriege ich KaroMUSKEL? =
  
= Wie hat sich KaroMUSKEL entwickelt? =
+
== Systemvoraussetzungen & Installation ==
  
== KaroMUSKEL 2 ==
+
'''KaroMUSKEL''' ist in Java geschrieben und benötigt daher für die Ausführung lediglich eine installierte Java Runtime Environment (mindesten Java 8).
 +
Seit Version 3.0 kommt der KaroMUSKEL nicht mehr als ZIP, sondern als "executable JAR". Ihr müsst dafür lediglich die KaroMUSKEL-3.x.x-bin.jar herunterlanden und entweder via "java -jar KaroMUSKEL-3.x.x-bin.jar" oder mit dem mitgelieferten Skript gestartet werden (Batch-File).
  
=== Version 2.6 ===
+
Kurz und knapp bedeutet das:
In Version 2.6 wurde (hoffentlich) endlich der Bug behoben, der dazu führte, dass der Server kaum noch reagiert und ewig lang hängende Spielerstellungen abarbeitet und damit zahllose Spiele mehrfach erstellt.
 
  
* Fehler im Umlaut-Encoding der Spielerstellungs-Requests korrigiert
+
* JAR-Datei
* HTTP User-Agent ergänzt
+
* JRE 8 oder höher
* Spielerstellungslogging ergänzt
+
* eine Konsole oder das Script zum Starten
 
+
* Internet für die Verbindung zu karopapier.de
 
+
* Maus und Tastatur für die Bedienung ;-)
=== Version 2.5 ===
 
In Version 2.5 wurden dem KaroMUSKEL einige Performance- und Usability-Verbesserungen spendiert.
 
 
 
* Reduzierung der Thread-Anzahl für die Anfragen beim Server
 
* Caching der Karten-Bilder
 
* Vereinfachung der Spielerauswahl durch Änderung des Anzeigetextes
 
* Auto-Fokus der Textfelder beim Login
 
* Diverse kleinere Bug-Fixes
 
 
 
 
 
=== Version 2.4 ===
 
In Version 2.4 wurden ein paar gewünschte Funktionen nachgereicht.
 
 
 
* Möglichkeit in der Zusammenfassung mehrere Spiele gleichzeitig zu ändern
 
* Neuen Serientyp "Jeder gegen jeden"
 
 
 
=== Version 2.3 ===
 
Version 2.3 wurde für die [[KaroLiga]] (und natürlich andere Meisterschaften im Liga-Format) angepasst.<br/>
 
Ein spezieller Algorithmus sorgt nun dafür, dass die Anzahl der Heim- und Auswärtsspiele für jeden Spieler in Hin- und Rückrunde ausgeglichen verteilt ist.
 
 
 
=== Version 2.2 ===
 
Version 2.2 war nur eine kleine Anpassung nach Einführung der KaroAPI, damit das Skript Funktionsfähig blieb.
 
 
 
=== Version 2.1 ===
 
 
 
Version 2.1 wurde speziell für die [[CraZZZy Crash Challenge]] in Angriff genommen. Zusätzlich wurden noch ein paar Wünsche von Nutzern des Skripts berücksichtigt.
 
 
 
* Neuer Serientyp "Ausgewogene Spieleserie"
 
* Neue Strukturierung der Platzhalter
 
* Hinzufügen neuer Platzhalter
 
* Bug-Fix bei der Erstellung von mehr als 50 Spielen
 
 
 
 
 
=== Version 2.0 ===
 
 
 
Bei dem Schritt auf Version 2 hat sich so viel verändert, dass hier einmal der (halbwegs) komplette Funktionsumfang aufgelistet wird. Was unter KaroMUSKEL 1 steht, ist also nicht zwangsläufig auch noch möglich...
 
 
 
* Erweiterte Möglichkeiten der Spieleserienerstellung nach verschiedenen Serientypen: "Einfache Spieleserie", "Liga", "KO-Meisterschaft"
 
* Spielerstellung unterteilt in mehrere Teilschritte: "Einstellungen", "Regeln", "Spielerauswahl", "Streckenauswahl", "Zusammenfassung"
 
* Speichern und Laden von Spielserien
 
* Optionales Beachten oder Nicht-Beachten der Einladbarkeit
 
* Spielerauswahl je nach Spieleserientyp unterschiedlich möglich
 
* Meisterschaften können sowohl für Einzelspieler, als auch für ganze Teams erstellt werden
 
* Spierersteller kann auch an Meisterschaften teilnehmen
 
* Spieler können in mehreren Teams mitfahren
 
* Einschränkung der Streckenauswahl für Zufallskarten oder feste Streckenauswahl
 
* Meisterschaften erstellbar mit Zufallskarten oder Heimkarten
 
* Automatische Erstellung von Folgerunden bei KO-Meisterschaften
 
* Feste und zufällige Regelfestlegung möglich (ZZZ, TC, Richtung,...)
 
* Überprüfung und Zusammenfassung aller Spieler vor der Erstellung
 
* Anpassung der Spielparameter (Name, Karte, Spieler, Regeln) für einzelne Spiele vor der Erstellung
 
* Erstellung einzelner Spiele steuerbar. Andere Spiele können auch später erstellt werden
 
* Automatischer Ausstieg aus allen oder nur einigen Spielen möglich
 
* Erstellung der Spiele in Threads für verringerte Wartezeit
 
* Spielerlogin vor Spieleerstellung
 
* Anzeige aller verfügbaren Spieler mit aktueller Spielzahl und Maximum, soweit bekannt
 
* Spielerkontrolle für die Beschränkung der maximalen Spielanzahl
 
* Minivorschau für Karten
 
  
 +
== Download ==
  
== KaroMUSKEL 1 ==
+
Da alte Versionen vermutlich größtenteils eh nicht mehr lauffähig sind, habe ich diese jetzt mal entfernt. Hier wird jetzt immer nur noch die neueste Version verlinkt...
=== Version 1.1 ===
 
Version 1.1 war nur eine kleine Anpassung an Änderungen in der "newgame.php", damit das Skript Funktionsfähig blieb.
 
=== Version 1.0 ===
 
Dies ist die erste verfügbare Version gewesen. Daher hier die komplette Liste der Funktionen.
 
  
* Grundlegende Funktionsbereitstellung für einfache Spieleserien
+
Damit es losgehen kann benötigst du folgende Dateien:
* Konfiguration der Spieleserie auf einer einzigen Seite
 
* Unterstützung einer festen Strecke oder Zufallswahl der Strecke
 
* Spielerauswahl in drei Kategorien möglich
 
* Erstellung der Spiele in Threads für verringerte Wartezeit
 
* Spielerlogin vor Spieleerstellung
 
* Anzeige aller verfügbaren Spieler mit aktueller Spielzahl und Maximum, soweit bekannt
 
* Minivorschau für Karten
 
  
 +
* [https://github.com/ultimate/KaroToolsCollection/raw/master/archive/KaroMUSKEL-3.3.1-bin.jar KaroMUSKEL-3.3.1-bin.jar] (zwingend erforderlich)
  
== KaroMUSKEL 0 ==
+
* [https://github.com/ultimate/KaroToolsCollection/raw/master/archive/KaroMUSKEL-3.bat KaroMUSKEL-3.bat] (nur für Windows, nur zur Bequemlichkeit :wink: )
=== Version 0.1 ===
 
Bevor ich angefangen habe das ganze vernünftig in Java zu programmieren gab es noch eine ganz einfache HTML/JavaScript-Version. Die wurde aber überhaupt nicht weiterverfolgt und ist nur durch Zufall mal wieder auf meiner Festplatte aufgetaucht...
 
  
[[Kategorie:Definition]]
+
Hinweis: die Releases gibt es auch unter https://github.com/ultimate/KaroToolsCollection/releases
[[Kategorie:Tools]]
 

Aktuelle Version vom 18. März 2024, 15:43 Uhr

Was ist KaroMUSKEL?

KaroMUSKEL steht für "Maschinelle-Ultimative-Spielserien-für-Karopapier-Erstellungs-Lösung" und ist ein von ultimate geschriebenes Script für die automatische Erstellung von Spieleserien und Meisterschaften.

Hintergrundinformationen

KaroMUSKEL wird seit Anfang 2008 von ultimate entwickelt. Anfangs habe ich das Skript nur für den Eigenbedarf geschrieben, später habe ich es auf Anfrage aber auch an andere Spieler weitergegeben. Nach der Fertigstellung der Version 1.0 Mitte 2008 hat sich lange nichts beim Skript getan. Es wurden einzig zwischendurch mal ein paar Anpassungen auf Neuerungen von karopapier.de eingebaut, damit das Skript weiter Funktionsfähig bleibt. Im März 2010 habe ich mich dann mal ran gesetzt das ganze rund zu erneuern. Danach gab es dann mehr oder weniger Regelmäßig Anpassungen, Erweiterungen und Bug-Fixes.

Auch wenn alte Versionen größtenteils nicht mehr funktionsfähig sind, hier mal aus Nostalgie-Gründen eine kleine Versionsübersicht mit den wesentlichen Unterschieden. Zur aktuellen Version geht es dann weiter unten...

Versionsübersicht

Version Beschreibung & Key-Features Screenshots Technologie Karo-Schnittstelle Speichern & Laden Status
4.x Um den Nutzerkreis zu erweitern und die Benutzung zu vereinfachen, hatte ich mich vor einiger Zeit entschlossen für die Version 4 auf HTML5/JavaScript zu setzen. Das bedeutete eine komplette Neuentwicklung mit vielen neuen Funktionen. Die Entwicklung dieser Version ist jedoch aus Zeitgründen auf Eis gelegt und stattdessen habe ich Version 3 weiter verbessert... ? HTML + JavaScript API JSON Entwicklung pausiert
3.x Die aktuelle Version des KaroMUSKELs! Optisch, also bei der GUI, gleicht Version 3 der Version 2. Unter der Haube wurde sie jedoch vollständig überarbeitet. Ziel war eigentlich nur die vollständige Umstellung aller Funktionen auf die KaroAPI. Im Zuge Umbauten wurden aber gleich noch einige andere Verbesserungen vorgenommen. Die grundsätzlichen Funktionen sind aber gleich geblieben:
  • Spieleserien: "einfach", "Liga", "KO", "Jeder gegen Jeden", "KLC"
  • GUI: Erstellung in mehreren Teilschritten: Einstellungen, Regeln, Spieler, Karten, Zusammenfassung
  • Spieler- & Kartenauswahl abhängig vom Typ der Serie
  • Regeln: fix oder Zufall
  • Unterstützung von Teams
  • Speichern und Laden
  • Batch-Edit in der Zusammenfassung
  • Hilfreiche Extras wie Autosave, Logs, Supercreatormodus, uvm.
  • Unterstützung von Kartengeneratoren
  • KaroMUSKEL-3.x (1).png KaroMUSKEL-3.x (2).png KaroMUSKEL-3.x (3).png KaroMUSKEL-3.x (4).png KaroMUSKEL-3.x (5).png KaroMUSKEL-3.x (6).png Java API JSON
    + Rückwärtskompatibilität zu muskel2 Dateien
    Aktuelle Version
    + Kontinuierliche Weiterentwicklung
    2.x In Version 2 wurden verschiedene neue Spieleserien-Typen eingeführt und auch sonst viele neue Funktionen eingebajt, die noch flexiblere Spieleserien ermöglichen. Aufgrund des steigenden Funktionsumfangs war es nötig die Spielerstellung im mehrere Schritte zu unterteilen:
  • Spieleserien: "einfach", "Liga", "KO", "Jeder gegen Jeden", "KLC"
  • GUI: Erstellung in mehreren Teilschritten: Einstellungen, Regeln, Spieler, Karten, Zusammenfassung
  • Spieler- & Kartenauswahl abhängig vom Typ der Serie
  • Regeln: fix oder Zufall
  • Unterstützung von Teams
  • Speichern und Laden
  • Batch-Edit in der Zusammenfassung
  • KaroMUSKEL-2.x (1).png KaroMUSKEL-2.x (3).png KaroMUSKEL-2.x (2).png Java newgame.php Binär-Dateien veraltete Version,
    vermutlich nicht mehr lauffähig
    1.x Dies war die erste richtige verfügbare Version. Damals waren die Funktionen noch so übersichtlich, dass alles auf eine einzelne Ansicht gepasst hat:
  • Spieleserien: nur "einfach"
  • GUI: Erstellung in einem Schritt
  • Spielerauswahl: in 3 Kategorien (immer dabei, dabei solange einladbar, auffüllen)
  • Streckenauswahl: fix oder Zufall
  • KaroMUSKEL-1.x.png Java newgame.php nicht möglich veraltete Version,
    vermutlich nicht mehr lauffähig
    0.x Bevor ich angefangen habe das ganze vernünftig in Java zu programmieren gab es noch eine ganz einfache, schnell zusammengetippte HTML/JavaScript-Version. Die wurde aber überhaupt nicht weiterverfolgt und ist nur durch Zufall mal wieder auf meiner Festplatte aufgetaucht... KaroMUSKEL-0.1-HTML.png HTML + JavaScript newgame.php nicht möglich veraltete Version,
    vermutlich nicht mehr lauffähig

    Changelog

    Hier geht es zum kompletten Changelog.

    Benutzung & FAQ

    Die Benutzung sollte eigentlich selbsterklärend sein und wird durch viele Erklärungen innerhalb des Programms verdeutlicht.

    Wie funktioniert die Spielerstellung?

    Die Spielerstellung ist in mehrere Schritt gegliedert, um eine übersichtliche Definition aller Einstellungen zu ermöglichen. Das Programm unterstützt zudem verschiedene Spielmodi, die ebenfalls in Programm selbst genauer erläutert werden. Um zu beginnen wähle einen Spieleserien-Typ aus. Ab dort leitet sich der KaroMUSKEL durch die verschiedenen Schritte...

    Warum muss ich mich einloggen?

    Um das Programm benutzen zu können musst du dich bei Programmstart mit deinen Login-Daten für Karopapier anmelden. Nur so ist natürlich gewährleistet, dass du auch Spiele erstellen kannst und nur so ist auch der Zugriff auf die teilweise für die Initialisierung benötigten Seiten möglich. Es werden dann später bei der Spielerstellung alle Spiele im Namen des angemeldeten Spielers erstellt, d.h. du nimmst natürlich auch an allen Spielen teil.

    Muss ich mich für bestimmte Funktionen freischalten lassen?

    KaroMUSKEL verfügt seit Version 3.0 über keine Benutzerkontrolle mehr. Stattdessen wird das Server-Flag "supercreator" ausgewertet. Unabhängig davon gibt es eine Konfiguration, die die maximalzahl der Spiele beschränkt. Wenn dich dies zu sehr einschränkt komm auf mich zu und ich zeige dir, wie man das anpasst ;-)

    Gibt es ein Log?

    Ja, seit der Version 2.6 legt der KaroMUSKEL bei jeder Spielerstellung und bei jedem Aussteigen ein Log an, in dem alle Anfragen an den Server und andere wichtige Ereignisse protokolliert werden. Die Datei liegt im Unterordner logs unterhalb des Ordners wo das JAR-File ausgeführt wurde: "logs/karomuskel yyyy-MM-dd HH-mm-ss.log"

    Warum lädt der KaroMUSKEL am Anfang so lange?

    Beim ersten Start muss der KaroMUSKEL die Bilder zu allen Karten runterladen, dass kann je nach Internetverbindung und Serverlast ein paar Minuten dauern. Dabei werden die Vorschaubilder aber für alle nachfolgenden Starts gecached, so dass diese dann schneller ablaufen.

    • Hinweis: Bei einem Update auf eine neue Version kann durch kopieren des Ordners "cache" der Ladevorgang auch in der neuen Version beschleunigt werden.
    • Hinweis: Das Löschen des "cache" Ordners löscht die Vorschaubilder und sorgt dafür, dass diese beim nächsten Mal neu runtergeladen werden.

    Sind die Serien-Typen hard-coded?

    Ja und nein: Also grundsätzlich ist das Verhalten der verschiedenen Typen fest programmiert. Aber gewisse Randparameter sind über eine Konfigurations-Datei "karomuskel.properties" innerhalb des Jar-Files (KaroMUSKEL-3.x.x-bin.jar).

    Bei Bedarf sollte man über einen vernünftigen Zip-Editor das Jar-File öffnen und die "karomuskel.properties" bearbeiten und aktualisieren können und somit die Einstellung ändern können, ohne eine neue Version des KaroMUSKELs erzeugen zu müssen.

    • Achtung: hier nur was ändern, wenn du weißt was du tust. Andere Werte sind nicht getestet und können zu Fehlern führen!

    Wohin mit Fragen, Anmerkungen und Bugs?

    Gerne schicke deine Fragen an mich (ultimate) auf einem der bekannten Wege (Mail an Mitspieler, Zettel, App-Nachricht, Spiel erstellen) oder erstelle auch gerne ein Issue auf Github KaroToolsCollection. :)

    Wie kriege ich KaroMUSKEL?

    Systemvoraussetzungen & Installation

    KaroMUSKEL ist in Java geschrieben und benötigt daher für die Ausführung lediglich eine installierte Java Runtime Environment (mindesten Java 8). Seit Version 3.0 kommt der KaroMUSKEL nicht mehr als ZIP, sondern als "executable JAR". Ihr müsst dafür lediglich die KaroMUSKEL-3.x.x-bin.jar herunterlanden und entweder via "java -jar KaroMUSKEL-3.x.x-bin.jar" oder mit dem mitgelieferten Skript gestartet werden (Batch-File).

    Kurz und knapp bedeutet das:

    • JAR-Datei
    • JRE 8 oder höher
    • eine Konsole oder das Script zum Starten
    • Internet für die Verbindung zu karopapier.de
    • Maus und Tastatur für die Bedienung ;-)

    Download

    Da alte Versionen vermutlich größtenteils eh nicht mehr lauffähig sind, habe ich diese jetzt mal entfernt. Hier wird jetzt immer nur noch die neueste Version verlinkt...

    Damit es losgehen kann benötigst du folgende Dateien:

    Hinweis: die Releases gibt es auch unter https://github.com/ultimate/KaroToolsCollection/releases