libgdx/libgdx-maven-archetype

Libgdx Maven archetype, largely based on the PlayN archetype

Cross-platform Game Development Framework

libGDX is a cross-platform Java game development framework based on OpenGL (ES), designed for Windows, Linux, macOS, Android, web browsers, and iOS. It provides a robust and well-established environment for rapid prototyping and iterative development. Unlike other frameworks, libGDX does not impose a specific design or coding style, allowing you the freedom to create games according to your preferences.

Open Source, Feature Packed, and Fostering a Large Third-Party Ecosystem

libGDX is released under the Apache 2.0 License, offering unrestricted usage in both commercial and non-commercial projects. While not mandatory, we appreciate any credit given to libGDX when you release a game or app using it. Check out our showcase for a selection of popular libGDX-powered games. With libGDX, you gain access to a comprehensive set of tools and features to develop multi-platform 2D and 3D games using Java.

Moreover, libGDX boasts a vibrant third-party ecosystem, with numerous tools and libraries that streamline development tasks. Explore the awesome-libgdx repository for a curated list of libGDX-centered libraries, serving as an excellent starting point for newcomers in the libGDX community.

An example game created with libGDX: Pathway by Robotality. Discover more captivating games in our Showcase.

Getting Started with libGDX / Documentation

Thanks to Gradle, you can easily set up libGDX without the need to download the framework itself. Your favorite build tool can handle everything for you. Additionally, we offer a convenient setup tool that automates project creation and downloads all the necessary components. Check out our website for instructions on getting started or refer to our comprehensive wiki.

• Creating a libGDX Project
• Building a Simple Game
• Tutorials & Demos

We provide the libGDX javadocs online for easy reference. Additionally, the javadocs are bundled with every libGDX distribution, ensuring smooth integration with your preferred IDE.

Community & Contribution

Stay up to date with the latest libGDX news by following our blog. For engaging discussions and support, join our official libGDX Discord.

Reporting Issues

Use the Issue Tracker here on GitHub to report any issues you encounter. Before submitting, please read our Getting Help guide, which walks you through the process of reporting an issue effectively.

Contributing to the Codebase

libGDX benefits greatly from contributions made by our dedicated developer community. We appreciate any assistance in making libGDX even better. Check out the CONTRIBUTING.md file for details on how to contribute. Note that contributing involves working directly with libGDX's source code, a process that regular users do not typically undertake. Refer to the Working with the Source article for guidance.

You can also support our infrastructure (build server, web server, test devices) by contributing financially through our Patreon!

libgdx-maven-archetype's Issues

Maven skeleton generating failed

Hi. I repeat step by step instructions.
When I run
mvn archetype:generate
-DarchetypeRepository=local
-DarchetypeRepository=$HOME/.m2/repository
-DarchetypeGroupId=com.badlogic.gdx
-DarchetypeArtifactId=gdx-archetype
-DarchetypeVersion=1.2.0

I get an exception:
[WARNING] Error reading archetype catalog http://repo1.maven.org/maven2 org.apache.maven.wagon.TransferFailedException: Transfer failed for http://repo1.maven.org/maven2 501 HTTPS Required

Why it uses HTTP instead of HTTPS? I set up a profile in maven settings.xml like this:

id maven-https
activation
activeByDefault true
repositories
repository
id central
URL https://repo1.maven.org/maven2
snapshots
enabled false
pluginRepositories
pluginRepositor
id central
url https://repo1.maven.org/maven2
snapshots
enabled false

When maven asks me to choose a number:
Choose a number: 16:
What is it? I didn't found it in the readme. So next, I enter group and artefact id, version, package. It doesn't ask me to enter JavaGameClassName.

Then I get more errors. One of them:
[ERROR] Unable to add module to the current project as it is not of packaging type 'pom' org.apache.maven.archetype.old.ArchetypeTemplateProcessingException: Unable to add module to the current project as it is not of packaging type 'pom'

any help?
console_log.txt

maven commands fail with "'jar-no-fork' was specified in an execution, but not found in the plugin"

First of all, I'm not particularly familiar with the maven or the rest of the java ecosystem (i'm a python developer) so this could be a user error...

Anyways, after installing this archetype and generating an empty project, all the maven subcommands (package, integration-test, etc...) fail with the following error:

INFO] ------------------------------------------------------------------------
[INFO] Building Drop Parent
[INFO]    task-segment: [integration-test]
[INFO] ------------------------------------------------------------------------
[INFO] [site:attach-descriptor {execution: default-attach-descriptor}]
[INFO] ------------------------------------------------------------------------
[INFO] Building Drop Core
[INFO]    task-segment: [integration-test]
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[ERROR] BUILD ERROR
[INFO] ------------------------------------------------------------------------
[INFO] 'jar-no-fork' was specified in an execution, but not found in the plugin
[INFO] ------------------------------------------------------------------------

I managed to resolve this by adding the maven-source-plugin to my project's pom.xml as follows:

diff --git a/pom.xml b/pom.xml
index 00d2266..c0ee2d7 100644
--- a/pom.xml
+++ b/pom.xml
@@ -34,6 +34,15 @@
                                        <target>1.6</target>
                                </configuration>
                        </plugin>
+                       <plugin>
+                               <groupId>org.apache.maven.plugins</groupId>
+                               <artifactId>maven-source-plugin</artifactId>
+                               <version>2.2.1</version>
+                               <configuration>
+                                       <source>1.6</source>
+                                       <target>1.6</target>
+                               </configuration>
+                       </plugin>
                </plugins>
        </build>

Is this something that needs to be in src/main/resources/archetype-resources/pom.xml?

Use new LWJGL 3.0 pointer methods

As the title says. Reduce Buffer allocations, yay...

mvn -Pandroid package fail : NoClassDefFoundError: Lorg/sonatype/aether/RepositorySystem

Hi. I'm trying to follow the wiki to setup maven project and import it to Intellj.
The desktop package goal works fine. But the android one is not working.
Here's the log

https://gist.github.com/jagt/6570775

Another issue is that when I'm trying to import it into IntelliJ the desktop profile works fine. But when I running the package goal of android profile, it complains that can't find the core module:

[ERROR] Failed to execute goal on project plasma-android: Could not resolve dependencies for project com.pre_sence.plasma:plasma-android:apk:0.0-DEV: Failure to find com.pre_sence.plasma:plasma-core:jar:0.0-DEV in https://oss.sonatype.org/content/repositories/snapshots/ was cached in the local repository, resolution will not be reattempted until the update interval of gdx-nightlies has elapsed or updates are forced -> [Help 1]

Unable to generate project structure

When I run the command:
mvn archetype:generate -DarchetypeRepository=local -DarchetypeRepository=$HOME/.m2/repository -DarchetypeGroupId=com.badlogic.gdx -DarchetypeArtifactId=gdx-archetype -DarchetypeVersion=1.2.0

I get this:

[INFO] Scanning for projects...
[INFO]
[INFO] -----------------------< com.bmj:BetweenWorlds >------------------------
[INFO] Building BetweenWorlds 0.0.1
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] >>> maven-archetype-plugin:3.0.1:generate (default-cli) > generate-sources @ BetweenWorlds >>>
[INFO]
[INFO] <<< maven-archetype-plugin:3.0.1:generate (default-cli) < generate-sources @ BetweenWorlds <<<
[INFO]
[INFO]
[INFO] --- maven-archetype-plugin:3.0.1:generate (default-cli) @ BetweenWorlds ---
[INFO] Generating project in Interactive mode
[WARNING] Archetype not found in any catalog. Falling back to central repository.
[WARNING] Add a repsoitory with id 'archetype' in your settings.xml if archetype's repository is elsewhere.
[WARNING] The POM for com:gdx-archetype:jar:1 is missing, no dependency information available
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Skipping BetweenWorlds

[INFO] This project has been banned from the build due to previous failures.
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  3.377 s
[INFO] Finished at: 2019-04-04T23:14:40+01:00
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-archetype-plugin:3.0.1:generate (default-cli) on project BetweenWorlds: The desired archetype does not exist (com:gdx-archetype:1) -> [Help 1]
[ERROR]
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR]
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoFailureException

Libgdx 0.9.8 archetype in repository

Would it be possible to push a tagged version of 0.9.8 and its archetype to your repository? If I'm building/releasing a game using Maven I'd like to be able to release using a tagged version as to avoid any possible bugs introduced in nightly builds.

WIKI: wrong version in installation instruction

Hi,

Can you update please instruction for installing from Maven, currently version 0.9.9 not available on server, instead 1.0-SNAPSHOT available

Unable to generate a project

I've just try the following commande :

frederic@nostromo5:~/Projects/java/myfirstgame$ mvn archetype:generate     -DarchetypeRepository=local     -DarchetypeRepository=$HOME/.m2/repository     -DarchetypeGroupId=com.badlogic.gdx     -DarchetypeArtifactId=gdx-archetype     -DarchetypeVersion=0.9.9-SNAPSHOT

And the input the following parameters :

[INFO] Scanning for projects...
[INFO]                                                                         
[INFO] ------------------------------------------------------------------------
[INFO] Building Libgdx Project Archetype 0.9.9-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO] 
[INFO] >>> maven-archetype-plugin:2.0:generate (default-cli) @ gdx-archetype >>>
[INFO] 
[INFO] <<< maven-archetype-plugin:2.0:generate (default-cli) @ gdx-archetype <<<
[INFO] 
[INFO] --- maven-archetype-plugin:2.0:generate (default-cli) @ gdx-archetype ---
[INFO] Generating project in Interactive mode
[INFO] Archetype defined by properties
[WARNING] Could not transfer metadata com.badlogic.gdx:gdx-archetype:0.9.9-SNAPSHOT/maven-metadata.xml from/to gdx-archetype-repo (/home/frederic/.m2/repository): No connector available to access repository gdx-archetype-repo (/home/frederic/.m2/repository) of type default using the available factories WagonRepositoryConnectorFactory
Define value for property 'groupId': : com.mcgivrer.games
Define value for property 'artifactId': : myfirstgame
Define value for property 'version':  1.0-SNAPSHOT: : 
Define value for property 'package':  com.mcgivrer.games: : 
Define value for property 'JavaGameClassName': : MyFirstGame
Confirm properties configuration:
groupId: com.mcgivrer.games
artifactId: myfirstgame
version: 1.0-SNAPSHOT
package: com.mcgivrer.games
JavaGameClassName: MyFirstGame
 Y: : Y

Then, the process crash with the following error :

[ERROR] org.apache.maven.archetype.exception.InvalidPackaging: Unable to add module to the current project as it is not of packaging type 'pom'
org.apache.maven.archetype.exception.ArchetypeGenerationFailure: org.apache.maven.archetype.exception.InvalidPackaging: Unable to add module to the current project as it is not of packaging type 'pom'
    at org.apache.maven.archetype.generator.DefaultFilesetArchetypeGenerator.generateArchetype(DefaultFilesetArchetypeGenerator.java:237)
    at org.apache.maven.archetype.generator.DefaultArchetypeGenerator.processFileSetArchetype(DefaultArchetypeGenerator.java:136)
    at org.apache.maven.archetype.generator.DefaultArchetypeGenerator.generateArchetype(DefaultArchetypeGenerator.java:106)
    at org.apache.maven.archetype.generator.DefaultArchetypeGenerator.generateArchetype(DefaultArchetypeGenerator.java:149)
    at org.apache.maven.archetype.generator.DefaultArchetypeGenerator.generateArchetype(DefaultArchetypeGenerator.java:209)
    at org.apache.maven.archetype.DefaultArchetypeManager.generateProjectFromArchetype(DefaultArchetypeManager.java:71)
    at org.apache.maven.archetype.mojos.CreateProjectFromArchetypeMojo.execute(CreateProjectFromArchetypeMojo.java:190)
    at org.apache.maven.plugin.DefaultBuildPluginManager.executeMojo(DefaultBuildPluginManager.java:101)
    at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:209)
    at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:153)
    at org.apache.maven.lifecycle.internal.MojoExecutor.execute(MojoExecutor.java:145)
    at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:84)
    at org.apache.maven.lifecycle.internal.LifecycleModuleBuilder.buildProject(LifecycleModuleBuilder.java:59)
    at org.apache.maven.lifecycle.internal.LifecycleStarter.singleThreadedBuild(LifecycleStarter.java:183)
    at org.apache.maven.lifecycle.internal.LifecycleStarter.execute(LifecycleStarter.java:161)
    at org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:320)
    at org.apache.maven.DefaultMaven.execute(DefaultMaven.java:156)
    at org.apache.maven.cli.MavenCli.execute(MavenCli.java:537)
    at org.apache.maven.cli.MavenCli.doMain(MavenCli.java:196)
    at org.apache.maven.cli.MavenCli.main(MavenCli.java:141)
    at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)
    at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    at java.lang.reflect.Method.invoke(Method.java:606)
    at org.codehaus.plexus.classworlds.launcher.Launcher.launchEnhanced(Launcher.java:290)
    at org.codehaus.plexus.classworlds.launcher.Launcher.launch(Launcher.java:230)
    at org.codehaus.plexus.classworlds.launcher.Launcher.mainWithExitCode(Launcher.java:409)
    at org.codehaus.plexus.classworlds.launcher.Launcher.main(Launcher.java:352)
Caused by: org.apache.maven.archetype.exception.InvalidPackaging: Unable to add module to the current project as it is not of packaging type 'pom'
    at org.apache.maven.archetype.common.DefaultPomManager.addModule(DefaultPomManager.java:98)
    at org.apache.maven.archetype.generator.DefaultFilesetArchetypeGenerator.processPomWithParent(DefaultFilesetArchetypeGenerator.java:608)
    at org.apache.maven.archetype.generator.DefaultFilesetArchetypeGenerator.processFilesetProject(DefaultFilesetArchetypeGenerator.java:553)
    at org.apache.maven.archetype.generator.DefaultFilesetArchetypeGenerator.processFilesetModule(DefaultFilesetArchetypeGenerator.java:495)
    at org.apache.maven.archetype.generator.DefaultFilesetArchetypeGenerator.generateArchetype(DefaultFilesetArchetypeGenerator.java:210)
    ... 27 more
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 23.383s
[INFO] Finished at: Mon Oct 21 20:56:00 CEST 2013
[INFO] Final Memory: 9M/81M
[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-archetype-plugin:2.0:generate (default-cli) on project gdx-archetype: org.apache.maven.archetype.exception.InvalidPackaging: Unable to add module to the current project as it is not of packaging type 'pom' -> [Help 1]
[ERROR] 
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] 
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoFailureException
frederic@nostromo5:~/Projects/java/libgdx-maven-archetype$ 

What have I done wrong ?

Add support linux x86_64 to the gdx-freetype-platform

Maven can't resolve gdx depency.

Then I have generated maven project according to documentation. In parent pom file gdx.version is 0.9.9-SNAPSHOT. Maven can't resolve it. And I think it is an old version and needs to be changed.