libGDX Cross-Platform Game Development

Knowledge base for building production-grade games with libGDX, the cross-platform Java/Kotlin game framework.

When to Use

• Scaffolding a new libGDX project with gdx-liftoff
• Designing the Game/Screen structure and Scene2D + Ashley + Box2D integration
• Managing the rendering pipeline: SpriteBatch, TextureAtlas, viewports, cameras
• Handling AssetManager lifecycle and OpenGL resource disposal
• Targeting Desktop, Android, iOS, or HTML5 from a shared codebase
• Migrating to libGDX 1.14.0 and its breaking changes (Pools -> PoolManager, JsonValue case sensitivity)
• Debugging frame-rate drops, VRAM leaks, or input handling bugs

Quick Start

For 80% of new libGDX projects, follow this path: