----------------------------------------------------------------------
                    SHIPS 98 [versione 2.00.008]
----------------------------------------------------------------------
By Maurizio Benvenuti
Copyright 1997-2000, Tutti i diritti riservati
----------------------------------------------------------------------

 Indice
 =======
 1. Introduzione
 2. Installazione
 3. Utilizzo di Ships 98
 4. Modica di una lista di navi
 5. Il checksum
 6. Il file Ships98.dat
 7. Domande, suggerimenti ed rapporto errori
 8. Ringraziamenti
 9. Note finali


1. Introduzione
===============
Questo programma vi permette di conoscere tutto al riguardo delle
liste delle navi che state utilizzando nelle vostre partite di
VGA Planets.

Il termine "lista di navi" si riferisce all'insieme dei file che
definiscono gli scafi, le armi e i motori. In pratica i cinque
file dati utilizzati da Ships 98 sono una lista di navi.
Perche' una nuova lista di navi funzioni correttamente, SIA l'host
SIA i giocatori DEVONO utilizzare gli STESSI file che definiscono
la lista di navi. Una nuova lista di navi non funzionera' se solo
i giocatori (o l'host) la stanno utilizzando.
E' possibile modificare la lista delle navi in una partita gia'
in corso, ma non  consigliabile. I giocatori e l'host dovrebbero
aggiornare i loro file della lista delle navi nello STESSO turno.
Se l'host utilizza una lista di navi diversa ci saranno gravi
problemi per i giocatori nel turno successivo.


2. Installazione
=================
Ships 98 non necessita di installazione, potete metterlo ovunque.
Ricordate: i tre file inclusi in questa distribuzione devono
           risiedere nella stessa cartella.

Ships98 richiede solo il percorso a questi cinque file:

HULLSPEC.DAT : Questo file contiene i dati riguardanti i 105 scafi.
               I dati contenuti includono i minerali, la dimensione
               della stiva di carico e del serbatoio del carburante,
               come pure il numero di membri dell'equipaggio, armi
               e motori.

TORPSPEC.DAT : Questo file contiene tutti i dati dei lancia-siluri.
               Ci sono 10 tipi di lancia-siluri. I dati contenuti
               includono anche il costo di ogni siluro di ogni tipo.

BEAMSPEC.DAT : Questo file contiene tutti i dati delle armi a raggi.
               Ci sono 10 tipi di armi a raggi.

ENGSPEC.DAT  : Questo file contiene tutti i dati dei motori.
               Ci sono 9 tipi di motori. I dati contenuti includono
               la quantita' di carburante che ogni motore consuma
               alle diverse velocit selezionabili.

TRUEHULL.DAT : Questo file contiene tutte le informazioni necessarie
               a VGA Planets per stabilire quali navi ogni razza puo'
               costruire. Ogni razza ha 20 slot per gli scafi, ma non
               e' obbligatorio utilizzarli tutti. Gli slot contengono
               i numeri degli scafi che la razza pu costruire.

Questi file sono presenti in tutte le distribuzioni di VGA Planets.
Potrete trovarli nella cartella principale di VGA Planets.
E' preferibile effettuare un backup di questi file e metterli al
sicuro in caso vengano danneggiati.


3. Utilizzo di Ships 98
========================
Quando Ships 98 viene avviato, carica la lista delle navi presente
nella cartella specificata. E' possibile avviare Ships 98 inserendo
un percorso dalla linea di comando (es: SHIPS98 c:\planets).
Se solo uno dei cinque file richiesti non  presente nel percorso
inserito, Ships 98 mostrer il nome del file del file mancante e
richieder di inserire un nuovo percorso.

Se presente, il file HCONFIG.HST verr caricato, come pure il file
RACE.NM. Se il file RACE.NM non  presente, verranno utilizzati i
nomi standard delle razze.
Ships 98 ricerca inoltre il file RESOURCE.PLN (prima nel percorso
specificato, poi nella cartella corrente). Se questo file non 
presente Ships 98 non potr visualizzare le immagini degli scafi.

Ships 98, dopo la fase di caricamento, mostra quattro schede:
Scafi, Motori, Armi a raggi e Lancia-siluri

Selezionate la scheda "Scafi" oppure premete ALT+S per visualizzare
 i dati degli scafi.
 Il riquadro principale mostra l'immagine dello scafo e le sue
  specifiche. Utilizzate i piccoli pulsanti con le frecce oppure
  i tasti Sinistra/Destra per sfogliare la lista degli scafi.
 Il riquadro "Progetto disponibile a" mostra quali razze possono
  costruire lo scafo corrente. Cliccate con il tasto destro del
  mouse sul nome di una razza per visualizzare un menu contenente
  la lista degli scafi correntemente assegnati a quella razza,
  cliccate su uno di questi scafi per visualizzarne le specifiche.
 Il riquadro "Abilita' speciali - Host 3.22" mostra le abilita'
  speciali che l' HOST 3.22 attribuisce allo scafo selezionato.
  Se il file HCONFIG.HST e' stato caricato e l'abilita' speciale
  e' attiva, un segno di spunta verra' mostrato all'interno della
  relativa casella.

Selezionate la scheda "Motori" oppure premete ALT+M per visualizzare
 i dati dei motori.
 Il riquadro principale mostra le specifiche del motore. Utilizzate
  i piccoli pulsanti con le frecce oppure i tasti Sinistra/Destra
  per sfogliare la lista dei motori.
 Il grafico a destra visualizza i dati del consumo di carburante
  del motore selezionato.

Selezionate la scheda "Armi a raggi" oppure premete ALT+A per
 visualizzare i dati dei motori.
 Il riquadro principale mostra le specifiche dell'arma a raggi.
  Utilizzate i piccoli pulsanti con le frecce oppure i tasti
  Sinistra/Destra per sfogliare la lista delle armi a raggi.
 Il grafico a destra visualizza i dati della potenza dell'arma a
  raggi selezionata.

Selezionate la scheda "Lancia-siluri" oppure premete ALT+L per
 visualizzare i dati dei lancia-siluri.
 Il riquadro principale mostra le specifiche del lancia-siluri.
  Utilizzate i piccoli pulsanti con le frecce oppure i tasti
  Sinistra/Destra per sfogliare la lista dei lancia-siluri.
 Il grafico a destra visualizza i dati della potenza dei siluri
  del tipo del lancia-siluri selezionato.

Ships 98 mostra inoltre una barra dei menu:
File, Opzioni e ? (Guida).

Selezionate il menu "File" oppure premete ALT+F per:
 * Caricare una lista di navi.
 * Salvare la lista di navi corrente, se modificata.
 * Salvare la lista di navi corrente, se modificata, in una cartella
   diversa.
 * Esportare la lista di navi corrente come file di testo.
 * Calcolare il checksum corrente.
   (dettagli nella sezione "Il checksum")
 * Uscire da Ships 98.
   Questa opzione si puo' attivare dalla finestra principale
   premendo ALT+X.

 Nota: se la lista delle navi corrente  stata modificata e
       selezionate "Apri..." oppure "Esci", Ships 98 avvertir
       che sono state effettuate delle modifiche e chieder
       se salvare la lista delle navi.

Selezionate il menu "Opzioni" oppure premete ALT+O per:
 * Visualizzare il preventivo del costo di costruzione di una
   nave del tipo dello scafo selezionato.
 * Visualizzare le abilita' extra dello scafo selezionato (dettagli
   nella sezione "Il file Ships98.dat")
 * Modificare l'oggetto corrente (scafo, motore, arma a raggi o
   lancia-siluri). (dettagli nella sezione "Modica di una lista
   di navi")
 * Assegnare lo scafo corrente ad una razza.
   Questa opzione si puo' attivare dalla finestra principale
   premendo ALT+P.

Selezionate il menu "?" oppure premete ALT+? per:
 * Visualizzare questa guida.
 * Visualizzare le informazioni sul copyright.


4. Modica di una lista di navi
===============================
Le quattro finestre di modifica (scafi, motori, armi a raggi o
lancia-siluri) funzionano alla stessa maniera.
Ogni finestra di modifica presenta:
  * un'area client per visualizzare i dati correnti.
  * due piccoli pulsanti nella barra del titolo per sfogliare gli
    oggetti. (E' possibile utilizzare anche i tasti Sinistra/Destra)
  * un pulsante "OK" per confermare le modifiche e chiudere la
    finestra di modifica.

Utilizzate i tasti Su/Giu' per navigare attraverso le specifiche
dell'oggetto corrente e premete il tasto Invio per modificare il
valore selezionato.
Premere ESC per annullare le modifiche e chiudere la finestra di
modifica.

Nota: la finestra di modifica degli scafi mostra inoltre l'immagine
      dello scafo selezionato e presenta altri due piccoli pulsanti
      per sfogliare la lista delle immagini (e' possibile utilizzare
      anche i tasti Sinistra/Destra) ed integra un sistema di
      appunti:
       * CTRL+INS per copiare lo scafo selezionato negli appunti
       * SHIFT+INS per incollare il contenuto degli appunti nello
         scafo selezionato
       * ALT+INS per scambiare i dati contenuti negli appunti con
         i dati dello scafo selezionato


5. Il checksum
===============
Quando Planets carica la lista delle navi effettua il calcolo del
checksum sui file. Se il checksum e' errato Planets pensera' che
i file dati siano stati danneggiati.
Ships 98 aggiusta automaticamente il checksum della lista delle
navi quando questa viene salvata.
In certe condizioni potrebbe essere impossibile correggere il
checksum. In questi casi Ships 98 provvedera' ad avvertirvi.
Se Ships 98 riporta che il valore del checksum e' troppo alto,
provate allora a convertire in maiuscolo i nomi degli scafi, dei
motori e/o delle armi.
Anche ridurre la lunghezza dei nomi potrebbe aiutare.
Se Ships 98 riporta che il valore del checksum e' troppo basso,
provate allora a fare il contrario. In aggiunta, aumentare i
valori inferiori a 255 fino a 255, potrebbe essere una soluzione.


6. Il file Ships98.dat
=======================
Questo file e' utilizzato per immagazzinare e mostrare le abilita'
addizionali supportate dai vari addons utilizzati nelle vostre
partite di VGA Planets.

Questo file deve avere un'intestazione fissa :   [Abilities]

seguono poi delle linee di testo strutturate come:

nhull = 1 abilita' extra | 2 abilita' extra | ecc...
   (|  il carattere pipeline)

---Esempio:-------------------

[Abilities]

22=Megalaser|Celle Criogeniche


------< End of Extract >------

Nota: Ships 98 aggiornera' automaticamente i vecchi file Ships97.dat
      al nuovo formato.


7. Domande, suggerimenti ed rapporto errori
============================================
Questo programma e' stato ampiamente testato. Sono abbastanza sicuro
che sia esente da errori, comunque se ne riscontrate uno mandatemi
un'e-mail.
Per qualsiasi domanda mandatemi un messaggio a zeross.mauri@tin.it


8. Ringraziamenti
==================
A Tim Wisseman per il suo aiuto e per VGA Planets.
Il sito ufficiale di VGA Planets e':
http://www.wilmington.net/vgaplanets


9. Note finali
===============
Controllate la pagina di Ships 98 per le ultime novita':
http://www.geocities.com/TimesSquare/Battlefield/5544/shipsit.html

Il software contenuto in questa distribuzione puo' essere utilizzato
gratuitamente e puo' essere distribuito liberamente, ma deve sempre
essere distribuito non modificato e con tutti i file che lo
compongono, incluso questo documento.

E' assolutamente vietato decompilare, deassemblare o modificare
in alcun modo il software contenuto in questa distribuzione.

Il prodotto software e ogni tipo di documentazione ad esso relativa
sono forniti "cosi' come sono", senza alcuna garanzia di qualsiasi
tipo, sia espressa che implicita, ivi incluse, senza limitazioni,
le garanzie implicite di commerciabilit o idoneita' per uno scopo
particolare ovvero quelle che escludano la violazioni di diritti
altrui. L'intero rischio derivante dall'uso o dalle prestazioni
del prodotto software rimane a carico dell'utente.
In nessun caso l'autore di questo software sara' responsabile per
i danni diretti, incidentali o conseguenti all'utilizzo di questo
prodotto software, anche nel caso l'autore sia stato informato
della possibilita' del verificarsi di tali danni.

----------------------------------------------------------------------
