Skip to content

Creating and Submitting Packs

Lê Hoàng Triều edited this page Nov 16, 2026 · 2 revisions

Creating & Submitting Custom Intro 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.

1. Folder Structure

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 .zip contains one outer folder (e.g. my_intro_pack/intro_pack.json) — Reimagined Intro automatically locates intro_pack.json and loads relative paths from there.

What Each Part Controls In-Game

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.

Best Practices for Smooth Playback

  • Aspect ratio: Use 16:9 (for example 1920x1080 or 2560x1440). The mod scales to fill ultrawide and taller windows automatically with zero black bars.
  • Image format: Use .jpg instead of .png for intro/ and loop/ frames — file sizes are drastically smaller and frames stream much faster.
  • Size limit: Direct URL / Marketplace .zip downloads have a 512 MB limit. Using 1080p JPEGs at 25–30 FPS keeps downloads fast while looking crisp!

2. Writing intro_pack.json

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 Reference

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": true to community packs — that badge is reserved for official packs in the marketplace.

3. FFmpeg Commands & Auto-Build Scripts

You need FFmpeg installed to turn video files (.mp4, .mov, .mkv, .webm) into frame sequences and .ogg audio.

Option A: Copy-Paste Auto-Build Script (Recommended)

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 Green
macOS / 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"

Option B: Manual Commands

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.png

Pro 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!

4. Testing Your Pack Locally

  1. Launch Minecraft and open Intro Packs (F8 or Options > Reimagined Intro...).
  2. On the Installed tab, click Open Folder to open .minecraft/intros/.
  3. Put your pack folder or .zip inside .minecraft/intros/.
  4. Back in Minecraft, click the Refresh button (🗘).
  5. Check your card thumbnail & hover tooltip, click Preview to test the intro & audio sync, and check the Title Screen to verify your loop/ (or panorama/) works cleanly.

Quick Troubleshooting

  • Frames play in the wrong order: Make sure filenames are zero-padded (frame_0001.jpg, frame_0002.jpg... not frame_1.jpg).
  • Audio goes out of sync: Check that "fps" in intro_pack.json matches the -r <fps> rate you used when exporting frames.
  • No sound plays: Confirm the file is Ogg Vorbis (.ogg), not a renamed .mp3 or .wav.

5. Submitting to the Online Marketplace

Once your .zip works cleanly in Reimagined Intro 4.0.0+:

  1. Upload your .zip to 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.
  2. Open the Submission Form: Go to the Intro Pack Submission Form on GitHub.
  3. Fill it out:
    • Replace <Your Pack Name> in the issue title with your pack's name.
    • Paste your .zip download link.
    • Optionally drop a preview clip/screenshot or credit any source trailers/music in Preview & Notes.
    • Tick the checklist boxes and submit!

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!