Snapmatica

This mod supports only English and Japanese.
このmodは英語、日本語のみの対応です。

Snapmatica

"Transform your Minecraft screenshots into true photography."

Snapmatica is a premium photography and cinematic video recording mod that strictly replicates the authentic operation and immersive experience of a real-world camera inside Minecraft. Created as the sister mod to the acclaimed Photographica.

Since Snapmatica is a purely client-side mod (Client-only), you can freely bring it into your favorite multiplayer servers or modpacks without needing any server-side installations! It is also fully compatible with Photon Shader and Distant Horizons (DH).

Uncompromising Camera Simulation

Just like a real mirrorless or DSLR camera, you have granular control over essential exposure settings: Aperture (F-number), Shutter Speed, and ISO. Perfect your lighting, shadows, and blur to capture your world at its absolute best.

• Advanced Manual Mode: Fine-tune every single parameter to construct dramatic, intentional compositions.
• Beginner-Friendly Auto Exposure Mode: New to photography? No problem. Simply toggle on the Auto Exposure (such as "Av" mode) and "AF" (Auto Focus), and the mod will automatically optimize the brightness for a flawless snapshot instantly.
• Focus Peaking: A viewfinder overlay that highlights every edge sitting right at your focus distance, the same manual-focus aid a real mirrorless body draws — dial in critical focus by eye instead of guessing from the blur alone.

World Scale — From Real Cities to Tilt-Shift Miniatures

A Minecraft block has no real-world size of its own, so how much anything blurs depends entirely on how big you consider your build to be. Snapmatica lets you set that scale directly, from 1 cm a block — the same optics an actual diorama lens has, for a tilt-shift miniature look — up to a full metre a block, for a true-to-life city.

Freecam & Drone Mode

Fly the camera free of your character to compose a shot from anywhere — even with yourself in the frame, as a stable subject for a proper selfie. Two feels are available: direct, instant-response flight for precise placement, or Drone Mode, which trades that for inertia, an altitude hold, and a droppable orbit pin — aim at a subject or a building and fly a smooth, radius-locked orbit around it, hands-free. An optional toggle keeps your character out of frame entirely, for landscape or wildlife shots that have no business including you.

Camera Path — Cinematic Flythroughs

Record a handful of keyframes while flying the freecam and play them back as a smooth, spline-interpolated flythrough — snapmatica's own motion-control camera rig. Reposition and re-aim keyframes right with the mouse, watch the whole shot draw itself in the world as you build it, and play it back live or straight to video. An optional focus lock keeps one subject — a block or a moving creature — pin-sharp for the whole shot, however the camera swings around it.

---

Snapmatica

「マイクラのスクリーンショットを、本物の『写真』へ。」

Snapmaticaは、現実のカメラの操作感と撮影体験をマインクラフト内で厳密に再現した、最高峰のフォトグラフィ＆シネマティック録画MODです。拙作『Photographica』の姉妹作として誕生しました。

本MODは**クライアントサイドのみで動作する（Client-only）ため、お気に入りのマルチプレイサーバーやModパック環境にも、サーバー側を気にすることなくそのまま導入して撮影を楽しめます！さらに、PhotonシェーダーやDistant Horizons (DH)**にも対応しています。

妥協なきカメラシミュレーション

本物のミラーレス一眼やDSLRカメラさながらに、F値（絞り）、シャッタースピード、ISO値といった露出の要素を詳細にコントロール可能です。光と影、飾らないボケ味をチェンジして、あなたのワールドを最も美しい状態で切り取ることができます。

• 本格マニュアルモード：各数値を自分で追い込み、意図した通りのドラマティックな1枚を構築。
• 初心者向けオート露出モード：カメラに詳しくない方でも安心。「Av（絞り優先）」などのオート露出や「AF（オートフォーカス）」に設定するだけで、MODが自動で最適な明るさに調整し、一瞬で最高のスナップを撮影できます。
• フォーカスピーキング：ピント位置にある輪郭をファインダー上でハイライトする補助機能。実機のミラーレスと同じ感覚で、ボケ具合だけに頼らず目でピントを追い込めます。

ワールドスケール ── 実寸の街から極端なミニチュアまで

マインクラフトのブロックには本来「実寸」がないため、どれだけボケるかはワールドをどれくらいのスケールで捉えるか次第です。Snapmaticaでは1ブロック=1cm（実物のジオラマ用レンズと同じ光学特性で、極端なチルトシフト・ミニチュア風の絵が撮れます）から、1ブロック=1mの実寸スケールまで、このスケール自体を設定できます。

フリーカム & ドローンモード

プレイヤー本体から離れてカメラだけを自由に飛ばし、どんな場所からでも構図を組めます。自分自身を被写体にした本格的な自撮りにも使えます。操作感は2種類選択可能：即座に反応する直感的な飛行と、ドローンモード（慣性・高度ホールド・オービットピンが加わり、被写体や建物を指定してその周りを一定半径でスムーズに周回できるモード）。オプションでプレイヤー本体を画面から完全に消すこともでき、自分が映り込む必要のない風景・野生動物の撮影にも対応します。

カメラパス ── シネマティックなフライスルー撮影

フリーカムで飛びながらキーフレームを記録し、なめらかなスプライン補間のフライスルーとして再生できます——Snapmatica版モーションコントロールカメラリグです。キーフレームの位置・向きはマウス操作でその場で調整でき、組み立てている最中もパス全体がワールド上に描画されます。そのまま再生プレビューも、映像への書き出しも可能。フォーカス固定オプションを使えば、被写体がブロックでも動く生き物でも、カメラがどう動いてもピントを外しません。

---

Snapmatica - Controls & Usage Guide

English

Some of Snapmatica's controls can be customized via the standard in-game "Controls" menu. Below is the manual for default keybindings and primary operations.

Controls

Action	Input
Open Config Screen	G
Toggle Viewfinder Mode	,
Open Camera Mode (Viewfinder)	Shift
Take Photo (Shutter)	Enter
Adjust Focal Length (Zoom)	Shift+Mouse Wheel
Adjust Aperture (F-number)	Shift+Ctrl+Mouse Wheel (Depending on mode)
Adjust Shutter Speed	Shift+Alt+Mouse Wheel (Depending on mode)
Fine-tune Focus Distance	Shift+Ctrl+Alt+Mouse Wheel (Depending on mode)
Start Video Recording (Open Config) / Stop	R
Toggle Freecam	Config Screen button (no key by default)
Lock Freecam (freezes the camera, hands control back to your body)	C
Drop/Clear Orbit Pin (Drone Mode)	X
Freecam movement	WASD + Space/Shift, hold Ctrl to move faster
Open Camera Path Menu	Q

---

Usage & Instructions

1. Entering Camera Mode & Composing

1. Configure your preferences via the Snapmatica settings screen (press G). If you are unsure about the options, set the top two settings to "Av" and "AF" from the top. This is also where you set the world scale — how big a block is treated as, which controls how strong the blur gets.
2. Press the Shift key to switch into the dedicated viewfinder (EVF) overlay screen.
3. Move your mouse to aim at your subject, and scroll the mouse wheel up or down to adjust your zoom (focal length).

2. Auto Focus (AF) & Capturing

1. When AF is enabled, the camera automatically focuses on the object or entity at the center of the screen (near the crosshair), or any target with high screen occupancy.
2. Once focus is achieved, the background or foreground will blur in real-time (Depth of Field effect). By adjusting the F-number, you can fine-tune both the overall brightness and the intensity of the blur.
3. Once your shot is composed, press Enter to release the shutter and capture the photo.
4. Want to see focus itself rather than judge it from the blur? Turn on Focus Peaking in the settings screen — every high-contrast edge sitting within a hair of your focus distance lights up on the viewfinder, so you can nail critical focus by eye. It's a viewfinder aid only; it never appears in the saved photo or a recorded frame.

3. Instant Sharing via Clipboard

1. When a photo is captured, it is saved as a png file in the "snapmatica/photos" folder inside your game directory, and automatically copied to your clipboard at the exact same time. (Verified to work on Windows only)
2. After taking a shot, you can keep the game running, switch to external apps like Discord or X, and press >Ctrl + V< or right-click and paste to share your high-quality capture.

4. Video Recording (Beta)

1. Press R to bring up the video recording settings screen.
2. Configure your desired F-number and FPS value (24/30/60), then click the REC button to start recording.
3. A dedicated Recording HUD will be displayed on screen during the capture so you can monitor your current status.
4. Press the same key again to stop and save your recording.
5. The video goes through a brief encoding phase before being saved. You can track the encoding progress status at the top of your screen.
6. The finalized video file will be saved in "snapmatica/videos". Just like photos, it will also be automatically copied to your clipboard.

5. Freecam & Drone Mode

1. Open the settings screen (G) and press the Freecam button (it takes the place of Close — Esc already closes any screen) to fly the camera free of your body. Press it again from the same menu to return to normal control.
2. While flying, WASD/Space/Shift move the camera and the mouse looks around, exactly like the viewfinder — the hotbar, targeted-block outline and your held item all stay out of the shot automatically. Left/right click do nothing while freecam is active, and it hands control back to you the instant you take damage, so you're never caught helpless mid-shot.
3. Press C to lock the camera in place and hand WASD/mouse back to your body — useful for a tripod-style static shot where you still want to walk or look around normally without disturbing the framing. Press C again to pick the camera back up from wherever you left it.
4. Turn on Drone Mode in the settings screen for aerial footage: movement eases in and out instead of snapping to speed, and letting go of Space/Shift holds altitude instead of drifting.
5. With Drone Mode on (or off — the pin works either way), press X while aiming at a subject or a piece of terrain to drop an orbit pin. WASD/Space/Shift now orbit it (angle/radius/height) with the camera always facing it; press X again to release and fly on from where the orbit left off. Aiming at a living entity — including yourself — pins to it and follows it as it moves.
6. Optionally, toggle Hide Player in the settings screen to keep your own body out of frame entirely — useful for landscape or wildlife shots you're not meant to be standing in.

6. Camera Path (Cinematic Flythroughs)

1. While freecam is active, fly to your first camera position and press Q to open the Camera Path menu, then Add Keyframe — repeat as you fly to build up a route. Each keyframe remembers position, orientation and the current focal length, so a path can carry a zoom/dolly move too.
2. Fine-tune keyframes with the mouse: hold left-click on one to drag it along your view (scroll to push it away or pull it closer); hold left+right click together to "possess" that keyframe's own viewpoint and re-aim it exactly the way it'll actually look, scrolling to dolly-zoom its focal length while you do.
3. Middle-click a keyframe to delete it, middle-click the path itself to insert a new keyframe mid-route, or middle-click empty space to add one at your current position — no need to reopen the menu for any of it.
4. The whole path draws itself in the world as you build it: a curve through every keyframe with a small frustum marking each one's framing, numbered in order. Any stretch that would clip through a solid block turns orange as a warning.
5. Open the Camera Path menu (Q) to set the path's total playback duration and recording frame rate, then press Play to preview the flythrough live, or Play + Record to capture it straight to video.
6. Toggle Lock Focus During Playback in the same menu to keep one subject pin-sharp for the whole shot — whatever's centered in your reticle at the moment you turn it on (a block, or a living creature, which it keeps tracking as it moves) stays in focus however the camera swings around it during playback.

---

日本語 (Japanese)

Snapmaticaの一部操作は、ゲーム内の「設定」 > 「キー割り当て」から変更可能です。以下はデフォルトおよび主要な操作手順のマニュアルです。

基本操作方法 (Controls)

操作内容	入力方法
設定画面表示	G
ファインダー起動切り替え	,
カメラモード（ファインダー）の起動	Shift
シャッター（静止画撮影）	Enter
画角（ズーム）調整	Shift+マウスホイール
F値設定	Shift+Ctrl+マウスホイール（設定やモードによる）
シャッタースピード設定	Shift+Alt+マウスホイール（設定やモードによる）
フォーカス距離の微調整	Shift+Ctrl+Alt+マウスホイール（設定やモードによる）
ビデオ録画の開始(設定画面表示) / 停止	R
フリーカム切り替え	設定画面内のボタン（デフォルトのキー割り当てなし）
フリーカム固定（カメラを静止させ、プレイヤー本体の操作を返す）	C
オービットピン設置/解除（ドローンモード）	X
フリーカム移動	WASD + Space/Shift、Ctrl長押しで高速移動
カメラパスメニューを開く	Q

---

実際の操作手順と仕様

1. カメラモードの起動と構図調整

1. Snapmatica用設定画面（Gキー）から撮影の設定をします。(わからない人は下の二つを上から「Av」と「AF」にしてください。) ここではワールドスケール（1ブロックを何cm/mとして扱うか）も設定でき、ボケの強さに直結します。
2. Shiftキーを押すと、専用のファインダー（EVF）オーバーレイ画面へと切り替わります。
3. マウスを動かして被写体にカメラを向け、マウスホイールを前後に回転させることで、画角（ズーム）を調整できます。

2. オートフォーカス（AF）と撮影

1. AF設定をしている場合、画面中央（クロスヘア付近）にあるオブジェクトやエンティティ、もしくは画面占有率の高いオブジェクトに対して、自動的にピントが合います。
2. ピントが合うと、背景や手前がリアルタイムでボケます（被写界深度エフェクト）。F値を設定することで、全体の明るさやボケ感を調整できます。
3. 構図が決まったら、Enterを押すことでシャッターが切れ、静止画が撮影されます。
4. ボケ具合から間接的に判断するのではなく、ピント自体を目で確認したい場合は設定画面でフォーカスピーキングをON。ピント位置とほぼ同じ距離にある高コントラストの輪郭がファインダー上でハイライトされ、目で正確にピントを追い込めます。ファインダー限定の表示で、保存した写真や録画映像には一切焼き込まれません。

3. 撮影した画像の共有（クリップボード転送）

1. 静止画を撮影すると、起動構成ファイル内の「snapmatica/photos」フォルダにpngが保存されると同時に、自動的にクリップボードへ画像データがコピーされます。(Windowsでのみ動作確認)
2. 撮影後、ゲームを開いたままの状態でDiscordやXなどのアプリやブラウザを開き、>Ctrl + V< もしくは右クリックからペーストを押すことで、撮影した画像をペーストできます。

4. 録画機能(β)

1. Rを押すと、録画設定画面が開きます。
2. F値とFPS（24/30/60）を設定し、RECボタンを押すと撮影が開始します。
3. 録画中は専用の録画HUDが画面上に表示され、ステータスを確認できます。
4. 再び同じキーを押すことで、録画を停止・保存できます。
5. 動画は短時間のエンコードを挟んで保存されます。ステータスは画面上部に表示されます。
6. 出力動画は「snapmatica/videos」に保存されるほか、写真と同様クリップボードに自動コピーされます。

5. フリーカム & ドローンモード

1. 設定画面（G）を開き、フリーカムボタン（「閉じる」の代わりに配置 — 閉じるはEscで代用可能なため）を押すとカメラが本体から離れて自由に飛べるようになります。同じメニューからもう一度押すと通常操作に戻ります。
2. 飛行中はWASD/Space/Shiftでカメラ移動、マウスで視点操作ができ、ファインダー同様ホットバー・照準先のブロック枠・持ち手アイテムは自動的に映り込みません。左右クリックは無効化され、被弾した瞬間に自動で通常操作へ戻るので、丸腰のまま撮影に夢中になる心配はありません。
3. Cキーでカメラをその場に固定し、WASD/マウスの操作をプレイヤー本体に返せます。三脚に据えたような固定ショットのまま、構図を崩さずに普通に歩き回ったり視点を動かしたりしたいときに便利です。もう一度Cでカメラの操作を取り戻せます。
4. 空撮向けには設定画面でドローンモードをON。移動が加減速する慣性のある動きになり、Space/Shiftを離すと高度を保持します。
5. ドローンモードON/OFFどちらでも、被写体や地形に照準を合わせてXキーを押すとオービットピンを設置できます。WASD/Space/Shiftが角度・半径・高さのオービット操作に切り替わり、カメラは常にピンの方を向きます。もう一度Xでピン解除、その場から通常飛行に戻ります。生き物（自分自身も含む）に照準を合わせればそれに追従するピンになります。
6. 設定画面のHide PlayerをONにすると、プレイヤー本体を完全に画面外に隠せます。自分が映り込む必要のない風景・野生動物の撮影に便利です。

6. カメラパス（シネマティックなフライスルー撮影）

1. フリーカム中、最初のカメラ位置まで飛んだらQでカメラパスメニューを開き、キーフレーム追加を押します。飛びながら繰り返して経路を組み立てましょう。各キーフレームは位置・向きに加えてそのときの焦点距離も記憶するので、パスにズーム/ドリー動作を持たせることもできます。
2. キーフレームはマウスで微調整可能：左クリック長押しでドラッグして視線方向に位置調整（スクロールで距離の押し引き）。左+右クリック同時押しでそのキーフレーム自身の視点に「憑依」し、実際の見え方そのままに向きを再調整できます。このときスクロールで焦点距離のドリーズームも操作できます。
3. ミドルクリックでキーフレームを削除、パス上をミドルクリックで途中にキーフレームを挿入、何もない場所をミドルクリックで現在位置に追加——メニューを開き直さずその場で完結します。
4. パス全体は組み立てている最中からワールド上に描画されます：全キーフレームを通る曲線と、各キーフレームの画角を示す小さなフラスタム、そして順番を示す番号。壁を貫通してしまう区間は警告のオレンジ色で表示されます。
5. カメラパスメニュー（Q）で再生時間と録画FPSを設定し、再生でフライスルーをその場でプレビューするか、再生+録画でそのまま映像として書き出せます。
6. 同じメニューの再生中にフォーカスを固定をONにすると、ONにした瞬間にレティクル中央にある被写体（ブロック、または動く生き物ならその後も追従）にピントを固定でき、再生中カメラがどう動いてもその被写体からピントが外れません。