2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【Minecraft】第1回リソースパック(バニラ)シェーダー入門:JSON・VSH・FSHの役割とデータの流れ(全体像)

2
Last updated at Posted at 2026-09-21

26.3時点での注意

Minecraftのシェーダー機能は現在も変更される可能性があります。
26.3ではShaderCによるシェーダーコンパイルや#includeの仕様などにも変更が入っているため、
古いバージョン向けの記事やサンプルコードとは記述が異なる場合があります。

この記事はMinecraft Java Edition版 26.3向けの記事です。
また、リソースパック制作の際の最低限の知識が前提となります。
(pack_formatの書き方や、ファイル、フォルダ作成など)

はじめに

バージョン表記も年数表示に変わり、アップデートが目まぐるしくされているマイクラ。
近年のMinecraftではグラフィック周りの変更が進んでおり、26.3ではシェーダーのコンパイル処理にも大きな変更が入りました。OpenGL環境でもVulkanと同じくShaderCによってシェーダーがコンパイルされるようになり、シェーダーの記述方法にも一部変更が加えられています。

さらに、26.3のアップデートから新たに posteffectコマンド が追加され、リソースパック内のポストエフェクトシェーダーをコマンドから直接制御・適用できるようになりました。これにより、配布マップや演出表現においてリソースパックに定義したポストエフェクトコマンドから利用できるようになり、画面全体を使った演出をより柔軟に作れるようになりました。

外部の影mod(Optifineやiris)を使わなくても、 リソースパックだけでポストエフェクトなどの画面効果を自作・制御できる のが、リソースパックシェーダー最大の面白さです。

今回は、そんなリソースパックシェーダーを自作・改変していくための第一歩として、必ず触ることになる3つのファイル(JSON/VSH/FSH)の役割と、それがどう連動して動いているのか(全体の構造)について解説します!

※ちなみにこの記事を書いている私は、ほかのプログラミング言語を触ったことがないマイクラのコマンドしかわからない初心者です。

検証・前提環境

  • 対象: Minecraft Java Edition
  • 動作確認: 26.3

1. シェーダーを構成する3つのファイルと配置場所

リソースパックシェーダーには、coreシェーダー/postシェーダー の2つがあります。
今回追加されたコマンドはpostシェーダーを扱うものなのでcoreシェーダーに関しては、今回は詳しく解説をしません。

postシェーダーを自作・改変する際、主に.json .vsh .fshの3つ扱います。
以下にディレクトリのファイル配置を記述しています。

  • assets/名前空間/post_effect/
    ポストエフェクト全体の定義ファイル(.json)を置く場所。posteffectコマンド等で呼び出す起点となる。
  • assets/名前空間/shaders/core/
    バニラの描画(UI、ブロック、エンティティなど)を書き換えるシェーダー(.vsh .fsh)を置く場所。
  • assets/名前空間/shaders/post/
    画面全体に対するポストエフェクト処理用のシェーダープログラム(.vsh .fsh)を置く場所。

ポストエフェクトでは、JSONが使用するシェーダーや入力・出力などを定義し、VSHとFSHが実際の描画処理を担当します。

ただし、 VSHとFSHを必ず自作する必要はありません。 既存のVSHを利用してFSHだけを自作する、といった構成も可能です。

そして、今後手を加えるのは

  • assets/名前空間/post_effect/
  • assets/名前空間/shaders/post/

の二つです。

ファイル種別 主な役割 内容のイメージ
JSON (.json) 指示書・司令塔 使用するVSH/FSHの指定、シェーダーへの入力・出力やUniformなどの設定
VSH(.vsh) 位置・形状の計算 頂点座標やUV座標を計算し、FSHへ渡すデータを作る
FSH(.fsh) ピクセルの色塗り 最終的に各ピクセルを何色にするか(色味の変更、ブラー、テクスチャ合成など)の処理

補足:.glslファイルについて
shaders/include/には.glslファイルが置かれていることがあります。これらは複数のシェーダーから共通して利用する処理をまとめたファイルです。26.3ではShaderCによる#includeが使用されます。
例えば、共通処理を別の.glslファイルにまとめ、シェーダー側から#includeして利用できます。
本記事で扱うポストエフェクト作成では、基本的にJSON/VSH/FSHの3つを編集するため、「共通の便利ツール集のようなものがあるんだな」くらいの認識で大丈夫です。


そもそもcoreシェーダーとpostシェーダーってどう違うの?

マイクラの画面が作られるとき、この2つは 「役割(描くタイミング)」 が全く異なります。
wikiでは画像ありでcoreシェーダー/postシェーダーについて説明しています。

  • core シェーダー(ゲーム内の各種描画処理に使用されるシェーダー)
    • イメージ : ゲーム画面に映る「1つ1つのオブジェクト」を描き出す処理
    • 使われている場所: ブロック、Mob、アイテム、空、UIなど、ゲーム内のさまざまな描画処理
    • 例: 「特定アイテムを光らせる」「UIの背景色を変える」「草ブロックを揺らす」

なお、26.3現在、リソースパックによるCoreシェーダーの上書きは「可能ではあるものの、公式にはサポート対象外」とされています。CoreシェーダーはMinecraft内部の実装の一部であり、今後のアップデートで変更される可能性があります。

  • post シェーダー(出来上がった画面全体の仕上げ)
    • イメージ: 通常の描画が終わった後の画面全体に対して処理を行う「カメラのレンズフィルター」
    • 使われている場所: 画面全体に対するポストエフェクト処理
    • 例: 水中に潜ったときのボカシ、クリーパー視点の緑画面、クモ視点の画面分割など

2. 3つのファイルはどう連携しているか

これらのファイルはそれぞれ独立して処理を行うのではなく、JSONで描画に必要な設定を定義し、その設定に基づいてVSHとFSHが組み合わされて実行されます。Minecraftから渡されるUniformやテクスチャなどのデータも、シェーダー内で利用できます。

まだ、完全に理解する必要はないです。次からの記事で詳しく説明していきますので、今はなんとなくで問題ないです。

3. まとめ & 次回予告

シェーダー自作で迷ったら、まずこの基本の役割分担を思い出してみてください。

  • JSON = どのシェーダーを使い、どのデータを入出力するかを決める「指示書」
  • VSH = どこに描くかを決める「位置計算」
  • FSH = 何色にするかを決める「色計算」

この「データの流れ」さえ頭に入っていれば、これからコードを書いていく中で「今自分はどのファイルのどこを触っているのか」で迷うことがなくなると思います。

次回(第2回)は、すべてのスタート地点となる 「JSONファイルの書き方とシェーダーへのデータの受け渡し(Uniform)」 について、実際のコードを見ながら詳しく解説していきます。

2
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?