Wenn du ein neues Multiplayerspiel erstellen willst, musst du eine neue Session starten. Nutze hierfür folgende Funktion:
mplay_session_create(sesname,playnumb,playername) erstellt eine neue Session auf der momentanen Verbindung. sesname ist ein String, der den Namen der Session angibt. playnumb ist die maximale Spieleranzahl in diesem Spiel (0=beliebig). playname ist der Name des Spielers. Die Funktion gibt zurück ob sie erfolgreich war.
Eine Instanz des Spiels muss die Session erstellen. Die anderen Instanzen sollten dieser Session beitreten. Das ist etwas schwieriger. Du musst zuerst schauen, welche Sessions verfügbar sind und dann an einer teilnehmen. Drei wichtige Routinen gibt es dafür:
mplay_session_find() sucht alle Sessions, die noch Spieler akzeptieren und gibt die Anzahl der gefundenen zurück.
mplay_session_name(numb) gibt den Namen der Session mit der Nummer numb an(0 ist die erste Session).Diese Funktion kann nur nach der voranstehenden aufgerufen werden.
mplay_session_join(numb,playername) an der Session mit der Nummer numb (0 ist die erste Session) wird teilgenommen. playername ist der Name des Spielers. Diese Funktion gibt zurück, ob sie erfolgreich war.
Es gibt eine weitere Funktion, die den Session-Modus ändert. Sie sollte vor dem Erstellen einer Session ausgeführt werden:
mplay_session_mode(move) bestimmt ob ein anderer Rechner die Session übernimmt, wenn der momentane Server ausfällt. move sollte entweder true (wahr) oder false (falsch, ist voreingestellt).
Um den Verbindungsstatus zu prüfen verwende:
mplay_session_status() gibt den Status der momentanen Session an. 0 = keine Session, 1 = erstellte Session, 2 = an Session teilgenommen.
Ein Spieler kann folgende Routine nutzen, um eine Session zu stoppen:
mplay_session_end() beendet die Session für diesen Spieler.