Youtube動画
こちらより視聴できます。
説明
マインクラフトには、「スクリプトAPI」と呼ばれる拡張機能が存在します。この「スクリプトAPI」とは、プログラミング言語（Javascript）を用いてゲームシステムをカスタマイズできる機能のことであり、Javascriptの知識さえあれば、マインクラフトのシステムをある程度いじることができるんです。 本動画では、このスクリプトAPI（ScriptAPI）についての情報を体系化し、この動画を一通り見ることでその概要・書き方・実践的な使い方が学べるようにすることを目的とします。動画内で言及される各種スクリプトについては以下をご覧ください。
【ScriptAPIのテンプレート】https://lemon-slime.com/?p=1210
【ScriptAPIの環境構築】https://lemon-slime.com/?p=1254
【UIの作り方】https://lemon-slime.com/?p=1299
【コマンドの作り方１】https://lemon-slime.com/?p=1404
【コマンドの作り方２】https://lemon-slime.com/?p=1492
【クールダウン】https://lemon-slime.com/?p=1235
【ブロックを動かす】https://lemon-slime.com/?p=1638
【vscode】https://code.visualstudio.com/
【node.js】https://nodejs.org/en/download/prebuilt-installer
【uuidジェネレーター】https://www.uuidgenerator.net/
各種スクリプトの説明
こちらで「逆引きScriptAPI」と称してよく使う関数やスクリプトをまとめています：
字幕一覧
以下は字幕です。結構長いです笑
コマンドを作りたい、
エンチャントを自作したい、
オリジナルのUIが作りたい！
こうしたマインクラフトの「やりたい！」を支えるのがScriptAPIである…
このチャンネルではこれまで多くのscript apiに関する情報を発信してきたが、
少々断片的な印象があった…
そこでこの動画ではこれらについての情報を体系的に並べて、
一通り動画を見ればscript apiについての概要が分かるようになることを目的とする
つまり総集編ってことだね
せやけど過去動画の中でもとりわけ有用な部分だけを抜き出し、
そうでない部分はできるだけ省くようにしたからだいぶ見やすくなったと思うわ
最終的にこの動画を全て見れば、script apiそのものの概要と、
スクリプトの書き方、オリジナルのUI、エンチャント、コマンドの作り方が分かると思うわ
葵、そもそもスクリプトAPIって何やと思う？
よく分かんないけど、プログラミングをしてるってイメージはあるよ？
せやな、具体的にはJavascriptっていう言語を使って、
マインクラフトのシステムをカスタマイズする機能のことやねん
例えばこれは、「プレイヤーがジャンプしたらkillコマンドを発動する」っていうスクリプトやけど、
こんな感じでシステムに干渉できるわけやな
面白そうだね
そうやと思うわ
で、早速このスクリプトAPIを触ってみるわけやけど、
これ、事前準備がそこそこ必要なんよ
…
そういう本質的じゃない部分に時間をかけるのもイヤやし、
うp主がスクリプトAPIのテンプレートを作ったみたいやから、
今回は、これを使って楽しよっ！
テンプレートか、助かる～
まずはお馴染み、うp主のサイトにアクセスしよう
概要欄にリンクがあるで
概要欄にリンクがあるで
ちょっとスクロールするとダウンロードリンクがあるから、これをクリック
適当な場所にダウンロードして…
ダウンロードしたzipファイルを右クリックして「すべて展開」を選択
適当な場所に展開しよう
展開が終わったフォルダを右クリックして、「切り取り」を選択。
com.mojangのdevelopment_behavior_packsフォルダ内にコピーしよう
com.mojangなんてフォルダー、どこにあったっけ？
結構奥のほうなんよ、さっきのページに詳しいことが書いてあるから、見てみて
こんな感じに、development_behavior_packs内に
スクリプトAPIのテンプレートがあれば成功。
マインクラフトを起動してさっきのテンプレートが認識されているか確認してみるで
「ビヘイビアパック」を選択して
さっきのテンプレートが正しく表示されていればOK。
ちゃんとあるね！
OK。ただ、これ自体はテンプレートであって
何か特別なことをするわけではないから、有効化しても何も起こらへんで
ねー、早速スクリプトを書いてみようよ！
せやな、一旦マインクラフトは終了するで
さっきのフォルダをダブルクリックして、
その中にあるscriptsフォルダを開こう
何かあるよ？ main.js？
これはjavascriptのファイルで、ここにスクリプトを書いていくねん
早速ダブルクリックして開こう
初めてjsファイルを開くときはこんな画面が出ると思うけど、
メモ帳とかVSCodeとかのテキストエディタを開けばOK
なんかあるよ？
一行目は「minecraft/serverモジュールを持ってきなさい」という意味。
これでマインクラフトの世界に干渉できるようになんねん
めっちゃ大事だ
せやで、これは消さんほうがええな
余談やけど、ここで変数serverを宣言してるから、
後で突拍子もなく出てくるserverは、
このマインクラフトのモジュールを表してるから注意な。
了解！
次にスクリプトを書いていくで
スクリプトを記述って書いてあるね
これはコメントやから消しても残してもどっちでも大丈夫やで
この下に早速、こんな感じでスクリプトを書いてみよう！
うp主のサイトにも書いてあるから、それをコピー＆ペーストするのが早いかも
これはどういう意味なん？
実際にゲーム内で見てみよう！
さっきのjsファイルを保存したらワールドを新規作成して
ビヘイビアパックを有効化。
すると・・・
え、なにこれ
メッセージ欄がHelloで埋め尽くされてるんだけど…
こんな感じで、ゲームシステムを改変できるのが、「スクリプトAPI」の効果。
どういうこと？
マインクラフトのモジュールにはsystemクラスのrunInterval関数があるんやけど、
これは何かを常時実行することができんねん
そしてworldクラスのsendMessage関数はメッセージを送信する関数。
今回はHelloという文字を送信してるな
なるほど、それらを組み合わせて・・・
こんなことができたんだ
せやで、意外と単純やろ？
でも、もっと実用的なスクリプトがいいなあ・・・
じゃあ、葵がさっき言ってたアイテムを使ったらコマンドが発動するスクリプトでも作ろう！
とりあえずさっきのスクリプトはもう使わへんから削除して…
ここに新しいスクリプトを書いていくで
まずは、アイテムが使われたときに発火する関数を定義。
関数の名前はeventの頭文字、evとするで。
もしも使われたアイテムのidがstickであれば、
そのイベントの発動者を基準にコマンドを発動する、という感じ。
今回はgiveコマンドとするで
そしてマインクラフトを起動して手持ちの棒を右クリックで使ってみると・・・
あ、ダイアモンドが増えてる。
これもスクリプトAPIの効果やな。
このスクリプトもうp主のサイトに書いてあるから、コピー＆ペーストするのが早いで。
アイテムのidやコマンドの内容を変えればお好みにアレンジできるので是非。
うちの作ったオリジナルアイテムもいけるのか…
もちろん！
この動画では簡単にAPIスクリプトについて触れたけど、
ここからはちょっと専門的な解説もしていくわ
専門的な解説って何？
あれはすでにあるテンプレートを使って構築したけど、
それだとちょっと柔軟性・拡張性に欠けるんだよね
というわけでここでは一からAPIスクリプトの環境を構築する方法について話すわ
まずは必要なものがいくつかあるからこれをインストールしよう
詳細は概要欄を見てね
なんかソフトの一覧にマインクラフトが入ってるんだけど
このチャンネルの視聴者の大多数は持ってると思うから解説は省くわ
次のvscodeはプログラミングに特化したテキストエディタで、
必須ではないけどあったほうが断然楽やで
概要欄に貼ってあるリンクからダウンロードできるで
ゲーム制作で使ったやつだ
汎用性が高いよな
最後にnode.js。
これはあんまり聞かないなぁ
本来javascriptっていう言語はWebページ上で動作するスクリプトなんやけど、
これをパソコン上で使えるようにするのがnode.jsの役割。
ふーん…
これも概要欄からアクセス可能。
ダウンロードボタンを押して、msiファイルをダブルクリックして実行すれば完了。
今回解説する工程ではnode.jsは必須やで
これがダウンロードできたら次に進もう
まずはいつも通り、com.mojangフォルダを開こう
com.mojangフォルダの場所はご覧の通り。
一時停止推奨。
結構奥のほうだよね
せやな、迷いやすいから注意。
開けたらdevelopment_behavior_packsを開こう
そしたら右クリックしてフォルダを新規作成。
フォルダの名前はお好みで。
今回はtestとしたで
そしたらこれを開いてmanifest.jsonを作ろう
右クリックして新規作成からテキストドキュメントを選択。
するとテキストファイルが作成されるから、これを改名して
manifest.jsonとしよう
聞いたことあるな…
これはアドオンの要項を記述する、必須のファイルだから
本チャンネルでも何回か取り上げてるで
これをvscodeで開いて、編集しよう
内容はこのサイトに書いてある通りで、コピー＆ペーストすればOK。
何点か補足すると、
ここでアドオンの名前と説明を定義しているので、
アレンジはお好みで。
これがそのまま表示名になるで
このuuidはアドオン固有の文字列。
これはそのまま使うというよりも、
uuidジェネレーターとかを使って生成・変更するのがええかもな
そのまま使うとどうなるの？
このアドオン自体は動くんやけど、配布するときにちょっと面倒なことになるな
最後にminecraft/serverのバージョンについて。
動画作成時点で有効なバージョンはこんな感じで、
基本的に最新のバージョンになればなるほどいろんな機能が使えるようになるんやけど
ベータ版は挙動が安定しないから使用には注意が必要やな
それが完了したらフォルダを新規作成して
scriptsと改名しよう
たしかここにスクリプトを書いていくんだっけ？
せやな、scriptsフォルダを開いて
新規作成からテキストドキュメントを選んで
これをmain.jsに改名しよう
これをvscodeで開いたら、
上のメニュー欄からTerminal、New Terminalの順に選択。
するとターミナルが開くので、
まずはこのアドオンがあるフォルダに移動しよう
続いてnpmコマンドでマインクラフトのモジュールをインストール。
こんな感じになれば成功。
ちなみにこの一連の操作はコマンドプロンプトでもできるで
もはやマイクラの動画とは思えない…
ちょっと専門的すぎたな…
でも事前準備はこれで終わり。
あとはmain.jsに何かスクリプトを書いていこう
スクリプトの内容についてはさっきお話ししているので
ここでは割愛。
こんな感じで簡単にスクリプトが書けたら保存して、
アドオンの有効化を行ってからゲームをロードすると…
無事、メッセージ欄がHelloで埋め尽くされるで
manifest.jsonのversionについてなんやけど、
ここをベータ版にすると最新の機能、
例えば自作のコマンドの制作なんかができるようになるんやけど
その場合はベータAPIをオンにする必要があるから注意な
というところで基本事項の解説は終了
ここからは、これらを使って実践的な使い方、
例えばオリジナルのコマンドやUIの制作方法について解説
さて、まずUIの制作にあたっては必要なものがいくつかあるから注意
これらのインストールを前提にこの動画の解説を進めていくんやけど、
その前に用語の定義から。
え、そこから？
一応ね…
やりすぎると視聴者維持率が下がるよ…
おっと、それはあかん
これは各自確認してもらうとして
早速、uiの制作に取り掛かろう！
まずはスクリプトAPIの根幹を成すアドオンを作っていくんやけど、
葵、アドオンに欠かせないものと言えば？
え、根気とか？
そういう精神的な話とちゃうのよ
あー、manifest.jsonね
せやな、いつも通りcom.mojangフォルダを開いて
中にあるdevelopment_behavior_packsを開くで
manifest.jsonの作り方はさっき解説しているので今回は割愛
見た感じいつもと変わらないけど…
一見するとそうなんやけど、
最後でモジュールserver-uiをインストールせなあかんから注意点やな
テンプレートを使っている場合、これがない可能性が高いので、この部分を書き足せばOK
初見殺しだ…
この辺がハードルになってるのは否めへんよな
このnameやdescriptionを変えてアレンジできるのはいつも通り。
uuidも変えておくとええで
それが終わったら次にマイクラのモジュールのインストールをしよう
まずはVSCodeのターミナルかコマンドプロンプトを起動。
コマンドプロンプト？
タスクバーの検索欄に「cmd」と入力したら起動できるで
ここにコマンドを打っていくんやけど…
まずはcdコマンドを実行してアドオンの作業フォルダに移動しよう
例としてはこんな感じ。このパスは人によって違うから各自確認してみてね
次に、ご覧の2つのコマンドを実行。
npmコマンドなんてあるんだぁ
これはjavascriptのモジュールをインストールできるコマンドなんやけど、
実行には冒頭で話したnode.jsのインストールが必要やから注意。
こんな感じのメッセージが出れば成功やな
いよいよ本題。次にスクリプトを書いていこう！
やっとか…
scriptsフォルダ内のmain.jsに移動。
ここにスクリプトを書いていくんだよね
せやで
これをテキストエディタで開いたら、
早速、これを記述してモジュールの呼び出しを行おう
あれ、今回は2つなんだ…
せやで、uiを表示するための特殊なモジュールが必要やねん
これで事前準備は完了。
次にうp主のサイトにある、これをコピー＆ペースト。
これはどういう意味？
端的に言えば、UIを定義して表示するための関数。
ここでUIのタイトルとボタンの名前を定義しているから、アレンジはお好みで。
下に書いてあるのは？
ここでボタンを押したときの挙動を定義してんねん
一番上のボタンを押したときにresponseは0になって、
二番目のボタンを押すとresponseは1になるで
何も押さなかったときは、デフォルト。
今回はそれぞれについてsendMessage関数でメッセージを送信してるな
これで終わり？
ここでやってるのはUIそのものの定義だから、実際に表示するスクリプトはまだなんよ
というわけで最後に、定義した関数を実行してUIを表示するスクリプトを書こう
とは言っても、常にUIが表示されてたら邪魔やし、UIが表示される条件も考えなあかんな
何かアイテムを使ったら表示するのがシンプルで良さそう
せやな、そうするとこういうのがええかもな
例にもれず、うp主のサイトに書いてあるからコピー＆ペーストすればOK
アイテムを使ったら発火する関数を定義して、
もし使ったアイテムが棒だったら、
使っているプレイヤーを基準にUIを表示する、という感じ。
この関数はplayerを引数にしてるから、アレンジする場合はこの点に注意やな
あと、ここがbeforeEventsだと動かへんから、これも注意。
一度マイクラを起動して棒を使ってみるで
え、すごい！ UIが表示されてる
こんな感じでUIとボタンが表示されて、どちらかを選択すると…
ちゃんとメッセージが表示されてるな
もう一個のボタンもOK。
ところでお姉ちゃんはどっち派なの？
うち？ うちはマクド派やで
逆に、何でみんなマックって言うの？
あ..やっぱり
葵は？
え、意外…
メッセージだけじゃ物足りない場合は、コマンドを実行することもできるで
正直、コマンドでほとんどのことはできるから、これとsendMessageで事足りると思うわ
試しに「マック」を選択するとgiveコマンドが発動するようにしてみたで
実際にマックを選択してみると…
あ、エメラルドが手に入った
こんな感じで自由にカスタマイズできるのがええよな
さっきはボタンをいくつか配置して、
何かを起こす、みたいなことをやったけど、
そもそもボタンしか配置できへんかったから、
ちょっと自由度が低いのは否めへんよな
あー、確かに
今回はボタンだけじゃなくて、テキスト入力欄とか
チェックボックスとか、色々なものを追加する方法を解説するで
面白そう！
解説の前に挙動の確認を。
このスライダーを動かすと数字を入力できるし、
テキストボックスにはテキストを入力できんねん
ドロップダウンでいくつかの選択肢の中から選ぶことができて、
チェックボックスでオンとオフを切り替えられるで
これで送信をすると、データが出力されんねん
へえ、すごい
というわけで早速これを作っていくんやけど、
まずはお馴染み、main.jsにアクセスして、
ここにスクリプトを書いていこう！
まずはimport文で２つのモジュールを呼び出すで
これはいつも通りだね
これはいつも通りだね
せやな、既にある場合はこれは不要。
次に引数をplayerとして、フォームを呼び出す関数を作ろう
変数formを宣言して、
uiモジュールのmodalformdataを呼び出すで
こんなのあったっけ？
これはformのテキストボックスとかチェックボックスを呼び出す関数。
前回とはちょっとちゃうから注意な。
さて、これを使って各種機能をつけていくで
まずは、このスライダー。
スライダーを定義するには、slider関数を使おう
この関数には引数が必要で、この引数の文字が、
そのままここに表示するラベル名になんねん
さらにこの関数は引数が4つ必要で、
順に最小値、最大値、刻み幅、初期値を定義すんねん
実際にこのスライダーの初期値は50になってるな
引数、多いね
一つでもなかったらエラーを吐くから気つけてな
続いて、テキストエリアを定義。
textField関数を使おう！
ここでは引数の文字列が２つ必要で、
順にラベル名とプレースホルダー名を定義すんねん
それぞれ、こことここの文字になんねん
へえ、細かい…
次に、いくつかの選択肢から一つを選ぶドロップダウン。
dropdown関数を使うで
ここでは引数が２つ必要で、
一つは表示されるラベル名、もう一つは表示される選択肢。
これは配列形式で定義するから注意な
最後に、オンオフを切り替えるチェックボックス。
toggle関数を使うで
引数は、ラベル名。
１個だけなんだ
これはシンプル。
最後にこのformを表示する機構を作ろう！
前回と同じで、show関数を使おう
引数は、player。
これを実行したら、引数responseを受けて実行する関数を定義
ここでいきなり挙動を書いてもええんやけど、
例外処理を先にすましておくのが筋やな
例外処理？
予期しない動作をした時の挙動を定義すんねん
まずはこのフォームを送信せず閉じたときの挙動を設定しよう
if文を使って条件分岐させて、
もしフォームがキャンセルされたなら、
プレイヤーに軽くメッセージを送っといて、
return文でこの関数から離脱。
次にメインの挙動を設定するんやけど、
今回はフォームのデータを表示するだけの
シンプルなシステムを設定するで
なるほど
sendMessage関数でメッセージを送信。
ここではスライダーの値を取得して出力するで
スライダーの値をString型にして、
response.formvalue0でスライダーの値を取得
どうして０なの？
このformvaluesはフォームのデータを配列で出力するんやけど、
上から順に0,1,2と配列の番号が振られんねん
今回、スライダーは一番上にあるから０になるわけやな
なるほどね
なるほどね
同じようにテキストボックスは今回１となるし、
ドロップダウンは２になるな
チェックボックスは3やけど、基本これは
選択に合わせてtrueかfalseを返すから、
if文と合わせて使うことが多いかもしれへん
なにこれ？
三項演算子。if文みたいなもんや
さて、関数の宣言ができたから、後はこれを呼び出すで
今回は、棒を使ったらこの関数を発火させよう
この辺のやり方についてはこの動画が詳しいで
関数を使うときにplayerクラスの引数が必要なのは注意
この状態で棒を使うと・・・
なんか出てきた！
表示もOKやな
色々入力を変えて遊んでみよう
出力が変わったね
ドロップダウンの選択が１になってるけど…
ドロップダウンは要素の名前じゃなくて、
要素の番号を返すみたいやな..
こんな時はif文を使って、
それぞれについて処理を定義するのがええかもな
こうするとドロップダウンの名前が出てくるな
キャンセルしたときの処理もOK
今回はsendmessageでメッセージ送信をやったけど、
実際はrunCommandと合わせて
動的に処理を実行することが多いかもな
これを使えば、入力した座標にテレポートするアドオンが作れたり
夢が広がるね！
せやな、みんなも試してみてね！
さて、これまではUIの作り方について話してきたけど、
ここからはコマンドの作り方について解説するわ
自作といってもな、スラッシュから始まる普通のコマンドを作るわけとちゃうんよ
こんな感じでチャット欄を監視して、
特定のフレーズだったら何かを実行する、というのをやりたいねん
で、ここが重要やねんけど、
今回チャット欄の監視を行うにあたって
ここがベータ版じゃないと動かへんのよ
最新機能なんだ
で、ここのバージョンは頻繁に変わるから、
公式のリファレンスでバージョンを確認してね
ちなみに、動画作成時点のバージョンは1.15のベータ版。
あと、ベータ版を使う場合はワールド起動時に「ベータAPI」を
オンにする必要があるのも注意。
忘れそうだ…
後でもう一回話すで
main.jsを開いて、スクリプトを書いていこう！
ようやくコマンドが作れるのね…
その前にモジュールのインストールを忘れずに
あとはスクリプトを書くだけだね！
せやな、
大まかな流れはこんな感じで、
何らかのメッセージが送信されたときにそれを検知して
処理につなげていくという流れやな
まずは簡単な例を書いていくで
まずは、いつも通りモジュールの呼び出しから
これでマイクラの世界に干渉できるようになるで
続いて、チャットが送信されたときに発火する関数を定義。
chatSendなんてあるんだ
これで、チャットの送信を監視できんねん
便利やからめっちゃ使うで！
subscribeで関数の実行を予約したら、
この関数の名前をevとするで
ev.messageでメッセージの内容を取得して、
もしこのメッセージが「!killall」だったら、
このメッセージの送信者、ev.senderのもとで
runCommand関数でコマンドを実行。
これを保存して、
さっき言ったようにベータAPIをオンにしたら、
ゲーム内で「!killall」が使えるようになるはずやで
実際に使ってみよう
あ、モブが倒された
こんな感じでちゃんと機能するな
さっき書いたスクリプトはうp主のサイトにもあるから、
コピー＆ペーストするのが早いで
ここではrunCommand関数を使って処理を行ったけど、
sendMessage関数を使ってメッセージを送信することもできるで
これを実行すると、こんな感じでメッセージが返ってくるで
山びこ山みたい
それ以外にもさっき紹介したやり方でUIを出すとか、
色んなスクリプトが考えられるな
みんなもオリジナルのコマンドを作ってみよう！
で、普通のブログとか動画はここで終わるところやけど、
ここで終わらないのが当チャンネル。
普通のコマンドだとこんな感じでオプションの設定、
いわゆる引数を付けられるんやけど、
オリジナルのコマンドにもこれを実装してみよう、という話。
説明に入る前に、前提知識から。
例えばこんな感じに文章があったとするやん？
ぶん、しょう？
オレンジのところに文字が入って、白は空白。
で、こんな文章について、
javascriptに標準搭載されてるsplit関数を使って
空白で分割すると、
こんな感じになんねん
それぞれの文字に番号が振られるのか
せやで、そしてそれぞれを配列に格納。
これは空白に限らずいろんな文字で分割出来て、
この文章を点で分割するとこんな感じになるな
このsplit関数を使うと引数を取得出来て、
その例はこんな感じ。
これは何？
足し算を行うaddコマンドを実装する例。
実際に使ってみるで
引数の数字を２つ入力すると・・・
あ、足し算ができてる！
もちろん、他の数字でも・・・
これも大丈夫そう
小数の足し算もOK
ということでこれの解説を。
一行目はさっきと変わらないね
せやな
だけど２行目はstartsWithが使われてるな
ほんとだ。これは何？
これは、文字列が指定の語句から始まっているかどうかを判定する、
javascriptの標準ライブラリの関数。
今回は、メッセージが「!add」から始まっている時にtrueを返すで
3行目ではさっき話したsplit関数を使って、
空白でメッセージを分割して配列に格納。
４行目で足し算を行う、という流れやな
この辺の詳しい流れはうp主のサイトにも書いてるで
そしてこれを応用すると、
引数を無限に増やすことができんねん
え、すご！
今回はこんな感じで５つの引数を置いてみよう
あ、合計が出た
こんな感じで引数の数に関わらず
コマンドを実行することができんねん
さっきと違うのは、引数の処理でfor文を使ってるところやな
このlengthで配列の要素の数を取得してるで
なるほど、面白いね！
みんなもカスタマイズして遊んでみてね！
で、さらに応用するとこんな感じで
コマンドの中で任意のコマンドを実行できるんよ
え、どういうこと？
executeコマンドをイメージすると分かりやすいかも
これはwaitコマンドといって、
コマンドの実行を遅らせるコマンドやねん
試しにこれを使ってみるで
こんな感じのコマンドを実行すると・・・
ちょっと遅れてメインのコマンドが発動すんねん
これは任意のコマンドについて有効で・・・
giveコマンドを遅延させることもできるな
ここでは実行が60ティック、3秒遅れるで
すごい！
今回の場合、空白で分割するのはあかんのよ
というと？
giveコマンドの中にも空白があるやろ？
ああ、waitコマンドの引数とgiveコマンドの引数を
区別しなきゃいけないのか…
今回はこういう感じで分割したいから、
for文でコマンド部分の文字列を合体してるで
なるほど…
ここまで色々コマンドの作成方法について話したけど、
チャット欄に依存する以上、
コマンドブロックを使った実行の自動化が難しいんだよね
確かに…
次はこの問題の解決策を示すわ
で、その方法なんやけど…
タイトルにも書いてあるし、何ならここにもあるよ？
せやな、鍵を握るのがこのscripteventコマンド。
でも、そんなのあったっけ？
それがあんねん
こんな感じでヘルプにも出てくるんやけど、
影が薄いのか、あまり知られてへんみたいやな
だって説明見てもよく分かんないこと書いてあるし…
せめて「コマンドを自作できます」とか書かれていればいいのに…
ま、その辺分かりづらいのはあるよな
まずはこのコマンドがどういうものなのかを話すわ
お願いします！
そもそも、scripteventコマンドの構文はこんな感じ。
最初にコマンド名であるscripteventをおいて、
その後にidを、
そして最後にメッセージを書くで
このidって何？ あらかじめ決まってるの？
いや、自分で決められんねん
このidだったらこういう処理をする…
っていうのを、あらかじめ自分で決めんねん
へぇ…
百聞は一見に如かずやな、実際にコマンドを使ってみるで
今回はあらかじめ、killallというidを入力すると
killコマンドが発動するようにしてるで
そしてこのコマンドを実行すると…
モブが倒されたね
こんな感じで機能するわけやな
このidの部分には名前空間が必要やから注意
これ、どうやってidを定義するの？
ここで必要になるのが、ScriptAPI。
いつも通りmain.jsにアクセスして
モジュールを呼び出したら、
こんな感じでスクリプトを書いていくで
まずは、scripteventが発火したときにトリガーする関数を定義。
関数の引数はevとするで
ev.idで送信されたscripteventのidを取得して
もしこれがkillallやったら、
scripteventの送信者、ev.sourceEntityのもとで
これで完成？
もうちょっとやりたいことがあんねんけど、
とりあえず、このスクリプトの挙動を確認してみよう！
scripteventコマンドを実行するで
ちゃんと動くね！
次にコマンドブロックで動くか見てみるで
同じようにscripteventコマンドを入力。
そしてコマンドを実行すると…
こんな感じでエラーが発生すんねん
え、scripteventはコマンドブロックでも使えるんじゃないの？
無条件で使えるわけとちゃうねん
考えてみれば当たり前のことで、
今回、コマンドを実行したエンティティについて
runCommand関数で処理を行ってるけど、
ブロックはエンティティとちゃうからエラーが発生するわけやな
スクリプトがコマンドブロックに対応してないのか…
じゃあ、どうすればいいの？
実行者を場合分けして、
それぞれについて処理を行っていくで
ev.sourceTypeでコマンドの実行元を取得して、
それがentityだったら普通に処理を実行。
そうでなくて、実行元がBlockやった場合、
ev.sourceBlockで実行元のブロックを取得して、
そのブロックのディメンション内でrunCommandを実行。
回りくどいね
しゃーなしやな
実際に動かしてみるで
コマンドブロックを起動すると…
あ、モブが倒されてる
エラーも発生してへんな
え、これを応用すると足し算コマンドが作れんねん
足し算？
今回は、idとしてaddを入力。
そして次のメッセージ欄に、足し算する数字を入力。
今回は、小数の入った２つの数字を足し算するで
結果がでてるね
さっきと違うのは、このev.messageで
メッセージ部分の文字を取得してるとこやな
ホントだ
これをsplit関数を使って空白で分割して、
それらの数字を使って足し算をしてるで
後半部分はさっきとあまり変わらへんのやけど、
この辺の流れだけちょっとちゃうな
ホントだ、どういうこと？
sendMessage関数はクラスがプレイヤーじゃないと使えへんから、
そのブロックがあるディメンションにいるプレイヤーを取得して、
各プレイヤーについてメッセージ送信してんねん
こんな感じで、scripteventを使えば
コマンドを「自作」できんねん
結構、面白いね
せやろ、これを使えば自由度がかなり上がると思うわ
コマンドブロックが使えるのもええよな
さて、基本的なscript apiの概要や使い方についてお話ししたところで、
次は実践的な使い方、特にエンチャントの自作について話すわ
百聞は一見に如かずやし、まずは挙動を見せるわ
え、雷が落ちてる！
こんな感じで、敵を攻撃したら雷が落ちるエンチャントを作れんねん
ホントにエンチャントなの？ コマンドでもできそうだけど…
でも、ただの剣で攻撃しても何も起こらへんねん
あー、それはコマンドじゃ難しいか…
このエンチャントがついてるときだけ、雷が落ちんねん
どういう仕組みなの？
実は、雷が落ちる剣にはこんな説明文がついてんねん
ん？電撃の力？
せやで、これが付いてたら雷が落ちるし、
逆についてへん場合は雷は落ちへん
これが実質的なエンチャントとして機能するわけやな
疑似的といったのはそういうことだったのね…
そういえばアイテムに説明文ってつけれたっけ？
それができんねん
詳しいことはこの動画とかこの動画で解説してるで
どうやって説明文を検知して、雷を落とすんだろう？
流れとしては敵を攻撃したときに発火する関数を作って、
そのとき持っているアイテムを取得して、
そのアイテムについている説明文を検知。
その説明文が「電撃の力」ならば、
summonコマンドで対象に雷を落とす、という感じやな
次章ではこれを形にしていこう！
まずはimport文でモジュールを呼び出し。
次にスクリプトの本体を書いていこう
まずは攻撃したときに発火する関数を定義。
entityHitEntityプロパティを使うで
関数の引数をevとして
まずは攻撃をしたplayerを取得して変数に格納。
この変数playerが、エンティティのplayerであることを確認して、
playerの持っている武器を取得して変数weaponに格納
getComponent関数を使おう
getItem関数で現在選択中のスロットのアイテムを取得して
もしこのweaponが定義されてないなら関数から離脱
この場合は素手っていうことやな
続いてgetLore関数でこのアイテムの説明文を取得して、
それが電撃の力であるかどうかを確認
もしそうなら攻撃されたエンティティを基準に
summonコマンドで雷を召喚。
なんかここの書き方おかしくない？
実はこの関数は説明文を配列の形式で出力すんねん
へえ、意外。
ここでは０番目の要素を取り出してる感じやな
スクリプトの本体はそうなんやけど、
「電撃の力」のついたアイテムをどっかから調達せなあかんから、
次はそれを定義するスクリプトを書こう！
今回はコマンドで入手することにするで
詳細はさっき解説してるな
idをenchantmentの頭文字、enchとして
実行者playerを宣言。
そしてさっきと同じように手に持ってるアイテムを取得
さっきと違ってここがgetSlotなのは注意な
そしてこのweaponがきちんと存在するか確認して、
最後にこのweaponに「電撃の力」という説明文を付与
相変わらず配列で指定する点には注意。
実際に確認してみるで
まずは説明文がついてない状態。
ただの剣だね
この剣を使っても特に何も起こらへんな
次にさっき作ったコマンドで説明文をつけてみよう
ちゃんと説明文がついたね
実際に攻撃すると…
雷が落ちてる！
ちゃんと動くことが確認できるな
さて、このエンチャントだけど、やろうと思えば
ツルハシとか道具にもついちゃうんだよね
あ、ホントだ。剣だけに制限したいなぁ
そういう時は条件付きで説明文を付与すればええかも
weaponのidを取得して、これが「sword」で終わるなら
setLore関数を実行するようにしてみよう
そうでない場合は、
プレイヤーに軽くメッセージを送信。
試しにこのシャベルに説明文をつけてみるで
scripteventを実行すると…
あ、なんか出てきた
こんな感じでエンチャントの付与を制限することもできるな
今回の処理は敵に対して何かを行うものだったけど、
当然、自分に対して何かを起こすこともできんねん
試しにsayコマンドが発動するようにしてみよう
攻撃をすると…
なんか出てきた
こんな感じでエンチャントの挙動を変えることもできるな
基本的にはこれらを組み合わせてscript apiを構築していくんやけど、
ここではscript apiの実践的な使い方の例を２つ示すわ
これらを参考にしながらオリジナルのスクリプトを作ってみてね
まずはこの「クールダウン」をどう定義するかなんやけど…
え、定義も何も一度アイテムを使ったら一定時間は使えなくなることでしょ？
せやな、その線で考えていこうか
でもどうやって実装するの？
いろいろ考えたんやけど、こんなアプローチはどうやろうか？
え、難しそう…
ここではscoreboardコマンドを使うのが肝やな
もし視聴者の中でもっとスマートな方法を思いついた方は、コメントをお願いします！
肝心のスクリプトは？
さっきのアプローチに則ると、こんな感じ。
さっきよりだいぶ長くなったね
機能がちょっと複雑なぶん、しゃーなしやな
いつも通り、うp主のサイトにも書いてあるから、参考に。
一つずつ解説していくな
最初のcooldown_timeはクールダウンの長さを定義していて、単位は秒。
デフォルトは3秒なんだ
せやな、ここの数字を変えることでアレンジできるで
次はアイテムを使用したときに発火する関数を定義。
さっきも見たな…
１つ違うのは、コマンドの発動が使用者のスコアに依存している点。
ここのrun以下でアイテム使用時のコマンドを定義しているので、
アレンジする場合はお好みで。
sayコマンドとかいうマニアックなものを…
sayコマンドはマインクラフト界のHello Worldやで…
アイテムを使用した際にスコアを付与している点もさっきと違うところやな
続いてゲーム内で常に実行される関数を定義。
このrunIntervalがそれか
せやで、結構よく使うから覚えておいて損はないな
全てのプレイヤーについて、
scoreboardコマンドを使って、毎ティックスコアを１ずつ減らしていく感じ
ちなみに、何かを常に実行するにはrunInterval以外にも
tick.jsonというのがあるんやけど、
これについてはまた別の機会に。
別の機会に解説すること多すぎ。
ネタは多ければ多いほどええんよ
で、これを保存することで棒を使ったらhello!というメッセージが表示されるけど、
連続で使用すると表示されなくなるはずやで
「はず」…とは？
実機検証は済んでるから心配せんでもええで
良かった…
最後にアイテムの使用時に条件を課す方法について解説するで
ところでその「条件」って何？
色々あると思うけど、ここではプレイヤーが特殊なアクションを起こしていた場合に
アイテムを使用可能にする方法について考えていくで
例えばプレイヤーがスニークしているときにアイテムを使用可能にするスクリプトはこんな感じ。
if文が加わってるね
せやな、このisSneakingプロパティはエンティティがスニークしている時にtrueを返すから、
これを条件判定に使ってる感じやな
そしてこれを応用して、
条件分岐を行うこともできるな
スニークしている時はHelloというメッセージを送信して、
そうでない場合は別のメッセージを送信する感じ。
これの何がすごいの？
葵、これを侮っちゃいけない…
こうやって条件分岐をすることで、一つのアイテムに複数の機能を持たせられるんよ
あー、その発想はなかったわ
ちなみに同様のことはanimation_controllerでもできるんやけど、
いつかこれについても解説するかもしれへん
それは解説しないやつだ…
ぐぬぬ…
こういう条件判定に使うプロパティにはいくつか種類があって、
主なものはこんな感じ。
結構あるんだね
まあ、でも実際うp主がよく使うのはisSneakingとisJumpingくらいやけどね…
詳しいことはうp主のサイトに書いてあるから、参考にどうぞ。
次はscript apiでブロックを動かす方法について話すわ
さて、まずはいつも通り挙動の確認から
え、すごい！勝手にブロックが動いてるよ？
こんな感じで、自由自在に動くブロックが作れんねん
これ、どういう仕組みで動いてるの？
今回はプレイヤーが手に持っているアイテムを判別して、
それが木の棒なら右に、そうでないなら左に動いてんねん
あ、プレイヤーの意思で動いてるんだ
せやねん、勝手に動いてるんとちゃうから、それが今回の肝やな
でも、ブロックを動かせたところで何ができるんだろう？
実用的に使えそうなところだとエレベーターとかかな
プレイヤーの意思で上や下に行けるようにすると面白そうやし
同じように自動ドアとかエスカレーターも作れそう
あとはこれを応用してブロックゲームを作ってみるとか
あー、なるほど。マイクラでテトリスなんかできたら楽しそうだ
これってどうやって動かすんだろう？
おそらく２つ方法があって、
一つはコマンドを使ったやり方。
そしてもう一つはScriptAPIを使ったやり方。
それぞれの方法のメリット・デメリットについて話すわ
さて、このコマンドを使ったやり方の良いところは
とにかく簡単ってことやな
専門知識は要らへんし、環境が整ってなくても可能。
具体的なコマンドは？
setblockを２つ組み合わせて移動を実現するのが早いかも
ただ、コマンドの場合対象となる座標を指定せなあかんから、
柔軟性に欠けるのは否めへんよな…
あー、それぞれの移動先に対応したコマンドが必要だもんね
この時点で、自由自在に動かせへんのと同義やな
そこで登場するのがScriptAPIってことか
せやねん、プログラミングを使って
ブロックの移動を制御できれば自由度も増すよな
というわけで、今回はscript apiを使ってブロックを動かしてみよう
まずはいつも通り、main.jsにアクセスして開こう
そしてimport文でモジュールを呼び出し。
続いてブロックを動かすための関数を作ろう
引数は、動かすブロックと方向
方向？
正確に言うと、これはベクトルやな
そして移動先のブロックの座標を計算して
x,y,zのそれぞれについてこのように記述。
それが出来たら移動先のブロックを取得しよう
まずこれが定義済みかどうか確認して
続いてこれが空気ブロックかどうかを確認。
そっか、移動先に別のブロックがあったら困るもんね
せやな、別にブロックが埋まってもええならこのif文は不要。
続いてブロックの移動を定義しよう
setblocktype関数で指定の座標のブロックを置き換え。
元々ブロックがあった場所にはairを配置しておこう
さて、この関数の部分はこれで終了。
あとはこれを呼び出すだけかな？
実はこの関数の呼び出しには一つ問題点があんねん
問題点？
というのもこのblockの指定にあたって
block型のオブジェクトが要んねん
え、普通にここにあるブロックを指定したいんだけど
そのブロックの指定をどうやるか、という問題やな
一々座標で指定するのは大変。
あ、そっか
ということで今回はプレイヤーの近くにあるブロックを
柔軟に指定することにしよう
新しく関数get blocksを定義して、
引数はplayerとblockのid、範囲としよう
各種変数をこのように定義して、
x,y,z座標のそれぞれについて繰り返し処理。
それぞれの座標に存在するブロックを取得して変数に格納。
そのblockが指定のidと同じなら、
配列blocksの末尾にそのブロックを格納。
最後にこの配列をreturnして関数部分は終了
近くにあるブロックの組をまとめて出力するんだ
そういうこと！
そういうこと！
最後にこれらの関数を使ってブロックの移動を定義しよう
今回は試しにプレイヤーの近くにあるダイアモンドブロックを指定して
次にプレイヤーが手に持っているアイテムを取得。
このアイテムが定義されてるかをまず確認して、
もし定義済みならさっき取得した各ダイアモンドブロックについて
プレイヤーの手に棒があるときに
move block関数でブロックの移動を実行。
今回はx方向に1移動させてみよう
逆に棒を持ってへんときはx方向に-1移動。
これでプレイヤーの操作を可能にするのか
今回は手持ちのアイテムで場合分けしてるけど、
他にも色々方法はあると思うわ
実際にマイクラを起動すると、
あ、ちゃんとブロックが動いてるね
手に持っているアイテムの判定もOK
ちなみにこのストッパーのブロックを撤去すると
あ、さらに進み続けるんだ
行き先が空気ブロックならこんな感じで進み続けんねん
でも、なんか止まってない？
今回はプレイヤーの周囲10ブロックにある
ダイアモンドブロックだけを指定して移動の対象にしてるから
当然離れたブロックには効果が及ばへんわけやな
さっきの関数の部分を変えればアレンジできるで
あ、そうなんだ
でもあんまり範囲を広げすぎると重くなるから注意な
このブロックの移動、応用も効いて楽しいので
みんなもやってみてね！
今回のスクリプトは概要欄からコピペできるので是非！
というわけでこの動画ではscript apiについて一通り解説したけど、
当然できることはまだぎょうさんあると思うわ
まさに氷山の一角だよね
せやねん、みんなもこれを参考にオリジナルのスクリプトで遊んでみよう！
あと、ここでは紹介しなかったけどマイクラにはweb socket serverと呼ばれる分野があって、
こっちはscript apiより専門的な分、扱えるとさらに楽しいので触ってみるのもええかも
今回の動画はこれでおしまい！
長時間のご視聴、お疲れ様です…
質問やご意見はコメント欄よりお願いします
それじゃー、
バイバーイ！
バイバーイ！
立ち絵素材：琴葉葵・琴葉茜（ユメのオワリ様 – im10706241）
