Skip to content

stephengold/Georg

Repository files navigation

The Georg Project provides procedurally generated assets for use in JMonkeyEngine applications.

It contains 3 subprojects:

  1. FuzeCreekTextures: generate textures for the FuzeCreek project
  2. HeartTextures: generate textures for the Heart project
  3. MavTextures: generate textures for the More Advanced Vehicles project

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

How to build Georg from source

  1. Install a Java Development Kit (JDK), if you don't already have one.
  2. Download and extract the Georg source code from GitHub:
  • using Git:
    • git clone https://github.com/stephengold/Georg.git
    • cd Georg
  1. 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. Run the Gradle wrapper:
  • using Bash or Fish or PowerShell or Zsh: ./gradlew textures
  • using Windows Command Prompt: .\gradlew textures

After a successful build, texture assets will be found in FuzeCreekTextures/build, HeartTextures/build, and MavTextures/build.

Conventions

The source code is compatible with JDK 7.

Acknowledgments

Like most projects, the Georg Project builds on the work of many who have gone before. I therefore acknowledge the creators of (and contributors to) the following software:

  • the Firefox web browser
  • the Git revision-control system and GitK commit viewer
  • the GitKraken client
  • the Gradle build tool
  • the ImgScalr Library
  • the Java compiler, standard doclet, and virtual machine
  • jMonkeyEngine and the jME3 Software Development Kit
  • the Linux Mint operating system
  • LWJGL, the Lightweight Java Game Library
  • the Markdown document-conversion tool
  • the NetBeans integrated development environment

I am grateful to Github 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]