ProtoFlux/ja

The official ProtoFlux logo

ProtoFlux は、ProtoFlux Tool を使用して 3D 空間内で操作できるノードベースのスクリプト言語です。

ProtoFlux は、私たちのクリエイティブツール群の中でも最高峰に位置する視覚的プログラミング言語です。熟練の開発チームが設計したこの言語は、シンプルなインタラクションから複雑なゲームやシステムまでを迅速にプロトタイプ／構築できるようにし、リアルタイム共同編集と即時フィードバックを完全にサポートします。アバターやワールドのインタラクティブ性から、複雑なシステム、ゲーム開発に至るまで、あらゆるものを作り上げることができます。

— https://resonite.com/features.html

Usage

ProtoFlux はワールド内でノードとして表現されており、ProtoFlux Node Browser でノードを選択し、ProtoFlux Tool からスポーンさせることができます。

ProtoFlux でスクリプトを開始するには、Inventory に含まれる Resonite Essentials フォルダーから ProtoFlux Tool を簡単にスポーンできます（ツール自体は Essentials フォルダー内の Tools フォルダーにあります）。

ProtoFlux Browser Version を参照するか、網羅的な一覧をご覧になりたい場合は Alphabetical list of all nodes をご覧ください。各ノードのページには、これら両方の一覧へのリンクが設けられています。

まず ProtoFlux を使い始めるには、前述のフォルダーから ProtoFlux Tool をスポーンして装備します。装備すると、Context menu に ProtoFlux ノードブラウザーが表示されます。ノードを選択するには、ProtoFlux Tool でそのノードをダブルクリックしてください。ノードが選択されると、ツールの上部にノード名が表示されます。その後、もう一度ダブルクリックして選択したノードをスポーンします。

すでに配置済みのノードを素早く選択するには、そのノードにレーザーを当てながら Secondary ボタンをタップしてください。

ノードを接続するには、レーザーをノードの接続ポイントに向けた状態で Primary（ほとんどのコントローラーではトリガー、または左クリック）を押し続け、ワイヤーをドラッグして別のノードの接続ポイントに合わせたら Primary を離します。接続したワイヤーを切るには、Primary を押したまま ProtoFlux Tool の先端から伸びる赤い線でワイヤーを横切ってください。

コンポーネントやスロットとのインターフェース（連携）

To change or read the properties of a slot's or component's properties, grab with your controller (or right click) while pointing at a given field name with the ProtoFlux Tool (For example, point at and grab the spot where it says 'Position' on a slot). While grabbing the field with the ProtoFlux Tool, open your Context menu. This will give you three options.

Source: This will spawn a node that references the source of the property you were holding. This is used to both read the value of the field or to write to it using Protoflux.

Drive：このオプションを選ぶと、保持していた変数に対してローカルで継続的に値を書き込むためのノードがスポーンされます。

Reference: This will spawn a node to allow you to get the reference to the field of the given value. This is useful for nodes like ProtoFlux:Tween Value that require a reference to the value it is changing.

Packing / Unpacking Protoflux

To pack Protoflux, hold Secondary while pointing at a group of Protoflux using the ProtoFlux Tool. The Protoflux should become light blue, this indicates it has been selected (This also makes the Protoflux that is selected act as one object, allowing you to easily move groups of Protoflux around).

Once the Protoflux has been selected, make an empty Slot using the Inspector. This will be the slot the Protoflux is packed into. To then pack the Protoflux, grab the slot using the left side of the Inspector so that it's name is above the ProtoFlux Tool. While you are grabbing it, open your Context menu and select Pack Into. Once packed, the Protoflux will still function like normal, but will no longer show its visuals and will apply some optimizations.

To then unpack it, grab the same slot you packed it into and open your context menu, while a ProtoFlux Tool is equipped. There should now be an option to unpack the Protoflux.

Variables

In ProtoFlux, there are 3 types of generic variables:

• Data Model Store
• Store
• Local

The simplest type of variable is a Data Model Store. It's automatically synced to all users upon being written to. Most simple scripts can be done entirely with these, but it can impact performance if overused.

The natural progression down the list is a Store. It's similar to standard variables in most languages. It does not get synced over the network, which alleviates the overhead of doing so, but could lead to desync.

Lastly, we have locals. They're instanced for different execution chains, so if your ProtoFlux is called twice at once, you can read from and write to the variable from both contexts, they will each use a unique instance of the variable that gets discarded when that execution ends.

Impulses

See Impulses