How can I best present it for folks to review and comment upon it? I will attach a JAR file that includes source code. But unless one has an IDE, extracting the source files will be a bit of a nuisance. Another suggestion for presentation? The program has six .java files.
Hello, first I usually don't open random jar file (because of security, because of the trouble, etc.) So maybe you should try to make your demo available as an applet
or as java webstart
For the source code, I usually prefer reading it directly on the web page. But you have 6 java files so it's kinda big to be all on the forum. My suggestion would be to present the essential part of your program on the web site and giving the full source code as an attachment.
I read your code. It's very different than the structure I use for making my game but I guess it work too. Can't say which one is better. One thing I can't complain about are the comment; yes you have commented your code! But to make it quicker to read on the forum, you should just put the code unless the comment are essential to understand what a part of the code does. Most of us can understand what code does just by seeing it. Another suggestion is to write your comment as Javadoc comment. IDE like netbeans and eclipse will be able to recognize them and provide quicker feedback to the reader about what your code is doing. You can also produce html javadoc of your code with a few click.
Btw your code is clear. Good job. I often see code that make me want to stop reading it after the first few line because it's too awful.