Das Kmud-Handbuch: Benutzung: Hauptfenster

Kmud Homepage

Next Previous Table of Contents

### 3. Benutzung: Hauptfenster

### 3.1 Wie verbinde ich mit einem Mud?

#### Verbindung

Um sich schnell und einfach mit einem Mud zu verbinden, wählt man im Mud-Menü die Verbinden-Option. In dem darauffolgenden Dialog gibt man die IP-Adresse oder den Hostnamen des Zielservers und die Portnummer an. Wenn keine Portnummer eingegeben wird, wird Port 23 (Standard-Telnet-Port) automatisch angenommen.

#### Verbindungsassistent

Der Verbindungsassistent wird benutzt um Charaktere/Mud-Profile für die Verbindung zum Mud zu erzeugen. Um den Verbindungsassistenten aufzurufen, wähle "Verbindungsassistent" im Mud-Menü aus oder benutze das Verbindungsassistent-Icon in der Werkzeugleiste.

Um einen neuen Charakter und das zugehörige Mud-Profil zu erzeugen, klicke auf den "Neu"-Knopf. Daraufhin erscheint ein Dialog, in dem man den Namen des Charakters unter "Name" eintragen kann. Man kann dem Charakter auch ein schon existierendes Profil zuordnen, indem man den Auswahl-Knopf neben dem Namen anklickt. Außerdem werden in dem Dialog die Daten für das Mud eingetragen. Wenn das Mud schon existiert und man nur einen neuen Charakter erstellen will, kann man hier auch den Auswahl-Knopf drücken. Zum Schluss; klickt man 'OK' an, um die Eingaben zu bestätigen, oder "Abbrechen", um die Daten zu verwerfen. Bei Rückkehr in den Verbindungsassistenten kann man sich durch Klick auf den "Verbinden"-Knopf mit dem ausgewählten Profil verbinden oder mit "Übernehmen" nur das gewählte Profil aktivieren, um Einstellungen vorzunehmen ohne online zu sein (z.B. bei Triggern und Aliasen).

Um ein existierenden Charakter zu verändern, selektiert man es in der Auswahlliste und klickt auf "Bearbeiten". Die aktuellen Daten erscheinen in den Textfeldern des Dialogs, und können nun verändert werden. Durch Klick auf "OK" bestätigt man diese Änderungen.

Im Verbindungsassistenten ist es möglich zu prüfen ob das Mud online ist indem man auf den "Ping"-Knopf klickt. Dies öffnet ein Fenster welches die Antwortzeiten des Muds zeigt. Klicke "Abbrechen" um das Fenster zu schließen.

Mit Kmud ist es möglich seinen Charakter automatisch einzuloggen, welches einem das Eingeben von Name und Passwort erspart. Um diese Option zu nutzen muss der Loginname und das Passwort sowie der Text der sonst bei der Abfrage von Login und Passwort erscheint eingegeben werden.

Ein Profil kann auch gelöscht werden, indem man es in der Liste auswählt und dann auf "Löschen" klickt.

### 3.2 Aliase / Makro's

Aliase werden dazu benutzt bestimmte Befehle auszuführen, wenn Text in die Eingabezeile getippt oder eine Taste gedrückt wird. Dies kann z.B. dazu genutzt werden, um sich die Lebensenergie anzuzeigen, wenn ein Alias 'hp' benutzt wird.

Um ein Alias zu erzeugen, wählt man die Option "Alias" vom Menü "Profil". Die Aliase werden benutzt um neue Kommandos zu erzeugen. Diese neuen Kommandos werden aus den alten zusammengesetzt. Um zum Beispiel ein Alias "gehen" zu erzeugen, dass dazu führt, dass sich der Charakter nach Norden, Süden und schließlich nach Westen bewegt, drückt man die Schaltfläche "Neu" im Alias-Dialog. In dem nun erscheinenden Dialog trägt man im Feld "Name" den Wert "gehen" ein und im Feld "Definition" trägt man "norden;süden;westen" ein (Falls ein anderes Zeichen als ';' als Kommandotrennzeichen angegeben ist, dann benutzt man dieses). Wenn dieses Alias durch Druck auf die Taste F1 aktiviert werden soll, drückt man die Schaltfläche "ändern" und drückt im darauffolgenden Dialog auf die Taste F1. Man kann als Makro-Tasten die Funktionstasten und die Tasten des numerischen Blockes verwenden. Auf diese Weise kann man ganz einfach laufen mit dem numerischen Tastenblock ermöglichen; zum Beispiel die "8" auf dem numerischen Tastenblock um nach "Norden" zu gehen. Die SHIFT-, ALT- und STRG-Tasten können ebenfalls genutzt werden. Nun hat man ein Alias erzeugt, welches durch Druck auf F1 oder durch Eingabe von "gehen" die Befehlssequenz "norden, süden, westen" abspult!

Wenn man in Kmud ein Alias benutzt, wird die restliche Eingabe behalten. Damit ist es z.B. möglich mit dem Alias "sb" -> "Schieße mit Bogen auf" den Befehl "sc Yeti" -> "Schieße mit Bogen auf Yeti" auszuführen. Ausserdem kann man verschachtelte Aliase erstellen. Dies sind Aliase, die einen weiteren Alias aufrufen. Also z.B. "sby" -> "sb Yeti" um direkt auf einen Yeti zu schießen. Eine automatische Schleifenerkennung verhindert, dass sich Aliase gegenseitig immer wieder aufrufen.

Es ist weiterhin möglich externe Befehle mit einem Alias aufzurufen, um z.B. im Internet Mud Mails zu lesen. Diese Befehle müssen mit einem speziellen Zeichen beginnen. Zu Beginn ist dies "#". Im Einstellungsmenü kann dies unter "Eingabe Einstellungen" geändert werden.

Um ein Alias zu ändern muss man nur in der Alias Liste einen Eintrag auswählen und "Bearbeiten" drücken. Um ein Alias zu entfernen einfach auf "Löschen" drücken. Mit "OK" bestätigt man alle Eingaben und sichert sie. "Abbrechen" schließt den Dialog, ohne dass die Änderungen wirksam werden.

Man kann die Aliase aktivieren und deaktivieren, indem man die zugehörige Taste drückt. Diese Taste kann unter "Tastenbelegungen" im Menü "Einstellungen" geändert werden. Die Standardtaste ist STRG+A. Der Alias Status kann am Bild in der Iconleiste kontrolliert werden. Wenn das Bild grau ist, werden Aliase nicht beachtet. Trotzdem ist es möglich Aliase im Menü einzustellen.

### 3.3 Trigger

Trigger reagieren auf die Ausgabe eines Muds und senden ein Kommando bei Empfang eines bestimmten Textes. Dies kann zum Beispiel ein Kommando zum trinken von Wasser sein wenn Kmud den Text "Du bist durstig." empfängt.

Du kannst einen Trigger erstellen indem du die Option "Trigger" im Profil Menü auswählst. Dies ruft einen Dialog auf in dem alle bisher für das aktuelle Mud erstellten Trigger angezeigt werden.

Klicke auf 'Neu' um einen neuen Trigger zu erstellen. Dies öffnet einen neuen Dialog mit zwei Eingabefeldern. Gib den Text auf den Kmud reagieren soll in das erste Feld ein. Dies kann auch ein regulärer Ausdruck sein, wenn der Knopf "Regulärer Ausdruck" gewählt ist. Weitere Informationen über das benutzte System für reguläre Ausdrücke kann auf Trolltechs Internetseite gefunden werden ( RegExp online documentation)

Nun muss gewählt werden, welche Aktion bei der Aktivierung des Triggers ausgeführt werden soll. Dies kann entweder ein Befehl sein, der an das Mud geschickt wird oder aber der Text, der den Trigger ausgelöst hat, kann verändert werden.

Um einen Befehl auszuführen, muss das Kommando in das Feld "Sende Befehl" eingegeben werden und der Knopf daneben gedrückt sein. Um das Aussehen des Strings oder der gesamten Linie zu ändern muss die jeweilige Option gewählt werden. Danach kann man die Einstellungen für Vorder- und Hintergrungfarbe, sowie Schriftart über die Icons ändern.

Klicke auf 'OK' um den Trigger zu erzeugen oder 'Abbrechen' um die Erzeugung des Triggers abzubrechen.

Trigger können bearbeitet oder aus der Triggerliste gelöscht werden indem man auf den 'Bearbeiten' oder 'Löschen Knopf klickt. 'OK' sichert die Änderungen. 'Abbrechen' schließt den Dialog ohne die 'Änderungen zu übernehmen.

Auch Trigger lassen sich über eine Taste an- und abschalten. Dies geschieht wie bei Aliasen im Menü "Tastenbelegungen". Die Standardtaste ist STRG+T. Der Status der Trigger kann am Bild in der Iconleiste kontrolliert werden. Wenn das Bild inaktiv ist, so sind die Trigger abgeschaltet. Man kann weiterhin im Menü die Trigger bearbeiten. Wenn ein Trigger in einer Schleife festhängt, kann mit der Taste dieser Vorgang beendet werden.

### 3.4 Protokoll

Die Protokoll-Option in Kmud kann dazu benutzt werden um die Ausgabe des Muds in eine Textdatei zu sichern. Die Option kann mit dem "Protokoll"-Knopf in der Werkzeugleiste an- und ausgestellt werden.

Um die Datei in die das Protokoll geschrieben wird zu ändern wähle "Protokoll" im Profil-Menü. Dies öffnet einen Dialog für die Protokoll-Optionen. Neben dem an- und ausschalten des Protokolls kann man auch auswählen ob das Protokoll auch die ANSI-Steuerzeichen enthalten soll. In dem Textfeld kann man die Datei angeben in die das Protokoll geschrieben werden soll. 'OK' sichert die Einstellungen und 'Abbrechen' verwirft sie wieder.

### 3.5 Programmierbare Werkzeugleiste

Mit Kmud lassen sich Knöpfe definieren, die Befehle an den Mud Client schicken. Diese Knöpfe erscheinen in der programmierbaren Werkzeugleiste unter der Hauptwerkzeugleiste. Im Menü "Ansicht" kann gewählt werden, ob diese Leiste angezeigt werden soll.

Um die Knöpfe zu bearbeiten, muss man im "Profil"-Menü die Option "Werkzeugleiste" wählen. Dies öffnet das Einstellungsfenster für die Werkzeugleiste. Hier kann man Knöpfe erstellen, editieren oder löschen.

Um einen Knopf zu erstellen, wählt man "Neu" und gibt im Dialog dem Knopf zu Beginn einen Namen. Im Feld "Befehl" wird das Kommando eingegeben, welches an den Client geschickt werden soll. Dies kann auch ein externes Kommando sein, wenn der Befehl mit dem Symbol für externe Kommandos beginnt (dies ist zu Beginn "#"). Unter "Icon" kann man ein Bild wählen, welches dann in der Werkzeugleiste erscheint. Wenn dieses Feld nicht ausgefüllt wird, wird der Name des Befehls in der Werkzeugleiste angezeigt. Mit "OK" werden die Einstellungen übernommen und der Knopf erscheint in der Liste der Werkzeugleiste.

Die Reihenfolge der Knöpfe wird geändert, indem man einen Eintrag in der Liste auswählt und auf die Pfeile auf der rechten Seite klickt. Desweiteren kann man die Knöpfe mit "Bearbeiten" und "Löschen" nochmal verändern oder wieder entfernen.

Nachdem alle Einstellungen gemacht wurden, wird die Werkzeugleiste mit "OK" aktualisiert.

### 3.6 Schnelllaufen

Die Schnelllaufen-Option ermöglicht es einem ein Kommando bei der Eingabe in die Eingabezeile mehrere Male hintereinander auszuführen. Zum Beispiel um sechs Mal hintereinander nach Norden zu laufen, kann man einfach '.6n' eingeben. '.' ist das Schnelllaufen-Zeichen und kann in den Kmud-Einstellungen konfiguriert werden.

### 3.7 Einstellungen

Man kann den Zeichensatz und die Farben in dem Menü "Einstellungen" verändern. Unter "Einstellungen" kann man das Echo-Verhalten und die Speicher-Einstellungen verändern. Schaltet man "Letzte Ausgabe markiert behalten" an, dann wird in der Eingabezeile die jeweils letzte Ausgabe beibehalten, aber markiert, so dass man sie durch Neueingaben sofort überschreiben kann. Mit der Option "\007 als Piepton" kann man den Piepton anschalten, sobald der Buchstabe 7 vom Mud empfangen wird. "Automatisches Wiederverbinden" unter "Zeiten" ermöglicht das Erscheinen des Wiederverbinden-Dialogs, sobald man die Verbindung zum Mud verliert. Unter "Echo" gibt es die Optionen "Lokales Echo", welches die Anzeige der eigenen Eingaben im Mud Fenster regelt und "Eingabeecho", welches die Anzeige des eingegebenen Textes in der Eingabezeile bestimmt. Im Reiter "Puffer" kann man die maximale Anzahl gespeicherter Zeilen im Hauptfenster und im Eingabespeicher einstellen, um die Speichermenge für Kmud zu begrenzen. Mit "Speichern" im Einstellungen-Menü kann man das Speichern der Einstellungen erzwingen.

### 3.8 Verbindungsanzeige und -zeit

In der Statuszeile erscheint ein Symbol, das den aktuellen Verbindungsstatus anzeigt. Daneben wird die Zeit mitgezählt, die man schon mit dem Mud verbunden ist. Das Icon zeigt an, ob man mit dem Mud verbunden ist.

### 3.9 Automatisches Wiederverbinden

Wenn man die Verbindung zum Mud verliert, dann kann Kmud diese automatisch wiederherstellen. Diese Möglichkeit wird im Einstellungen-Dialog an- und ausgeschaltet. Wenn diese Option angeschaltet ist, erscheint ein Dialog, sobald man die Verbindung zum Mud verloren hat. Nach einer bestimmten Zeit wird automatisch die Verbindung wiederhergestellt, wenn man nicht zuvor eine der anderen angebotenen Möglichkeiten des Dialogs nutzt.

### 3.10 Eingabezeile

In Kmud kann man eine oder zwei Eingabezeilen nutzen. Diese Eingabezeilen werden genutzt, um Befehle an ein Mud zu schicken. Jeder Befehl wird in einem Puffer gespeichert. Mit den Pfeiltasten nach oben und unten, kann man alte Befehle in diesem Puffer wieder aufrufen.

Ausserdem ist es möglich mit der rechten Maustaste auf die Eingabezeile zu klicken. Dadurch wird eine Liste der letzten 8 Eingaben angezeigt aus der ein passender Befehl gewählt werden kann, der dann in der Eingabezeile angezeigt wird.

### 3.11 Mehrzeilige Eingabe

Kmud ermöglicht es einem mit Hilfe der Mehrzeiligen Eingabe längere Texte mit Zeilenumbrüchen an das Mud zu senden. Das kann etwas umständlich sein, wenn man dazu die normale Eingabezeile nutzt. Im Menü "Ansicht" kann die Option "Mehrzeilige Eingabe" ausgewählt werden, um dieses Feature zu aktivieren.

### 3.12 Ausgabebenachrichtigung, nach einiger ruhiger Zeit im Mud

Wenn Kmud Ausgaben erhält und der Benutzer einige Zeit keine Aktion vorgenommen hat, dann benachrichtigt Kmud den Benutzer über die neuen Ausgaben, indem das Symbol in der Titelzeile anfängt zu blinken.

Die Ruhezeit, nach der auf Ausgaben reagiert wird, kann im Einstellungsmenü unter "Zeiten" konfiguriert werden.

### 3.13 geteilter Bildschirm beim Zurückscrollen

Wenn man zu den älteren Ausgaben von Kmud zurückscrollt, dann wird die Bildschirmanzeige von Kmud geteilt. In der unteren Hälfte erscheinen weiterhin die aktuellen Ausgaben, so dass man immer noch den Überblick über die aktuelle Situation hat. Im oberen Teil erscheinen die alten Ausgaben, zu denen man zurückgescrollt hat. Als positiver Nebeneffekt des geteilten Bildschirms, kommt hinzu, dass man beim Anschauen älterer Ausgaben nicht jedesmal zurückspringt, wenn neue Ausgaben erscheinen. Man kann den geteilten Bildschirm wieder vereinigen, indem man nach unten scrollt.

### 3.14 Chef-Taste

Kmud hat die Fähigkeit sich zu einem kleinen Icon im KPanel zu minimieren. Die kann erreicht werden indem man die Chef-Taste (auch boss key genannt) drückt oder die "Hilfe! Der Chef!" Option im Hilfe Menü wählt. Diese Option ist dafür gedacht Kmud schnell zu verstecken für Leute die mudden wenn sie nicht sollten. ;-)

Die Chef-Taste kann geändert werden indem man den "Tasten" Menüeintrag im Optionen-Menü wählt. Die voreingestellte Taste ist die Escape-Taste.

### 3.15 Kommandozeilenparameter

Es gibt mehrere Kommandozeilenparameter, die vom Kmud verarbeitet werden:

- -h, --help Zeigt die Hilfe an.
- -v, --version Zeigt die Version von Kmud an.
- -h host, --host host Verbindet zum angegebenen Host.
- -p port, --port port Verbindet zum angegebenen Port.
- -w , --wizard Verbindet zum angegebenen Charakterprofil.

Beispiele: kmud -w \"Sunbright@Midnight Sun\" kmud --wizard Sunbright@WOW kmud --host midnight-sun.ludd.luth.se --port 3000

### 3.16 Kmud Plugins

Es gibt die Möglichkeit die Fähigkeiten von Kmud mit Plugins zu erweitern. Ein Pluginmanager im "Plugin"-Menü kann dafür genutzt werden um Kmud Plugins zu konfigurieren. Man kann ein Plugin laden und wieder entladen indem man das die zugehörige Checkbox an- oder ausschaltet. Um ein Plugin zu konfigurieren wählt man das Plugin in der Liste aus in klickt auf den "Konfigurieren..." Knopf. Dies ist jedoch abhängig vom Plugin. Nicht jedes Plugin muss konfigurierbar sein.

Damit Kmud die Plugins beim Start finden kann, sollten sich alle Plugins entweder in $KDEDIR/lib/kmud/, $HOME/.kde/lib/kmud oder innerhalb eines Pfades von $LD_LIBRARY_PATH befinden.

Wenn du ein Plugin für Kmud schreiben möchtest, lies bitte die README Datei im kmud/plugins Verzeichnis der Quelldistribution.

### 3.17 Hilfe

Diese Hilfe erscheint immer, wenn <F1> gedrückt wird, während man in der Applikation ist. Außerdem erhält man in vielen Situationen eine Schnellhilfe. Dazu klickt man mit der rechten Maustaste auf das Objekt, zu welchen man eine Hilfe wünscht und wählt im erscheinenden Kontextmenü die Schnellhilfe aus.

Next Previous Table of Contents