| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454 |
- <!DOCTYPE html>
- <html lang="en">
- <head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width,initial-scale=1">
- <title>troubleshooting :: jMonkeyEngine Docs</title>
- <link rel="canonical" href="https://wiki.jmonkeyengine.org/docs/sdk/troubleshooting.html">
- <meta name="keywords" content="documentation, tool, sdk, faq">
- <meta name="generator" content="Antora 2.3.3">
- <link rel="stylesheet" href="../../_/css/site.css">
- </head>
- <body class="article">
- <header class="header">
- <nav class="navbar">
- <div class="navbar-brand">
- <a class="navbar-item" href="https://wiki.jmonkeyengine.org">jMonkeyEngine Docs</a>
- <button class="navbar-burger" data-target="topbar-nav">
- <span></span>
- <span></span>
- <span></span>
- </button>
- </div>
- <div id="topbar-nav" class="navbar-menu">
- <div class="navbar-end">
- <a class="navbar-item" href="#">Home</a>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Products</a>
- <div class="navbar-dropdown">
- <a class="navbar-item" href="#">Product A</a>
- <a class="navbar-item" href="#">Product B</a>
- <a class="navbar-item" href="#">Product C</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Services</a>
- <div class="navbar-dropdown">
- <a class="navbar-item" href="#">Service A</a>
- <a class="navbar-item" href="#">Service B</a>
- <a class="navbar-item" href="#">Service C</a>
- </div>
- </div>
- <div class="navbar-item has-dropdown is-hoverable">
- <a class="navbar-link" href="#">Resources</a>
- <div class="navbar-dropdown">
- <a class="navbar-item" href="#">Resource A</a>
- <a class="navbar-item" href="#">Resource B</a>
- <a class="navbar-item" href="#">Resource C</a>
- </div>
- </div>
- <div class="navbar-item">
- <span class="control">
- <a class="button is-primary" href="#">Download</a>
- </span>
- </div>
- </div>
- </div>
- </nav>
- </header>
- <div class="body">
- <div class="nav-container" data-component="docs" data-version="master">
- <aside class="nav">
- <div class="panels">
- <div class="nav-panel-menu is-active" data-panel="menu">
- <nav class="nav-menu">
- <h3 class="title"><a href="../jme3.html">Docs</a></h3>
- <ul class="nav-list">
- <li class="nav-item" data-depth="0">
- <ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../documentation.html">Getting Started</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="https://javadoc.jmonkeyengine.org/v3.3.2-stable">JavaDoc</a>
- </li>
- <li class="nav-item" data-depth="1">
- <button class="nav-item-toggle"></button>
- <a class="nav-link" href="../jme3.html">jMonkeyEngine 3</a>
- <ul class="nav-list">
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Beginner Tutorials</span>
- <ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../jme3/beginner/hello_simpleapplication.html">Hello SimpleApplication</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../jme3/beginner/hello_node.html">Hello Node</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../jme3/beginner/hello_asset.html">Hello Asset</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../jme3/beginner/hello_main_event_loop.html">Hello Main Event Loop</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../jme3/beginner/hello_input_system.html">Hello Input System</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../jme3/beginner/hello_material.html">Hello Material</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../jme3/beginner/hello_animation.html">Hello Animation</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../jme3/beginner/hello_picking.html">Hello Picking</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../jme3/beginner/hello_collision.html">Hello Collision</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../jme3/beginner/hello_terrain.html">Hello Terrain</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../jme3/beginner/hello_audio.html">Hello Audio</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../jme3/beginner/hello_effects.html">Hello Effects</a>
- </li>
- <li class="nav-item" data-depth="3">
- <a class="nav-link" href="../jme3/beginner/hello_physics.html">Hello Physics</a>
- </li>
- </ul>
- </li>
- <li class="nav-item" data-depth="2">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Intermediate Tutorials</span>
- <ul class="nav-list">
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Concepts</span>
- <ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/intermediate/best_practices.html">Best Practices</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/intermediate/simpleapplication.html">Simple Application</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/features.html">Features</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/intermediate/optimization.html">Optimization</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/faq.html">FAQ</a>
- </li>
- </ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">Math Concepts</span>
- <ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/math_for_dummies.html">Math For Dummies</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/intermediate/math.html">Math</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/math.html">More Math</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/rotate.html">Rotate</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/math_video_tutorials.html">Math Video Tutorials</a>
- </li>
- </ul>
- </li>
- <li class="nav-item" data-depth="3">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">3D Graphics Concepts</span>
- <ul class="nav-list">
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/intermediate/multi-media_asset_pipeline.html">Multi-Media Asset Pipeline</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/scenegraph_for_dummies.html">Scenegraph for Dummies</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/beginner/hellovector.html">Hello Vector</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/terminology.html">Terminology</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/intermediate/how_to_use_materials.html">How to Use Materials</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/intermediate/transparency_sorting.html">Transparency and Sorting</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/external/blender.html">Importing from Blender</a>
- </li>
- <li class="nav-item" data-depth="4">
- <a class="nav-link" href="../jme3/external/3dsmax.html">Importing from 3DS Max</a>
- </li>
- </ul>
- </li>
- </ul>
- </li>
- </ul>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../logo.html">Logo Usage</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../bsd_license.html">License</a>
- </li>
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../github_tips.html">Github Tips</a>
- </li>
- </ul>
- </li>
- <li class="nav-item" data-depth="0">
- <button class="nav-item-toggle"></button>
- <span class="nav-text">SDK</span>
- <ul class="nav-list">
- <li class="nav-item" data-depth="1">
- <a class="nav-link" href="../sdk.html">jMonkeyEngine SDK</a>
- </li>
- </ul>
- </li>
- </ul>
- </nav>
- </div>
- <div class="nav-panel-explore" data-panel="explore">
- <div class="context">
- <span class="title">Docs</span>
- <span class="version">master</span>
- </div>
- <ul class="components">
- <li class="component is-current">
- <span class="title">Docs</span>
- <ul class="versions">
- <li class="version is-current is-latest">
- <a href="../jme3.html">master</a>
- </li>
- </ul>
- </li>
- <li class="component">
- <span class="title">Wiki UI</span>
- <ul class="versions">
- <li class="version is-latest">
- <a href="../../wiki-ui/index.html">master</a>
- </li>
- </ul>
- </li>
- </ul>
- </div>
- </div>
- </aside>
- </div>
- <main class="article">
- <div class="toolbar" role="navigation">
- <button class="nav-toggle"></button>
- <a href="../documentation.html" class="home-link"></a>
- <nav class="breadcrumbs" aria-label="breadcrumbs">
- <ul>
- <li><a href="../jme3.html">Docs</a></li>
- <li><a href="troubleshooting.html">troubleshooting</a></li>
- </ul>
- </nav>
- <div class="edit-this-page"><a href="https://github.com/jMonkeyEngine/wiki/edit/master/docs/modules/ROOT/pages/sdk/troubleshooting.adoc">Edit this Page</a></div>
- </div>
- <div class="content">
- <article class="doc">
- <h1 class="page">troubleshooting</h1>
- <div class="sect1">
- <h2 id="troubleshooting-jmonkeyengine3-sdk"><a class="anchor" href="#troubleshooting-jmonkeyengine3-sdk"></a>Troubleshooting jMonkeyEngine3 SDK</h2>
- <div class="sectionbody">
- <div class="sect2">
- <h3 id="graphics-card-driver"><a class="anchor" href="#graphics-card-driver"></a>Graphics Card Driver</h3>
- <div class="paragraph">
- <p><strong>On Windows and Linux make sure you have the latest driver installed. Make sure its the one supplied by the card manufacturer and not just the <abbr title="Operating System">OS</abbr>-default one.</strong> On OSX, make sure you have the latest update for your MacOS.</p>
- </div>
- </div>
- <div class="sect2">
- <h3 id="stability-graphics-issues"><a class="anchor" href="#stability-graphics-issues"></a>Stability / Graphics issues</h3>
- <div class="paragraph">
- <p>On some Linux and Windows systems, the SDK might perform unstable and quit with native VM crashes or “x” errors. There are a few things one can try to remedy those issues.</p>
- </div>
- <div class="sect3">
- <h4 id="heavyweight-canvas"><a class="anchor" href="#heavyweight-canvas"></a>Heavyweight Canvas</h4>
- <div class="paragraph">
- <p>First of all theres the new “OpenGL” settings page in the SDK global settings where you can enable the “Heavyweight Canvas”, which solved some issues for some people. The settings panel can be found under <code><span class="menuseq"><b class="menu">Tools</b> <i class="fa fa-angle-right caret"></i> <b class="menuitem">Options</b></span></code> on Windows and Linux and in the main menu (or by pressing Apple-Comma) for MacOSX.</p>
- </div>
- <div class="paragraph">
- <p>If you cannot start the SDK, edit the file <code>config/Preferences/com/jme3/gde/core.properties</code> in the SDK settings folder (see above). If it doesn’t exist, create the file including all folders. Add the line <code>use_lwjgl_canvas=true</code>. To try OpenGL1 compatibility mode (works for both canvas settings) add <code>use_opengl_1=true</code>.</p>
- </div>
- </div>
- <div class="sect3">
- <h4 id="look-and-feel"><a class="anchor" href="#look-and-feel"></a>Look and Feel</h4>
- <div class="paragraph">
- <p>The <abbr title="Operating System">OS</abbr>-built-in look and feel might cause issues, you can change the LAF by using the appropriate command line switch (or add it to the [app folder]/etc/jmonkeyplatform.conf file, without the “- -” prefix).</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code>--laf javax.swing.plaf.nimbus.NimbusLookAndFeel</code></pre>
- </div>
- </div>
- <div class="paragraph">
- <p>or alternatively</p>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre class="highlightjs highlight"><code>--laf javax.swing.plaf.metal.MetalLookAndFeel</code></pre>
- </div>
- </div>
- </div>
- <div class="sect3">
- <h4 id="compiz"><a class="anchor" href="#compiz"></a>Compiz</h4>
- <div class="paragraph">
- <p>Compiz on Linux might cause issues, if you set its rendering quality to “Medium” these should go away.</p>
- </div>
- <div class="ulist">
- <ul>
- <li>
- <p><code><span class="menuseq"><b class="menu">Appearance</b> <i class="fa fa-angle-right caret"></i> <b class="submenu">Set Special effects to</b> <i class="fa fa-angle-right caret"></i> <b class="menuitem">“Medium”</b></span></code></p>
- </li>
- </ul>
- </div>
- </div>
- </div>
- <div class="sect2">
- <h3 id="updating-problems"><a class="anchor" href="#updating-problems"></a>Updating problems</h3>
- <div class="paragraph">
- <p>If you have problems updating the SDK, try deleting all files from <code>jmonkeyplatform/update/download</code> and/or <code>[settings folder]/update/download</code> depending on your system (see below for the settings folder location).</p>
- </div>
- <div class="paragraph">
- <p>If you are on Linux, check if the user you run the SDK with has access to the files in <code>jmonkeyplatform/jdk/bin</code> and that they are executable.</p>
- </div>
- </div>
- <div class="sect2">
- <h3 id="freezing-performance-problems"><a class="anchor" href="#freezing-performance-problems"></a>Freezing / Performance problems</h3>
- <div class="paragraph">
- <p>If the SDK starts to become sluggish and / or slow or you get unexpected freezes of the application, you can try deleting the cache folder at var/cache in the settings folder (see below for the location of the settings folder). Do this while the SDK is not running, then restart the SDK.</p>
- </div>
- </div>
- <div class="sect2">
- <h3 id="preferences-and-settings"><a class="anchor" href="#preferences-and-settings"></a>Preferences and Settings</h3>
- <div class="paragraph">
- <p>To completely remove and/or reinstall the SDK it is vital that the settings folder is deleted too. The location can be seen through the “about” menu and is as following for the different <abbr title="Operating System">OS</abbr>'s:</p>
- </div>
- <div class="ulist">
- <ul>
- <li>
- <p>Windows: <code>C:\Userspass\<username>\AppData\Roaming\.jmonkeyplatform</code></p>
- </li>
- <li>
- <p>Windows (alt): <code>C:\Users\<username>\.jmonkeyplatform\</code></p>
- </li>
- <li>
- <p>MacOSX: <code>/Users/<username>/Library/Application Support/jmonkeyplatform</code></p>
- </li>
- <li>
- <p>Ubuntu: <code>/home/<username>/.jmonkeyplatform</code></p>
- </li>
- </ul>
- </div>
- </div>
- <div class="sect2">
- <h3 id="log"><a class="anchor" href="#log"></a>Log</h3>
- <div class="paragraph">
- <p>To see or post the error output of the SDK in the forum, you can find the log of the application in the settings folder above too, the file is called <code>var/log/messages.log</code>.</p>
- </div>
- </div>
- <div class="sect2">
- <h3 id="getting-error-messages-and-reporting-issues"><a class="anchor" href="#getting-error-messages-and-reporting-issues"></a>Getting error messages and reporting issues</h3>
- <div class="paragraph">
- <p>When an exception happens in the SDK, a small warning sign appears in the lower right corner of the main window. Double-click it to open a window that allows you to see the exception stack trace. When posting about issues in the forum, always post the stack trace along with a description of what happens and how it can be reproduced.</p>
- </div>
- </div>
- <div class="sect2">
- <h3 id="specifying-the-jdk-location"><a class="anchor" href="#specifying-the-jdk-location"></a>Specifying the JDK location</h3>
- <div class="paragraph">
- <p>You can install another JDK for use with the jMonkey SDK. You then have to specify the location manually.</p>
- </div>
- <div class="olist arabic">
- <ol class="arabic">
- <li>
- <p>Go to your jMonkeyEngine SDK installation directory.<br>
- Mac users right-click jMonkeyApplication.app (which actually is a directory) in the Finder and select “Show package contents”.</p>
- </li>
- <li>
- <p>Navigate to the <code>etc</code> directory.<br>
- Mac users navigate to <code>Contents/Resources/jmonkeyplatform/etc/</code>.</p>
- </li>
- <li>
- <p>Open the file <code>jmonkeyplatform.conf</code> in a text editor.</p>
- </li>
- <li>
- <p>Change the following line and enter the path to the JDK:</p>
- </li>
- </ol>
- </div>
- <div class="listingblock">
- <div class="content">
- <pre>jdkhome="/path/to/jdk"</pre>
- </div>
- </div>
- </div>
- <div class="sect2">
- <h3 id="freezing-at-startup"><a class="anchor" href="#freezing-at-startup"></a>Freezing at startup</h3>
- <div class="paragraph">
- <p>If you’re behind a proxy or special network settings, try :</p>
- </div>
- <div class="olist arabic">
- <ol class="arabic">
- <li>
- <p>Disable your network connection.</p>
- </li>
- <li>
- <p>Launch jme sdk (may wait 30s/1min for timeout).</p>
- </li>
- <li>
- <p>Go into <code><span class="menuseq"><b class="menu">Tools</b> <i class="fa fa-angle-right caret"></i> <b class="submenu">Options</b> <i class="fa fa-angle-right caret"></i> <b class="menuitem">General</b></span></code>.</p>
- </li>
- <li>
- <p>Setup “manual proxy settings” (for some reason the “Use System Proxy Settings” option doesn’t work on some Linux distributions)</p>
- </li>
- </ol>
- </div>
- <div class="paragraph">
- <p><a href="https://hub.jmonkeyengine.org/t/jme-sdk-stalls-on-startup/30555">Discussion</a> of the problem.</p>
- </div>
- </div>
- <div class="sect2">
- <h3 id="known-issues"><a class="anchor" href="#known-issues"></a>Known Issues</h3>
- <div class="paragraph">
- <p>For a list of known issues and possible workarounds see the following link: <a href="https://github.com/jMonkeyEngine/sdk/issues">List of known issues on github.</a></p>
- </div>
- <div class="paragraph">
- <p>Some issue are imported from the previous googlecode:
- <a href="https://code.google.com/archive/p/jmonkeyengine/issues">List of old issues on googlecode.</a></p>
- </div>
- </div>
- </div>
- </div>
- </article>
- <aside class="toc sidebar" data-title="Contents" data-levels="2">
- <div class="toc-menu"></div>
- </aside>
- </div>
- </main>
- </div>
- <footer class="footer">
- <p>This page was built using the Antora default UI.</p>
- <p>The source code for this UI is licensed under the terms of the MPL-2.0 license.</p>
- </footer>
- <script src="../../_/js/site.js"></script>
- <script async src="../../_/js/vendor/highlight.js"></script>
- </body>
- </html>
|