{"id":13622901,"url":"https://github.com/moddio/moddio2","last_synced_at":"2025-04-15T10:31:49.812Z","repository":{"id":74281991,"uuid":"517121808","full_name":"moddio/moddio2","owner":"moddio","description":"HTML5 multiplayer game engine","archived":false,"fork":false,"pushed_at":"2024-04-13T15:59:37.000Z","size":34018,"stargazers_count":447,"open_issues_count":97,"forks_count":37,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-04-14T12:03:31.125Z","etag":null,"topics":["game-engine","html5-game","io","io-games","iogames","multiplayer-browser-game","multiplayer-game","multiplayer-game-engine","multiplayer-game-server","multiplayer-online-game","nodejs","websocket"],"latest_commit_sha":null,"homepage":"https://www.modd.io/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/moddio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-07-23T17:27:09.000Z","updated_at":"2024-08-19T07:20:21.912Z","dependencies_parsed_at":"2023-09-27T22:54:25.649Z","dependency_job_id":"7e4fa537-26ca-434a-9c48-4b12ce16b110","html_url":"https://github.com/moddio/moddio2","commit_stats":null,"previous_names":["moddio/moddio2"],"tags_count":1241,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moddio%2Fmoddio2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moddio%2Fmoddio2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moddio%2Fmoddio2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moddio%2Fmoddio2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/moddio","download_url":"https://codeload.github.com/moddio/moddio2/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249051650,"owners_count":21204860,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["game-engine","html5-game","io","io-games","iogames","multiplayer-browser-game","multiplayer-game","multiplayer-game-engine","multiplayer-game-server","multiplayer-online-game","nodejs","websocket"],"created_at":"2024-08-01T21:01:25.520Z","updated_at":"2025-04-15T10:31:49.603Z","avatar_url":"https://github.com/moddio.png","language":"JavaScript","funding_links":[],"categories":["nodejs"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch2\u003e\u003ca href=\"https://modd.io\"\u003eModdio Game Engine 2\u003c/a\u003e\u003c/h2\u003e\n  \u003cp\u003eModdio is a Multiplayer-First Game Engine. It has a built-in server-authoritative netcode, including snapshot interpolation and client-side reconciliation. It can support 50+ concurrent players or 300+ moving entities hosted on a $5/month VM. Join us on \u003ca href=\"https://discord.gg/XRe8T7K\"\u003eDiscord\u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/contributors/moddio/moddio2?style=for-the-badge\u0026color=f01313\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/last-commit/moddio/moddio2?style=for-the-badge\u0026color=f01313\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/languages/code-size/moddio/moddio2?style=for-the-badge\u0026color=f01313\"\u003e\n\u003c/div\u003e\n\n\u003ch3\u003e\u003ca href=\"http://modd.io/play/two-houses\"\u003eDemo\u003c/a\u003e\u003c/h3\u003e\n\u003cbr\u003e\n\n## What's included in the box.\n\n- Box2D Physics\n- Server-authoritative netcode using Websocket, Snapshot interpolation, Client-side reconciliation, and LZ-string compression\n- Inventory \u0026 Item system\n- Built-in Attributes (e.g. HP, Energy, etc) with regeneration rates\n- Built-in Item system (melee \u0026 projectile)\n- Dialogues (ideal for visual novel-style games)\n- Shops (for selling items)\n- Unit control (top-down WASD or platformer)\n- Client-side predicted projectile + unit movement (optional)\n- Unit AI including A\\* pathfinding\n- Mobile controls\n- and more!\n\n## Running the game\n\nMake sure you have [Node 16](https://nodejs.org) or later.\nFirst, setup the repo\n\n```\ngit clone https://github.com/moddio/moddio2.git\ncd moddio2\nnpm install\nnpm run tsc\n```\n\nThen, to start the server run:\n\n```\nnpm run server\n```\n\nYou can now play the game at http://localhost:8080\n\n## How do I create a new game from scratch?\n\nModdio games are created \u0026 edited using Moddio Game Editor available at [https://www.modd.io](https://www.modd.io).\nTo learn how to use the game editor, visit [https://learn.modd.io](https://learn.modd.io).\n\nAfter creating your game, you can export the `game.json` file for use in your local installation. To do this, navigate to `Menu` in the Moddio Game Editor and click `Export Game`.\n\n\u003cimg src=\"./assets/images/gamejson2.png\" width=\"600\" alt=\"How to get game json in game's in-game editor\"\u003e\n\nNext, rename the downloaded Game JSON file to `game.json` and move it into the `src` directory.\n\nTo load your game file, simply start the server by running:\n\n```bash\nnpm run server\n```\n\nYou will be presented with a dropdown menu, where you can use the arrow keys to select your game file. Alternatively, you can pre-select your game file by running:\n\n```bash\nnpm run server --game=game.json\n```\n\n## How to contribute\n\nModdio is completely free and open source under the MIT license, and we are always looking for more contributors.\nTo learn about how to become a contributor, please visit [how to contribute page](https://docs.modd.io/how-to-contribute)\n\n## Credits\n\n[Isogenic Game Engine](https://www.isogenicengine.com/)\n\n[Phaser](https://phaser.io/)\n\n[PlanckJS](https://github.com/piqnt/planck.js)\n\n[uWebsocket](https://github.com/uNetworking/uWebSockets)\n\n[Box2D](https://github.com/erincatto/box2d)\n\n[Kenney Assets](https://www.kenney.nl/)\n\n[Hero Icons](https://github.com/tailwindlabs/heroicons)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoddio%2Fmoddio2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoddio%2Fmoddio2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoddio%2Fmoddio2/lists"}