IRC Play [ created by Tizzio ]

Introduzione

Irc Play è una libreria gml che permette di creare giochi Multiplayer Online senza aprire le porte del router. Richiede la GEX 39DLL installata

Pro e Contro

Pro:

• Semplice da utilizzare, dato che è molto simile alle mplay
• La lista delle sessioni è autogestita da un controller interno
• Non è necessario aprire una o più porte del modem, dato che si sfrutta la rete IRC per far comunicare gli exe

Contro:

• Non è possibile creare giochi in cui il personaggio deve muoversi in realtime o comunque inviare una grande quantità di dati al secondo, questo perchè la rete irc ha molti limiti per i messaggi inviati
• Non è molto sicuro, poichè un eventuale utente può entrare nel canale irc e rovinare le partite (la sicurezza deve quindi gestirla il programmatore con eventuali accorgimenti [controllare il nome del player, etc])

Lista delle funzioni

irc_init(host, canale): Inizializza il sistema, host: esempio "irc.forumfree.com" , channel : nome del canale a tua scelta.
irc_end(): Termina la libreria
irc_started(): Ritorna true se hai joinato nel canale richiesto, false se sei ancora disconnesso
irc_session_create(nome sessione,numero giocatori, nome player ): Ritorna true se è riuscito a creare la sessione
irc_session_count(): Ritorna il numero di sessioni disponibili.
irc_session_current(): Ritorna il nome della sessione corrente.
irc_session_accept(true o false): true di default, se imposti false, non verranno accettati nuovi player nella sessione.
irc_session_error(): Ritorna 0 se non ci sono errori altrimenti le costanti IRC_ERR_SESSION_FULL : sessione piena, IRC_ERR_SESSION_CLOSED : sessione chiusa, IRC_ERR_TIMEOUT_REQUEST : richiesta join fallita, IRC_ERR_PLAYER_EXISTS : esiste già un player col nickname scelto, nella sessione.
irc_session_find(): Cancella la lista delle sessioni, e inizia di nuovo la ricerca.
irc_session_join(numero, nickname): Invia una richiesta di join alla sessioen corrispondente a quel numero (da 0 a irc_session_count())
irc_session_maxplayers(numero): Ritorna il numero massimo di player che possono joinare nella sessione corrispondente a quel numero (da 0 a irc_session_count())
irc_session_players(numero): Ritorna il numero di player connessi nella sessione corrispondente a quel numero (da 0 a irc_session_count())
irc_session_name(): Ritorna il nome della sessione corrispondente a quel numero (da 0 a irc_session_count())
irc_session_status():ritorna una costante : IRC_STATUS_NOSESSION [nessuna sessione], IRC_STATUS_CREATEDSESSION [sessione creata], IRC_STATUS_JOINEDSESSION[entrato in una sessione]
irc_player_count():ritorna il numero di player nella sessione
irc_player_find():Cancella la lista di players alla sessione corrente e avvia una ricerca per re-inserirli in lista
irc_player_id(numero):Ritorna il nome irc (usato come id) del player corrispondente al numero (da 0 a irc_player_count())
irc_player_name(numero):Ritorna il nome del player(relativo alla sessione) corrispondente al numero (da 0 a irc_player_count())
irc_message_send(player,id,value):Ritorna true se ha inviato il messaggio al player con quel nome, puoi anche usare IRC_ALL_PLAYERS per inviare il messaggio a più giocatori , id: id del messaggio(numero intero a scelta) , value ( stringa o numero da mandare)
irc_message_receive(): Riceve il prossimo messaggio e lo cancella dalla lista
irc_message_id():ritorna l'id dell'ultimo messaggio estratto
irc_message_player():ritorna il nome del player che ha inviato l'ultimo messaggio estratto
irc_message_value():ritorna il valore dell'ultimo messaggio estratto
irc_message_count():ritorna il numero di messaggi in arrivo
irc_message_clear():pulisce la lista di messaggi in arrivo