{"id":17250094,"url":"https://github.com/stephengold/jme3-maze","last_synced_at":"2025-04-14T06:08:44.905Z","repository":{"id":55638213,"uuid":"41903458","full_name":"stephengold/jme3-maze","owner":"stephengold","description":"Game: explore a randomly-generated 3-D maze with a Pharaonic Egypt theme (New BSD license)","archived":false,"fork":false,"pushed_at":"2025-04-02T17:24:21.000Z","size":4415,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-14T06:08:39.211Z","etag":null,"topics":["3d-maze","game","java","jme3","jmonkeyengine3","maze","open-source","tonegodgui"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","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","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}},"created_at":"2015-09-04T07:33:51.000Z","updated_at":"2025-04-02T17:24:25.000Z","dependencies_parsed_at":"2023-09-28T01:13:31.852Z","dependency_job_id":"b20b974b-8649-46e3-96d9-36132cbda06f","html_url":"https://github.com/stephengold/jme3-maze","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephengold%2Fjme3-maze","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephengold%2Fjme3-maze/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephengold%2Fjme3-maze/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stephengold%2Fjme3-maze/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stephengold","download_url":"https://codeload.github.com/stephengold/jme3-maze/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248830397,"owners_count":21168272,"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":["3d-maze","game","java","jme3","jmonkeyengine3","maze","open-source","tonegodgui"],"created_at":"2024-10-15T06:46:11.036Z","updated_at":"2025-04-14T06:08:44.875Z","avatar_url":"https://github.com/stephengold.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg height=\"150\" src=\"https://i.imgur.com/MzrLrNm.png\"\u003e\n\nThe [Jme3-maze Project][jme3maze] is creating a first-person, single-player game\nwith a mouse-oriented GUI.  Its logline is:\n\u003cblockquote\u003e\nExplore a randomly-generated three-dimensional maze with a Pharaonic Egypt theme.\n\u003c/blockquote\u003e\n\nComplete source code (in [Java]) is provided under\n[a 3-clause BSD license][license].\n\nIt uses [jMonkeyEngine][jme], [tonegodGUI], and [Acorus].\n\n\n## How to build and run Jme3-maze 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-maze source code from GitHub:\n  + using [Git]:\n    + `git clone https://github.com/stephengold/jme3-maze.git`\n    + `cd jme3-maze`\n  + using a web browser:\n    + Browse to https://github.com/stephengold/jme3-maze/archive/refs/heads/master.zip\n    + save the ZIP file\n    + extract the contents of the saved ZIP file\n    + `cd` to the extracted directory/folder\n4. Run the [Gradle] wrapper:\n  + using Bash or Fish or PowerShell or Zsh: `./gradlew build runAssetProcessor`\n  + using Windows Command Prompt: `.\\gradlew build runAssetProcessor`\n\nYou can run the local build using the Gradle wrapper:\n+ using Bash or Fish or PowerShell or Zsh: `./gradlew run`\n+ using Windows Command Prompt: `.\\gradlew run`\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## Acknowledgments\n\nLike most projects, Jme3-maze builds on the work of many who\nhave gone before.  I therefore acknowledge the following\nartists and software developers:\n\n+ Cris (aka \"t0neg0d\") for creating tonegodGUI and adapting it to my needs\n+ the creators of (and contributors to) the following software:\n    + [Adobe Photoshop Elements][elements]\n    + the [Blender] 3-D animation suite\n    + the [Checkstyle] tool\n    + the [FindBugs] source-code analyzer\n    + the [Firefox] and [Google Chrome][chrome] web browsers\n    + the [Git] revision-control system and GitK commit viewer\n    + the [GitKraken] client\n    + the [Gradle] build tool\n    + the [IntelliJ IDEA][idea] and [NetBeans] integrated development environments\n    + the [Java] compiler, standard doclet, and runtime environment\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 [MakeHuman] 3-D character creation tool\n    + the [Markdown] document-conversion tool\n    + the [Meld] visual merge tool\n    + Microsoft Windows\n    + the PMD source-code analyzer\n    + the Subversion revision-control system\n    + the [WinMerge] differencing and merging tool\n\nI am grateful to [JFrog], Google, [Github], 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[adoptium]: https://adoptium.net/releases.html \"Adoptium Project\"\n[acorus]: https://stephengold.github.io/Acorus \"Acorus Project\"\n[blender]: https://docs.blender.org \"Blender 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]: https://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[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[jme3maze]: https://github.com/stephengold/jme3-maze \"Jme3-maze Project\"\n[license]: https://github.com/stephengold/jme3-maze/blob/master/LICENSE \"Jme3-maze license\"\n[lwjgl]: https://www.lwjgl.org \"Lightweight Java Game Library\"\n[makehuman]: http://www.makehumancommunity.org/ \"MakeHuman Community\"\n[markdown]: https://daringfireball.net/projects/markdown \"Markdown Project\"\n[meld]: https://meldmerge.org \"Meld merge tool\"\n[mint]: https://linuxmint.com \"Linux Mint Project\"\n[netbeans]: https://netbeans.org \"NetBeans Project\"\n[tonegodgui]: https://github.com/stephengold/tonegodgui \"TonegodGUI Project\"\n[winmerge]: https://winmerge.org \"WinMerge Project\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstephengold%2Fjme3-maze","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstephengold%2Fjme3-maze","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstephengold%2Fjme3-maze/lists"}