jMonkeyEngine.org

First thing’s first, no one ever confined to rules on the web, so we never bothered making them. Instead we put our trust in promoting good norms and overall best practices, starting with a couple no-brainer guidelines.

Be patient monkeys, one question at a time, please!

Support inquiries turn out much more helpful to other users if you ask your questions one at a time, with an articulate title specific to that one problem. This makes it easier for other users to search the forum and find issues identical to theirs, effectively avoiding duplicate support threads soaking up the developers’ time.

All your information up front

For most common issues, we have a simple template that you can follow so long as it feels relevant.

• What did you intend to do, what was the expected outcome?
• What outcome do you experience instead?
• What steps will reproduce the problem?
  1. …
  2. …
  3. …
• What version of the product(s) are you using?
• On what operating system?
• Please provide any additional information. (e.g. hardware specs & Java version, if considered relevant– it usually is!).

Forum

Our forum is the most active component of our site, and together with the wiki it is no doubt the most important. Every question asked and answered gets us one tiny step closer to an exhaustive knowledge base.

Navigating the forum

This is one of those things we wish we had a better solution for, but we just don’t. Just get used to it and hold on ’till 2012.

Making a new post

“Duh!” you say? Well, there several ways to go about it I say. I’ll only explain the tricky one.

Code Tags

If you use normal “code” tags with the “< >” brackets the highlighting will default to Java. You can use other languages by using square brackets and the language name as tag name, like [myLanguage]code here[/myLanguage]. Supported tags for example are “c”, “cpp”, “xml” “scala”, “groovy” and even “patch”.

Look herefor a complete lst.

These are the parameters you can pass to the shortcode and what they do. For the booleans (i.e. on/off), pass true/1 or false/0 e.g. [lang light="true"]

• autolinks — Toggle automatic URL linking.
• collapse — Toggle collapsing the code box by default, requiring a click to expand it. Good for large code posts.
• firstline — An interger specifying what number the first line should be (for the line numbering).
• gutter — Toggle the left-side line numbering.
• highlight — A comma-sperated list of line numbers to highlight.
• htmlscript — Toggle highlighting any extra HTML/XML. Good for when you’re mixing HTML/XML with another language, such as having PHP inside an HTML web page. The above preview has it enabled for example. This only works with certain languages.
• light — Toggle light mode which disables the gutter and toolbar all at once.
• padlinenumbers — Controls line number padding. Valid values are false (no padding), true (automatic padding), or an integer (forced padding).
• toolbar — Toggle the toolbar containing the helpful buttons.
• wraplines — Toggle line wrapping.

If you’re contributing code that you think might reusable for a long time you can create a code snippet. Above your post window, you’ll see “Insert” right under that long list of buttons. Just go:

Insert => snippet… => Add your own snippet

Uploading Images

There are plenty of free services out there, but most of them are infested with ads and might even be incompatible with our site. Please use this default method:

Insert => Upload Image => Upload your image to imgur.com => Copy the link displayed under “HTML Image (websites / blogs)” => Paste it in your post.

Email Notifications

If you want to receive an e-mail notification for every new post made to a particular board (aka ‘group’), start by navigating to your board of choice, e.g.:

http://jmonkeyengine.org/groups/development-discussion-jme3/forum/

Now all you have to do is press the magic button.

Also note that you can further adjust your notification settings on this private options page:

http://jmonkeyengine.org/members/<your_nickname>/settings/notifications/

But once again, messing around with these settings can result in some unexpected mail notifications.

Groups

What are they?

Groups currently act as the container for discussion boards. They can really do a whole lot more, we just haven’t gotten around to promoting these features to standard use yet. We’re still figuring it out, so we’ll come back to the topic of groups in a post of its own to give them the undivided attention they deserve.

Wiki

What’s my login?

Your login is synchronized with the main site’s login. If you change your password through your profile page, the wiki password is changed too.

How to edit a page?

First navigate to any wiki page. A new tab has now spawned in the top menu:

How to create a new page?

Just type any new page in the address bar like: “jmonkeyengine.org/wiki/doku.php/some_new_page”. You’ll see a “Create this page” button has spawned. At this moment we haven’t yet clarified the newest wiki conventions, such as the use of folders (e.g. “jme3:some-page”), so please consult us via the forum before creating new pages. We will update and clarify the newest guidelines shortly.

Known Bugs

YouTube embed fail

Our website lets you embed YouTube videos by simply pasting a direct link to a video. However, if you paste your link at the bottom of your post without any more text underneath, it will fail to load.

Content License

Unless stated otherwise, all textual content posted within the jmonkeyengine.org domain, i.e. user contributed work, is licensed under a Creative Commons Attribution 3.0 Unported License.