百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
U

unity-jsb

> 编程语言
开源

它通过集成 QuickJS 将 JavaScript 运行时功能引入 Unity3D。

341 stars0 点赞2 次浏览
访问官网GitHub

工具介绍

它通过集成 QuickJS 将 JavaScript 运行时功能引入 Unity3D。

unity-jsb

It brings Javascript runtime capability to Unity3D by integrating QuickJS.

Typescript is the scripting language used in unity-jsb, the definition files (d.ts) of exported C# types could be generated with one-click simplicity.

v8 is experimentally supported as an alternative backend (only on Windows x64 for now) Debugger is supported when using v8 backend.

QuickJS is a small and embeddable Javascript engine. It supports the ES2020 specification including modules, asynchronous generators, proxies and BigInt.

Features

  • Unity3D coroutines and C# tasks support in JS async function
  • Operator overloading for Vector2/Vector3 etc. (only supported with QuickJS)
  • Javascript hotload (development stage only)
  • Highly integrated with Unity3D
    • JS implemented MonoBehaviour (also available on Prefab)
    • JS implemented EditorWindow
    • JS implemented CustomEditor (Inspector)
    • JS implemented ScriptableObject
    • JS implemented AssetPostProcessor
  • JS/C# interaction without glue code (development stage only)
  • Generates glue code for better performance
    • [PLANNED] Generates glue code with Roslyn source generator (for Unity2021.3+ only)
  • [UNFINISHED] JS Worker
  • [UNFINISHED] Hotfix on C#
  • [UNFINISHED] UIElement support

Supports .NET4.0/dotnetcore3.1/Unity2020.3+ (Windows/macOS/iOS/Android) x86/x64/arm64 Only tested on macOS with Unity2020.3(INTEL)

Samples

Extends MonoBehaviour

…

Extends EditorWindow

typescript
import { EditorWindow } from "UnityEditor";
import { GUILayout, GUIContent } from "UnityEngine";

// with @ScriptEditorWindow decorator, the type will be listed in script launchpad window (Menu: JS Bridge -> Script Editor Window Launcher)
@ScriptEditorWindow()
export class MyEditorWindow extends EditorWindow {
    Awake() {
        console.log("MyEditorWindow.Awake");
    }

    OnEnable() {
        this.titleContent = new GUIContent("Blablabla");
    }

    OnGUI() {
        if (GUILayout.Button("I am Javascript")) {
            console.log("Thanks");
        }
    }
}

Hotload

Script hot-load is supported, you can run the game, edit scripts without stopping playing to see the change affects immediately. The class instance including member variables in scripts (MonoBehaviour/EditorWindow) will be retained, only the type of class itself will be replaced on the fly to the new version.

Editor Scripting

Supports editor scripting:

  • Editor
  • EditorWindow
  • ScriptableObject
  • AssetPostProcessor

Here is an example of EditorWindow totally implemented in typescript. Only imgui is supported for now.

Async Functions

  • await Unity3D coroutines
  • await C# Tasks

NOTE: In current version, a C# task returning nothing should use System.Threading.Tasks.Task as return type explicitly instead of void, then jsb.Yield can understand that it's a async task.

…

Operator overloading

Vector3 * Vector3 or Vector3 * float is all right, but be caution that there is no value type in Javascript, Vector3 is by-ref in Javascript.

NOTE: Operator overloading is only supported by quickjs.

typescript
{
    let vec1 = new Vector3(1, 2, 3);
    let vec2 = new Vector3(9, 8, 7);
    
    // @ts-ignore
    let vec3 = vec1 + vec2; 
    let vec4 = vec1 + vec2;
    console.log(vec3);
    console.log(vec3 / 3);
    console.log(vec3 == vec4);
}
{
    let vec1 = new Vector2(1, 2);
    let vec2 = new Vector2(9, 8);
    let vec3 = vec1 + vec2;
    console.log(vec3);
}

Modules

typescript
// Supports commonjs modules (require)

require("./test");

// commonjs modules cache access
Object.keys(require.cache).forEach(key => console.log(key));

WebSocket

typescript
let ws = new WebSocket("ws://127.0.0.1:8080/websocket", "default");

console.log("websocket connecting:", ws.url);

ws.onopen = function () {
    console.log("[ws.onopen]", ws.readyState);
    let count = 0;
    setInterval(function () {
        ws.send("websocket message test" + count++);
    }, 1000);
};
ws.onclose = function () {
    console.log("[ws.onclose]", ws.readyState);
};
ws.onerror = function (err) {
    console.log("[ws.onerror]", err);
};
ws.onmessage = function (msg) {
    console.log("[ws.recv]", msg);
};

XMLHttpRequest

typescript
let xhr = new XMLHttpRequest();
xhr.open("GET", "http://127.0.0.1:8080/windows/checksum.txt");
xhr.timeout = 1000;
xhr.onreadystatechange = function () {
    console.log("readyState:", xhr.readyState);
    if (xhr.readyState !== 4) {
        return;
    }
    console.log("status:", xhr.status);
    if (xhr.status == 200) {
        console.log("responseText:", xhr.responseText);
    }
}
xhr.send();

Worker

This feature is UNFINISHED, all C# types are not exported into Worker runtime at present.

typescript
/// master.js

let worker = new Worker("worker");

worker.onmessage = function (data) { 
    console.log("master receive message from worker", data);
}

// setTimeout(function () { worker.terminate(); }, 5000);

/// worker.js 

setInterval(function () {
    postMessage("message form worker");
}, 3000)

onmessage = function (data) {
    console.log("worker get message from master:", data);
}

Hotfix

You can replace a tagged C# member method by a script function at runtime. This feature is UNFINISHED.

…

Unity API Docs included in d.ts

Strong-typed

How to get the minimalistic jsb package

You could add jsb as a UPM package with this URL: https://github.com/ialex32x/unity-jsb.git#upm.

! Samples are not included in UPM package.

How to get the sample project

You could clone this repository as a complete sample project.

Clone

bash
git clone https://github.com/ialex32x/unity-jsb --depth=1

Restore node_modules

bash
npm install

Re-compile ts source files (only if modified)

bash
tsc 
# or compile and watch
# tsc --watch 

Generate d.ts

Open project with Unity3D, run menu command JS Bridge/Generate Type Definition

NOTE: The split size of the generated d.ts file is configurable in PrefsEditor (or directly edit js-bridge.json).

Examples

Examples for Unity

Open Assets/Examples/Scenes/SampleScene.unity and select specific example you want to check.

If you use node_modules in your scripts, you need to package them via webpack/gulp when the game actually runs on target platform.

Example for dotnetcore

Open this project directory in VSCode, select dotnetcore example in Run And Debug panel, then just run it.

How

Some experimental works

Extra Features (Optional)

  • Websocket
  • XMLHttpRequest

JSX

typescript
export interface TestData {
    name: string,
    tick: number;
}

@ScriptType()
export class MyWidgetTest extends JSXWidgetBridge {
    private _data: TestData;
    private _timer: any;

    get data() { return this._data; }

    Awake() {
        this._data = ViewModel.create({ name: "Unity", tick: 0 });
        this._widget =
            
                
            

        this._timer = setInterval(() => {
            this._data.tick++;
        }, 1000);
        this._data.tick++;
    }

    OnDestroy() {
        super.OnDestroy();
        clearInterval(this._timer);
    }
}

Multi-threading

Multi-threading is not supported in a single runtime. You need to use worker.

Debugger

Remote debugging is now available with Chrome DevTools.

NOTE: It's still in experimental stage.

Referenced libraries

  • QuickJS
  • v8
  • ECMAScript A Javascript (QuickJS) Binding for Godot
  • xLua
  • libwebsockets
  • mbedtls
  • zlib
  • sqlite3
  • quickjspp
  • Vue.js

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Chotloadjavascriptquickjsunity-javascript

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言