Loading...   

[Show Table of Contents]


EQEmu Zone Utilities are a suite of tools to manipulate zone geometry files.

 

§Release

The latest releases for EQEmu Zone Utilites are available at: https://github.com/EQEmu/zone-utilities/releases.

 

§azone

AZone reads in a geometry file and outputs a map file that can be loaded by the EQEmu server software and is then used for collision detection purposes.

Usage:

$ ./azone zone_name1 zone_name2 etc 

AZone will look within the current directory for each zone_name you pass it and attempt to open the files with one of three loaders in the following order:

  • EQG Standard
  • EQG Terrain (v4)
  • S3D

This is the same order in which eqgame attempts to load zone files.

Example:

$ ./azone nektulos tutorialb qeytoqrg

This will load and output the following files

  • nektulos.eqg -> nektulos.map
  • tutorialb.eqg -> tutorialb.map
  • qeytoqrg.s3d -> qeytoqrg.map

Each of these map files may then be copied to the server's maps directory to be used by the server.

 

§awater

AWater reads in a geometry file and outputs a water map file that can be loaded by the EQEmu server software and is then used for area detection purposes.

Water maps are a bit of a misnomer as they handle more than water volume data but rather all marked area volumes.

Usage:

$ ./awater zone_name1 zone_name2 etc 

AWater will look within the current directory for each zone_name you pass it and attempt to open the files with one of three loaders in the following order:

  • EQG Standard
  • EQG Terrain (v4)
  • S3D

This is the same order in which eqgame attempts to load zone files.

Example:

$ ./awater nektulos tutorialb qeytoqrg

This will load and output the following files

  • nektulos.eqg -> nektulos.wtr
  • tutorialb.eqg -> tutorialb.wtr
  • qeytoqrg.s3d -> qeytoqrg.wtr

Each of these wtr files may then be copied to the server's maps directory to be used by the server.

§pfs

PFS is a command line utility for manipulating pfs (S3D/EQG) files.  It works similarly to S3DSpy but from a command line.

The usage is modeled loosely after 7-Zip's command line utility for familiarity:

pfs [<switches>...] <command> <command args>... <archive_name> [<file_names>...]
<Switches>
 -i=dir: Set input directory
 -o=dir: Set output directory
<Commands>
 a: Add files to archive
 d: Delete files from the archive
 e: Extract files from the archive
 l: List contents of the archive
 <Command Args>
  arg1: Only search for files with this extension, may use * as a wildcard meaning all extensions
 u: Update files of the archive

 

§map_view

Map View is a utility that will attempt to load map and wtr files and then render them to a 3D view.

 

Usage:

$ ./map_view nektulos

This will attempt to load nektulos.map and nektulos.wtr

 

§Controls

You may use the mouse and WSAD for movement.

Holding shift will increase the speed you move within the world drastically.

N toggles rendering of non-collidable geometry.

C toggles rendering of collidable geometry.

V toggles rendering of area volumes.

 

§Troubleshooting

If you're having trouble with getting a zone to render here are some things to check:

  • Your graphics card and drivers support OpenGL 3.3 or 3.0 (you need to specify within CMake for a special 3.0 build)
  • The program can see the shaders/ directory and has the shaders files within it.
  • The program can see the map and wtr files you are attempting to load.