Lunar
What is Lunar?
Lunar is a networking library for LibGDX. With lunar you can easily create multiplayer games quickly and efficiently. Lunar provides many common utilities such as entities, worlds, protocol, and box2d support!
Lunar is still very early, so please be nice :)
Actual Game Demo
https://github.com/Vrekt/OasisGame
Features
- Player and entity renderers with animation loading.
- Partially Networked Box2d worlds.
- Networked player moving and velocity.
- Networked player creation/removing.
- Game lobbies and worlds.
- Basic entity support
- A expandable protocol with SSL support.
- Very customizable and extendable.
Get A Taste
// apply force to another player and send it to others since they were attacked.
this.player.getWorldIn().applyForceToOtherPlayerNetwork(somePlayer, player.getConnection(), fx, fy, px, py, true);
// apply a knock-back force to ourselves.
this.player.getWorldIn().applyForceToPlayerNetwork(player.getConnection(), fx, fy, point.x, point.y, true);
// register a unique custom packet.
this.connection.registerPacket(99, MyCustomPacket::new, packet -> handleEntityPropertiesPacket(packet));
// Create a networked world for others to join us.
// We tell the world to handle physics updates and local player updates for us.
lunarWorld = new BasicLunarWorld(player, world, scaling, true, true, true);
// Spawn our player in the world.
player.spawnEntityInWorld(lunarWorld, 2.0f, 2.0f);
// connect to remote server.
final LunarClientServer server = new LunarClientServer(lunar, "localhost", 6969);
server.connect().join();
// get our connection
final PlayerConnection connection = (PlayerConnection) server.getConnection();
Want to jump in? Check out the Building A Simple Game
Documentation and Examples
Planned Features
- Networked collision
- Better movement sync.
- Better protocol security.
- Networked entities and other map/world objects.
- ...
Known Issues
- Random ghost player blinks next to networked player
- Initial position seems to be de-synced some way
- Worlds will need to be disposed when switching between them
- probably other stuff I don't know about.
Using Lunar
You can find releases in the releases section. Both client and server rely on the Protocol dependency.
You must also add a dependency for netty-all.
Gradle 6.7.2
implementation group: 'io.netty', name: 'netty-all', version: '4.1.48.Final'
17 Nov 8, 2022
18 Oct 23, 2022
13 Nov 18, 2022
0 Dec 20, 2022
27 Dec 10, 2022
58 Dec 26, 2022
1 Jan 23, 2022
69 Jan 7, 2023
3 Nov 14, 2021
20 Apr 20, 2022
2 Dec 19, 2022
6 Feb 3, 2022
1 Jan 13, 2022
5 Sep 11, 2022
4 Jul 23, 2022
26 Jan 5, 2023
75 Dec 22, 2022
10 Nov 22, 2022
238 Dec 16, 2022