# NFT Sensor

{% hint style="info" %}
**新機能**

新しいコンポーネントとしてGame Maker 0.9 から導入されました。ドロップダウンリストから1つのNFT のURL と1つのNFT コレクションを要件として使用できます。
{% endhint %}

<figure><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/r5RTQIdsd4QhdXcqEJbw/NFT%20Sensor.webp" alt=""><figcaption><p>上記の画像ではNFT Sensor のコンポーネントのメッセージがRules で作成された<a href="../../game-rules/rule-types#popup-window"><strong>ポップアップウィンドウ</strong></a>をトリガーした状態を表示しています。<br>プレイヤーは必要なNFT を持っていることで特典を受けることができるようになります。またこのルールをトリガーすることで<a href="../../creative-guide/game-rule-guide/shop"><strong>Play Coins</strong></a> のメカニクスを使用して設定した150 コインを受け取ることができます。すべてのプレイヤーがドアを開けることができますが、このロジックを使うとドアを開けた人だけがボーナス特典を受け取るという設定ができます。</p></figcaption></figure>

<figure><img src="https://1963719226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV8pr5EgDZn2rnTUJE8XB%2Fuploads%2FKft9Nm1P0kMgO23r6xOH%2Fimage.png?alt=media&#x26;token=8cbb70ba-13d3-45d1-9d88-ceb658d6aa2c" alt="" width="563"><figcaption><p>プレイヤーが全ての必要なNFT を持っていない場合でも、ポップアップウィンドウに<br>どのNFT が必要かを表示できます。（マーケットプレイスのリンクを含む）</p></figcaption></figure>

{% hint style="info" %}
ヒント：ポップアップウィンドウに表示されるのは全ての必要なNFT で持っているものを除いて必要なNFT だけを表示することはできません。
{% endhint %}

{% hint style="info" %}
[**シングルプレイヤーとマルチプレイヤーのロジックを制作**](https://docs.sandbox.game/jp/creators/game-maker/creative-guide/game-rule-guide/build-singleplayer-and-multiplayer-logic)のページでも<mark style="color:green;">**\[SP]**</mark> や <mark style="color:orange;">**\[MP]**</mark> のビヘイビアやコンポーネントの使い方をご紹介しています。
{% endhint %}

{% hint style="success" %}
**NFT をお持ちの方へのシークレット特典**\
特定のNFT を持っているプレイヤーのシークレットエリア、隠されたクエスト、その他のボーナスなどへのアクセスを許可するにはNFT Sensor のコンポーネントを使って成功メッセージをトリガーするプレイヤーを移動させられる[**Teleport** ](https://docs.sandbox.game/jp/creators/game-maker/document/components/avatar-teleport)のコンポーネントを使用します。
{% endhint %}

## <img src="https://docs.sandbox.game/~gitbook/image?url=https%3A%2F%2F331512196-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F83PS3g9zpWmq73xzlwFn%252Fuploads%252FDAQm7e737FocYXPRciSW%252Fimage.png%3Falt%3Dmedia%26token%3D76c036d8-c3cd-4c80-906e-979ba0a68d48&#x26;width=40&#x26;dpr=4&#x26;quality=100&#x26;sign=e3e2bad5&#x26;sv=2" alt="" data-size="line"> **NFT Sensor のコンポーネント&#x20;**<mark style="color:orange;">**\[MP]**</mark>

NFT の検知方法には以下の2種類があります。

* The Sandbox のNFT を指定する（The Sandbox のウェブサイトよりアセットのURL を使用）
* NFT コレクションを選択する

すべての指定したNFT またはコレクション（最低1つ）の所有権に関する条件をトグルで設定できます。

NFT オーナーに報酬を与えられる様々なロジックをトリガーするメッセージを送信できます。

## おすすめの使い方

{% hint style="info" %}
[**収益化への使用例**](https://docs.sandbox.game/jp/creators/shou-yi-hua#gmunokontentsuniakusesuninanft-no)より、成功メッセージをトリガーするNFT オーナー向けの限定アクセス作成ロジックを参照してください。
{% endhint %}

NFT の所有権を使ってアクセスを限定することで体験のプレミアムコンテンツを収益化できます。

指定したNFT オーナーにアクセスを付与できます：

* 体験内の限定エリア
* クエストやナラティブをアンロック
* ボーナスパワーアップ
* ゲームルールで作成したゲームメカニクスを使った特典など

## コミュニケーション

|                                            |                                                                   |
| ------------------------------------------ | ----------------------------------------------------------------- |
| <p><strong>インプット</strong>：</p><p>メッセージ</p> | <p><strong>アウトプット</strong>：</p><p>成功メッセージまたは失敗メッセージ（カスタマイズ可能）</p> |

## NFT に関する要件の設定方法

{% hint style="info" %}
NFT Sensor のコンポーネントの最初のバージョンではロジックを使った成功/ 失敗の基準としてNFT を1つ、もしくはコレクションを1つだけ使用できます。
{% endhint %}

{% tabs %}
{% tab title="NFT" %}

### NFT トークンID を追加

1. NFT Sensor のコンポーネントから**NFT Token ID** をクリックします。**アセットのURL** を追加するウィンドウが開きます。
2. The Sandbox のウェブサイトのアセットページを開き（インベントリまたは[**マーケットプレイス**](https://www.sandbox.game/ja/shop/)から検索）、URL をコピーします。以下の画像を参照してください。
3. Game Maker に戻り**Asset URL** にURL を貼り付けます。**Validate** をクリックして**Continue** をクリックします。

URL を追加したり、**AND/OR** の条件を設定できます。

<figure><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/aK58sTDH95lMqEKA9cnu/GM%200.9%20NFT%20Sensor%20TSB%20URLs.png" alt=""><figcaption><p>The Sandbox ウェブサイト上で表示される<strong>アセットのURL</strong></p></figcaption></figure>
{% endtab %}

{% tab title="コレクション" %}

### コレクションを追加

{% hint style="warning" %}
プレイヤーがアバターを装備していることを確認してください！

コレクションから、NFT Sensor を持つアバターを所有しているだけでは成功メッセージをトリガーすることはできません。NFT Sensor をトリガーする時にアバターを装備している必要があります。

体験スタート前に[**体験ページ**](https://docs.sandbox.game/jp/creators/game-maker/publish-experiences/experience-manager/pji)よりアバターを装備するようにお知らせすることができます。現時点ではアバターを変更してプレイを再開することはできません。
{% endhint %}

The Sandbox マーケットプレイスより既存のアバターコレクションからドロップダウンメニューを使って選択してください。

{% hint style="info" %}
NFT Sensor のコンポーネントの最初のバージョンでは、The Sandbox のマーケットプレイス上の使用可能なコレクションに含まれるアバターのみが対象になります。
{% endhint %}
{% endtab %}
{% endtabs %}

## :brain::thunder\_cloud\_rain: 様々なゲームプレイや収益化のための使用事例

NFT Sensor のコンポーネントを使用して可能な設定をご紹介します。以下の紹介する例はごく一部で、このコンポーネントを使うと様々な可能性を引き出すことができます。クリエイターポータルのページではNFT Sensor のコンポーネントを使ってクリエイティブな可能性だけでなく、収益化も図ることができるようになります。

### すべてのプレイヤーに開くドア

[**Door**](https://docs.sandbox.game/jp/creators/game-maker/document/behavior/door) のビヘイビア \[MP] をトリガーすることでNFT を所有しているプレイヤーは体験内にいるすべてのプレイヤー向けのドアを開く手助けができます。コミュニティチャレンジでは迷路に様々なドアを用意し、それぞれ異なるNFT を必要とするといった設定もできます。

### VIP エリアにテレポート

[**Avatar Teleport** ](https://docs.sandbox.game/jp/creators/game-maker/document/components/avatar-teleport)のコンポーネント\[MP] をトリガーしてNFT を持っているプレイヤーを限定エリアにテレポートさせることができます。テレポート先では[**クエスト**](https://docs.sandbox.game/jp/creators/game-maker/build-menus/top-bar/objectives#kuesutonitsuite)をトリガーしたり、[**Power Up**](https://docs.sandbox.game/jp/creators/game-maker/document/components/power-up) の機能を使ったり、[**ゲームルール**](https://docs.sandbox.game/jp/creators/game-maker/document/game-rules)で設定したゲームメカニクスを使ってより深みのあるゲームプレイを実現できます。

### プレイヤーをテレポートさせてチーム作り

[**Avatar Teleport** ](https://docs.sandbox.game/jp/creators/game-maker/document/components/avatar-teleport)のコンポーネントを使ってプレイヤーを体験内の様々な場所に割り振り、[**ゲームルール**](https://docs.sandbox.game/jp/creators/game-maker/document/game-rules)をや[**Crowd Event** ](https://docs.sandbox.game/jp/creators/game-maker/document/behavior/crowd-event)のビヘイビアを使って制限時間付きのチャレンジを行うことができます。異なるテーマやアートスタイルを作り、プレイヤーが興味のあるものにアピールすることもできます。さらには所有しているNFT を使って、テーマにマッチする空間を作り上げることもできます。

### 競争力を高める

[**Power Up**](https://docs.sandbox.game/jp/creators/game-maker/document/components/power-up) のコンポーネントを使って[**Collectable**](https://docs.sandbox.game/jp/creators/game-maker/document/components/collectable) のアイテムをスポーンさせ、ゲームプレイを進めていくのに必要なリソースやプレイヤーのステータスを強化するのに必要な装備品などを設定できます。NFT を持っているプレイヤーだけがボーナスを獲得できるようにするために、秘密の場所にテレポートさせて、これらのアイテムを集めて、また戻ってくるという設定もできます。

パルクールのチャレンジではNFT を持っているプレイヤーを近道のある場所に[**テレポート**](https://docs.sandbox.game/jp/creators/game-maker/document/components/avatar-teleport)させ、他のプレイヤーが使っている同じコースに戻すという設定もできます。

### マルチプレイヤーでパーティー開催

NFT を持っているプレイヤーだけが楽しめる機能を設定できます。

* [**Actor Property Switcher**](https://docs.sandbox.game/jp/creators/game-maker/document/behavior/actor-property-switcher) 、[**Post Process Effect**](https://docs.sandbox.game/jp/creators/game-maker/document/behavior/post-process-effects)、[**Weather Switcher** ](https://docs.sandbox.game/jp/creators/game-maker/document/behavior/weather-switcher)のビヘイビアや[**Visual FX** ](https://docs.sandbox.game/jp/creators/game-maker/document/components/visual-fx)のコンポーネントを使ってゲームの世界を変えることができます。
* [**Asset Spawner**](https://docs.sandbox.game/jp/creators/game-maker/document/behavior/asset-spawner) のビヘイビアをトリガーして、誰でも使える[**Collectable**](https://docs.sandbox.game/jp/creators/game-maker/document/components/collectable) や[**Power Up**](https://docs.sandbox.game/jp/creators/game-maker/document/components/power-up) のコンポーネントを持つアイテムを表示させることができます。Trigger [**Asset Spawners**](https://docs.sandbox.game/jp/creators/game-maker/document/behavior/asset-spawner) to make [**Collectable**](https://docs.sandbox.game/jp/creators/game-maker/document/components/collectable) [**Power Up**](https://docs.sandbox.game/jp/creators/game-maker/document/components/power-up) items appear that anyone can use.
* [**Toggle**](https://docs.sandbox.game/jp/creators/game-maker/document/components/toggle) コンポーネントを持つ[**Basic Platform**](https://docs.sandbox.game/jp/creators/game-maker/document/behavior/basic-platform) や[**Advanced Platform**](https://docs.sandbox.game/jp/creators/game-maker/document/behavior/advanced-platform) のビヘイビアをOn/Off で切り替えることができます。
* [**Crowd Event**](https://docs.sandbox.game/jp/creators/game-maker/document/behavior/crowd-event) の進捗状況のメーターを進め、すべてのプレイヤーもしくはレンジ内のプレイヤーに[**VFX**](https://docs.sandbox.game/jp/creators/game-maker/document/components/visual-fx) を楽しんでもらうことができます。

### ボーナスゲームメカニクス

Rules で[**ローカル変数値**](https://docs.sandbox.game/jp/creators/game-maker/game-rules#rkarutogurbaru)（L）を使用し、NFT を持っているプレイヤーにだけ適用される[**ゲームルール**](https://docs.sandbox.game/jp/creators/game-maker/document/game-rules)をトリガーできます。

\[SP] と \[MP] のロジックはお互いにコミュニケーションを取ることができませんが、ゲームルールをはコミュニケーションを取ることができます。

プレイヤーがメッセージ送信をトリガーすると（一連のロジックが長い場合でも）、**プレイヤーソース**がメッセージに含まれ、ゲームルールシステムはプレイヤーのローカス変数値のみを変更できます。この機能を使って、NFT を持っているプレイヤーにゲーム世界のショップで使用される通貨やエクストラポイント、ボーナスタイムなどを付与できます。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sandbox.game/jp/creators/game-maker/document/components/nft-sensor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
