{"id":50115359,"url":"https://github.com/widgrensit/asobi-unreal","last_synced_at":"2026-05-23T14:34:10.718Z","repository":{"id":353408797,"uuid":"1199473119","full_name":"widgrensit/asobi-unreal","owner":"widgrensit","description":"Unreal Engine 5 C++ plugin SDK for Asobi game backend","archived":false,"fork":false,"pushed_at":"2026-05-01T17:52:30.000Z","size":49,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-01T19:25:07.271Z","etag":null,"topics":["asobi","client-sdk","cpp","game-backend","gamedev","multiplayer","sdk","ue5","unreal-engine","unreal-engine-5"],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/widgrensit.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,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-02T11:38:22.000Z","updated_at":"2026-05-01T17:52:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/widgrensit/asobi-unreal","commit_stats":null,"previous_names":["widgrensit/asobi-unreal"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/widgrensit/asobi-unreal","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/widgrensit%2Fasobi-unreal","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/widgrensit%2Fasobi-unreal/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/widgrensit%2Fasobi-unreal/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/widgrensit%2Fasobi-unreal/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/widgrensit","download_url":"https://codeload.github.com/widgrensit/asobi-unreal/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/widgrensit%2Fasobi-unreal/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33400247,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T04:15:53.637Z","status":"ssl_error","status_checked_at":"2026-05-23T04:15:53.242Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["asobi","client-sdk","cpp","game-backend","gamedev","multiplayer","sdk","ue5","unreal-engine","unreal-engine-5"],"created_at":"2026-05-23T14:34:10.223Z","updated_at":"2026-05-23T14:34:10.712Z","avatar_url":"https://github.com/widgrensit.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# asobi-unreal\n\nUnreal Engine 5 C++ plugin SDK for the [Asobi](https://github.com/widgrensit/asobi) game backend. Requires UE 5.4+ (tested on 5.4–5.7).\n\n## Installation\n\nClone into your project's `Plugins/` directory:\n\n```bash\ncd YourProject/Plugins\ngit clone https://github.com/widgrensit/asobi-unreal.git AsobiSDK\n```\n\nRegenerate project files, then enable `Asobi SDK` in *Edit → Plugins → Networking*.\n\n## Run a backend first\n\nThe SDK talks to an Asobi server. The fastest way to get one is:\n\n```bash\ngit clone https://github.com/widgrensit/sdk_demo_backend\ncd sdk_demo_backend \u0026\u0026 docker compose up -d\n```\n\nThat serves at `http://localhost:8084` (HTTP + WebSocket on `/ws`) with a 2-player `demo` mode. For the full reference game (arena shooter) see [`asobi_arena_lua`](https://github.com/widgrensit/asobi_arena_lua).\n\n## Quick Start\n\n```cpp\n#include \"AsobiClient.h\"\n#include \"AsobiAuth.h\"\n#include \"AsobiMatchmaker.h\"\n#include \"AsobiWebSocket.h\"\n\nUAsobiClient* Client = NewObject\u003cUAsobiClient\u003e();\nClient-\u003eSetBaseUrl(TEXT(\"http://localhost:8084\"));\n\nUAsobiAuth* Auth = NewObject\u003cUAsobiAuth\u003e();\nAuth-\u003eInit(Client);\n\nFOnAsobiAuthResponse OnLogin;\nOnLogin.BindDynamic(this, \u0026AMyPawn::HandleLogin);\nAuth-\u003eLogin(TEXT(\"player1\"), TEXT(\"secret\"), OnLogin);\n```\n\n### Listening for a match\n\nThe matchmaker pushes `match.matched` after pairing players; a client-initiated `match.join` produces `match.joined`. Subscribe to **both** to cover matchmade and direct-join paths:\n\n```cpp\nWebSocket-\u003eOnMatchMatched.AddDynamic(this, \u0026UMyClass::OnReady);\nWebSocket-\u003eOnMatchJoined.AddDynamic(this, \u0026UMyClass::OnReady);\n```\n\nSee the [WebSocket protocol guide](https://github.com/widgrensit/asobi/blob/main/guides/websocket-protocol.md) for the full event surface.\n\n## Features\n\n| Subsystem | REST | WebSocket |\n|---|---|---|\n| Auth (register, login, refresh, OAuth, IAP) | ✓ | — |\n| Players \u0026 stats | ✓ | — |\n| Matches \u0026 matchmaker | ✓ | ✓ |\n| Worlds (MMO-scale, terrain streaming) | ✓ | ✓ |\n| Chat \u0026 direct messages | ✓ | ✓ |\n| Social (friends, groups) | ✓ | — |\n| Economy (wallets, store, inventory) | ✓ | — |\n| Leaderboards \u0026 tournaments | ✓ | — |\n| Cloud saves \u0026 storage | ✓ | — |\n| Presence \u0026 notifications | ✓ | ✓ |\n| Voting (cast, veto) | ✓ | ✓ |\n\nBlueprint-callable on every subsystem. Typed `USTRUCT` responses for player, world, match, DM, leaderboard, etc.\n\n## Modules\n\n- `UAsobiClient` — HTTP + JSON helpers, auth token store\n- `UAsobiAuth`, `UAsobiMatch`, `UAsobiMatchmaker`, `UAsobiWorld`, `UAsobiEconomy`, `UAsobiLeaderboard`, `UAsobiSocial`, `UAsobiStorage`, `UAsobiTournament`, `UAsobiDirectMessage`\n- `UAsobiWebSocket` — real-time client with typed multicast delegates (`OnMatchState`, `OnWorldTick`, `OnWorldTerrain`, `OnDmMessage`, …)\n\n## Demo\n\nSee [asobi-unreal-demo](https://github.com/widgrensit/asobi-unreal-demo) for a working UE5 sample project.\n\n## Smoke test\n\nEvery release of this plugin runs the canonical SDK smoke flow against `widgrensit/sdk_demo_backend`. See [`Source/AsobiSDK/Tests/SmokeTest.md`](Source/AsobiSDK/Tests/SmokeTest.md) for the manual run command and CI notes.\n\n## License\n\nApache 2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwidgrensit%2Fasobi-unreal","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwidgrensit%2Fasobi-unreal","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwidgrensit%2Fasobi-unreal/lists"}