【マイクラ】Skriptの導入方法と使い方！初めてのスクリプト作成

• Javaでプラグインを自作するほどの技術力はないけれど、独自コマンドや簡単な自動化を足したい
• プログラミング未経験で、Skript独特の構文が本当に書けるか不安
• 導入しても正しく読み込まれたか、構文エラーやリロード失敗をどう見分ければいいかわからない

Javaでのプラグイン開発は学習コストが高く、簡単な機能を1つ足したいだけでも及び腰になりがちです。

Skriptなら、プログラミング未経験でもカスタムコマンドやイベント処理を作れます。

ただしPaper専用のプラグインで、Spigotでは動作しません。

この記事では、Skriptの導入からカスタムコマンド、on joinイベント、権限設定、動かないときの確認方法までを順番に説明します。

読み終えたときのゴールは、最初のカスタムコマンドが実際に動く状態です。

spaこの記事を書いた人

サーバーの構築と運用を繰り返して4年。その経験をもとに記事100本以上を執筆。

プロフィール詳細 →お仕事の相談 →

Skriptとは？できることとJavaプラグインとの違い

Skriptは、コマンドやイベントの処理をテキストファイルに書いて動かすプラグインです。

Javaでのプラグイン開発とは異なる仕組みで、初めてスクリプトを書く人でも扱いやすい設計になっています。

まず全体像を押さえてから、次の章で実際の導入に進みます。

• Skriptで実現できること
• Javaプラグインとの違いと向いている人
• Paper専用でSpigotでは動かない制約

この3点を押さえておくと、導入後の動作確認もスムーズです。

Skriptで実現できること

Skriptを使うと、自分だけのコマンドを定義したり、プレイヤーの参加などのタイミングに合わせて処理を自動化したりできます。

たとえば参加時のあいさつメッセージや、簡単なショップコマンドの入り口、特定の場所に触れたときのメッセージ表示など、Javaプラグインを探すほどではない小さな機能が対象です。

Javaのようにコードをコンパイルする必要はなく、.skファイルに書いた内容をリロードするだけで反映されます。

Javaプラグインとの違いと向いている人

Javaプラグインは、開発環境を用意してコードを書き、コンパイルしてjarファイルを作る手順が必要です。

Skriptは.skファイルをテキストエディタで編集し、/sk reloadで変更を反映するだけで動かせます。

プログラミング未経験で、独自コマンドや簡単な自動化だけを足したい人に向いています。

アドオンを追加しなくても、この記事で紹介するコマンドとイベントはSkript本体だけで動きます。

アドオンを使いたくなった場合は、そのアドオンが対応しているSkriptとPaperのバージョンを、導入前に配布ページで確認してください。

Paper専用でSpigotでは動かない制約

Skript公式は、Paperでの動作を前提としており、Spigotでは動作しないと明記しています。

Spigotサーバーを使っている場合、Skriptを動かすにはPaperへの切り替えが必要です。

導入手順：Skriptをpluginsフォルダへ配置する

ここでは、Skriptのダウンロードから導入確認までを順番に進めます。

• Skriptのjarをダウンロードする
• pluginsフォルダに配置してサーバーを再起動する
• プラグイン一覧で導入を確認する

手順は3つだけなので、順番に進めれば迷いません。

Skriptを使うには、あらかじめPaperサーバーが起動している状態が必要です。

まだPaperサーバーを用意していない場合は、先にこちらでサーバーを立ち上げます。

✓ あわせて読みたい

マイクラプラグインサーバーの立て方！Paperで導入する手順を初心者向けに解説

Skriptのjarをダウンロードする

次のリンクからSkriptのjarをダウンロードします。

別のバージョンを使いたい場合は、GitHub Releasesページの一覧から選び直しましょう。

pluginsフォルダに配置してサーバーを再起動する

ダウンロードしたjarファイルを、サーバーのpluginsフォルダの直下に置きます。

サブフォルダに入れると読み込まれないため、直下に置くルールを守ってください。

配置したら、サーバーを再起動します。

プラグイン一覧で導入を確認する

サーバー起動後、コンソールまたはゲーム内で/pluginsを実行すると、読み込まれたプラグインの一覧が表示されます。

/plugins

一覧の中のSkriptが緑色で表示されていれば、導入は成功です。

赤色で表示された場合や一覧に出てこない場合は、後半のよくあるトラブルで原因を確認します。

初期設定：scriptsフォルダに.skファイルを作ってリロードする

Skriptの導入が確認できたら、実際にスクリプトを書く準備です。

• plugins/Skript/scriptsフォルダに.skファイルを作る
• スクリプトをリロードして反映する

この2つができれば、あとは中身を書き換えるだけで自由にスクリプトを増やせます。

plugins/Skript/scriptsフォルダに.skファイルを作る

Skriptを一度起動すると、plugins/Skriptフォルダが自動的に作られる仕組みです。

その中のscriptsフォルダに、拡張子.skのテキストファイルを作成します。

ファイル名は自由に決められますが、半角英数字にしておくと、あとの操作で迷いません。

スクリプトをリロードして反映する

スクリプトを保存したら、ゲーム内またはコンソールで/sk reloadを実行して反映します。

/sk reload <ファイル名>

<ファイル名>の部分は、拡張子を除いた実際のファイル名への置き換えが必要です。

greet.skならgreetです。

サーバー全体を再起動しなくても、この/sk reloadだけでスクリプトの変更を反映できます。

エラーが出なければ反映は成功です。

実際の使い方：カスタムコマンドとon joinイベントを作る

ここからは、実際にコマンドとイベントを作る番です。

• カスタムコマンドを作る
• on joinイベントで参加時の処理を作る
• 変数を使うときの注意点

どちらも数行のスクリプトで動かせるので、まずは動く状態を体験してみます。

カスタムコマンドを作る

カスタムコマンドは、command /コマンド名 <引数の型>:という形で定義します。

trigger:の下に書いた処理が、コマンドを実行したときに動く仕組みです。

command /greet <text>:
    trigger:
        send "%player%が%arg-1%と挨拶しました" to all players

1行目でコマンド名と引数の型を定義し、trigger:以下のsendで実行結果をチャットに表示しています。

%player%は実行したプレイヤー、%arg-1%は1つ目の引数を表します。

ゲーム内で/greetを実行してみましょう。

メッセージが表示されれば動作の証拠です。

on joinイベントで参加時の処理を作る

on join:は、プレイヤーがサーバーに参加した瞬間に処理を実行するイベントです。

on join:
    broadcast "%player%がサーバーに参加しました"

イベントの場合はtrigger:を書かず、on join:の下に直接処理を書きます。

コマンドとイベントの書き方の違いに注意が必要です。

保存してリロードしたあと、一度サーバーに再接続すると、参加メッセージが表示されるか確認できます。

変数を使うときの注意点

変数名の先頭に半角アンダースコアを付けると、{_name}のようなローカル変数になります。

ローカル変数は、そのコマンドやイベントの処理の中だけで使う値です。

アンダースコアを付けない{name}のような変数名は、グローバル変数として扱われます。

グローバル変数は既定の設定のまま使うとplugins/Skript/variables.csvに保存され、サーバーを再起動しても値が残る仕組みです。

複数人のスコアやランキングなど、サーバーをまたいで覚えておきたい値はグローバル変数、コマンド1回限りの一時的な値はローカル変数、と使い分けます。

権限設定：友達に安全にコマンドを使わせる

コマンドを誰でも使える状態のままにすると、荒らしや誤操作のリスクが上がります。

コマンド定義にpermission:の行を追加すれば、そのコマンドを使えるプレイヤーを制限可能です。

permission message:の行を加えると、権限を持たないプレイヤーがコマンドを実行したときのメッセージも変更できます。

command /vipmsg <text>:
    permission: skript.vip
    permission message: この機能を使う権限がありません
    trigger:
        send "%arg-1%" to all players

permissionの値は自分で決める権限名です。

skript.<コマンド名>のように、コマンドごとに分かる名前にしておくと、あとで権限管理プラグイン側から見返したときに迷いません。

権限管理プラグインやOP限定の運用と組み合わせて、友達に渡す権限を割り当てます。

OPには通常このpermissionの制限が及ばないため、設定後はOP以外のプレイヤーでコマンドを試し、設定したメッセージが表示されるか確認してください。

よくあるトラブル：構文エラー・未反映・権限ミスの確認方法

導入や設定でうまくいかないときは、症状ごとに見る場所が決まっています。

構文エラーで/sk reloadに失敗したときは、追加した行を一度削除して保存し、もう一度/sk reloadを実行すると、どの変更が原因かを切り分けられます。

permissionを設定したのにコマンドが使えない場合は、/sk reloadをやり忘れていないかも合わせて確認してください。

プラグイン全般の赤色表示や読み込み失敗の原因は、こちらの確認手順でさらに詳しく解説しています。

よくある質問

まとめ：Skriptで最初のカスタムコマンドを動かす

Skriptは、Javaを書かなくてもコマンドやイベントを自動化できるPaper専用のプラグインです。

この記事で押さえたポイントをまとめます。

• Skriptのjarをpluginsフォルダへ配置し、/pluginsで緑色表示を確認する
• .skファイルはplugins/Skript/scriptsフォルダに置き、/sk reloadで反映する
• カスタムコマンドとon joinイベントは、どちらも数行のスクリプトで動かせる
• permissionとpermission messageで、コマンドを使える人を絞り込める
• 動かないときは、症状別の確認先を上から順にたどる

次にやることは、まず1つのカスタムコマンドを実際に動かして、/pluginsとコマンド実行の両方で成功を確認することです。

権限を設定できたら、友達を招待してコマンドを試してもらいます。

機能が増えて物足りなくなったら、鯖主に人気のプラグインから目的に合うものを探すのも一つの方法です。