# 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 public 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 public 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 public 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)
| | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------: | ## Dependencies ```txt - guava 30.0-jre - log4j-core 2.13.3 - reflections 0.9.9-RC1 - netty-all 4.1.63.Final - jetty-server 9.4.38.v20210224 - jetty-servlet 9.4.38.v20210224 - servlet-api 2.5 - json 20180130 - spring-boot - spring-cloud ``` ## Requirements - Java 11 - Java 8 - Docker ## License The `TenIO` project is currently available under the [MIT](https://github.com/congcoi123/tenio/raw/master/LICENSE) License. ## Changelog Please check out the [changelog](https://github.com/congcoi123/tenio/blob/master/CHANGELOG.md) for more details. ## 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 Please start the server before its corresponding client in each example package. ```code $ java ``` For instance: ```code $ java TestServerLogin configuration.example1.xml ``` ```txt |-- example |-- example1 | |-- TestClientLogin | |-- TestServerLogin |-- example2 | |-- (*)TestFsmMechanism |-- example3 | |-- TestClientAttach | |-- TestServerAttach |-- example4 | |-- TestClientMovement | |-- TestServerMovement | |-- (*)TestMovementMechanism |-- example5 | |-- (*)TestEcsMechanism |-- example6 | |-- TestClientEchoStress | |-- TestServerEchoStress |-- example7 | |-- TestServerWebsocket |-- example8 | |-- TestClientRestful | |-- TestServerRestful ``` > Happy coding !