{"id":13589337,"url":"https://github.com/vizor-games/InfraworldRuntime","last_synced_at":"2025-04-08T09:32:26.550Z","repository":{"id":65361222,"uuid":"133630346","full_name":"vizor-games/InfraworldRuntime","owner":"vizor-games","description":"A solution that enables Unreal Engine 4 to work with Google gRPC services from either C++ or Blueprints.","archived":false,"fork":false,"pushed_at":"2020-06-16T10:29:02.000Z","size":345,"stargazers_count":169,"open_issues_count":10,"forks_count":56,"subscribers_count":19,"default_branch":"master","last_synced_at":"2024-11-06T09:39:32.875Z","etag":null,"topics":["blueprints","cpp","grpc","ue4","unreal-engine"],"latest_commit_sha":null,"homepage":"","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/vizor-games.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}},"created_at":"2018-05-16T07:52:49.000Z","updated_at":"2024-07-11T03:26:55.000Z","dependencies_parsed_at":"2023-01-19T13:35:13.229Z","dependency_job_id":null,"html_url":"https://github.com/vizor-games/InfraworldRuntime","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vizor-games%2FInfraworldRuntime","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vizor-games%2FInfraworldRuntime/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vizor-games%2FInfraworldRuntime/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vizor-games%2FInfraworldRuntime/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vizor-games","download_url":"https://codeload.github.com/vizor-games/InfraworldRuntime/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247814129,"owners_count":21000506,"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":["blueprints","cpp","grpc","ue4","unreal-engine"],"created_at":"2024-08-01T16:00:28.310Z","updated_at":"2025-04-08T09:32:26.169Z","avatar_url":"https://github.com/vizor-games.png","language":"C++","funding_links":[],"categories":["Networking","Game Development"],"sub_categories":["Unreal Engine: Resources"],"readme":"Vizor Infraworld\n================\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![Maintainability](https://api.codeclimate.com/v1/badges/d8740022fdc1bbc8277b/maintainability)](https://codeclimate.com/github/vizor-games/InfraworldRuntime/maintainability)\n\nWelcome to the Infraworld source code!\n\n![](icon.png)\n\nInfraworld is a solution that enables [Unreal Engine 4](https://www.unrealengine.com/en-US) to work with [Google gRPC](https://gRPC.io) services using either **C++** or **Blueprints**.\n\nInfraworld is a fast, robust and cross platform.\nIt fits any stage of development: either prototyping or production. Saving a tons of your team's time, you need to write your gRPC wrappers by hand no more.\n[A special converter utility](https://github.com/vizor-games/infraworld-cornerstone) will do it for you, producing high quality, debuggable and multi-threaded code, gaining lowest possible overhead to your game logic thread.\nYou may also work with either generated or shipped with gRPC C functions and C++ classes in your own way, even completely ignoring runtime classes, since the InfraworldRuntime adds all required headers and wires all required libraries.\n\nAlso, you may want to use a [protobuild](https://github.com/vizor-games/infraworld-protobuild) utility to automate cross-language gRPC wrapper generation.\n\n\nGetting started\n===============\n\n##### Building gRPC support\n\nAt the first step, you need to build gRPC runtime libraries.\nJust run `Setup.sh` for Linux, `Setup.bat` for Windows or `Setup.command` for macOS (please don't use `Setup.sh` on macOS, because Linux and macOS build pipelines are completely different!). OR you may want to use our sweet [pre-compiled binaries](../../releases) to avoid manual building and save our planet from carbon emission disaster! The runtime uses gRPC branch `v1.23.x`.\n\n* For Windows, we recommend you to use [chocolatey](https://chocolatey.org) to install packages into your system.\n**Note** that you do need all these programs in your system's `PATH` ([See how to edit PATH on Windows](https://www.computerhope.com/issues/ch000549.htm)):\n  * [Git VCS](https://git-scm.com/download/win)\n  * [Visual Studio 2017](https://visualstudio.microsoft.com/downloads/) with VC++ tools v141 installed\n  * [CMake](https://cmake.org) is used to generate a Visual Studio solution from the `CMakeLists.txt` provided with gRPC\n  * [Strawberry perl](http://strawberryperl.com) 64bit version\n  * [NASM](https://www.nasm.us)\n  * [Golang](https://golang.org/doc/install)\n* For any distribution of Linux and for macOS systems you need (use `apt`, `pacman`, `emerge` or any other package manager to install this software):\n  * git\n  * automake, autoconf and libtool\n  * make\n  * strip\n  * go\n  * [Unreal Engine 4.22 installed](https://github.com/EpicGames/UnrealEngine/tree/4.22), additionally you need to `export UE_ROOT=/path/to/root/ue4/directory`, because you need UE4 to build GRPC for linux.\n* For macOS (use `homebrew` or `macports` to install this software):\n  * git\n  * xCode 10.0+\n  * go\n\n**Note** that required programs for Linux and MacOS systems are being checked in run-time.\n\nThen you may (or may not) import `GrpcIncludes` and `GrpcLibraries` folders into your VCS, but you need to build them manually at least one time for each platform.\nThe build process requires an access to the Internet.\n\n##### Installing the plugin\nJust copy the resulting folder into the your project’s Plugins folder (create it if you don’t have one).\nThen, after that project is being opened, a dialog box, telling that the plugin is need to be compiled should appear. Then confirm the dialog by clicking `Yes`.\n\n##### Building and the converter\nPlease take a look at the [infraworld-cornerstone documentation](https://github.com/vizor-games/infraworld-cornerstone) for details.\n\n##### Using generated code.\nPlease take a look at the [example project](https://drive.google.com/open?id=13EZzP_9033vBC7VzJf9LFrygg42LHaOW) for tutorial.\n\nRunning the example project\n===========================\n\nYou should copy built plugin's folder into `InfraworldRuntimeExample/Plugins` folder.\nThen just open `InfraworldDemo.uproject`. Server code is in `DemoServer` folder.\nYou are required to install dependencies using `pip` and `requirements.txt` file.\nFor more details please check our [**InfraworldExample**](https://github.com/vizor-games/InfraworldRuntimeExample) repository\n\nDebugging\n=========\n\nSince the plugin itself is an open source software, you may want to debug it or add some extra functionality.\nSince it is distributed as an Unreal Engine plugin, you can add it into your own game\nand then generate **Visual Studio solution**, **XCode project** or **CMakeLists**. Use `Development` or `DebugGame` run configuration!\n\nContribution\n============\n\nPlease feel free to report known bugs, propose new features and improve tests using Github's pull request system.\nPlease do not add either build libraries for an any platform or header files into your commits. Thank you very much for contributing into free software.\n\nReferences\n==========\n* [Introduction to UE4 Plugins](https://wiki.unrealengine.com/An_Introduction_to_UE4_Plugins)\n* [gRPC API docs](https://gRPC.io/docs/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvizor-games%2FInfraworldRuntime","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvizor-games%2FInfraworldRuntime","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvizor-games%2FInfraworldRuntime/lists"}