見出し画像

カスタムテーブル機能について -天狗ダイス拡張機能-

ニンジャスレイヤーTRPG用ダイスbot「天狗ダイス」にまた新たな機能が搭載されました!

そもそも「天狗ダイス」って?という方は以下の記事をチェックしてね。

カスタムテーブル機能とは?

天狗ダイスには「サツバツ!」や「カルマロンダリング」といった、ダイスロールの結果を元に、その効果を表示する表参照機能が付与されています。
今まではニンジャスレイヤーTRPGの公式・プラグインルールに記載された表のみ、効果を表示することができました。

このカスタムテーブル機能は、皆さんがDIYしたルールに基づく表を登録し、上記と同様の表参照機能を使えるようにしてくれます!

基本的にはプラグインやルールセットの開発者向けの機能ですが、使い方次第では「シナリオのハンドアウトを予め登録しておいて、セッション中のチャットの手間を省く」といった、NMの準備としての使用も期待できるでしょう。

作成したテーブルは、最初は作成を始めたチャンネル内でのみ使用できますが、より広くルールを使ってもらいたい!という方は、そのテーブルを「天狗ダイス」を登録している全サーバーに向けて公開する事もできます。
ダイスロールの表をいちいち参照する手間を省き、みんなに使ってもらいやすくなるかもしれません。

この記事を読んでぜひ作ってみてくださいね!

機能の仕様

カスタムテーブル機能に関するコマンドは全てスラッシュコマンドの「/ct」から開始します。
これは表を作成するためのコマンドであり、表を利用する場合は、サツバツなどと同様に「/nd」にて使用します。固定値で表示する「/fnd」にも対応しています。
なお、作成済みの表を使用するだけであれば、この先はほぼ読み飛ばしても大丈夫です。

機能利用の開始

/ct help

各コマンドについての詳細なヘルプを参照します。
この記事では各コマンドについての詳細は載せておりませんので、上記コマンドからそれぞれどのような使い方が必要なのかをチェックしてください。

利用者向け機能

/ct checkTableList

「今このチャンネルではどんな表が使えるのか?」を見るためのコマンドです。
公開済みテーブルと、そのチャンネルでのみ使用できるテーブル(プライベートテーブル)の2種類が表示されます。
なお、公開済みテーブルとプライベートテーブルの中に同名の物があった場合、効果表示はプライベートテーブルが優先されます。

これ以降は表の開発者向け記事です。利用するだけであればこれ以降は読み飛ばしても大丈夫です。

開発者へ:カスタムテーブルの作成方法

カスタムテーブルを作成する最初の手順は以下のとおりです。

1.「/ct createTable,(表名)」でテーブルを作成する。
2.「/ct updateDice,(表名), a, (ダイス)」で表を使用したときに振るダイスを登録する。
3.「/ct updateData,(表名), (出目),(表示する効果)」で出目ごとの表示する効果を登録する。
※3は登録が必要な出目ごとに1回ずつ行う必要があります。
4.「/ct checkTableData,(表名)」で、全てが正しく登録できているか確認する。
5.(公開する場合)「/ct publishTable,(表名)」で公開する。

3.の表示する効果では、Discordの全てのMarkdown記法をそのまま使うことができます。文字列を太字にしたり、下線を引いて強調する、絵文字を入れるなど、効果の文章をデコレーションすることができます。

また、updateDataは出目1つごとに1回発言が必要なため、別途メモ帳などで予め打ち込む命令文を作っておくと良いでしょう。

※注意※
表示メッセージの改行は、そのままの改行では無効になります。改行する場所を「<br>」という文字列に置き換えてください!
以下の補助ツールで作った場合はセル内の改行が自動的に<br>で補完されるようになります。慣れない方は補助ツールを使ってください!

カスタムテーブルを作成するまでに必要な発言を自動で生成するツールを開発しました。表作成時にぜひご利用ください!

カスタムテーブルの編集権限

作成したカスタムテーブルは「bot管理者(くりーむ)」、「そのサーバーの管理者」、「テーブル作成者」のみ編集・公開が可能です。第三者に勝手に表を編集されることはありません。
もし上記以外にテーブルの編集権限を与えたい場合は、
/ct addPermission」コマンドを利用してください。
なお、このコマンドで編集権限を与えられたユーザーでは「表自体の削除」「パーミッションの付与・解除」「表の公開」を行うことができません。

その他

詳細は「/ct help」から確認してください。
また、コマンドエラー時には何が間違っていたのかを教えてくれますので、それを元に再度発言を作り直してみましょう。

「ヘルプをみたけどわからない!」といった質問や、「公開した表を削除したい」「バグを見つけた」といった問い合わせにつきましてはDHTLS公式サーバーにいる「くりーむ」へご連絡くださいませ。
Twitterでも受け付けています!(ただしこちらでは反応速度はあまり早くありません)

サポートのお願い

天狗ダイスは Ver 5.0 を迎え、アプリの開発規模が大きくなってきました。
リッチなニンジャTRPG体験を支える天狗ダイスはランニングコストがかからない限り、基本無料のまま提供を続けていく所存です。

それとは別に、天狗ダイスに対してお金を払っていただける方は常に募集中です!
いただいたサポートを糧に、よりよい機能を提供するための開発を続けていきます。お金を払っても良いというカネモチの方は、本記事の下部にある「サポートをする」ボタンよりお願いいたします。
金額はお気持ちです。皆様のお気持ちを天狗ダイスにお伝えくださいますと幸いです。

更新履歴

『天狗ダイス』の記事に集約されています。

ニンジャスレイヤーTRPGを盛り上げるために、もしよろしければドネートを…!聖戦の継続の為に…!