Help - OGame Commercial Helper

Questo tool è un supporto gratuito ai meccanismi di commercio che sussistono in OGame.
Spesso il commercio di OGame diventa leggermente complicato di per se, e altre volte vogliamo utilizzare tassi di scambio che non sono quelli standard... è quindi richiesto l'uso della calcolatrice, ma le cose diventano ancora più complesse se ci sono quantità di materiali misti fra loro o parti di debito già pagate ecc...
Per avere un aiuto a questi problemi, si può utilizzare questo strumento.

OGCH è stato ideato e realizzato da Keul, ex membro dell'Alleanza Anubis di UNI7 ed è utilizzabile secondo la licenza GPL distribuita col prodotto. La proprietà intellettuale del software rimane dell'autore. La modifica dei sorgenti del prodotto è consentita se questa proprietà viene mantenuta.

Quali sono le funzionalità generali?

Nuove regole commerciali di Gennaio 2007

Siamo allineati al regolamento di ogame.it del Gennaio 2007

Il regolamento commerciale del 06/01/2007 di fatto elimina completamente la possibilità di variare il rapporto di scambio tra due risorse. Questo elimina le utilità introdotte da OGCH dal ramo 0.2.x.
Avendo faticato abbastanza per arrivare a questa versione, è potenzialmente ancora possibile variare i rapporti; ciò che è stato fatto è aggiornare il file di configurazione delle regole commerciali.

Siete avvertiti: commerciare al di fuori del tasso che trovate nelle regole è punibile di ban dal gioco.

Cosa pensi delle nuove regole commerciali?

Penso che si sia impoverito un gioco che già di per se non è troppo vario, ma sono anche certo che il lavoro dei GO sia piuttosto difficile se li immaginate continuamente a caccia di gente che viola le regole.
Probabilmente avrei preferito un irrigidimento del tasso massimo e minimo... ma sono pur sempre un ex giocatore!

Supporto

Ciò che dice OGCH è affidabile?

OGCH può essere soggetto a bug che ne invalidino i risultati.
Il suo uso è completamente sotto la responsabilità dell'utilizzatore.
Siete liberi di non fidarvi dei risultati del prodotto e se venite danneggiati dal suo utilizzo, l'autore non si ritiene responsabile.
Quindi non incavolatevi se, per un errore del tool, scambiate la vostra intera riserva di deuterio per una pizza e una birra media... Se vi trovate errori od imperfezioni, o semplicemente trovate che non faccia qualcosa che voi desiderate, segnalate all'autore il problema o la vostra idea, e grazie al vostro aiuto il tool potrebbe venire migliorato, con beneficio di tutti!

Che browser supporta OGCH?

OGCH vuole funzionare sul maggior numero possibile di browser, ma ho bisogno del vostro aiuto per questo... E' stato scritto e testato per funzionare al meglio con Mozilla Firefox (1.5.x e 2.0.x) e i browser che portano il motore Geko.

Per quanto consideri Internet Explorer una delle piaghe dell'umanità e colpevole di un sottosviluppo del Web a livello mondiale, non posso fare a meno di fornire compatibilità verso questo prodotto.
Ho eseguito i test di questa versione con IE 7 su WinXP SP2... se trovate problemi con altre versioni potete segnalarmi la cosa ma dovete per forza suggerimi la correzione da eseguire perché non saprei come testarla da solo!
Opera è stato testato con la versione 9.1.

Aprire OGCH

Come posso includere OGCH nel mio forum/spazio web?

Avete fondamentalmente due modi: uno consigliato e uno meno...
Ciò che non consiglio è copiarvi localmente i sorgenti del tool e metterli da qualche parte in uno spazio Web sotto al vostro controllo o semplicemente sul vostro computer.
Non ho nulla in contrario in questo, il tool è open source, ma se usate invece il tool nei modi che illustrerò sotto, avrete automaticamente i benefici delle nuove versioni e possibili correzione di bachi.

Tecnicamente parlando, dovete collegare il vostro forum/spazio Web al tool includendo un link opportuno.
Per ottenere la visualizzazione a finestra, dovete includere questo codice:

Al posto di TESTO DA INCLUDERE dovete mettere la frase o la parola che volete, oppure un'immagine (non vi spiego come, di corsi di HTML ne trovate milioni in rete... iniziate da html.it).
Siete liberi di ritoccare i parametri come desiderate... le dimensioni sono ottimizzate per l'immagine di sfondo dell'applicazione; altre impostazioni, quali il ridimensionamento e l'abilitazione barra di stato e altro, in una finestra così piccola danno fastidio... vedete voi. Attenzione però a non cambiare il nome della finestra (commhelper) che viene utilizzato all'interno dell'applicazione.

Finestra o schermo interno?

A seconda di come avete aperto OGCH dovreste vedere una piccola finestra di popup oppure una normale finestra del vostro browser completamente vuota se non per una piccola area con l'interfaccia del tool.
OGCH era stato pensato per l'utizzo in finestra in modo tale da poterlo mantenere sempre attivo a fianco della finestra di OGame durante operazioni commerciali; alcuni hanno suggerito e preferito invece un uso più comune: rendere utilizzabile anche la sua apertura a schermo intero.

Nella visualizzazione a schermo interno vi sarà possibile muovere la finestra effettiva dell'interfaccia ovunque vogliate, semplicemente posizionandovi sul titolo della finestra.

Non nascondo che, sebbene sia stato inizialmente contrario, la visualizzazione a schermo intero ha ottenuto maggiore successo che quella a finestra...

Usare OGCH

Come è composta l'interfaccia di OGCH?

Puoi fare qualche esempio di utilizzo?

Il giocatore Iside mette in vendita 50.000 unità di deuterio per un'altra risorsa qualsiasi. Amon-Ra è interessato e vuole offrire in cambio del metallo. Egli quindi inserisce 50000 nell'apposita casella di testo riservata al deuterio nella seconda area del tool.
Dalla terza area seleziona quindi il metallo ed inizia la conversione premendo il l'apposito tasto. Otterrà quindi 150.000, la quantità di metallo da inviare ad Iside

Complichiamo leggermente, volendo ora commerciare con quantità miste di risorse.

Il giocatore Iside vuole vendere al giocatore Amon-Ra 12.000 unità di cristallo. Iside non si preoccupa di cosa le verrà offerto in cambio. Amon-Ra quindi inserirà 12000 nel campo relativo al cristallo, nella seconda area di OGCH. Nella terza area selezionerà quindi sia metallo che deuterio (cristallo no, difficilmente Iside vuole ricevere indietro del cristallo dalla sua stessa cessione...). Amon-Ra vedrà quindi quanto metallo e deuterio inviare (9.000 di metallo e 3.000 di deuterio).

Questo esempio illustra un particolare di OGCH: la suddivisione dei valori convertiti. Il funzionamento del tool prevede innanzi tutto la conversione di tutte le risorse in unità di metallo (ossia quel materiale con valore minore). Nel nostro caso, quindi, i 12.000 di cristallo sono diventati 18.000 unità di metallo.
Avendo selezionato due tipi di risorse nell'area numero 3, questi 18.000 unità di metallo vengono ripartiti al 50% tra le due tipologie di risorse: 9000 diventano metallo (che quindi rimangono allo stesso valore) e gli altri 9000 diventano deuterio (che al tasso utilizzato diventano 3000 unità).
Bisogna quindi ricordare che OGCH ripartisce in modo equo (in base al tasso di conversione impostato) le risorse del lotto di partenza tra tutte le categorie incluse tra le possibili quantità convertite.

Il giocatore Iside è stato pesantemente piallato dal malvagio giocatore Septh (non me ne voglia il nostro primo faraone, mi riferisco alla divinità malvagia! N.d.A.) e l'amico Amon-Ra vuole quindi aiutarla nel risollevarsi, inviandogli vari carghi portandole in tutto 60.000 unità di metallo, 30.000 di cristallo e 15.000 di deuterio.
Iside col tempo si riprende dalla sventura e decide di restituire ad Amon-Ra il prestito ricevuto. Utilizzando OCGM inserisce tutte le quantità ricevute. A questo punto è in una situazione dove, dopo essersi vendicata di Septh e depredando la colonia del nemico, si trova a possedere molto deuterio e cristallo; decide quindi di restituire il favore con questi due tipi di risorse.
Nella terza area selezionerà quindi cristallo e deuterio, ed eseguirà la converzione.
Otterrà quindi una ripartizione al 50% tra le due risorse, ossia 50.000 unità di cristallo e 25.000 di deuterio.

Questo esempio è un rafforzativo del precedente, dove viene mostrato come si può trattare facilmente con unità miste sia nei lotti di partenza che nei risultati della conversione.

Septh è tornato ed ha di nuovo piallato Iside ('sta ragazza deve capire l'importanza del fleet-save! N.d.A.)... Amon-Ra aiuta di nuovo l'amica e le invia altri carghi. In tutto le presta 70.000 unità di metallo, 50.000 di cristallo e 12.000 di deuterio.
Naturalmente Iside torna in breve all'antico splendore ed è pronta a pagare il debito. Come la volta scorsa, dalle rappresaglie verso Septh ha ottenuto moltissimo cristallo e deuterio. Vuole però inviare al compagno anche 30.000 unità di metallo che le giacciono inutilizzate in una colonia.
Ella inserisce tutti i dati degli aiuti ricevuti, ed ancora un volta seleziona dalla terza area dell'interfaccia cristallo e deuterio, ma questa volta inserisce anche nella casella relativa al metallo 30000 unità.
Saprà quindi che deve restituire all'amico 30.000 unità di metallo (ovviamente), 50.333 unità di cristallo ed infine 25.166 unità di deuterio.

Questo esempio fa vedere come è possibile gestire in modo più complesso il tool nella terza area. Come nell'esempio precedente sono state selezionate le due risorse da convertire, ma è stata immessa una quantità di metallo che, notare bene, non è inclusa nei materiali che si vogliono ottenere.
Il comportamento del tool a questo punto è il seguente: dopo aver convertito le unità di partenza tutte in metallo, come è solito fare, ottenendo quindi 181.000 unità di metallo, a queste vengono sottratti le 30.000 unità di metallo preimpostate quindi 181.000-30.000=151.000).
La quantità di metallo che viene equamente distribuita tra cristallo e deuterio è quindi 151.000, ottenendo quindi 75.500 unità di metallo da convertire in cristallo (50.333) e altri 75.500 da convertire in deuterio (25.166).
Inutile dire che la somma totale delle risorse convertite (metallo incluso) equivale il valore iniziale, secondo i tassi di conversione vigenti (e arrotondamenti vari).

Iside mette in vendita 80.000 unità di deuterio e vuole un misto di cristallo e metallo. Amon-Ra ha abbondanza di entrambi, ma preferirebbe cedere una quantità maggiore di metallo all'amica.
Egli quindi inserisce le 80.000 unità di deuterio che Iside offre e seleziona la conversione con cristallo e metallo; avendo letto accuratamente il fantastico manuale utente di OGCH, sa che il tool convertirebbe al 50% di valore il deuterio tra metallo e cristallo. Volendo offrire più metallo che altro, Amon-Ra preinserisce nella casella del metallo della terza area una quantità di 50.000 unità di metallo. Fatto ciò esegue la conversione.
Amon-Ra ottiene 145.000 unità di metallo e 63.333 unità di cristallo, che deve inviare all'amica.

OGCH suddivide sempre equamente le quantità che convertire e per ora non c'è nessun modo di preferire una quantità ad un'altra nel meccanismo di conversione (funzione futura?).
Questo esempio è molto simile al precedente, salvo il fatto che la quantità preimpostata fa parte dell'insieme dei materiali che si vogliono ottenere. Il tool non si comporta diversamente: la quantità preimpostata viene convertita in metallo (in questo caso è già metallo) e sottratta dal quantitativo totale di metallo del lotto di partenza convertito. Poi abbiamo la solita equa suddivisione tra le risorse selezionate.
Visto che il metallo preimpostato fa parte dei materiali da convertire, questo "smuove" la conversione verso una maggiore quantità di metallo piuttosto che di cristallo. Se non fosse stata preimpostata nessuna quantità di partenza, la conversione avrebbe portato quantità pari a 120.000 unità di metallo e 80.000 unità di cristallo.
Preimpostare le quantità permette anche di convertire in modo non equo le risorse. Non mi soffermo su altri esempi del genere, ma è possibile preimpostare più tipi di risorse contemporaneamente, sia facenti parte delle unità da convertire che non.

Amon-Ra vuole commerciare con Iside agevolandola, permettendo alla ragazza di guadagnare leggermente di più da tali scambi. Iside cerca metallo in grandi quantità ed offre molto deuterio; mette quindi in vendita 70.000 unità di deuterio. Amon-Ra si offre quindi di comprare il deuterio ad un valore diverso dal solito 3:1 (3 di metallo stanno ad 1 di deuterio) ma fornendo un più vantaggioso (per Iside) tasso di 3.2:1 (3,2 unità di metallo stanno a 1 di deuterio). Quindi serve più metallo per avere la stessa quantità di deuterio... in pratica il valore del deuterio è aumentato.
Amon-Ra inserisce l'offerta di Iside, 70.000 unità di deuterio, e cambia i fattori di conversione del metallo da 3 a 3.2 nella prima area. Dopo la conversione, Amon-Ra saprà che dovrà dare ad Iside 224.000 unità di metallo.

Questo esempio è molto semplice. Se i fattori fossero simasti gli stessi, il metallo da offrire sarebbe stato inferiore: solo 210.000. Il regolamento di OGame permette di oscillare leggermente dai dal valore prestabilito dei materiali: con OGCH potete sapere quanto oscillare senza cadere in pericolo di ban per pishing.

In che modo vengono controllati i miei possibili errori?

OGCH esegue vari controlli per evitare errori. Come è naturale, ogni area di inserimento dati è fatta per contenere numeri e nient'altro: è possibile scrivere direttamente un numero o eseguire un'operazione che verrà trasformata nel risultato finale. Le aree atte a contenenre grandi usano un separatore per le migliaia.
I tassi di conversione hanno un doppio livello di controllo. Il primo vuole che sia rispettato l'assioma per cui M : C : D dove vale sempre M>=C>=D.
Il secondo livello di controllo è dinamico e dipende da un file XML di configurazione esterno. Se questo file non viene trovato, questa funzionalità viene disattivata. Il suo scopo e avvertire l'utente quando i tassi che sta utilizzando stanno uscendo dal regolamento del commercio utilizzato dai gestori di OGame.
In questo caso l'icona informativa che mostra il regolamento di commercio vigente cambia e mostra il motivo dell'errore; cambiano anche i colori delle aree di testo dove è possibile inserire i tassi per ogni tipo di risorsa. Se per esempio un'impostazione sbagliata del valore del metallo viola le regole di scambio tra metallo e cristallo, queste due aree diverranno rosse fino alla correzione.
E' comunque possibile ignorare l'avvertimento e proseguire nel calcolo dello scambio.

Configurare le regole commerciali

Cosa devo sapere sulla configurazione delle regole commerciali?

Dalla versione 0.2, OGCH utilizza una tecnologia piuttosto nuova, Ajax, che arricchisce enormemente le applicazioni Javascript. Questo mi permette di scaricare un file XML di configurazione delle regole commerciali ed impostare quindi alcuni parametri del tool.
Se il file non viene trovato (mancanza di una connessione Web, errore nel file stesso, etc...) il tool disattiva queste funzionalità avanzate.

Analizziamo il sorgente del file.
All'interno dell'elemento ogch-rules vengono fornite due date. rule-date rappresenta la data delle regole utilizzate (di solito cambia col cambio dei regolamenti) mentre file-date è la data della versione del file XML utilizzata (cambia se vengono effettuate modifiche al file XML).

Di seguito ci possono essere più elementi version. Il tool li scorre tutti fino a trovarne uno opportuno, controllando l'attributo valid-until.
Per esempio: un valore di valid-until uguale a 0.3 significa che tutte le versione del tool fino alla 0.2 compresa utilizzeranno quel blocco di informazioni. La versione 0.3.1 invece passerà oltre.
Questo mi permette di mantenere la compatibilità con le vecchie versioni del tool nel caso nel futuro anche la struttura del file XML cambi. Sarà quindi mia buona norma aggiornare le informazioni di tutti i campi versione.

L'elemento info contiene informazioni testuali sulla versione, l'autore e commento.

L'elemento general-rapp è molto importante in quanto imposta i valori predefiniti dei tassi di scambio utilizzati dal tool.

Segue poi una serie di elementi change-rate, differenziati dall'attributo type, che rappresentano le vere e proprie regole utilizzate per il commercio: per ogni coppia di risorse viene specificato il guadagno minimo e massimo che si può mantenere senza cadere nel fenomemo del pushing, che su ogame.it è punibile con il ban dal gioco.
Queste sezioni sono quelle che maggiormente risentono del cambio del regolamento di gioco.

Cosa devo sapere sulla configurazione delle opzioni?

Sfruttando la stessa tecnologia con cui sono possibili le impostazioni delle regole commerciali, OGCH permette anche di personalizzare alcune caratteristiche dell'interfaccia.

Avete un'alleanza? Volete fornire ai vostri membri il tool mantenendo però traccia del fatto che si sta usando quello della vostra ally? Non vi piacciono alcune scelte dei fogli di stile usati? Il vostro browser è poco conosciuto e OGCH non funziona perfettamente?

Avete due strade possibili!
Ancora una volta, la prima è quella di scaricarvi i sorgenti del tool e personalizzarvi tutto quello che volete, ma è un lavoro che dovrete ripetere ogni volta che una nuova versione del tool verrà fornita, oltre al fatto che dovrete per forza conoscere HTML, Javascript e capire il mio codice (sono stato il più chiaro possibile, ad ogni modo!). Quello che consiglio è invece costruirvi un vostro file XML di configurazione, dove potrete specificare tutte le opzioni che desiderate per rendere l'interfaccia del tool più gradita a voi e ai vostri compagni!
Una volta costruito questo file XML non dovrete fare altro che cambiare l'URL con cui caricate il tool per indicare che volete utilizzare delle opzioni non standard.

Il caricamento del file di configurazione avviene tramite la specifica di un URL di caricamento del tool differente da quello descritto in precedenza:

L'esempio precedente è riportato solo per farvi capire il funzionamento... per manterene la compatibilità con browser Opera dovremmo in realtà cambiare il codice come segue:

Questo è di certo meno leggibile ma è piuttosto semplice da realizzare... ho semplicemente sostituito ogni carattere "/" con un "%2f". Se questo non viene fatto, gli utenti di Opera non riusciranno ad utilizzare le vostre opzioni e visualizzeranno anche scorrettamente il tool (l'effetto che ho sperimentato è il mancato caricamento dei CSS).
Il risultato è il caricamento a schermo interno del tool personalizzato per l'Alleanza Anubis (per la visualizzazione a finestra il concetto non cambia).
Ogni effetto non comune che vedete in questa finestra verrà ora spiegato.

Analizziamo il sorgente del file.
All'interno dell'elemento ogch-options viene fornita una data nell'elemento date, che rappresenta la data della versione del file XML utilizzato (dovrebbe cambiare alla modifica del file XML).
Come per la configurazione delle regole commerciali, ci possono essere più elementi version che vengono controllati in ordine fino a trovare il primo opportuno.

L'elemento info contiene ancora informazioni testuali sulla versione come l'autore e un possibile commento.

Seguono poi una serie di informazioni che caratterizzano l'interfaccia:
l'intestazione cambiera da "OGame Commercial Helper" a "OGCH - XXXX" in base al contenuto dell'elemento.

Seguono una serie di elementi che permettono di modificare i CSS caricati dal tool dinamicamente. E' possibile quindi sostituire alcuni o tutti i fogli di stile dell'interfaccia per personalizzarne vari aspetti.
Utilizzando l'elemento custom-css-url è possibile anche aggiungere un nuovo CSS completamente che non sovrascrive ma si somma a quelli esistenti (standard o sostituiti da opzioni precedenti).

Finiamo con due importantissime opzioni: commerce-xml-rule-url e commerce-xml-rule-filepath di cui è necessario specificarle entrambe per ottenerne il funzionamento.
Queste opzioni sono un url e un percorso (anche solo il nome del file) che possono individuare un file XML nel Web nello stesso formato di commrate.xml analizzato al punto precedente. Viene in questo modo permesso di specificare un nuovo sorgente per le regole commerciali utilizzate dal tool, diverso da quello che gestisco personalmente.

Perché usare (e sviluppare) i file di configurazione?

Il file delle opzioni generiche è stato fornito per permettere le più comuni personalizzazione senza perdere il potere della compatibilità e dell'aggiornamento. Mi piacerebbe davvero molto che le alleanze che utilizzano il tool scegliessero i loro colori, magari legati alla home page o al forum dell'alleanza dove OGCH viene utilizzato.

La questione delle regole commerciali e grosso modo la stessa... magari alcune alleanze vorranno usare tassi di scambio diversi (direi più restrittivi) per i propri commerci interni.
In ques'ultimo caso però sento anche il bisogno di fornire uno strumento che non debba essere aggiornato ad ogni cambio delle regole di ogame.it... anzi... non deve nemmeno essere legato ad ogame.it in quanto le regole non dipendono dall'implementazione!

Potrei anche stancarmi supportare OGCH prima o poi... non è impossibile... il tool perderebbe quindi della possibilità di ottenere nuove funzionalità (anche se chiunque potrebbe prendere il mio posto... il bello del mondo Open Source!) ma non di funzionare correttamente con quello che ha già.

Che casino! Dove posso mettere il file di configurazione personalizzato della mia alleanza?

Sono disposto ad ospitare i file di configurazione e anche i folgi di stile personalizzati, le immagini...
. Per capire come andare alla sezione della Gilda dei Mercanti nelle impostazioni di OGCH.

OGCH -- Help della versione 0.3

Informazioni generali

Cosa si può dire di OGCH in breve?