#はじめに
この記事は、VCI Advent Calendar 2019の5日目の記事です。

#cytanb.luaはいいぞ
VCIでluaスクリプトを作成する場合において、私はほぼ全てのプログラムにoOさんが作成されているcytanb.luaを使用しています。（使っていない時は10行程度のプログラムのみ）
今回は感謝の気持ちをこめて、cytanb.luaの使い方の解説をしていきたいと思います。

cytanb.luaはこちらにあります。
GitHub - oocytanb/cytanb-vci-lua

github の使い方をご存知の方は後はワークスペースフォルダにこちらのデータを入れていただければ OK です。

github の使い方をご存知でない方のためのコピペ重視の導入方法をご紹介します。

#事前に
今回は、こちらのVCIスクリプトの開発環境の導入を実施した後という前提で話を進めます。
vscode:tutorial [VirtualCast]

#もくじ
cytanb.luaのススメ 1.導入編 - この記事
cytanb.luaのススメ 2.同一VCIのmessage競合対策
 cytanb.luaのススメ 3.同一VCIのtable転送

#1.cytanb_annotations.luaをワークスペースフォルダに置く

GitHub - oocytanb/cytanb-vci-luaからsrcフォルダを開きます
cytanb_annotations.luaファイルを開きます
Rawボタンをクリックして全文のみを表示させます
Ctrl+Aで全選択して右クリックでコピーします

次に、VScodeを開いて、EMBEDDEDSCRIPTWORKSPACEフォルダを選択して、新規ファイルを作成します。

新規ファイルを作成したら、cytanb_annotations.luaというファイル名にします。
(luaファイルでさえあればファイル名は自由だったりしますがこういうとこが大事)
types.luaやtemplate.luaファイルと同じ場所にcytanb_annotations.luaファイルがあることになります。

あとはこのcytanb_annotations.luaファイルを開いて、空欄を右クリックして先程コピーしたテキストを貼り付けたら完成です。

これでアノテーション・インテリセンスが効くようになります。
以後は更新されたcytanb_annotations.luaファイルを使用する際にはこのファイルに上書きすればOKです。
#2.cytanb_min.luaを使いたいluaファイルの最初の行に入れる

GitHub - oocytanb/cytanb-vci-luaからsrcフォルダを開きます
cytanb_min.luaファイルを開きます
Rawボタンをクリックして全文のみを表示させます
Ctrl+Aで全選択して右クリックでコピーします
使いたいluaファイルを選択して最初の行に貼り付けます

これで導入は完了です。

##cytanb_annotations.luaの利点は何？
選択肢・解説が出てくるようになります。

次は、これを使った便利な機能について解説していきます。