Repository navigation
Creating and Submitting Packs
This guide walks you through building your own Intro Pack (.zip or folder), testing it in-game, and submitting it to the Online Marketplace.
An Intro Pack is either a folder or a .zip archive inside .minecraft/intros/ containing an intro_pack.json file and your media assets:
my_intro_pack.zip (or folder)
├── intro_pack.json # Required: pack info & target FPS
├── thumbnail.png # Recommended: 16:9 card thumbnail (.png / .jpg)
├── audio.ogg # Optional: startup intro sound (Ogg Vorbis)
├── intro/ # Optional: startup intro frames (plays once on launch)
│ ├── frame_0001.jpg
│ ├── frame_0002.jpg
│ └── ...
├── loop/ # Optional: Title Screen loop frames (plays continuously)
│ ├── frame_0001.jpg
│ ├── frame_0002.jpg
│ └── ...
└── panorama/ # Optional: custom cubemap when Title Screen is set to Static
├── panorama_0.png
├── panorama_1.png
├── panorama_2.png
├── panorama_3.png
├── panorama_4.png
├── panorama_5.png
└── panorama_overlay.png
ZIP Wrapping Note: It's completely fine if your
.zipcontains one outer folder (e.g.my_intro_pack/intro_pack.json) — Reimagined Intro automatically locatesintro_pack.jsonand loads relative paths from there.
| File / Folder | Requirement | What it powers in Options | Format & Rules |
|---|---|---|---|
intro_pack.json |
Required | Pack card info & playback speed | Valid UTF-8 JSON (see Section 2). |
intro/ |
Optional | Startup Intro |
.jpg, .jpeg, or .png frames sorted alphabetically. Always zero-pad numbers (frame_0001.jpg, frame_0002.jpg...) so frame 10 doesn't play before frame 2! |
loop/ |
Optional | Title Screen: Animated | Same frame rules as intro/. Loops smoothly from last frame back to first. |
audio.ogg |
Optional | Intro Volume |
Must be .ogg (Ogg Vorbis) — .mp3 / .wav will not play. Also checked at intro/audio.ogg or intro/sound.ogg. |
thumbnail.png |
Recommended | Pack card preview in Intro Packs |
16:9 recommended (1280x720 or 1920x1080). Falls back to thumbnail.jpg or pack.png. |
panorama/ |
Optional | Title Screen: Static | Standard Minecraft cubemap faces panorama_0.png–panorama_5.png (all 6 must have matching dimensions) and/or panorama_overlay.png. |
-
Aspect ratio: Use
16:9(for example1920x1080or2560x1440). The mod scales to fill ultrawide and taller windows automatically with zero black bars. -
Image format: Use
.jpginstead of.pngforintro/andloop/frames — file sizes are drastically smaller and frames stream much faster. -
Size limit: Direct URL / Marketplace
.zipdownloads have a512 MBlimit. Using1080pJPEGs at25–30 FPSkeeps downloads fast while looking crisp!
Create a file named intro_pack.json in the root of your pack:
{
"id": "my_cool_intro",
"name": "My Cool Intro",
"author": "YourName",
"version": "1.0.0",
"description": "A short description shown when players hover over your pack.",
"fps": 30
}| Field | Type | Required | Description |
|---|---|---|---|
id |
String | Yes | Unique pack ID using lowercase letters, numbers, _, ., or - only (no spaces). |
name |
String | Yes | Display name shown on the pack card. |
author |
String | Yes | Creator name shown as by <Author> on the card. Defaults to "Unknown". |
version |
String | Recommended | Version string such as "1.0.0". |
description |
String | Recommended | 1–2 short sentences shown when hovering over the pack card. |
fps |
Integer | Important | Must be between 1 and 120 (defaults to 30). Match this to the exact FPS you exported your frames at, otherwise audio.ogg and video will drift out of sync! |
Note: Do not add
"official": trueto community packs — that badge is reserved for official packs in the marketplace.
You need FFmpeg installed to turn video files (.mp4, .mov, .mkv, .webm) into frame sequences and .ogg audio.
Put your intro.mp4 (and optional loop.mp4) inside a new folder, run the script below, and it will generate intro/, loop/, audio.ogg, thumbnail.png, intro_pack.json, and package everything into a ready-to-test .zip!
Windows (PowerShell) — make_pack.ps1
Save this as make_pack.ps1 in the same folder as your intro.mp4 (and optional loop.mp4), right-click Run with PowerShell (or run .\make_pack.ps1 in PowerShell):
# === Edit your pack info here ===
$PackId = "my_cool_intro"
$PackName = "My Cool Intro"
$Author = "YourName"
$Version = "1.0.0"
$Description = "Custom cinematic startup intro for Minecraft."
$Fps = 30
$Width = 1920
$Height = 1080
# ================================
$ErrorActionPreference = "Stop"
if (-not (Get-Command ffmpeg -ErrorAction SilentlyContinue)) {
throw "FFmpeg not found in PATH. Install it first (e.g. 'winget install Gyan.FFmpeg') and reopen PowerShell."
}
$OutDir = Join-Path $PSScriptRoot $PackId
if (Test-Path $OutDir) { Remove-Item $OutDir -Recurse -Force }
New-Item -ItemType Directory -Force -Path $OutDir | Out-Null
$IntroVid = Get-ChildItem $PSScriptRoot -File | Where-Object { $_.BaseName -eq "intro" -and $_.Extension -match '^\.(mp4|mov|mkv|webm|avi)$' } | Select-Object -First 1
if (-not $IntroVid) { throw "Put intro.mp4 (or .mov/.mkv/.webm) in this folder first!" }
Write-Host "[1/4] Extracting intro frames ($($Width)x$($Height) @ $Fps FPS)..." -ForegroundColor Cyan
$IntroDir = Join-Path $OutDir "intro"
New-Item -ItemType Directory -Force -Path $IntroDir | Out-Null
& ffmpeg -v warning -stats -i $IntroVid.FullName -vf "scale=${Width}:${Height}:force_original_aspect_ratio=increase,crop=${Width}:${Height}" -pix_fmt yuvj420p -r $Fps -q:v 2 (Join-Path $IntroDir "frame_%04d.jpg") -y
$LoopVid = Get-ChildItem $PSScriptRoot -File | Where-Object { $_.BaseName -eq "loop" -and $_.Extension -match '^\.(mp4|mov|mkv|webm|avi)$' } | Select-Object -First 1
if ($LoopVid) {
Write-Host "[2/4] Extracting loop frames ($($Width)x$($Height) @ $Fps FPS)..." -ForegroundColor Cyan
$LoopDir = Join-Path $OutDir "loop"
New-Item -ItemType Directory -Force -Path $LoopDir | Out-Null
& ffmpeg -v warning -stats -i $LoopVid.FullName -vf "scale=${Width}:${Height}:force_original_aspect_ratio=increase,crop=${Width}:${Height}" -pix_fmt yuvj420p -r $Fps -q:v 2 (Join-Path $LoopDir "frame_%04d.jpg") -y
} else {
Write-Host "[2/4] No loop video found (skipping loop)." -ForegroundColor DarkGray
}
Write-Host "[3/4] Converting audio (if present) & generating thumbnail..." -ForegroundColor Cyan
$AudioOut = Join-Path $OutDir "audio.ogg"
$CustomAudio = Get-ChildItem $PSScriptRoot -File | Where-Object { $_.BaseName -eq "audio" -and $_.Extension -match '^\.(ogg|mp3|wav|flac|m4a|aac)$' } | Select-Object -First 1
if ($CustomAudio) {
if ($CustomAudio.Extension -eq ".ogg") {
Copy-Item $CustomAudio.FullName $AudioOut -Force
} else {
& ffmpeg -v warning -i $CustomAudio.FullName -vn -c:a libvorbis -b:a 160k -ar 48000 $AudioOut -y
}
} elseif (Get-Command ffprobe -ErrorAction SilentlyContinue) {
$hasAudio = (& ffprobe -v error -select_streams a -show_entries stream=index -of csv=p=0 $IntroVid.FullName)
if ($hasAudio) {
& ffmpeg -v warning -i $IntroVid.FullName -vn -c:a libvorbis -b:a 160k -ar 48000 $AudioOut -y
}
}
$Frames = Get-ChildItem $IntroDir -Filter "frame_*.jpg" | Sort-Object Name
if ($Frames.Count -gt 0) {
$MidFrame = $Frames[[math]::Floor($Frames.Count / 2)].FullName
& ffmpeg -v warning -i $MidFrame -vf "scale=1280:720:force_original_aspect_ratio=increase,crop=1280:720" -frames:v 1 (Join-Path $OutDir "thumbnail.png") -y
}
Write-Host "[4/4] Writing intro_pack.json & creating ZIP..." -ForegroundColor Cyan
$Manifest = [ordered]@{
id = $PackId
name = $PackName
author = $Author
version = $Version
description = $Description
fps = $Fps
} | ConvertTo-Json -Depth 2
[System.IO.File]::WriteAllText((Join-Path $OutDir "intro_pack.json"), $Manifest + "`n", [System.Text.UTF8Encoding]::new($false))
$ZipOut = Join-Path $PSScriptRoot "$PackId.zip"
Compress-Archive -Path (Join-Path $OutDir "*") -DestinationPath $ZipOut -Force
Write-Host "Done! Created $ZipOut" -ForegroundColor GreenmacOS / Linux (Bash) — make_pack.sh
Save this as make_pack.sh in the same folder as your intro.mp4 (and optional loop.mp4), then run chmod +x make_pack.sh && ./make_pack.sh:
#!/usr/bin/env bash
set -euo pipefail
# === Edit your pack info here ===
PACK_ID="my_cool_intro"
PACK_NAME="My Cool Intro"
AUTHOR="YourName"
VERSION="1.0.0"
DESCRIPTION="Custom cinematic startup intro for Minecraft."
FPS=30
WIDTH=1920
HEIGHT=1080
# ================================
command -v ffmpeg >/dev/null 2>&1 || { echo "FFmpeg not found. Install it first (e.g. brew install ffmpeg / apt install ffmpeg)."; exit 1; }
find_media() {
for ext in mp4 mov mkv webm avi; do
if [[ -f "$1.$ext" ]]; then echo "$1.$ext"; return 0; fi
done
return 1
}
find_audio() {
for ext in ogg mp3 wav flac m4a aac; do
if [[ -f "audio.$ext" ]]; then echo "audio.$ext"; return 0; fi
done
return 0
}
INTRO_VID="$(find_media intro || true)"
[[ -n "$INTRO_VID" ]] || { echo "Put intro.mp4 (or .mov/.mkv/.webm) in this folder first!"; exit 1; }
OUT_DIR="./$PACK_ID"
rm -rf "$OUT_DIR"
mkdir -p "$OUT_DIR/intro"
echo "[1/4] Extracting intro frames (${WIDTH}x${HEIGHT} @ ${FPS} FPS)..."
ffmpeg -v warning -stats -i "$INTRO_VID" \
-vf "scale=${WIDTH}:${HEIGHT}:force_original_aspect_ratio=increase,crop=${WIDTH}:${HEIGHT}" \
-pix_fmt yuvj420p -r "$FPS" -q:v 2 "$OUT_DIR/intro/frame_%04d.jpg" -y
if LOOP_VID="$(find_media loop || true)" && [[ -n "$LOOP_VID" ]]; then
echo "[2/4] Extracting loop frames (${WIDTH}x${HEIGHT} @ ${FPS} FPS)..."
mkdir -p "$OUT_DIR/loop"
ffmpeg -v warning -stats -i "$LOOP_VID" \
-vf "scale=${WIDTH}:${HEIGHT}:force_original_aspect_ratio=increase,crop=${WIDTH}:${HEIGHT}" \
-pix_fmt yuvj420p -r "$FPS" -q:v 2 "$OUT_DIR/loop/frame_%04d.jpg" -y
else
echo "[2/4] No loop video found (skipping loop)."
fi
echo "[3/4] Converting audio (if present) & generating thumbnail..."
AUDIO_SRC="$(find_audio)"
if [[ "$AUDIO_SRC" == *.ogg ]]; then
cp "$AUDIO_SRC" "$OUT_DIR/audio.ogg"
elif [[ -n "$AUDIO_SRC" ]]; then
ffmpeg -v warning -i "$AUDIO_SRC" -vn -c:a libvorbis -b:a 160k -ar 48000 "$OUT_DIR/audio.ogg" -y
elif command -v ffprobe >/dev/null 2>&1 && [[ -n "$(ffprobe -v error -select_streams a -show_entries stream=index -of csv=p=0 "$INTRO_VID" || true)" ]]; then
ffmpeg -v warning -i "$INTRO_VID" -vn -c:a libvorbis -b:a 160k -ar 48000 "$OUT_DIR/audio.ogg" -y
fi
FRAME_COUNT=$(find "$OUT_DIR/intro" -maxdepth 1 -name 'frame_*.jpg' | wc -l | tr -d ' ')
if (( FRAME_COUNT > 0 )); then
MID_IDX=$(( FRAME_COUNT / 2 + 1 ))
MID_FRAME=$(printf "$OUT_DIR/intro/frame_%04d.jpg" "$MID_IDX")
if [[ -f "$MID_FRAME" ]]; then
ffmpeg -v warning -i "$MID_FRAME" -vf "scale=1280:720:force_original_aspect_ratio=increase,crop=1280:720" -frames:v 1 "$OUT_DIR/thumbnail.png" -y
fi
fi
echo "[4/4] Writing intro_pack.json & creating ZIP..."
cat > "$OUT_DIR/intro_pack.json" <<EOF
{
"id": "$PACK_ID",
"name": "$PACK_NAME",
"author": "$AUTHOR",
"version": "$VERSION",
"description": "$DESCRIPTION",
"fps": $FPS
}
EOF
(cd "$OUT_DIR" && zip -qr "../${PACK_ID}.zip" .)
echo "Done! Created ./${PACK_ID}.zip"If you prefer running commands yourself one at a time:
# 1. Extract 1080p frames at 30 FPS (swap intro.mp4 -> loop.mp4 for loop/)
ffmpeg -i intro.mp4 -vf "scale=1920:1080:force_original_aspect_ratio=increase,crop=1920:1080" -pix_fmt yuvj420p -r 30 -q:v 2 intro/frame_%04d.jpg
# 2. Extract audio as 48 kHz Ogg Vorbis
ffmpeg -i intro.mp4 -vn -c:a libvorbis -b:a 160k -ar 48000 audio.ogg
# 3. Export a 16:9 thumbnail from timestamp 00:00:02
ffmpeg -ss 00:00:02 -i intro.mp4 -vf "scale=1280:720:force_original_aspect_ratio=increase,crop=1280:720" -frames:v 1 thumbnail.pngPro Tip: Check the last few frames of
intro/and delete any solid-black frames at the end so the transition from your intro into the Title Screen feels seamless!
- Launch Minecraft and open Intro Packs (
F8or Options > Reimagined Intro...). - On the Installed tab, click Open Folder to open
.minecraft/intros/. - Put your pack folder or
.zipinside.minecraft/intros/. - Back in Minecraft, click the Refresh button (
🗘). - Check your card thumbnail & hover tooltip, click Preview to test the intro & audio sync, and check the Title Screen to verify your
loop/(orpanorama/) works cleanly.
-
Frames play in the wrong order: Make sure filenames are zero-padded (
frame_0001.jpg,frame_0002.jpg... notframe_1.jpg). -
Audio goes out of sync: Check that
"fps"inintro_pack.jsonmatches the-r <fps>rate you used when exporting frames. -
No sound plays: Confirm the file is Ogg Vorbis (
.ogg), not a renamed.mp3or.wav.
Once your .zip works cleanly in Reimagined Intro 4.0.0+:
-
Upload your
.zipto Google Drive, Dropbox, MediaFire, or a GitHub Release.- If using Google Drive, set sharing access to "Anyone with the link".
- Avoid Discord upload links since they expire.
- Open the Submission Form: Go to the Intro Pack Submission Form on GitHub.
-
Fill it out:
- Replace
<Your Pack Name>in the issue title with your pack's name. - Paste your
.zipdownload link. - Optionally drop a preview clip/screenshot or credit any source trailers/music in Preview & Notes.
- Tick the checklist boxes and submit!
- Replace
You do not need to edit registry.json yourself — once your pack is reviewed and tested, it will be added directly to the in-game Online Marketplace!