• Stars
    star
    33
  • Rank 783,877 (Top 16 %)
  • Language
    Java
  • License
    Other
  • Created about 9 years ago
  • Updated about 1 month ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Reusable code and assets for jMonkeyEngine games (code has New BSD license)

Jme3-utilities Project

The Jme3-utilities Project contains Java packages and assets, developed for sgold's jMonkeyEngine projects, which might prove useful in similar projects.

It contains 4 sub-projects:

  1. nifty: the jme3-utilities-nifty library for using NiftyGUI user interfaces with jMonkeyEngine
  2. x: the jme3-utilities-x library of experimental software
  3. moon-ccbysa: assets for a realistic Moon in SkyControl
  4. tests: demos, examples, and test software

The SkyControl library, formerly a sub-project, is now a separate project at GitHub.

The textures sub-project is now part ofthe SkyControl Project.

The jme3-utilities-heart library, formerly a sub-project, is now Heart, a separate project at GitHub.

The jme3-utilities-debug library, formerly a sub-project, is now part of the Heart Library.

The jme3-utilities-ui library, formerly a sub-project, is now Acorus, a separate project at GitHub.

The Minie library, formerly a sub-project, is now a separate project at GitHub.

The Wes library, formerly a sub-project, is now a separate project at GitHub.

Complete source code (in Java) is provided under a 3-clause BSD license.

Contents of this document

How to build Jme3-utilities from source

  1. Install a Java Development Kit (JDK), if you don't already have one.
  2. Point the JAVA_HOME environment variable to your JDK installation: (In other words, set it to the path of a directory/folder containing a "bin" that contains a Java executable. That path might look something like "C:\Program Files\Eclipse Adoptium\jdk-17.0.3.7-hotspot" or "/usr/lib/jvm/java-17-openjdk-amd64/" or "/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home" .)
  • using Bash or Zsh: export JAVA_HOME=" path to installation "
  • using Fish: set -g JAVA_HOME " path to installation "
  • using Windows Command Prompt: set JAVA_HOME=" path to installation "
  • using PowerShell: $env:JAVA_HOME = ' path to installation '
  1. Download and extract the Jme3-utilities source code from GitHub:
  • git clone https://github.com/stephengold/jme3-utilities.git
  • cd jme3-utilities
  • git checkout -b latest nifty-0.9.37
  1. Run the Gradle wrapper:
  • using Bash or Fish or PowerShell or Zsh: ./gradlew build
  • using Windows Command Prompt: .\gradlew build

After a successful build, Maven artifacts will be found in "*/build/libs".

You can install the artifacts to your local Maven repository:

  • using Bash or Fish or PowerShell or Zsh: ./gradlew install
  • using Windows Command Prompt: .\gradlew install

You can restore the project to a pristine state:

  • using Bash or Fish or PowerShell or Zsh: ./gradlew clean
  • using Windows Command Prompt: .\gradlew clean

Jump to the table of contents

Downloads

Recent releases can be downloaded from GitHub.

Recent Maven artifacts (since nifty v0.9.18 and x v0.2.20) are available from MavenCentral: nifty and x.

Jump to the table of contents

Conventions

Most package names begin with jme3utilities. Packages copied from jMonkeyEngine, however, retain their original names, which began with com.jme3.

The source code is compatible with JDK 7. The pre-built libraries are compatible with JDK 8.

Jump to the table of contents

History

Since September 2015, the Jme3-utilities Project has been hosted at GitHub.

From November 2013 to September 2015, it was hosted at Google Code.

The evolution of each sub-project is chronicled in its release notes:

Jump to the table of contents

Acknowledgments

Like most projects, the Jme3-utilities Project builds on the work of many who have gone before. I therefore acknowledge the following software developers:

  • Paul Speed, for helpful insights which got me unstuck during debugging
  • Rรฉmy Bouquet (aka "nehon") for many helpful insights
  • the creators of (and contributors to) the following software:

I am grateful to GitHub, Sonatype, JFrog, and Imgur for providing free hosting for this project and many other open-source projects.

I'm also grateful to my dear Holly, for keeping me sane.

If I've misattributed anything or left anyone out, please let me know, so I can correct the situation: [email protected]

Jump to the table of contents

More Repositories

1

Minie

Integrate Bullet Physics and V-HACD into jMonkeyEngine projects (code has New BSD license)
Java
122
star
2

Libbulletjme

A JNI interface to Bullet Physics and V-HACD
C++
86
star
3

Maud

An editor for jMonkeyEngine 3-D models (code has New BSD license)
Java
39
star
4

Wes

An animation editing and retargeting library for jMonkeyEngine (code has New BSD license)
Java
17
star
5

Heart

A general-purpose add-on library for jMonkeyEngine (code has New BSD license)
Java
15
star
6

SkyControl

A sky simulation library for jMonkeyEngine (code has New BSD license)
Java
15
star
7

jolt-jni

JVM bindings for Jolt Physics
Java
13
star
8

j-ogg-all

Open-source JVM libraries for reading Ogg bitstreams and decoding the media they contain.
Java
12
star
9

MonkeyWrench

A versatile library for loading 3-D assets into JMonkeyEngine (code has New BSD license)
Java
11
star
10

LbjExamples

Documentation and example applications for the Libbulletjme physics simulation library
Java
11
star
11

Garrett

A collection of camera controllers for JMonkeyEngine
Java
11
star
12

asm

A small and fast library for manipulating Java bytecode.
Java
9
star
13

jme3-maze

Game: explore a randomly-generated 3-D maze with a Pharaonic Egypt theme (New BSD license)
Java
7
star
14

BasicGame-on-Gradle

jMonkeyEngine's prototypical BasicGame implemented as a Gradle/Java project
Java
7
star
15

kk-physics

Integrate Jolt Physics into jMonkeyEngine projects (code has New BSD license)
Java
6
star
16

V-Sport

A Vulkan-based 3-D graphics engine, written in Java (code has New BSD license)
Java
6
star
17

JmePower

A JVM library to promote the jMonkeyEngine game engine
Java
5
star
18

Banana

Physics tests and performance benchmarks for the jMonkeyEngine3 game engine.
Java
4
star
19

Acorus

An action-oriented user-interface library for jMonkeyEngine
Java
3
star
20

stephengold.github.io

Stephen Gold's personal website
Ruby
3
star
21

RyzomConverter

Adapt models from the Ryzom Asset Repository for use with jMonkeyEngine.
Java
3
star
22

stack-alloc

Allocate Java objects from method stack instead of the program heap.
Java
3
star
23

characters-for-jme

Animated 3-D character models for use with JMonkeyEngine.
3
star
24

sport

A Simple Physics-ORienTed 3-D graphics engine based on OpenGL.
Java
3
star
25

RyzomDemos

Demonstrates how to use 3-D assets from the Ryzom Asset Repository with JMonkeyEngine.
Java
2
star
26

Minie-site-it

Translation of the Minie project documentation into Italian.
2
star
27

FuzeCreek

A grid-based, real-time river-rafting game with explosives
Java
2
star
28

BasicGame-on-Kotlin

jMonkeyEngine's prototypical BasicGame implemented as a Gradle/Kotlin project
Kotlin
1
star
29

DacWizard

A GUI application to configure a Minie ragdoll (code has New BSD license)
Java
1
star
30

HelloCollision-on-Gradle

jMonkeyEngine's HelloCollision tutorial implemented as a Gradle project
Java
1
star
31

Georg

Procedurally generated textures (New BSD license)
Java
1
star
32

gold-tiles

turn-based multi-player game: draw tiles from a bag and play them onto a 2-D grid (GNU GPL v3 license)
C++
1
star
33

snap-jolt

Testbed for combining jolt-jni with jSnapLoader
Java
1
star
34

macana

Testbed for combining Obsidian with SPORT
Java
1
star