==============================
Open Jedi Project (OJP) Readme
==============================

Basic Release Version:  0.0.2
Enhanced Release Version: Not Released
Vehicles Release Version:  0.0.2
Skins Release Version: 0.0.1

Stuff in this Release:  


JKA Version Required: 1.01

NOTE:  This readme might not be part of an official OJP release since this readme is required to be included in all OJP based projects.  If this isn't an official OJP release, this document will only partially apply.


========================
0000 - Table of Contents
========================

	0000..................Table of Contents
	0001..................Introduction
	0002..................Installation
	0003..................What's New?
	0004..................Features
	     0004.1...........Basic
	     0004.2...........Enhanced
	     0004.3...........Vehicles
	0005..................Using Our Work
	0006..................Submitting Stuff to OJP
	     0006.1...........Submission Guidelines
	0007..................Known Issues
	     0007.1...........Issues with Basic Features
	0008..................Credits
	0009..................Contact Information
	0010..................Legal Stuff

	
	
===================
0001 - Introduction
===================

The Open Jedi Project is a coding/modding collaboration with the intent of maximizing the features and fun factor for all Jedi Knight Academy (JKA) mods.  We work together by contributing fun, interesting, and useful game features so that everyone can benefit.

We operate on what's basically an open source system. Open source basically means that the source code is freely available and accessible by all. See the "Using Our Work" section for details about rights and permissions.

Our design philosophy is to make everything as separated and customizable as possible to allow developers and players to choose what features they wish to use. 

We currently have two distributions (gameplay/code changes), Basic and Enhanced. We also have two packs (non-gameplay related), Vehicles and Skins.

Basic has two main features. One is bug fixes and balance fixes, neither which will severely alter game play. They are designed to be the "unofficial patch" for bugs and game play problems. Basic can still be considered vanilla Jedi Academy. The other main feature is map enhancements. Things such as new entities, expanded AI, vehicles, scripting and effects system can allow mappers to create far more immersive and fun maps. Since Basic also aims towards recreating all the single player entities and code, it is possible for mappers to create full featured cooperative and single player games and levels using the multiplayer engine. This allows modders to make other enhancements such as new weapons, AI, etc., not possible using the single player engine. 

Enhanced is a superset of Basic, meaning it has anything and everything included in the Basic distribution. The difference is that it adds many significant gameplay alterations. It is a playable mod, but also a code base for other developers. To decrease the possibility of mods based off Enhanced loosing originality, we are keeping our game play feature list generic and flexible. New features will be generic, expandable, and flexible so other developers can easily adopt them to their mods. It won't venture out side of Jedi Academy's principle game play, so there won't be anything that makes this drastically unique in terms of pure game play. Players get a full mod that shares the same basic principles and ideas that stock Jedi Academy offers. Developers get a solid, flexible code base that includes the basic, fundamental features you would want to find in most mods, allowing them to spend their time on what makes their work truly unique. An example of a feature for Enhanced would be an extended version of the player class system seen in Siege, one that is available in more game types, and is far more flexible.

The Vehicles package is a collection of additional vehicles for JKA.  We're including them in the project to allow OJP compatible maps to use additional vehicles without having to include said vehicles in their release packages.

The Skins package is a collection of quality modder created skins that have been turned 
into customizable player classes.  We've done this to allow more player options, to 
allow SP useage of these skins, to allow servers and players to quickly get a pack of 
quality skins, and to prevent a lot of redundent data from clogging up your game 
directory.  

We have a web forum set up for OJP.  You can find it at...
http://www.lucasforums.com/forumdisplay.php?s=&forumid=542

We have a website pending.  Please be patient.



===================
0002 - Installation
===================

To Install:

Just unzip this file to your jedi Academy directory.  The current game files will automatically run when you start your game.

To Uninstall:

	Basic:
		Delete ojp_basic_002 from your /GameData/base directory.

	Vehicles:
		Delete the ojp_vehicles_002 from your /GameData/base directory.

	Skins:
		Delete the ojp_skins_001 from your /GameData/base directory.

	OJP Documents:
		Delete the /ojp directory in your /GameData directory.



==================
0003 - What's New?
==================

What's New? has been moved to OJP_changelog.txt


		
===============
0004 - Features
===============


--------------
0004.1 - Basic
--------------

	Bug Fix 001 (BUGFIX1) - Animation.cfg fix for BOTH_WALKBACK2
	Single Player, Animations

	What It Does:
		Fixes an animation bug seen when walking backwards with an ignited single saber in single player by correcting the number of frames
	
	Special Notes:
		This fix will be obsolete once a game patch comes out.  Remember to remove this file before you patch the game.
		Might cause problems when playing multiplayer.  If you have any problems, just move the file out of the /base directory. 


	Hidden JKA Saber Hilts (HSABERS)
	Multiplayer

	What It Does:
		Adds to multiplayer the Retribution (Desann's), the Skywalker (Luke Skywalker's Saber), and the Stinger (default Reborn's) saber hilts.  These hilts come with the game but are hidden by baseJKA.



	Hidden Lannik Racto Skin
	Multiplayer
	
	What It Does:
		Makes the Lannik Racto skin selectable in the MP skins menu.  Also created icon for said skin.


	Improved Botrouting
	Multiplayer, Bots
	
	What It Does:
		Botrouting controls how MP bots navigate a given maps.  We've gone thru and improved the botrouting for the following maps:
		mp/duel3
		mp/duel8
		mp/ffa5
		

	RGB Character Color Menu Options
	Multiplayer, Single Player, Menus

	What It Does:
		 Adds a submenu that allows you to pick any color for your character's color with simple slide bars.


	SP Dual/Staff Menu
	Single Player, Sabers

	What It Does:
		The SP menu file has been altered to allow you to use the dual sabers/saber staff from the beginning of the game.  This also allows you to choice a red saber blade in SP.


	Various Bot Tweaks
	Multiplayer, Bots
	
	What It Does:

	 - The Luke bot now uses the skywalker saber (single_skywalker) that is included in the game.

	 - Chewie now speaks in Wookie.

	 - The Lannik Racto bot now uses the correct model.


	Various Menu Tweaks
	Multiplayer, Single Player, Menus

	What It Does:

	- Shadow options are now in both SP and MP.  Projected shadows are now an option.

	- Light Flare option in the MP ingame More video Options menu.

	- Dynamic Glow option in the MP ingame More video Options menu.
		

-----------------
0004.2 - Enhanced
-----------------

Nothing Yet.


-----------------
0004.3 - Vehicles
-----------------

	Eopie
	Multiplayer, Vehicle
	Model Names:
		eopie - eopie with saddle
		eopiewild - eopie without saddle

	Description:
		A slow, ugly, and gassy beast of burden used on Tatooine.  Seen in Episode 1.


	Stap
	Multiplayer, Vehicle
	Model Name:
		Stap

	Description:
		"The STAP (single trooper aerial platform) is a slim, agile craft sporting a pair of blaster cannons.  STAPs are often deployed as support vehicles in conjunction with larger craft.  The design draws inspiration from similar civilian vehicles called airhooks.  Trade Federation engineers refitted the design with greater performance and reliability.  High-voltage energy cells fuel the tiny craft's drive turbines, which afford the STAP impressive maneuverability." (starwars.com/databank) 
	

--------------
0004.4 - Skins
--------------

	Hoth Custom Player Clothing
	Multiplayer, Single Player, Player Classes

 	What It Does:
		Adds the ability to select the Hoth clothes for all the built-in player classes.  You can now also select the color of Hoth outfit.

	Technical Notes:
		For most of the player classes, I've shared the icons by placing dummy .png icon files (so the menu tries to load them) in the player model directories and then using shader referencing to use the general icons.  The generic icons are located in the jedi_hoth directory.  
		Please note that the jedi_kdm, jedi_rm, and jedi_tf have custom torso icons and jedi_tf has a custom lower icon.  Those custom icons are found in the individual model directories.


=====================
0005 - Using Our Work
=====================

We have few rules for using our work as part of your own projects:

 - You must include this readme in any public releases of your mod.  This doesn't apply if you're only using OJP features that you wrote yourself.
 - You must treat your fellow coders and the project with respect.
 - You may NOT use our work for ANY commercial purposes without the author's direct permission.

Please don't violate these rules; they are here for everyone's benefit.

We have a public CVS repository set up to let you directly access the OJP source materials to keep up-to-date with latest additions to the project.  However, the process to access the repository is a bit complicated, so please email one of the moderators for assistance.

In addition, we are still waiting for the MP SDK so there will probably not be anything to see for a while anyway.

We suggest that you:

 - Submit any cool features from your work that you think other developers may benefit from. 
 - Keep in contact with us about your project.  The more information we have, the better we can coordinate OJP to help you and the community.  We also like to know that people are using and enjoying our works.



==============================
0006 - Submitting Stuff to OJP
==============================


We are looking mostly for new code features, but are not limited to that. We are usually looking for generic, flexible, and adaptable features that anyone can work into their own code. Features that are drastically unique or special probably do not belong here, because we believe in keeping individuality and uniqueness among mods.

We also accept patches. If you see something in our code that has a problem, you can submit a patch for it. A patch would usually be replacement code or files.

Before you consider submitting, take note that we won't let you desubmit or remove your works from the project. Allowing people to do so would cause too many problems for the project. While your work will remain your work, submitting stuff to OJP means that you give us the rights to use your work and modify it freely as part of the project forever.

In addition, your work won't necessarily be turned on or even in every compiled version of OJP.  Some features will be disabled by default to allow people to just fire up and play OJP without confusion.

That being said, if you have something to submit just contact one of the OJP moderators.

DO NOT E-MAIL MOD MATERIALS TO STAFF MEMBERS WITHOUT ASKING FIRST! Just contact one of us, tell us a summary of your patch or feature, and if we think it fits the project, we'll accept it.

If you think you would like to actively participate in developing OJP, we can give you write access to the CVS repository, so that you may work on it yourself. This doesn't have to be a commitment, but if you would like to just submit features or patches separately, go ahead.


------------------------------
0006.1 - Submission Guidelines
------------------------------

 - Document your work as much as possible.  Be sure to add mentions of your work in the readme and other project documents.

 - Make your work as clean and tight as possible.

 - Follow the coding guidelines.  Try to keep your code as separated from other code as is reasonable.  Label EVERY coding change (from basejka) with appropriate coding tags.  If you're creating a new feature, you'll get to determine what the tag name will be.  Try to pick something that is simple and easy to search for.

 - NEVER DELETE FILES/DIRECTORIES/ETC FROM THE CVS REPOSITORY.  If it is necessary, the moderators will handle it.  



===================
0007 - Known Issues
===================


-----------------------------------
0007.1 - Issues with Basic Features
-----------------------------------

	Hidden Player Class Clothes (Hoth):

	- In the Hoth mission of the single player campaign, your Hoth outfit will lose its color selection abilities.  
	This is because the Hoth cold suit that is selectable in the menu is a slightly modified version of the original Hoth skin. The Hoth maps use the originals, so you're basically stuck with this issue unless you activate cheat mode and manually switch back to the selectable Hoth.

	- Twi'lek Female doesn't have selectable colors for her Hoth suit. 
	This is because the color selection system can only handle one custom color at a time.  In this case, the color is already being used for your player's skin tone.  Sorry! 



==============
0008 - Credits
==============

Coding:

	Original Jedi Knight Academy source code:  Raven Software


OJP Administration:

	Documentation:  Emon, Razor Ace

	Original OJP Concept:  Razor Ace

	OJP Organizational Planning:  Emon, RenegadeofPhunk, Razor Ace


OJP Basic:

	Bug Fix 1:  Razor Ace

	Botrouting:
		Duel3:  Razor Ace

	Hidden JKA Sabers:  TiM
		Menu Names:  Razor Ace

	Hoth Custom Player Clothing:  Razor Ace

	SP Dual/Staff Menu:  Aryyn

	Various Bot Tweaks:  Razor Ace

	Various Menu Tweaks:  Razor Ace


Vehicles:

	Eopie:  Chairwalker
	Stab:  Monsoontide, Duncan_10158


Special Thanks:

Raven Software
George Lucas
Lucas Entertainment Company (LEC)



==========================
0009 - Contact Information
==========================

OJP Project Moderators:

	Razor Ace
	Email:  razorace@hotmail.com
	MSN:  Razor Ace (razorace@hotmail.com)
	ICQ:  618641
	AIM:  razorsaces
	Yahoo:  razorsaces

	RenegadeOfPhunk
	Email:  renegadeofphunk@3dactionplanet.com
	ICQ:  253305779 (Knobby)


OJP General Discussion Board:

	http://www.lucasforums.com/forumdisplay.php?s=&forumid=542


==================
0010 - Legal Stuff
==================

We are making no claim on Raven Software's, ID Software's, or LEC's intellectual properties.  The above rules only apply to the additional works created by OJP contributors.  Ravensoft's, ID's, and LEC's code and additional materials is only included for ease of use.  All applicable licensing agreements still apply.  Please don't sue us.

End of Line.


