Roll20 Mods (API)

2024年11月06日 10:47

	無料	プラス	プロ
Roll20 Mods (API)

このページは、プロ契約者、または契約者が作成した対局のプレーヤー限定の機能についてのページです。この機能をご利用になりたい場合は、アカウントのアップグレードをご検討ください。

Roll20 Mods (API) は、ゲームをカスタマイズして強化するための強力な方法を提供します。ゲームプレイ中に駒を動かしたり、トークンにステータスマーカーを追加したり、サイコロを振ったりするような、Roll20に指示するコードスクリプトを作成します。 Mods（API）の使い方はシンプルで簡単だが、可能性は無限大だ。

MOD（API）ガイドとドキュメント

謝辞

フォーラム・チャンピオン（兼Arcane Scriptomancer）であるThe Aaronに感謝します！

ワンクリック・スクリプト・ライブラリを使用してMOD（API）スクリプトをインストールする方法を教えてください。

目的のゲームのランディングページに移動します。
Settings "ドロップダウンをクリックし、"Mod (API) Scripts "を選択します。
スクリプトライブラリ]ドロップダウンで、必要なスクリプトを探します。
スクリプトの追加］ボタンをクリックします。
これで、ゲーム内でスクリプトを使い始めることができます！

MOD（API）スクリプトをインストールする方法を教えてください。

ワンクリック・スクリプト・ライブラリを使ってスクリプトをインストールするのと同じようなプロセスです。

目的のゲームのランディングページに移動します。
Settings "ドロップダウンをクリックし、"Mod (API) Scripts "を選択します。
MOD（API）設定］ページで、［新規スクリプト］タブをクリックします。
コード・エディター・ウィンドウが表示されるので、そこでスクリプトのコードを挿入し、スクリプトに名前を付けます。
スクリプトコードをコピーペーストし、スクリプトの名前を指定します。
スクリプトを保存］ボタンをクリックします。
MOD（API）サンドボックスが再起動し、ゲーム内でスクリプトを使用できるようになります。

スクリプトを外部から入手した場合は、スクリプトの説明を参照して、重要な情報と指示を確認してください。

助けてくれ！スクリプトが動かないんだ！

MOD（API）のトラブルシューティングに関する一般的な支援をお探しの場合は、こちらの記事をご覧ください。より高度なデバッグのアドバイスや情報をお探しの方は、こちらの記事をご覧ください。それでも問題が解決しない場合は、 Mod (API) Forumに投稿してください。

脚本を書きたい場合、まず何が必要ですか？

Roll20 Mods (API) のスクリプトはJavaScript で書かれています。 JavaScriptを始めるには、言語の基本的な理解が必要ですが、JavaScriptについてもっと学びたい場合は、このCodecademyのコースが役立ちます。

まずは、上級者向け使用ガイドをご覧ください。

どのように機能するのか？

試合中に起こる出来事を聞くスクリプトを書くのだ。スクリプトは、ルールが守られているかどうかを確認したり、オブジェクトやトークンのプロパティを変更したり、さらにはカスタムチャットコマンドを提供したりすることができます。あなたのスクリプトはゲーム全体に影響を与え、GMと全プレイヤーの行動に影響を与えます。高度なスクリプトは独立して実行することもでき、パトロールルート上のトークンを移動させたり、手番が長引いたときにプレイヤーをナッジしたりといった自動アクションを実行する。

既成のスクリプトはどこにありますか？

Mod(API)スクリプトのコミュニティは、メンバーが常にスクリプトを作成し、議論しているため、かなり活発です。新しいスクリプトを探す基本的な場所は3つある：

GitHubにある公式Roll20 Mod (API) スクリプト・レポです。ここには、作者がレポに含めるために提出したスクリプトの最新版があります。
Roll20 Mod (API) スクリプト・フォーラム。ここでは、スクリプトが最初に表示される傾向があり、書かれているスクリプトや変更が必要なスクリプトについて議論が行われます。また、思いついたスクリプトを作ったり、ニーズを満たすスクリプトを見つけたりする際に、コミュニティに投稿して助けを求めることもできます。
WikiのMOD（API）スクリプトインデックス。利用可能なスクリプトに関する良い情報源です。

MOD（API）スクリプトをコミュニティに貢献する

Roll20コミュニティで提供したいスクリプトを作成した場合、Roll20 Mod (API) Script Repositoryに登録することができます。あなたのスクリプトがRoll20スタッフによって承認され、リポジトリに登録されると、あなたのアカウントに"API Scripter"フォーラムタグがアンロックされ、PatreonまたはPatreonに似たサイト（詳細は以下を参照）を通して広告を出すことができるようになります。スクリプトをリポジトリに正しく投稿するために必要なことは、Official Roll20 Mod (API) Script Repo を参照してください。

PatreonとTipeeeのリンク・ルールについて

Roll20 Mod (API) Script Repo に貢献している Mod (API) スクリプトの作者は、購読/寄付サービスサイトを通じて広告を出すことができます：PatreonとTippeeです。 Roll20 は、いかなる支払取引にも責任を負わず、いかなる個人的な取り決めも強制することはできません。

Mod(API)スクリプトの作者は、Roll20のスタッフによって承認され、Roll20 Mod(API)スクリプトレポに登録される必要があります。

GitHubにスクリプトを投稿する際に添付するsheet.jsonファイルには、PatreonまたはTipeeeのアカウント情報を含める必要があります。

PatreonやTipeeeで宣伝したい場合は、jsonファイルにこれらのフィールドのいずれかを追加してください：

パトロンパトロン・キャンペーンのURLをここに入力すると、スクリプトの説明文の下に表示されます。 (例："https://www.patreon.com/<name>")

ティピーTipeeeのURLをここに入力すると、スクリプトの説明文の下に表示されます。 (例："https://www.tipeee.com/<name>")

詳しくはhttps://github.com/Roll20/roll20-api-scripts#contributing。

Roll20フォーラムでのPatreon/Tipeeeへのリンク

Roll20フォーラムでのPatreonやTipeeeへのリンクは、キャラクターシートやMOD（API）スクリプトを投稿した、事前に承認されたコミュニティメンバーにのみ許可されます。利用者に直接資金提供を求める場合は、個人的に行うことができますが、投稿資料のない公開フォーラムでは、そのようなリンクは許可されません。