Preface

This section is currently a draft, and is subject to change.

DGA Game XMPP Network Protocol Specification ('the Specification') defines matters and guidelines for the DGA Game XMPP Network Protocol ('the Network Protocol'), which is an XMPP protocol extension for a game called 'DGA Distant Ground Attack' ('DGA', 'the DGA Game', or simply 'the Game').

This chapter introduces common topics related to the Specification.

Audience

The Specification is intended to be read by programmers, artists, testers, producers, managers, players, and everybody else involved in design, development, testing, and use of the Game. However, software developers, programmers, and architects are the primary audience of the Specification.

Legal

This documentation and the accompanying materials are made available under the terms of the GNU Free Documentation License, which is available at https://www.gnu.org/licenses/fdl.html.

SPDX-License-Identifier: GFDL-1.3-or-later

Java and Java EE are registered trademarks of Oracle and/or its affiliates.
Jakarta EE, GlassFish, and Eclipse IDE are registered trademarks of Eclipse Foundation.
Payara, Payara Server and its logos are a trademark of Payara Foundation.
Apache, Apache NetBeans, NetBeans IDE, and Maven are trademarks of The Apache Software Foundation.
DGA DISTANT GROUND ATTACK® and its logo are registered trademarks of Zhanat S. Skokbayev at The FLEISS Software Foundation.
All other trademarks, logos, and featured content are property of their respective owners.

Prerequisites

XMPP is a protocol for streaming XML elements over a network in order to exchange structured yet extensible data in near-real-time. We assume that you are familiar with the very basics of computer networking, common Internet applications (such as email and the World Wide Web), and structured data formats (such as HTML). The first place to start here is The XMPP Standards Foundation’s website.

The DGA Game is based on the Java Platform and written in the Java™ Programming Language. DGA’s software architecture is closely related to the Java Platform’s technologies. If you are new to Java, spend some time getting up to speed on the language and platform; a good place to start is dev.java/learn.

Also, each topic in this Specification provides some background information, but in general, we assume you have a basic knowledge of the technologies each Java Platform’s feature works with. Another field important for understanding the Specification is game development. We assume that you have some basic understanding in these fields.

Internationalisation and Localisation

From the beginning, DGA is implemented as an internationalised computer software addressed to the global audience and international markets. The following locale is default for the DGA Game and its projects:

Locale	Name	Description
en-EU	English in the European Union (European English, EU English).	The English language as it is accepted in the European Union as the shared standard usage of Ireland and the United Kingdom. As a general rule, Irish/British English is preferred, and Americanisms that are liable not to be understood by speakers of Irish/British English should be avoided. However, bearing in mind that a considerable proportion of the target readership may be made up of non-native speakers, very colloquial Irish/British usage should also be avoided. Although, the International System of Units (SI System) is used by default. (EU Language Rules; EU Guidelines for Translating into English)

Locale

Name

Description

en-EU

English in the European Union (European English, EU English).

The English language as it is accepted in the European Union as the shared standard usage of Ireland and the United Kingdom. As a general rule, Irish/British English is preferred, and Americanisms that are liable not to be understood by speakers of Irish/British English should be avoided. However, bearing in mind that a considerable proportion of the target readership may be made up of non-native speakers, very colloquial Irish/British usage should also be avoided. Although, the International System of Units (SI System) is used by default. (EU Language Rules; EU Guidelines for Translating into English)

At the same time, DGA is intended to be localised for as many languages and countries as possible. DGA strives to communicate with every player in his/her native language or in a language of his/her preference. Nevertheless, this communication has to be well implemented.

Since the Network Protocol is based on XSF’s standards written in American English, the Specification follows the style of the original language whenever appropriate.

Terminological Conventions

Throughout this document, we use the following terminological conventions:

Massive Vs. Massively Multiplayer Online Game: Massive versus Massively Multiplayer Online Game (MMOG) is a highly debatable topic. Laying aside the aspect of grammar, we prefer expanding MMOG as Massive Multiplayer Online Game because it represents a more general notion. The word massive refers to a multiplayer online game, which can be not only massively multiplayer (i.e. massive in quantity of players acting within the same online game world), but also huge in functionality, gameplay, network capabilities, virtual economy, and other parameters of the game. Whereas, the form massively multiplayer indicates only that there are numerous players in the game, i.e. this form has a more narrow meaning. Moreover, a massive multiplayer game can be either massively multiplayer or not. The modern game encyclopedias allow both forms, although they use massively multiplayer in the narrow, specific sense. (ECGG, p. 596)

Typographic Conventions

Throughout this document, we use the following typographic conventions:

Convention Meaning Example

Convention	Meaning	Example
Boldface	Boldface type indicates a new term defined in text below or in the glossary. Also it marks graphical user interface elements associated with an action.	Heaven signifies night and day, cold and heat, times and seasons. From the File menu, choose Open Project.
Italic	Italic type indicates book titles, emphasis, terms in the text or placeholder variables for which you supply particular values.	Read Chapter 6 in the User’s Guide. Do not save the file. The command to remove a file is `rm filename`.
`Monospace`	Monospace type indicates the names of files and directories, commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.	Edit your `.login` file. Use `ls -a` to list all files. `machine_name% you have mail.`
very important	Underlined type indicates texts of especial importance.	The Commander stands for the virtues of wisdom, sincerity, benevolence, courage and strictness.
(Book, page)	Letter code and number in round brackets indicates the index of a text resource through the Bibliography and the page number(s) within the text.	(ECGG, p. 319) (XTDG, pp. 27-29)

Boldface

Boldface type indicates a new term defined in text below or in the glossary. Also it marks graphical user interface elements associated with an action.

Heaven signifies night and day, cold and heat, times and seasons.

From the File menu, choose Open Project.

Italic

Italic type indicates book titles, emphasis, terms in the text or placeholder variables for which you supply particular values.

Read Chapter 6 in the User’s Guide.

Do not save the file.

The command to remove a file is rm filename.

Monospace

Monospace type indicates the names of files and directories, commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

Edit your .login file.

Use ls -a to list all files.

machine_name% you have mail.

very important

Underlined type indicates texts of especial importance.

The Commander stands for the virtues of wisdom, sincerity, benevolence, courage and strictness.

(Book, page)

Letter code and number in round brackets indicates the index of a text resource through the Bibliography and the page number(s) within the text.

(ECGG, p. 319)

(XTDG, pp. 27-29)

Want to help? Learn how to contribute to FLEISSF DGA Docs

Any reference to a particular make, model, manufacturer, and/or version of weapon, gear or vehicle is made for historical accuracy only and does not indicate any sponsorship or endorsement of any trademark owner, weapon or vehicle manufacturer.