Skip to content

Galah is a demonstration using Web3j and a Java networking layer to show the Unreal Engine interacting with a smart contract.

Notifications You must be signed in to change notification settings

TimTinkers/Galah

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Galah

Galah is a demonstration using Web3j and a Java networking layer to show the Unreal Engine interacting with a smart contract. The project consists of three distinct parts: the Solidity smart contract, the Java networking middle layer, and the Unreal Engine project. Together these pieces form a system capable of bridging the Unreal Engine's robust visualization tools and the decentralized computing benefits of smart contracts.

The motivation for such a project is the wide range of technical improvements that Unreal Engine games could feature if able to hook into smart contracts. A decentralized way of storing and sharing in-game content? Unique tracking of virtual game assets? A much more robust payment and trading platform for in-game resources? All of these applications are possible with this bridge in place.

The Smart Contract

In the "CounterContract" folder, this repository includes all files necessary to setup a Truffle project to test and deploy a simple "Counter.sol" Solidity smart contract counter which can increment and store a public integer. The example contract as it is deployed live for the demonstrations here can be viewed here with Etherscan. The Counter was kept intentionally simple for this demonstration, but the interaction between the Unreal Engine and smart contracts is easily extensible to more interesting cases.

In the specified folder's "configuration.js" file one can specify a node URL and 12 word secret phrase, which are both used to deploy the contract from some account. In the examples here I am deploying to a cloud-hosted node on the Kovan test network using Infura. The example contract also includes a "counter.js" test file in its test directory to verify the correct behavior of the example contract.

The Networking Layer

In the "GalahServer" folder, this repository includes an example server which uses Web3j to communicate with the deployed Counter contract and the LowEntry Socket Connection plugin to communicate with the Unreal Engine. Additionally, this server has a dependency on json-simple, a JSON parser which is used to generate the JSON packets sent between the server and the Unreal Engine application. The Java wrapper for the Counter contract was generated using these Web3j instructions. The resulting .abi and .bin files are included in "CounterContract/solc_compiled" and required separate installation of the solc-js Solidity compiler bindings.

When starting, this server first reads configuration details from "config/config.txt" where the user must specify the URL of their Ethereum node and the private key of the wallet used to pay for transaction fees incurred when interacting with the smart contract. Once it has successfully connected to the smart contract, the server simply opens a socket and listens for incoming JSON messages. The server responds to messages with two different "action" field values: "increment" and "read." These fields respectively determine whether the server will issue a function call to the Counter contract to increment its count variable, or whether it will read the value of count and return this to the initial sender.

The Unreal Engine Project

In the "GalahProject" folder, this repository includes an example Unreal Engine 4.17 project which communicates with the Java networking layer to relay messages to and from the Counter smart contract. Once again, this requires the LowEntry Socket Connection plugin to facilitate communication through JSON messages.

For this project, the Unreal Engine communication logic was developed using the blueprint visual scripting tools. Here is an image of the section which establishes the connection to the Java networking layer during initial setup of the Unreal Engine game mode.

Game Mode Server Connection
The example Unreal Engine blueprint used to establish a connection to the server.

Once the Unreal Engine application has established connection to the Java networking server, it can send JSON messages which communicate its requests for interaction with the smart contract. The Java server will in turn pass these requests onto Counter, and if applicable return the results. In the example project, this is used to periodically refresh a screen with the newest count by sending the "read" action field to the Java server.

Screen Refresh Messaging
This blueprint periodically requests the value of Counter's "count" variable to update the in-game screen.

Smart contract functions can also be executed in response to in-game actions. This project includes a simple red box with a collision detector. When triggered, it sends a packet with the "increment" action field to the Java server. This in turn fires the increment function of the Counter smart contract.

Sending a Request for Incrementing
This blueprint is for the red box which, when struck, requests that Counter's increment function be called.

Demonstration

The following clips show the entire interaction from Unreal Engine to smart contract in action. The console shows the messages logged by the Java networking layer when some update messages pass through it.

Demonstration of Java server networking.
Demonstrating the flow of data through the Java layer.

The in-game demonstration shows the value of the Counter being displayed on an in-game screen, the real-time update wait when the user requests that the value be incremented, and demonstrates the persistence of this value even when the game is exited and reloaded.

Demonstration of in-game interaction.
Demonstrating the in-game interactions of project blueprints.

References

The following resoures proved helpful for developing this project.

Supporting Code

This project requires and would not have been possible without the following frameworks and libraries:

  • Truffle, a development environment, testing framework and asset pipeline for Ethereum.
  • Etherscan, an Ethereum block explorer.
  • Infura, a gateway for cloud-hosted Ethereum nodes.
  • Web3j, a lightweight, reactive, type-safe Java and Android library for integrating with nodes on Ethereum blockchains.
  • LowEntry Socket Connection, a useful networking plugin for the Unreal Engine with native Java integration.
  • json-simple, a simple and fast JSON parser.
  • solc-js, JavaScript Solidity compiler bindings used here to create the Java contract wrapper.
  • Unreal Engine 4, the Unreal Engine is a free high-quality game and physics engine.

About

Galah is a demonstration using Web3j and a Java networking layer to show the Unreal Engine interacting with a smart contract.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published