# JMiniApp Version 1.00 - Using the Jet3D engine!

## Contents

- Overview
- Features
- Operating Guidelines
- Installation Notes
- System Requirements
- Links
- Legal Stuff
- Honorable Mentions

## Overview

The idea was to provide an 'Official' mini-app for all you budding Jet3D developers out there! Just use the Level Selector dialog to choose the level you want to load, then run JMiniApp......simple.
Several levels are included in the download section, although all JEdit levels should be supported.

To really understand what's going on you'll need to go to the official Jet3D Homepage and download the Jet3D SDK which includes the level editor JEdit.

Controls: The cursor keys allow you to walk around, TAB for stats and the escape key quits.

## Features

1. All written in nice user-friendly C++.
2. Video device and mode enumeration.
3. Simple camera movement.
4. Error logging.

## Operating Guidelines

The Level Selector application must first be run and a ‘compatible’ Jet3D level chosen, this will create a 'JMiniApp.ini' file in your Windows directory. This is the file that JMiniApp uses to decide which level to load. The compatibility of JMiniApp with levels created from the various versions of JEdit floating about is currently unknown.

## Installation Notes

You must have the following directory structure for the level you want to load. All of these directories must be spelt (they are case sensitive) exactly the same as they are written below.

[A_ROOT_DIRECTORY]\Levels
Contains your level (that you navigated to through the Level Selector dialog).
[A_ROOT_DIRECTORY]\[GlobalMaterials]
Contains all the bitmap/texture resources used by your level.
[A_ROOT_DIRECTORY]\[Sounds]
Contains all ‘WAV’ files used by your level.
[A_ROOT_DIRECTORY]\[Actors]
Contains all ‘actor’ objects used by your level.
Notes: [A_ROOT_DIRECTORY] must be the same for all of the above, for example you cannot have your ‘Sounds’ directory in a different place on your hard-drive than your ‘Levels’ directory.
I believe all of the above resources are also contained in the ‘J3D’ level file itself and therefore this is a duplication of those resources. In any case JMiniApp expects there to be these directories containing all the relevant objects! All of the above (including the directory layout and naming conventions) are part of the standard JEdit installation. You can also download all of these resources from the JMiniApp Home Page which are included with a set of levels.
That takes care of the level side of things now for the JMiniApp application itself.............

JMINIAPP_ROOT_DIRECTORY (this is where you installed JMiniApp on your hard-drive)
This directory should contain the following:
[JMINIAPP_ROOT_DIRECTORY] \JMiniApp.exe
[JMINIAPP_ROOT_DIRECTORY] \Jet3D.dll
[JMINIAPP_ROOT_DIRECTORY]\[objects] (this should contain all the standard Jet3D dll’s)
Notes: It’s very important that the main Jet3D.dll and the dll’s contained in the [objects] subdirectory described above should all be of the same version of the Jet3D that was used to build the JMiniApp executable!

## System Requirements

DirectX 7.0
Win 95/98
3D hardware (for release mode) and a fast CPU!

## Links

The Home of JMiniApp where you'll find an executable of the latest version + Jet3D levels to use with it!
The official Jet3D site
JShell the excellent Jet3D game-shell
AlphaDog's GameWeave project

## Legal Stuff

JMiniApp is free software and comes under the terms of the GNU General Public License.
Jet3D comes under it's own copyright license.

## Honorable Mentions

Countach the man behind the game-shell JShell for writing some decent code and then letting other people learn from it!
Special thanks must go to Incarnadine for his help on the CVS side of things.

Back to Top

This page was last modified on Friday June 09, 2000 00:08:27