Click on the title image to go to the main page
 Main Page
 Contact Logo
Last Updated: 3rd Oct, 2005, 14:05 GMT

Frequently Asked Questions

Q: What is JOGRE?

A: JOGRE (pronounced Joe-ger) is the acronym for "Java Online Gaming Real-time Engine".

JOGRE is a Java based client/server games engine and API for the easy creation and execution of online real time games. JOGRE is designed to be an open source equivalent to popular gaming websites such as Yahoo! Games.

[ top ]
Q: What licence does JOGRE use?

A: JOGRE has been programmed using the GNU licence. The text of the licence for JOGRE is as follows (inserted at the top of each source file):

JOGRE (Java Online Gaming Real-time Engine) - Project
Copyright (C) 2004  Bob Marks (
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software<
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

Where Project is the name of the sub project (e.g. API, Server, Chess etc).

[ top ]
Q: How do I create my first game?

A: Creating a multi-player game using JOGRE is easy as the JOGRE API does a lot of the hard work for you.

To create a game follow you first of all need the jogre.jar library which you must then include in your CLASSPATH environment variable. The next step is to follow one of the tutorials such as creating a simple game of Connect 4 which takes you through the stages step-by-step.

[ top ]
Q: How is client / server communication achieved in JOGRE?

A: All communication in JOGRE transmitted as XML. A client trys connect to a server by sending a connect message. If the client is sucessful he will be connected and be able to get a list of users and tables.

A document exists which outlines the JOGRE Protocol in terms of XML and describes in detail what the various attributes do.

[ top ]
Q: How can I connect a client to a JOGRE server?

A: A client must first of all enter a username (and a password if the server requires this) to log onto a server. Usernames and passwords are stored as persistent data on the server. The Jogre server supports different types of persistent data including XML and database. The default is xml (defined as an attribute in the jogre/server/server.xml file) and user details are defined in the /jogre/server/data/xml/users.xml file. The default users are "bob", "dave", "john" and "sharon".

A server host and port must be defined also. If you are connecting to a local server this is localhost or The default port is 1790.

Full details on the Jogre persistent data model is defined in the Jogre Server Persistent Data document.

[ top ]
Copyright 2004-2008, JOGRE API and JOGRE Games, by Bob Marks