libgdx-screenmanager
A screen manager for libGDX games that simplifies screen switching with built-in transition effects.
What is libgdx-screenmanager?
libgdx-screenmanager is a screen management library for libGDX, a popular Java game development framework. It simplifies switching between game screens (like menus, levels, or settings) and adds visual transition effects between them. It solves the problem of manually managing screen lifecycles and input handling in libGDX projects.
libGDX developers building 2D or 3D games who want to implement screen transitions and streamline screen management without writing boilerplate code.
It offers a clean, tested API with automatic input handling and support for custom shader transitions, reducing development time compared to manual implementations.
Overview
A screen manager for libgdx with support for transitions.
Use Cases
Best For
- Adding smooth transitions between menus and gameplay screens in libGDX games
- Managing complex screen stacks (e.g., pause menus, inventory screens) in Java-based games
- Implementing shader-based screen effects (e.g., fades, slides, wipes) in libGDX
- Simplifying input processor registration/unregistration across multiple screens
- Building GWT-compatible web games with polished screen navigation
- Reducing boilerplate code for screen lifecycle management in libGDX projects
Not Ideal For
- Games with only a single screen or minimal UI navigation that don't benefit from transition effects
- Developers who require fine-grained control over screen lifecycle and input processing without abstraction layers
- Projects using game engines other than libGDX, as it's tightly integrated with libGDX's architecture
- Performance-critical applications where even minor overhead from transition management is unacceptable
Pros & Cons
Pros
Provides a simple API with methods like `pushScreen` to switch screens, reducing boilerplate code compared to manual libGDX screen handling.
Includes built-in transitions and allows integration of custom shader-based transitions from sources like GL Transitions, enabling polished visual effects.
Handles registration and unregistration of input processors automatically when screens are shown or hidden, simplifying input logic across screens.
Features comprehensive wiki documentation and non-graphical tests, ensuring reliability and ease of integration for developers.
Cons
Forces games and screens to extend `ManagedGame` and `ManagedScreen`, which can be restrictive for projects with existing inheritance hierarchies or custom base classes.
Even when transitions are disabled by passing null, the library maintains transition management logic that may introduce unnecessary performance overhead in simple use cases.
Primarily optimized for 2D screen transitions and may not handle complex 3D scene management or transitions as effectively, requiring additional workarounds.
Frequently Asked Questions
Related Projects
Box2DLightsFork of box2dlights by Kalle Hamalainen
gdx-gltfGLTF 2.0 3D format support and PBR shader implementation for LibGDX
gdx-vfxlibGDX post-processing visual effects
Shape DrawerA library for libGDX that draws simple shapes using a batch.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.