Unreal.js

Unreal.js: Javascript runtime built for UnrealEngine

Programming language: - - -

License: GNU General Public License v3.0 or later

Tags: Editors     Js     Game Development     UnrealEngine    

README

Unreal.js

Unreal.js is a plug-in which brings V8-powered Javascript into UnrealEngine.

• Link to Demo project
• Link to the Unreal Engine Marketplace (4.11 ~ 5.0)
• Update notes
• Link to NDC 2017 presentation (KR)
• Link to NDC 2017 presentation Video (KR)
• Support Platform : Win64, Mac, Linux, Android, iOS

Installation

• Search unreal.js on the epic marketplace
• Manual installation
  1. git clone https://github.com/ncsoft/Unreal.js-core <YourProject>/Plugins/UnrealJS
  2. cd <YourProject>/Plugins/UnrealJS && ./install-v8-libs

Features

• Powered by latest V8 (ES6)
• CommonJS modules
• Full access to the whole UnrealEngine API
• Free to subclass existing classes including blueprint
• Live reload
• Communicate with outer world: REST(http), process(pipe), arraybuffer, ...
• Bridge API for editor extension
• Auto-completion for Visual Studio Code (auto-generated *.d.ts)
• Debugging within Visual Studio, Visual Studio Code, WebStorm and all IDE which supports V8 protocol
• Profiling supported by V8
• Dedicated Javascript console on UnrealEditor

• (Full) access to existing javascript libraries via npm, bower, ...

Dummy demo

• Very simple demo available (https://github.com/ncsoft/Unreal.js/archive/snippet-editor.zip)

Tutorials & documentation

• Building the plugin
• Running the examples
• Video tutorials
• Wiki

License

• Licensed under the BSD 3-Clause "New" or "Revised" License
• see LICENSE for details

Examples

2048

• View source code

Springy

• View source code

Editor extension

• View source code

Create a new actor

let myActor = new Actor(GWorld,{X:10,Y:20,Z:30});
myActor.SetActorLocation({X:40,Y:80,Z:120});

Subclass an existing class

class MyActor extends Actor {
  properties() {
    this.MyProp/*EditAnywhere+Replicated+int*/;
  }
  RPC(x/*int*/) /*Server+Reliable*/ {
    console.log('This function is replicated',this.MyProp++);
  }
}
let MyActor_C = require('uclass')()(global,MyActor);
if (GWorld.IsServer()) { 
  new MyActor_C(GWorld);
}

Node.js like

let _ = require('lodash');
let kick = () => {
  console.log("Hello timer!",_.keys(this));
  setTimeout(kick,1000);
};
kick();