Modスクリプト入門（API）

2025年11月07日 18:33

このページは、Proサブスクライバー限定、またはサブスクライバーが作成したゲーム内のプレイヤー限定の機能について説明しています。この機能をご利用になりたい場合は、アカウントのアップグレードをご検討ください。

Mod Scripts (API) は、ゲームのカスタマイズと機能強化を実現する強力な手段を提供します。ゲームプレイ中にRoll20に指示を出すコードスクリプトを作成します。例えば、駒を移動させたり、トークンにステータスマーカーを追加したり、ダイスを振ったりといった操作です。 Mods（API）の使用は、始め方はシンプルで分かりやすいですが、その可能性は無限大です。

Mod (API) ガイドとドキュメント

謝辞

フォーラムチャンピオン（そして秘儀の文字魔術師）であるアーロン氏に、Roll20コミュニティへ惜しみなく知識を共有してくださるその意欲と献身に対し、心から感謝申し上げます！

ワンクリックスクリプトライブラリを使用してMod（API）スクリプトをインストールするにはどうすればよいですか？

目的のゲームのランディングページに移動してください。
設定ドロップダウンをクリックし、Mod (API) スクリプトを選択してください。
スクリプトライブラリのドロップダウンで、必要なスクリプトを探してください。
スクリプト追加ボタンをクリックしてください。
ゲーム内でスクリプトの使用を開始できます！

独自のコードを書きたい場合、または外部ソースのコードを使用したい場合、Mod（API）スクリプトをどのようにインストールすればよいですか？

当社のワンクリックスクリプトライブラリを使用してスクリプトをインストールするプロセスと似ています。

目的のゲームのランディングページに移動してください。
設定ドロップダウンをクリックし、Mod (API) スクリプトを選択してください。
Mod（API）設定ページで、[新規スクリプト]タブをクリックします。
コードエディタウィンドウが表示されます。そこでスクリプトコードを挿入し、スクリプトに名前を付けることができます。
スクリプトコードをコピー＆ペーストし、スクリプトに名前を付けてください。
スクリプトを保存ボタンをクリックしてください。
Mod（API）サンドボックスが再起動します。これでゲーム内でスクリプトの使用を開始できます。

スクリプトを外部ソースから入手した場合は、重要な情報と手順についてスクリプトの説明を参照してください。

助けて！スクリプトがうまく動かない！

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

スクリプトを書きたい場合、始めるには何が必要ですか？

Roll20 Mods (API) のスクリプトはJavaScript で記述されています。始めるには言語の基本的な理解さえあれば十分ですが、JavaScriptについてさらに学びたい場合は、このCodecademyのコースが学習に役立ちます。

始めるには、まず「上級者向けガイド」をご覧ください。

どのように機能しますか？

ゲーム中に発生するイベントを監視するスクリプトを作成します。スクリプトは、ルールが守られていることを確認したり、オブジェクトやコマのプロパティを変更したり、カスタムチャットコマンドを提供したりすることもできます。あなたのスクリプトはゲーム全体に影響を与え、GMと全プレイヤーの行動の両方に作用します。高度なスクリプトは独立して実行することも可能で、パトロールルート上のトークン移動や、プレイヤーのターンが長引いた際の促しといった自動アクションを実行します。

既成のスクリプトはどこで見つけられますか？

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

GitHub上の公式Roll20 Mod（API）スクリプトリポジトリ。 ここには、リポジトリへの追加のために著者が提出したスクリプトの最新版が格納されています。
Roll20 Mod (API) スクリプトフォーラム。 ここでスクリプトが最初に公開される傾向があり、作成中または修正が必要なスクリプトについての議論が行われます。また、ここでコミュニティに助けを求め、考えたスクリプトの作成や、ニーズを満たすスクリプトの発見を依頼することもできます。
WikiのMod（API）スクリプトインデックス これは利用可能なスクリプトに関する有益な情報源です。

コミュニティへのモジュール（API）スクリプトの貢献

Roll20コミュニティの他のメンバーに提供したいスクリプトを作成した場合、Roll20 Mod (API) スクリプトリポジトリへの掲載を申請できます。 Roll20スタッフによるスクリプトの承認とリポジトリへの登録により、アカウントに「API Scripter」フォーラムタグが付与され、Patreonや類似サイトでの宣伝が可能になります（詳細は下記参照）。スクリプトをリポジトリに正しく提出するために必要な手順を確認するには、公式Roll20 Mod (API) スクリプトリポジトリにアクセスしてください。

コミュニティシート寄稿者向け Patreon と Tipeee 連携ルール

Roll20 Mod (API) Script Repo に貢献している Mod (API) スクリプト作成者は、Patreon および Tippee といった有料プラン/寄付サービスサイトを通じて広告を行うことが承認されています。 Roll20は、いかなる支払い取引についても責任を負わず、またいかなる私的取り決めも強制することはできません。

モッド（API）スクリプトの著者が資格を得るには、まず自身のスクリプト貢献がRoll20スタッフによって承認され、Roll20 Mod（API）スクリプトリポジトリに収録される必要があります。

GitHubにスクリプトを提出する際には、シート.jsonファイルにPatreonまたはTipeeeのアカウント情報を記載してください。

PatreonまたはTipeeeで広告を出稿したい場合は、jsonファイルに以下のいずれかのフィールドを追加する必要があります：

patreon: ここにPatreonキャンペーンのURLを入力すると、選択時にスクリプトの説明欄に表示されます。 (例: "https://www.patreon.com/<name>")

tipeee: ここにTipeeeのURLを配置すると、選択時にスクリプトの説明欄に表示されます。 (例: "https://www.tipeee.com/<name>")

詳細については、https://github.com/Roll20/roll20-api-scripts#contributing をご覧ください。

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

Roll20フォーラムにおけるPatreonまたはTipeeeへのリンクは、キャラクターシートまたはMod（API）スクリプトのいずれかを投稿した事前承認済みコミュニティメンバーのみが許可されます。資金提供を直接ユーザーに依頼する場合は、非公開で行うことは可能ですが、投稿内容のない公開フォーラムでのそのようなリンクの掲載は一切認められません。