Description

JAdventure is a Java (text) based implementation of a Role Playing Game (RPG) - Single Player.

Project Background

It was originally created as a project of the progether subreddit and worked on by Applzor, add7, geniuus, Malfunction, bdong_, Qasaur, and tamul. It was revived by Hawk554.

Project Status

Under Construction This project is in a alpha status. The player can walk through the game, find items and fight with some nice characters!

Developers are Welcome

Everyone is welcome to help with the creation of JAdventure!

The best way to find out more about the game and the ideas that are there, is to have a look at Reddit - JAdventure.

Or drop by at our IRC channel reddit-progether

All documentation is avaiable from the JAdventure wiki and from the JAdventure website. These form the majority of the project's documentation and development guidelines.

Contributors

1. Hawk554
2. projectdelphai
3. CageHN
4. kzisme
5. blackwolf12333
6. MikesNorth
7. pthayer3
8. Reinecker
9. tamul
10. shkesar
11. paddatrapper

Contributing

Don't make a pull request to the main repo's master if you don't want your commit merged yet. Don't make pull requests if you're not willing to merge that code.

Rather than opening a pull request, consider opening an issue to discuss the problem you're fixing. Keep the work-in-progress updates to your fork, maybe merging the updates to a separate branch in the main repo if there's enough there to warrant it.

1. Create an issue (optional)

2. Fork the codebase

3. Clone your fork

4. Create a branch

   git branch <branchName>
   git checkout <branchName>
   

5. Make your changes

6. Push to your branch

   git push origin <branchName>
   

7. Make a pull request between your branch and the progether master

Setting Up The Game For Development or Gameplay

You can download the game with:

git clone https://github.com/progether/JAdventure

###Run with Ant###

Install apache-ant and ant-ivy.

Run the game with:

ant -emacs run

It will automatically compile, test, and run the game.

Playing the Game

To start a new game:

start

To save a game:

s

Get a list of commands with:

h

To get a list of monsters around you:

m

To view details about your player:

v <s,e,b> - view status, equipped items, backpack

To quit the game:

exit

To move:

g n - go north
g s - go south
g e - go east
g w - go west

To pick up an item:

p <itemName>

To drop an item:

d <itemName>

To equip/unequip item:

e <itemName>
ue <itemName>

To attack:

a <monster>

To look around:

la

To talk to a Non-player Character:

t <npc>

Coding Standard/Convention/Style

To help make code more readable, understandable, and consistent, each contributor should follow the set guidelines laid out below. If you disagree with something or come across a style that has not been decided upon, make an issue or a pull request respectively for discussion on the best style. The standard will be decided based on either majority rule or official documentation (i.e. oracle coding standard).

1. Spaces not tabs
2. Space width is 4
3. No beginning/trailing empty lines
4. Each file should start with an import statement if necessary single-spaced
5. After class declaration and between class methods, there should be a space.
6. Within methods, there should be no spaces unless to separate specific chunks of code (i.e not for if statements, return values, or loops)
7. Opening curly braces appear a space after the closing parentheses, not directly after.
8. Closing curly braces appear on own line unless followed by an else etc. which will be a space after the curly brace.
9. Comments should have one space after "//"
10. Comments 4 lines or greater in length should be multi-line commented