Installation von VGA-Planets 68k
--------------------------------

1) Erstinstallation

Je nachdem, wo das ursprngliche VP68KINS entpackt wurde, sollten jetzt fol-
gende Dateien in einem gemeinsamen Verzeichnis vorliegen:

INSTALL .PRG       /* ein einfaches Installationsprogramm
INSTALL .TXT       /* dieser Text
PLANETS .PRG       /* das Hauptprogramm
README  .TXT       /* zustzliche Hinweise
VGAP68K .TOS       /* die Daten des Spiels
VPxxxxx .KEY       /* Schlsseldatei fr Registrierung (*)
VPSHELL .PRG       /* Eine Shell fr VGA-Planets 68k
DEMOGAME.TOS       /* RST-Files zum Ansehen
VPL_ICON.CNF       /* diverse Icons fr den Gebrauch mit der EASE

(*) Optional, nur falls es sich um eine registrierte Version handelt.

Die Installation beschrnkt sich (mehr oder weniger) auf ein simples Entpacken
des vorliegenden VGAP68K.TOS. Dabei wird die komplette Verzeichnisstruktur
angelegt und die Dateien da hin kopiert, wo sie hingehren. Die Daten sollten
NICHT in werweiwie verschachtelte Verzeichnisse gepackt werden, da es ansonsten
zu Problemen bei der bergabe von Pfadnamen/Parametern zwischen Shell und
Programm kommen kann (kein ARGV!). Ein Dateipfad wie

E:\ATARI\GAMES\STRATEGI\WELTRAUM\VGAP68K\

wre eher ungeschickt....

Am einfachsten ist die Installation, wenn das beiliegenden INSTALL.PRG benutzt
wird. Hier ist lediglich der zu verwendende Hauptpfad anzugeben, der Rest ge-
schieht dann automatisch.

Wer aus irgendwelchen Grnden 'zu Fu' installieren will, sollte folgende 
Dateistruktur einhalten:

\VGAP\                    /* Hauptverzeichnis
      GAME01\             /* 14 Spielverzeichnisse fr ver-
      GAME02\             /* schiedene Spiele
      GAME03\
      GAME04\
      GAME05\
      GAME06\
      GAME07\
      GAME08\
      GAME09\
      GAME10\
       GAME11\
      GAME12\
      GAME13\
      GAME14\
      SOUNDS\           /* HSN-Dateien fr Soundausgabe
    + BEAMSPEC.DAT      /* Angaben ber Waffen
    + ENGSPEC .DAT      /* Angaben ber Triebwerke
    + HULLSPEC.DAT      /* Angaben ber Rmpfe
    + PLANET  .NM       /* Planeten-Namen
    # PLANETS .68K      /* Konfigurationsdaten
      PLANETS .PRG      /* das eigentliche Programm
      PLNHELP .DAT                      /* Online-Hilfe-Datei
    + RACE    .NM       /* Rassen-Namen
      REG     .KEY      /* Registrierungsschlssel-Datei (*)
      RESOURCE.PLN      /* Grafikdaten
      STORM   .NM       /* Namen von Ionen-Strmen (ab Host 3.2)
    + TORPSPEC.DAT      /* Angaben ber Torpedowaffen
    + TRUEHULL.DAT      /* Zuordnungen Rassen <-> Rmpfe
    # VGAP68K .CFG      /* Konfigurationsdaten fr VPShell
      VPSHELL .PRG      /* Shell-Programm fr VGAP68k
    # VP_DEBUG.INF      /* Statusmeldungen fr Debugging-Zwecke
    + XYPLAN  .DAT      /* X/Y-Positionen aller Planeten

Zustzlich werden im Verlauf des Spiels noch weitere Dateien dazukommen:

\VGAP\GAMExx\TURNnnn\     /* Von VGAP68k angelegtes Verzeichnis 
                                           wenn KEEP_BACKUP in der Shell aktiv
           #         PLAYERpp.RST       /* Sicherheitskopien des Spielzugs
           #         PLAYERpp.TRN                         "
           #         UTILpp  .DAT                         "

\VGAP\GAMExx\
             BDATApp .DIS               /* Basedaten aus aktuellem RST
             BDATApp .DAT               /* Basedaten nach Bearbeitung
             PDATApp .DIS               /* Planetendaten aus RST
             PDATApp .DAT               /* Planetendaten nach Bearbeitung
             SHIPpp  .DIS               /* Schiffsdaten aus RST
             SHIPpp  .DAT               /* Schiffsdaten nach Bearbeitung
             SHIPXYpp.DAT               /* XY-Schiffsdaten aller Schiffe
             MDATApp .DAT               /* Nachrichten aus RST
             MESSpp  .DAT               /* Selbstgeschriebene Nachrichten
             TARGETpp.DAT               /* gesichtete Feindschiffe aus RST
             UFOpp   .HST               /* AddOn-Daten (Asteroiden etc.)
             UTILpp  .DAT               /* Zustzliche Infos (PHost only)
 
             METEOR  .DAT               /* Daten ber Meteor-Niedergnge (global)
             MINES   .HST               /* Daten ber Minenfelder (global)
             PDATA   .HST               /* Planetendaten-Datei (global)
             SCRAPPED.HST               /* Daten ber zerstrte Schiffe (global)
             S_MOVES .HST               /* Schiffsbewegungen (global)
             WORMHOLE.HST               /* Entdeckte Wurmlcher (global)

             AUTOBLDp.DAT               /* Autobuild-Vorgaben fr Rasse p (10=A)
             AUTOpp  .LOG               /* Autobuild-Logfile aktueller Zug
             BORDERpp.68K               /* Grenzverlufe Rasse pp
             COURSEpp.DAT               /* Long Waypoints Rasse pp
             NOTESpp .DAT               /* Notiz-Datei Rasse pp
             PLpp_tt .RPT               /* Planet-Report Player pp Turn tt
             SHpp_tt .RPT               /* Ship-Report Player pp Turn tt
             SBpp_tt .RPT               /* Starbase-Report Player pp Turn tt

C:\CLIPBRD\                   /* oder wo immer scrapdir() nun liegt
             VPPLAN  .CSV     /* Planetendaten als CSV-Datei
             VPSHIPS .CSV     /* Schiffsdaten als CSV-Datei
             VP_SBASE.CSV     /* Starbase-Daten als CSV-Datei

Die CSV-Dateien knnen als 'comma separated values' z.B. in Texel, K-Spread 
oder hnliche Programme importiert werden, um sie dann in einer Tabelle weiter-
zubearbeiten.

Erluterungen:

pp  Rassen-ID (falls einstellig, dann 1-9 und 10=A und 11=B)
tt  Turn-Nr.

(#) Diese Dateien werden von den Programmen angelegt
(+) Diese Dateien knnen (mssen) bei Spielen mit alternativer Schiffsliste und
    oder alternativem Universum in das entsprechende Spielverzeichnis verlegt
    werden. Bei derartigen Spielen werden die entsprechenden Dateien blicher-
    weise vom Host an die Spieler ausgegeben. VGAP68K versucht grundstzlich 
    zuerst, diese Dateien aus dem aktuellen GAMExx-Verzeichnis zu lesen, nur
    wenn sie da nicht gefunden werden, werden die aus dem Hauptverzeichnis
    benutzt.

Wie zu sehen ist, knnen die im Laufe des Spiels generierten Dateien recht
Platz-Intensiv werden. Wer KEEP_BACKUPS aktiviert hat, mu damit rechnen, da
sein VGAP-Verzeichnis pro gespielter Rasse in 50 Turns um ca. 3MB 'wchst'. Die
Report-Dateien knnen in spteren Turns auch schon mal ca. 200 Kb pro Rasse ein-
nehmen. Da diese ebenfalls turnweise gespeichert werden, empfiehlt es sich, sie
zu lschen, nachdem man sie nicht mehr braucht. Dies ist brigens die erste
Version, bei der das Abschalten von KEEP_RST in der VP-Shell tatschlich etwas
bewirkt. Alle frheren Betaversionen von VGAP68k haben die RSTs/TRNs IMMER
gesichert, unabhngig davon, was in der Shell angegeben war. Gerade in der jetzt
begonnenen, ffentlichen Betatest-Phase wre es mir allerdings lieb, wenn dieser
Parameter bei jedem Spieler trotzdem auf ON stehen wrde, da sich auftretende
Probleme wesentlich besser lokalisieren lassen, wenn das entsprechende RST-File
vorliegt.

2) Neuinstallation oder Verschieben auf ein anderes Laufwerk

Im Prinzip ist nur ein simples Verschieben (via Desktop oder wo auch immer) er-
forderlich, um VGAP68k ein neues Zuhause zu geben. Es sollte jedoch darauf ge-
achtet werden, da die Datei \VGAP\PLANETS.68K entweder komplett gelscht, oder
zumindest der Eintrag MAINDATA= auf den aktuellen Stand gebracht wird, da an-
derenfalls die Spieldaten nicht mehr gefunden werden.

3) Probleme

Frhere Versionen der VP-Shell hatten Probleme, wenn der fr das einzelne Spiel
angegebene RST-Download-/TRN-Upload-Pfad auf das eigentliche Spielverzeichnis
(also z.B. GAME01) verwies, da die Spieldateien vor dem Entpacken grundstzlich
erstmal vom Downloadpfad in das Spielverzeichnis kopiert werden. Die aktuelle
Version hat dieses Problem zwar nicht mehr, es ist aber trotzdem keine unge-
schickte Idee, fr jedes Spiel ein separates Up-/Downloadverzeichnis anzugeben,
da in spteren Versionen der Shell auch UUE/UUD und ein oder mehrere Packer 
aufgerufen werden knnen. Wenn dann die neu reingekommenen bzw. die auszusen-
denden Dateien in einem separaten Verzeichnis liegen, macht es das Handling 
bei play-by-pm-Spielen um einiges bersichtlicher.

Soweit zur Installation. Viel Spass mit VGA-Planets 68k, und mgen die besseren
gewinnen >:-)


Martin Eggers                     1.1.96

