mirror of https://github.com/DrBeef/JKXR.git synced 2024-11-23 04:22:27 +00:00

History

Simon 85f642e9e7 Use primary hand direction/location as trigger for buttons		2022-11-16 22:34:41 +00:00
..
JKVR	Use primary hand direction/location as trigger for buttons	2022-11-16 22:34:41 +00:00
OpenJK	Use primary hand direction/location as trigger for buttons	2022-11-16 22:34:41 +00:00
SupportLibs	Still too many build issues...	2022-09-19 22:46:47 +01:00
Android.mk	Still too many build issues...	2022-09-19 22:46:47 +01:00
Application.mk	update to make files	2022-10-03 22:19:20 +01:00
README.md	Initial Commit	2022-09-18 16:37:21 +01:00

README.md

JACoders "OpenJK" project

IRC: irc.arloria.net / #JACoders (webchat)

Forum: http://jkhub.org/forum/51-discussion/

The purpose of this project is to maintain and improve the Jedi Academy and Jedi Outcast games, developed by Raven Software. This project does not attempt to rebalance or otherwise modify core gameplay.

Major enhancement changes are very low priority at this time unless patches are made available and which do not alter the core functionality of gameplay or the stock renderer itself.

Please use discretion when making issue requests on github. The JKHub sub-forum is a better place for larger discussions on changes that aren't actually bugs.

Jedi Outcast Support

Do not make issues regarding Jedi Outcast support problems at this time. It is considered mostly unfinished, broken and use at your own risk! (We know things like saving and using the JK Mode are broken for sure)

There is no Multi-Player code for JKMP at all on our repository at this time. The Single-Player support must be explicitly turned on in your own compile. The prebuilt versions will not include this.

64-bit Support

64-bit is now mostly working on non-Windows platforms.

Installation

First, install Jedi Academy. If you don't already own the game you can buy it from online stores such as Steam, Amazon or Play. Then unpack the OpenJK zip file to your Jedi Academy GameData folder.

Maintainers (in alphabetical order)

eezstreet
Ensiform
ImperatorPrime
Razish
redsaurus
Xycaleth

Significant contributors (in alphabetical order)

exidl
mrwonko
Scooper
Sil

Dependencies

OpenGL
OpenAL (included on Windows)
libpng (included on Windows)
libjpeg (included on Windows)
zlib (included on Windows)

Dedicated Server

In order to run dedicated server, you must use the openjkded binary, running dedicated from the main executable is currently not allowed because it is broken with the addition of modular renderer.

Developer Notes

OpenJK is licensed under GPLv2 as free software. You are free to use, modify and redistribute OpenJK following the terms in LICENSE.txt.

Please be aware of the implications of the GPLv2 licence. In short, be prepared to share your code.

If you wish to contribute to OpenJK, please do the following

Fork the project on Github
Create a new branch and make your changes
Send a pull request to upstream (JACoders/OpenJK)

If you wish to base your work off OpenJK (mod or engine)

Fork the project on Github
Change the GAMEVERSION define in codemp/game/g_local.h from "OpenJK" to your project name
If you make a nice change, please consider backporting to upstream via pull request as described above. This is so everyone benefits without having to reinvent the wheel for every project.

Reserved renderer names

rd-vanilla (JA's original renderer)
rd-dedicated (Stripped down renderer for use with dedicated server)
rd-raspberry (OpenGL ES compliant renderer for use with Raspberry Pi - feel free to maintain!)
rd-rend2 (Maintainer: Xycaleth)
rd-strawberry (Maintainer: Xycaleth)
rd-vader (Maintainer: mrwonko)
rd-palpatine (Maintainer: mrwonko)
rd-sidious (Maintainer: mrwonko)

Engine "hax"

You will no longer be able to use runtime memory patches. Consider forking OpenJK and adding your engine modifications directly.