{"id":17250101,"url":"https://github.com/stephengold/jme3-utilities","last_synced_at":"2025-06-22T02:38:27.691Z","repository":{"id":46137848,"uuid":"41902984","full_name":"stephengold/jme3-utilities","owner":"stephengold","description":"Reusable code and assets for jMonkeyEngine games (code has New BSD license)","archived":false,"fork":false,"pushed_at":"2025-06-06T00:16:37.000Z","size":52274,"stargazers_count":35,"open_issues_count":0,"forks_count":8,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-06-06T01:23:53.623Z","etag":null,"topics":["gui","java","jme3","jmonkeyengine","jmonkeyengine3","jvm-library","nifty-gui"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stephengold.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-09-04T07:19:50.000Z","updated_at":"2025-06-06T00:16:39.000Z","dependencies_parsed_at":"2023-09-28T01:32:22.178Z","dependency_job_id":"ca426148-90e3-492d-a50b-981dcee21d8c","html_url":"https://github.com/stephengold/jme3-utilities","commit_stats":null,"previous_names":[],"tags_count":346,"template":false,"template_full_name":null,"purl":"pkg:github/stephengold/jme3-utilities","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephengold%2Fjme3-utilities","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephengold%2Fjme3-utilities/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephengold%2Fjme3-utilities/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephengold%2Fjme3-utilities/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stephengold","download_url":"https://codeload.github.com/stephengold/jme3-utilities/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephengold%2Fjme3-utilities/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261226059,"owners_count":23127255,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gui","java","jme3","jmonkeyengine","jmonkeyengine3","jvm-library","nifty-gui"],"created_at":"2024-10-15T06:46:12.895Z","updated_at":"2025-06-22T02:38:22.675Z","avatar_url":"https://github.com/stephengold.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Jme3-utilities Project\n\n[The Jme3-utilities Project][utilities] contains Java packages and assets, developed for\nsgold's jMonkeyEngine projects, which might prove useful in similar projects.\n\nIt contains 4 subprojects:\n\n1. nifty: the `jme3-utilities-nifty` library for using NiftyGUI user\n   interfaces with jMonkeyEngine\n2. x: the `jme3-utilities-x` library of experimental software\n3. moon-ccbysa: assets for a realistic Moon in `SkyControl`\n4. tests: demos, examples, and test software\n\nThe `SkyControl` library, formerly a subproject,\nis now [a separate project at GitHub][skycontrol].\n\nThe textures subproject\nis now part of[the SkyControl Project][skycontrol].\n\nThe `jme3-utilities-heart` library, formerly a subproject,\nis now [Heart], a separate project at GitHub.\n\nThe `jme3-utilities-debug` library, formerly a subproject,\nis now part of [the Heart Library][heart].\n\nThe `jme3-utilities-ui` library, formerly a subproject, is now [Acorus],\na separate project at GitHub.\n\nThe `Minie` library, formerly a subproject,\nis now [a separate project at GitHub][minie].\n\nThe `Wes` library, formerly a subproject,\nis now [a separate project at GitHub][wes].\n\nComplete source code (in Java) is provided under\n[a 3-clause BSD license][license].\n\n\n\u003ca name=\"toc\"\u003e\u003c/a\u003e\n\n## Contents of this document\n\n+ [How to build Jme3-utilities from source](#build)\n+ [Downloads](#downloads)\n+ [Conventions](#conventions)\n+ [History](#history)\n+ [Acknowledgments](#acks)\n\n\n\u003ca name=\"build\"\u003e\u003c/a\u003e\n\n## How to build Jme3-utilities from source\n\n1. Install a [Java Development Kit (JDK)][adoptium],\n   if you don't already have one.\n2. Point the `JAVA_HOME` environment variable to your JDK installation:\n   (In other words, set it to the path of a directory/folder\n   containing a \"bin\" that contains a Java executable.\n   That path might look something like\n   \"C:\\Program Files\\Eclipse Adoptium\\jdk-17.0.3.7-hotspot\"\n   or \"/usr/lib/jvm/java-17-openjdk-amd64/\" or\n   \"/Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home\" .)\n  + using Bash or Zsh: `export JAVA_HOME=\"` *path to installation* `\"`\n  + using [Fish]: `set -g JAVA_HOME \"` *path to installation* `\"`\n  + using Windows Command Prompt: `set JAVA_HOME=\"` *path to installation* `\"`\n  + using PowerShell: `$env:JAVA_HOME = '` *path to installation* `'`\n3. Download and extract the Jme3-utilities source code from GitHub:\n  + `git clone https://github.com/stephengold/jme3-utilities.git`\n  + `cd jme3-utilities`\n  + `git checkout -b latest nifty-0.9.37`\n4. Run the [Gradle] wrapper:\n  + using Bash or Fish or PowerShell or Zsh: `./gradlew build`\n  + using Windows Command Prompt: `.\\gradlew build`\n\nAfter a successful build,\nMaven artifacts will be found in \"*/build/libs\".\n\nYou can install the artifacts to your local Maven repository:\n+ using Bash or Fish or PowerShell or Zsh: `./gradlew install`\n+ using Windows Command Prompt: `.\\gradlew install`\n\nYou can restore the project to a pristine state:\n+ using Bash or Fish or PowerShell or Zsh: `./gradlew clean`\n+ using Windows Command Prompt: `.\\gradlew clean`\n\n[Jump to the table of contents](#toc)\n\n\n\u003ca name=\"downloads\"\u003e\u003c/a\u003e\n\n## Downloads\n\nRecent releases can be downloaded from\n[GitHub](https://github.com/stephengold/jme3-utilities/releases).\n\nRecent Maven artifacts (since nifty v0.9.18 and x v0.2.20)\nare available from MavenCentral:\n[nifty](https://repo1.maven.org/maven2/com/github/stephengold/jme3-utilities-nifty)\nand [x](https://repo1.maven.org/maven2/com/github/stephengold/jme3-utilities-x/).\n\n[Jump to the table of contents](#toc)\n\n\n\u003ca name=\"conventions\"\u003e\u003c/a\u003e\n\n## Conventions\n\nMost package names begin with `jme3utilities`.  Packages copied from\njMonkeyEngine, however, retain their original names, which began with `com.jme3`.\n\nThe source code is compatible with JDK 7.\nThe pre-built libraries are compatible with JDK 8.\n\n[Jump to the table of contents](#toc)\n\n\n\u003ca name=\"history\"\u003e\u003c/a\u003e\n\n## History\n\nSince September 2015, the Jme3-utilities Project has been hosted at\n[GitHub](https://github.com/stephengold/jme3-utilities).\n\nFrom November 2013 to September 2015, it was hosted at\n[Google Code](https://code.google.com/archive/).\n\nThe evolution of each subproject is chronicled in its release notes:\n\n+ [debug](https://github.com/stephengold/jme3-utilities/blob/master/debug/release-notes.md)\n+ [nifty](https://github.com/stephengold/jme3-utilities/blob/master/nifty/release-notes.md)\n+ [x](https://github.com/stephengold/jme3-utilities/blob/master/x/release-notes.md)\n\n[Jump to the table of contents](#toc)\n\n\n\u003ca name=\"acks\"\u003e\u003c/a\u003e\n\n## Acknowledgments\n\nLike most projects, the Jme3-utilities Project builds on the work of many who\nhave gone before.  I therefore acknowledge the following\nsoftware developers:\n\n+ Paul Speed, for helpful insights which got me unstuck during debugging\n+ Rémy Bouquet (aka \"nehon\") for many helpful insights\n+ the creators of (and contributors to) the following software:\n    + [Adobe Photoshop Elements][elements]\n    + the [Ant] and [Gradle] build tools\n    + the [Checkstyle] tool\n    + the [FindBugs] source-code analyzer\n    + the [Firefox] and [Google Chrome][chrome] web browsers\n    + the [Git] and Subversion revision-control systems\n    + the [GitKraken] client\n    + Guava core libraries for Java\n    + the [IntelliJ IDEA][idea] and [NetBeans] integrated development environments\n    + the [Java] compiler, standard doclet, and virtual machine\n    + the JCommander Java framework\n    + [jMonkeyEngine][jme] and the jME3 Software Development Kit\n    + the [Linux Mint][mint] operating system\n    + LWJGL, the Lightweight Java Game Library\n    + the [Markdown] document-conversion tool\n    + the [Meld] visual merge tool\n    + Microsoft Windows\n    + the [Nifty] graphical user-interface library\n    + the PMD source-code analyzer\n    + the [WinMerge] differencing and merging tool\n\nI am grateful to [GitHub], [Sonatype], [JFrog], and [Imgur]\nfor providing free hosting for this project\nand many other open-source projects.\n\nI'm also grateful to my dear Holly, for keeping me sane.\n\nIf I've misattributed anything or left anyone out, please let me know, so I can\ncorrect the situation: sgold@sonic.net\n\n[Jump to the table of contents](#toc)\n\n\n[acorus]: https://github.com/stephengold/Acorus \"Acorus Project\"\n[adoptium]: https://adoptium.net/releases.html \"Adoptium Project\"\n[ant]: https://ant.apache.org \"Apache Ant Project\"\n[checkstyle]: https://checkstyle.org \"Checkstyle\"\n[chrome]: https://www.google.com/chrome \"Chrome\"\n[elements]: https://www.adobe.com/products/photoshop-elements.html \"Photoshop Elements\"\n[findbugs]: http://findbugs.sourceforge.net \"FindBugs Project\"\n[firefox]: https://www.mozilla.org/en-US/firefox \"Firefox\"\n[fish]: https://fishshell.com/ \"Fish command-line shell\"\n[git]: https://git-scm.com \"Git\"\n[github]: https://github.com \"GitHub\"\n[gitkraken]: https://www.gitkraken.com \"GitKraken client\"\n[gradle]: https://gradle.org \"Gradle Project\"\n[heart]: https://github.com/stephengold/Heart \"Heart Project\"\n[idea]: https://www.jetbrains.com/idea/ \"IntelliJ IDEA\"\n[imgur]: https://imgur.com/ \"Imgur\"\n[java]: https://en.wikipedia.org/wiki/Java_(programming_language) \"Java programming language\"\n[jfrog]: https://www.jfrog.com \"JFrog\"\n[jme]: https://jmonkeyengine.org \"jMonkeyEngine Project\"\n[license]: https://github.com/stephengold/jme3-utilities/blob/master/license.txt \"jme3-utilities license\"\n[markdown]: https://daringfireball.net/projects/markdown \"Markdown Project\"\n[meld]: https://meldmerge.org \"Meld merge tool\"\n[minie]: https://stephengold.github.io/Minie/minie/overview.html \"Minie Project\"\n[mint]: https://linuxmint.com \"Linux Mint Project\"\n[netbeans]: https://netbeans.org \"NetBeans Project\"\n[nifty]: https://nifty-gui.github.io/nifty-gui \"Nifty GUI Project\"\n[skycontrol]: https://github.com/stephengold/SkyControl \"SkyControl Project\"\n[sonatype]: https://www.sonatype.com \"Sonatype\"\n[utilities]: https://github.com/stephengold/jme3-utilities \"Jme3-utilities Project\"\n[wes]: https://github.com/stephengold/Wes \"Wes Project\"\n[winmerge]: https://winmerge.org \"WinMerge Project\"","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstephengold%2Fjme3-utilities","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstephengold%2Fjme3-utilities","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstephengold%2Fjme3-utilities/lists"}