nrsharip / hammergenics Goto Github PK

HammerGenics is a simple, extensible (with Groovy - under development) 3D sanbox game engine built on top of the LibGDX ecosystem and Bullet3 physics engine. It has been designed with an idea that the game development could be as simple, seamless and joyful as playing with Lego.

Major features introduced in current version are:

• Material Attributes editor: the UI and underlying structures to edit colors, textures and lights
• Mesh editor: including node transforms and render, vertex analysis for primitive shapes (used for tiles in map/terrain generation)
• Animation editor: allows to create the keyframes and edit the bones affected with the timeline frame slider
• Map Generator: with the help of noise4j allows to generate the terrain chunk grids and apply the tiles, which are primitive terrain parts in the form of a squerish mesh
• Physics: currently all the models that are being added to the project have rigid body created and being added to the Dynamics World (Bullet3) engine
• AI Algorithms: currently implemented the following features from gdx-ai library: Steering, Formations and Pathfinding Algorithms

CREDITS: assets by Kenney (Animated Characters 1, Car Kit, Weapon Pack etc.)

Material Attributes	Mesh Editor
Animations	Map Generation
Physics	AI Algorithms

HammerGenics is released under the Apache License Version 2.0.

As an example of another well-known projects under the very same license think of Android OS, Spring Framework, Gradle or Apache HTTP Server (or any of these projects) which are installed and used by the majority of people and organizations accross the globe.

Address any licensing concerns or considerations regarding the use of HammerGenics as you were dealing with any of these projects.

1. Prerequisites
   1. Download Java Development Kit 8
   2. git clone or download the sources
2. Project Structure
   1. :core Project structure
   2. Credits for libraries
3. Running HammerGenics
   1. Running :desktop Project

Choose one of the available distributors and download JDK 8:

1. Adoptium.net (former AdoptOpenJdk)
2. Amazon Corretto

Do one of the following:

git clone https://github.com/nrsharip/hammergenics.git

OR

Download the ZIP archive with the source code of this repo.

Run the following command to see the list of the projects in the build: .\gradlew.bat projects.

The output should look like this:

------------------------------------------------------------
Root project
------------------------------------------------------------

Root project 'hammergenics'
+--- Project ':android'
+--- Project ':core'
+--- Project ':desktop'
+--- Project ':html'
\--- Project ':ios'

Other useful commands:

1. .\gradlew.bat model (also for project specific info, e.g. .\gradlew.bat core:model)
2. .\gradlew.bat properties (also for project specific info, e.g. .\gradlew.bat core:properties)
3. .\gradlew.bat tasks -all (also for project specific info, e.g. .\gradlew.bat core:tasks)

The following is a high-level component diagram to show the folder/package structure of the :core Project and the dependencies these packages have on the external libraries

.\gradlew.bat desktop:run

see also Command Line Interface from LibGDX.