2.7.0 • Published 6 years ago

metaverse-rpc v2.7.0

Weekly downloads
2
License
ISC
Repository
github
Last release
6 years ago

CircleCI. Build status

metaverse-rpc

This repository contains the low-level API that allows us to run sandboxed (and even remote) code for Decentralands LANDs and other systems like Physics.

Scripting

Scripts are pieces of logic that run inside the context of a Web Worker or remotely in a server. They are meant to provide the user a way to run custom logic inside the player's client, allowing the creation of rich experiences inside Decentraland. To achieve this, low level hooks are exposed from the scripting host and consumed by the scripting client.

Transports

The scripts communicate with the host application thru a JSON-RPC2 based protocol using a defined transport. We have 3 built in transports.

  • WebWorker: Used to load a sandboxed script locally, inside a WebWorker
  • WebSocket: Used to run scripts in remote servers
  • Memory: Used to run tests, mainly. The script runs in the same execution context as the host.

Scripting host

The ScriptingHost is a core piece that instanciates APIs and handles incoming/outgoing messages from the scripts.

APIs

APIs work as a bridge between user-created scripts and the lower level APIs of the client (communication, 3D entity management, etc). It provides a set of exposed methods that can be accessed from the script context. These methods are async by default and Promises are used as hooks for events that may be triggered in the future (HTTP Responses, entity collisions, etc).

The @exposeMethod decorator is provided as means of exposing API methods to the Script.

An example implementation can be found at 3.Class.spec.ts

See also

  1. APIs introduction
  2. Common patterns
  3. Scripting host

Scripts

The term "script" or sometimes "system" refers to the instance of a user-created script, normally running inside a Web Worker. To access an API instance the decorator @inject(apiName: string) function is used. From then on, the user will be able to call all exposed methods and await the promises returned by them.

An example implementation can be found at 7.0.MethodsInjection.ts

See also

  1. Scripts introduction
  2. Common patterns

Related documents

The Entity-Component-System - An awesome gamedesign pattern in C Part 1

Why do we create a component based system? Components