{"id":16877043,"url":"https://github.com/penberg/multiplayer-matchmaker","last_synced_at":"2025-07-26T11:15:15.927Z","repository":{"id":136543865,"uuid":"553544646","full_name":"penberg/multiplayer-matchmaker","owner":"penberg","description":"A multiplayer on-line game matchmaking server.","archived":false,"fork":false,"pushed_at":"2022-10-19T09:24:11.000Z","size":11,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-25T07:51:13.965Z","etag":null,"topics":["matchmaking","server"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/penberg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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,"publiccode":null,"codemeta":null}},"created_at":"2022-10-18T11:33:01.000Z","updated_at":"2025-01-29T11:03:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"ecfd53c9-dae0-4ee3-beae-5039c565304d","html_url":"https://github.com/penberg/multiplayer-matchmaker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/penberg%2Fmultiplayer-matchmaker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/penberg%2Fmultiplayer-matchmaker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/penberg%2Fmultiplayer-matchmaker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/penberg%2Fmultiplayer-matchmaker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/penberg","download_url":"https://codeload.github.com/penberg/multiplayer-matchmaker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248384218,"owners_count":21094687,"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":["matchmaking","server"],"created_at":"2024-10-13T15:41:24.411Z","updated_at":"2025-04-11T11:33:34.627Z","avatar_url":"https://github.com/penberg.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Multiplayer Matchmaker\n\nThis project implements a multiplayer matchmaking server for games with [ChiselStrike](http://github.com/chiselstrike/chiselstrike/).\n\n## Getting Started\n\nTo get going, run:\n\n```console\nnpm run dev\n```\n\nWhich starts a local development server of the multiplayer matchmaker.\n\nTo start a matchmaking process, run:\n\n```console\ncurl -d '{\"username\": \"alice\"}' localhost:8080/dev/match \n```\n\nThe query returns the session the player is queued for:\n\n```json\n{\n  \"id\": \"a2f27ea0-295d-4c4c-be86-af27081d50fb\",\n  \"serverAddr\": \"10.0.1.1:1000\",\n  \"state\": \"MATCHMAKING\",\n  \"requiredPlayers\": 2,\n  \"players\": [\n    \"alice\"\n  ]\n}\n```\n\nTo complete the matchmaking, run:\n\n```console\ncurl -d '{\"username\": \"bob\"}' localhost:8080/dev/match \n```\n\nThe query returns the completed session:\n\n```json\n{\n  \"id\": \"a2f27ea0-295d-4c4c-be86-af27081d50fb\",\n  \"serverAddr\": \"10.0.1.1:1000\",\n  \"state\": \"DONE\",\n  \"requiredPlayers\": 2,\n  \"players\": [\n    \"alice\",\n    \"bob\"\n  ]\n}\n```\n\nTo see all complete sessions, run:\n\n```console\ncurl \"localhost:8080/dev/sessions?.state=DONE\"\n```\n\nTo delete completed sessions, run:\n\n```console\ncurl -X DELETE \"localhost:8080/dev/sessions?.state=DONE\"\n```\n\n## Deploying\n\nYou can build a Docker image of the multiplayer matchmaker with:\n\n```console\ndocker build . --tag multiplayer-matchmaker\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpenberg%2Fmultiplayer-matchmaker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpenberg%2Fmultiplayer-matchmaker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpenberg%2Fmultiplayer-matchmaker/lists"}