# TenIO `TenIO` is an open-source project to create multiplayer online games that includes a java NIO (Non-blocking I/O) based server specifically designed for multiplayer games, which supports UDP, TCP, Websocket, HTTP transports, and available simple client projects for quick development. ## Features - Scalable, distributed design - Easy-to-use, OOP design - Based on standard Java development, ensuring cross-platform support - Simple event handlers implementation - Simple physic simulator and debugger - Have simple existing game clients for rapid development ## Showcases | [

_{Gold Miner Online}](https://www.youtube.com/watch?v=BBv5IQFHLjc)
| [

_{Retro Brick Game Online}](https://www.youtube.com/watch?v=nojkJMAfG6Y)
| | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------: | ## MMOG System Architecture ![Game Server](https://github.com/congcoi123/tenio/raw/master/documentations/datagram/game-server.jpg) ![Game System](https://github.com/congcoi123/tenio/raw/master/documentations/datagram/game-system.jpg) ## First Glimpse - Simple Movement Simulation ![Simple Movement Simulation](https://github.com/congcoi123/tenio/raw/master/assets/movement-simulation-example-4.gif) ## Simple Implementation ```Java @Bootstrap public final class TestServerLogin { public static void main(String[] params) { ApplicationLauncher.run(TestServerLogin.class, params); } } @Component final class ConnectionEstablishedHandler extends AbstractExtension implements EventConnectionEstablishedResult { @Override public void handle(Session session, ServerMessage message, ConnectionEstablishedResult result) { if (result == ConnectionEstablishedResult.SUCCESS) { var data = (ZeroObject) message.getData(); api().login(data.getString(SharedEventKey.KEY_PLAYER_LOGIN), session); } } } @Component final class PlayerLoggedinHandler extends AbstractExtension implements EventPlayerLoggedinResult { @Override public void handle(Player player, PlayerLoggedinResult result) { if (result == PlayerLoggedinResult.SUCCESS) { var data = object().putString(SharedEventKey.KEY_PLAYER_LOGIN, String.format("Welcome to server: %s", player.getName())); response().setContent(data.toBinary()).setRecipient(player).write(); } } } @Component final class ReceivedMessageFromPlayerHandler extends AbstractExtension implements EventReceivedMessageFromPlayer { @Override public void handle(Player player, ServerMessage message) { var data = object().putString(SharedEventKey.KEY_CLIENT_SERVER_ECHO, String.format("Echo(%s): %s", player.getName(), ((ZeroObject) message.getData()).getString(SharedEventKey.KEY_CLIENT_SERVER_ECHO))); response().setContent(data.toBinary()).setRecipient(player).write(); } } ``` ## Wiki The [wiki](https://github.com/congcoi123/tenio/wiki) provides implementation level details and answers to general questions that a developer starting to use `TenIO` might have about it. ## Clients | [

_{TenIO Cocos2dx}](https://github.com/congcoi123/tenio-cocos2dx)
| [

_{TenIO Libgdx}](https://github.com/congcoi123/tenio-libgdx)
| [

_{TenIO Unity}](https://github.com/congcoi123/tenio-unity)
| [

_{TenIO Phaserjs}](https://github.com/congcoi123/tenio-phaserjs)
| | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------: | ## Framework The project is strongly based on the same name framework as you can be referenced by the following repositories. - [`tenio-common`](https://github.com/congcoi123/tenio-common.git) - [`tenio-core`](https://github.com/congcoi123/tenio-core.git) - [`tenio-engine`](https://github.com/congcoi123/tenio-engine.git) ## Requirements ```txt - Java 11 - Java 8 - Docker ``` ## License The `TenIO` project is currently available under the [MIT](https://github.com/congcoi123/tenio/raw/master/LICENSE) License. ## Contributing Please check out the [contributing guideline](https://github.com/congcoi123/tenio/blob/master/CONTRIBUTING.md) for more details. ## Documentations Please check out the [documentations directory](https://github.com/congcoi123/tenio/raw/master/documentations) for more details. ## Installation ```sh $ git clone https://github.com/congcoi123/tenio.git ``` ## Examples ### Collection Please check out [`this repository`](https://github.com/congcoi123/tenio-examples.git) for references. ### Wanna try Kotlin? Then you should check out [`this showcase`](https://github.com/congcoi123/lonely-dragon.git) for more details. > Happy coding !