Thursday, September 22, 2011

Better version available!

If you're reading this post, don't download the old files; the new ones are better!
As before, we present three files (the jar file is the playable one, and the two zip files are the source code, presented in two forms).

Jar (Playable)
Zip (Plain source code)
Zip (Eclipse-exported source)

This version brings the addition of a Shop after your Battle.  You may buy and sell items (provided you've got the money, that is).

All of the instructions are the same as before, so see Early Development Version Now Available for details.

As far as comments and suggestions are concerned, our feedback center should be up and running within a week.  Thanks for playing.

Thursday, September 15, 2011

Early development version now available

The first version of simpleRPG is now available.
We present three files you may download: the jar file is the playable one, and the two zip files are the source code, presented in two forms.

Jar (Playable)
Zip (Plain source code)
Zip (Eclipse-exported source)

The first zip is just the source code, whereas the second is an Eclipse export (link: eclipse.org), and is convenient for Eclipse users*.

Instructions

READ FIRST, whether playing or editing
To use simpleRPG in any form, you must first have Java installed on your computer.
In its current form, simpleRPG uses Java 1.6, but we plan to move to Java 1.7 once it becomes (officially) available for Mac OS X.

Playing
SimpleRPG is meant to be played from the command line.  Depending on your system, this may instead be called a Console, Konsole, Terminal, or perhaps even a DOS Prompt.
Regardless, the first step is to navigate to the directory/folder where you have downloaded the jar file (generally using commands like "cd").**
The second step is to type "java -jar simpleRPG.jar".  Make sure to use spaces between "java" and "-jar" as well as between "-jar" and "simpleRPG.jar" and not tabs.
At this point the game should be running.  The computer will alternate between describing the scene and asking for your choices.  When it asks you for your choice, you should type either a letter*** or a number, based on the options presented to you (e.g. you can usually type "Q" or "q" to query, or ask questions about the state of the battle).

Editing
To edit the source code, you also need a third-party library called JDOM (link: JDOM downloads).
However, you can skip this if you want****, since simpleRPG doesn't actually use the JDOM methods yet.  (These are planned for saving/loading).
Feel free to root through the source code, but be warned that we haven't included many comments (or for that matter, any design documents) yet, and we are almost certain that bugs and poor coding practices abound.
We'll be uploading some general design documents soon, as well as setting up a feedback system, where we'll encourage all sorts of suggestions, from bug reporting to redesign suggestions, such as making use of third-party packages or improving the structure through the use of various design patterns.


* Just choose import -> import new project into workspace -> from archive -> [select the location where you downloaded the file]

**Please note that the quotation marks (i.e. ") are not meant to be typed; they delineate the input, i.e. you should just type the things between them.

***Capitalization doesn't matter.

 ****This will require three steps:
1) remove the org.simplerpg.xml package
2)  remove the toJDOMElement methods from the classes that implement JDOMconversion (as denoted by the "implements JDOMconversion" statement towards the top of the file, just after the class declaration)
3) in the same classes as (2), also remove the static getXFromElement methods (where X is the name of the class).

Friday, September 9, 2011

Second Post

Now with enhanced version number!

This is a test

This is the inaugural post of simplerpg.org.  Stay tuned for information, code and JARs.