================================================================
 EndZone for Windows - 3D Universal Campus
================================================================

WHAT YOU NEED

  1. EndZone.exe            (this folder, ~118 MB)
  2. The campus geometry    (~3.1 GB, copied separately)

EndZone.exe is self-contained - there is nothing to install. The
campus is NOT inside it, because it is 3.1 GB. You copy that
across once, separately, and tell EndZone where you put it.


STEP 1 - COPY THE CAMPUS ACROSS

From a terminal on your PC (PowerShell, or Git Bash, or WSL):

  scp -r mbayne@atmocenter.org:/huge/mbayne/godot_conversion/oar_out  D:\EndZone\

If the transfer drops part-way, rsync can resume where it left off:

  rsync -av --partial --progress \
    mbayne@atmocenter.org:/huge/mbayne/godot_conversion/oar_out/ \
    /d/EndZone/oar_out/

You end up with a folder containing three subfolders:

  oar_out\Terrains     4 files,      72 MB
  oar_out\Solids       2,137 files,  1.0 GB
  oar_out\Phantoms     2,580 files,  2.1 GB

IN A HURRY? Terrains + Solids alone (about 1.1 GB) gives you the
whole walkable campus - every building, floor, wall and desk. The
Phantoms folder is grass and foliage only. You can copy it later
and it will simply start appearing.


STEP 2 - TELL ENDZONE WHERE IT IS

Pick ONE:

  (a) Name the folder  oar_out  and put it next to EndZone.exe.
      Nothing else to do.

  (b) Edit campus_path.txt in this folder and put the full path
      on a line of its own, e.g.   D:\EndZone\oar_out

  (c) Set the environment variable ENDZONE_CAMPUS_DIR.

If EndZone cannot find it, the 3D screen lists every place it
looked, so you can see what to fix.


STEP 3 - RUN IT

Double-click EndZone.exe, log in, then click 3D in the left menu.

Windows SmartScreen will likely warn you, because the program is
not code-signed. "More info" then "Run anyway".


CONTROLS

  W A S D / arrows   walk
  mouse              look around
  Shift              run (or fly fast)
  Space              jump (or fly up)
  Ctrl               fly down
  F                  toggle FLYING  <- use this to reach the upper
                     floor and the dome without finding the stairs
  C                  first person / third person
  Tab                landmarks - ALL TEN CLASSROOMS ARE HERE
  Esc                release the mouse, so you can click BACK
  H                  hide the on-screen help


GETTING INTO THE CLASSROOMS

Press Tab and pick one. You arrive hovering - press F to land and
walk around. The Main Building's ground floor is a corridor with
five classrooms down each side; the whiteboards and screens are on
the corridor-side wall, so you arrive looking at the front of the
class.

The doors are drawn closed but you can walk straight through the
doorways. In the original OpenSimulator world they slid open when
you approached; those scripts do not survive the conversion, so
leaving them non-solid is what stands in for them.


IF IT RUNS SLOWLY

The campus streams in nearest-first, so you can walk immediately
while the rest arrives. A full load is several GB of RAM and a
minute or two.

On a machine with less memory, run it from a shortcut or command
line with one of these after a bare -- :

  EndZone.exe -- --skip-phantoms        buildings only, ~1/3 the data
  EndZone.exe -- --limit=1500           only the nearest 1500 objects
  EndZone.exe -- --landmark=3           start in the Main Building
                                        corridor (also decides what
                                        loads first)

They combine:

  EndZone.exe -- --skip-phantoms --landmark=3


IF IT WILL NOT START

EndZone uses OpenGL (the "Compatibility" renderer). If you get a
blank window or a driver error, update your graphics driver. On
very old Intel chipsets you may need Godot's ANGLE fallback, which
this build does not bundle - say so and it can be rebuilt with it.
