java
/
jMonkeyEngine-website
mirror de https://github.com/jMonkeyEngine/jmonkeyengine-website.git


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192
							<!DOCTYPE html>
<html lang="en-us">

<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">

  <title>jMonkeyEngine</title>

  
  <meta name="description" content="A cross-platform game engine for adventurous Java developers.">
  

  <link rel="stylesheet" href="/css/custom.css">
  <link rel="stylesheet" href="/lib/fomantic/semantic.min.css">
  <link rel="stylesheet" href="/lib/blueimp-gallery/2.41.0/css/blueimp-gallery.min.css" />

  <script src="/js/jquery.min.js"></script>
  <script src="/lib/fomantic/semantic.min.js"></script>
  <script src="/lib/blueimp-gallery/2.41.0/js/blueimp-gallery.min.js" defer></script>
  <script src="/js/custom.js" defer></script>

  
        <link rel="alternate" type="application/rss+xml" href="/start/index.xml" title="jMonkeyEngine">

</head>

<body>
  

<header>

    <div class="ui stackable inverted secondary menu" style="background-color: #222222;">
        <div class="ui container">
            <div class="item">
                <a href="/"><img class="ui image" src="/images/jme-logo.png"/></a>
            </div>

            
                <a class="item" id="Blog" href="/blog/">Blog</a>
                
                <a class="item" id="Documentation" href="/docs/">Documentation</a>
                
                <a class="item" id="Features" href="/features/">Features</a>
                
                <a class="item" id="License" href="/license/">License</a>
                
            
            <a class="item" href="https://hub.jmonkeyengine.org">Community</a>
            <a class="item" href="https://store.jmonkeyengine.org">Store</a>


            <div class="right menu">
                
    <a class="item" href="https://github.com/jMonkeyEngine/jmonkeyengine" id="git-menu-item"><i class="github icon"></i>Github</a>


    <a href="https://discord.gg/JhefT9s" class="item" id="discord-menu-item"><i class="discord icon"></i>Discord</a>

            </div>
        </div>
    </div>

</header>


    <div class="ui container">
        <br />
        <h1></h1>    
        <h1 id="quick-start">Quick Start</h1>
<p>There are a variety of ways to use jMonkeyEngine:</p>
<ul>
<li>Download the SDK</li>
<li>Download the engine</li>
<li>Add the libraries to a build script</li>
</ul>
<p>Using the Netbeans-based SDK is by far the quickest solution to get you up and running. Everything needed is provided, along with extra tools and integrations, and is generally the place most users start their endevour.
<a href="https://github.com/jMonkeyEngine/sdk/releases">Download the SDK</a>.</p>
<p>jMonkeyEngine is not bound to any specific IDE or SDK, though, and if you feel comfortable in the Java environment you can use any IDE. The engine itself and it&rsquo;s dependencies can be downloaded directly and you can include them just like any other library in your java project.
<a href="https://github.com/jMonkeyEngine/jmonkeyengine/releases">Download the Engine</a>.</p>
<p>If you prefer to use online dependencies you can include them in your project from jcenter. This is the most common approach for users that use an IDE such as intellij.</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-groovy" data-lang="groovy">repositories <span style="color:#f92672">{</span>
    jcenter<span style="color:#f92672">()</span>
<span style="color:#f92672">}</span>

dependencies <span style="color:#f92672">{</span>
    implementation <span style="color:#e6db74">&#34;org.jmonkeyengine:jme3-core:3.3.2-stable&#34;</span>
    implementation <span style="color:#e6db74">&#34;org.jmonkeyengine:jme3-desktop:3.3.2-stable&#34;</span>
    implementation <span style="color:#e6db74">&#34;org.jmonkeyengine:jme3-lwjgl:3.3.2-stable&#34;</span> 
<span style="color:#f92672">}</span></code></pre></div>
<h2 id="creating-a-game">Creating a Game</h2>
<p>All games created with jmonkey start by extending <code>SimpleApplication</code>. Below is the most basic setup required to start your game and show a cube.</p>
<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-java" data-lang="java"><span style="color:#f92672">package</span> my.game<span style="color:#f92672">;</span>

<span style="color:#f92672">import</span> com.jme3.app.SimpleApplication<span style="color:#f92672">;</span>
<span style="color:#f92672">import</span> com.jme3.material.Material<span style="color:#f92672">;</span>
<span style="color:#f92672">import</span> com.jme3.math.ColorRGBA<span style="color:#f92672">;</span>
<span style="color:#f92672">import</span> com.jme3.scene.Geometry<span style="color:#f92672">;</span>
<span style="color:#f92672">import</span> com.jme3.scene.shape.Box<span style="color:#f92672">;</span>
<span style="color:#f92672">import</span> com.jme3.system.AppSettings<span style="color:#f92672">;</span>

<span style="color:#66d9ef">public</span> <span style="color:#66d9ef">class</span> <span style="color:#a6e22e">Main</span> <span style="color:#66d9ef">extends</span> SimpleApplication <span style="color:#f92672">{</span>

    <span style="color:#66d9ef">public</span> <span style="color:#66d9ef">static</span> <span style="color:#66d9ef">void</span> <span style="color:#a6e22e">main</span><span style="color:#f92672">(</span>String<span style="color:#f92672">[]</span> args<span style="color:#f92672">)</span> <span style="color:#f92672">{</span>

        Main app <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> Main<span style="color:#f92672">();</span>

        AppSettings settings <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> AppSettings<span style="color:#f92672">(</span><span style="color:#66d9ef">true</span><span style="color:#f92672">);</span>
        settings<span style="color:#f92672">.</span><span style="color:#a6e22e">setTitle</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;My Awesome Game&#34;</span><span style="color:#f92672">);</span>
        app<span style="color:#f92672">.</span><span style="color:#a6e22e">setSettings</span><span style="color:#f92672">(</span>settings<span style="color:#f92672">);</span>

        app<span style="color:#f92672">.</span><span style="color:#a6e22e">start</span><span style="color:#f92672">();</span>

    <span style="color:#f92672">}</span>

    <span style="color:#a6e22e">@Override</span>
    <span style="color:#66d9ef">public</span> <span style="color:#66d9ef">void</span> <span style="color:#a6e22e">simpleInitApp</span><span style="color:#f92672">()</span> <span style="color:#f92672">{</span>

        Box b <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> Box<span style="color:#f92672">(</span>1<span style="color:#f92672">,</span> 1<span style="color:#f92672">,</span> 1<span style="color:#f92672">);</span>
        Geometry geom <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> Geometry<span style="color:#f92672">(</span><span style="color:#e6db74">&#34;Box&#34;</span><span style="color:#f92672">,</span> b<span style="color:#f92672">);</span>

        Material mat <span style="color:#f92672">=</span> <span style="color:#66d9ef">new</span> Material<span style="color:#f92672">(</span>assetManager<span style="color:#f92672">,</span> <span style="color:#e6db74">&#34;Common/MatDefs/Misc/Unshaded.j3md&#34;</span><span style="color:#f92672">);</span>
        mat<span style="color:#f92672">.</span><span style="color:#a6e22e">setColor</span><span style="color:#f92672">(</span><span style="color:#e6db74">&#34;Color&#34;</span><span style="color:#f92672">,</span> ColorRGBA<span style="color:#f92672">.</span><span style="color:#a6e22e">Blue</span><span style="color:#f92672">);</span>
        geom<span style="color:#f92672">.</span><span style="color:#a6e22e">setMaterial</span><span style="color:#f92672">(</span>mat<span style="color:#f92672">);</span>

        rootNode<span style="color:#f92672">.</span><span style="color:#a6e22e">attachChild</span><span style="color:#f92672">(</span>geom<span style="color:#f92672">);</span>

    <span style="color:#f92672">}</span>

    <span style="color:#a6e22e">@Override</span>
    <span style="color:#66d9ef">public</span> <span style="color:#66d9ef">void</span> <span style="color:#a6e22e">simpleUpdate</span><span style="color:#f92672">(</span><span style="color:#66d9ef">float</span> tpf<span style="color:#f92672">)</span> <span style="color:#f92672">{</span>
        <span style="color:#75715e">//TODO: add update code
</span><span style="color:#75715e"></span>    <span style="color:#f92672">}</span>

<span style="color:#f92672">}</span></code></pre></div>
<p>Running this class will start your first game and display a blue box on the screen, and you can move around using your mouse and WASD keys. Congratulations! You&rsquo;re running your first JME game!</p>
<p>For a more thorough tutorial on jMonkey browse through our <a href="https://wiki.jmonkeyengine.org">wiki</a>. The wiki provides extended documentation as well as tutorials on how to develop your game effectively using jmonkey practices. Tutorials start from the basics all the way up to collision detection, input mapping and shaders, and will be your go-to place for most of the information you require.</p>
<p>If you ever find yourself confused or wondering how something is done, head over to our <a href="https://hub.jmonkeyengine.org">community hub</a> and create a new thread. Our ultra-helpful team and community will be more than happy to give you a hand in getting you back on track.</p>

        <br />
    </div>

	
  <footer>
        <div id="bottom-shadow"></div>
    <div class="ui inverted segment footer" style="border-radius: 0px; margin-bottom: 0px;">

        <div class="ui container">
            <br />

            <div class="ui two column stackable grid">

                <div class="column">
                    <p>
                        &copy; 2020 <a href="https://jmonkeyengine.org/">jMonkeyEngine</a>.
                        A free open-source game engine licensed under the <a href="https://choosealicense.com/licenses/bsd-3-clause/">BSD 3-Clause license</a>.
                        All rights reserved.
                    </p>
                </div>

                <div class="column">
                  <a class="ui yellow right floated button" href="/sponsor/">
                    <i class="info circle icon"></i>
                    Sponsor Us
                  </a>
                </div>

            </div>


            <br />
        </div>
    </div>

</footer>

</body>

</html>