# Minecraft Vanilla Video Player<\/p>\n
[English](README\/README_en.md) [\u7b80\u4f53\u4e2d\u6587](README.md)<\/p>\n
> by WindWaves_Sea
\n>
\n> This article is also published on the author’s Blog, Bilibili Column, the project’s GitHub repository, and Modrinth.<\/p>\n
—<\/p>\n
## Introduction<\/p>\n
This project is based on a datapack and provides pseudo-video playback in vanilla Minecraft by displaying image sequences.<\/p>\n
Main purposes of this datapack:<\/p>\n
– Automatically calculate frame rates and batch process frame files.
\n– Provide adaptive frame rate to improve performance.
\n– Provide interfaces for quick configuration.
\n– Play image sequences stored in resource packs.<\/p>\n
It also provides several **variables** for quickly adding image-sequence videos through resource packs.<\/p>\n
—<\/p>\n
### Warning<\/p>\n
This **datapack** uses the head equipment slot by default to trigger the camera overlay.
\nIf you do not want to use the head slot, you can modify it inside the datapack manually (currently required in V2.0).<\/p>\n
The resource pack includes a transparent model used as the equipped overlay item, creating a pseudo “no item equipped” playback effect.<\/p>\n
> **Image Sequence** means saving every frame of a video or animation as an independent static image file, arranged in order by frame number. It is widely used in post-production, 3D animation, visual effects, and other fields due to high compatibility and lossless quality.<\/p>\n
—<\/p>\n
## Download<\/p>\n
You can download this package from:<\/p>\n
– Modrinth
\n– GitHub<\/p>\n
—<\/p>\n
## Video Requirements<\/p>\n
Videos must be converted into **PNG image sequences**.<\/p>\n
—<\/p>\n
### Play 60 FPS Video with Increased Tick Rate<\/p>\n
20 FPS videos are recommended.<\/p>\n
If using a 60 FPS video, set the tick rate to 60:<\/p>\n
“`mcfunction
\n\/tick rate 60
\n““<\/p>\n
This sets the target game tick speed.<\/p>\n
—<\/p>\n
### Play 60 FPS Video with Frame Interpolation<\/p>\n
Set the original frame rate in the config:<\/p>\n
“`txt
\nframe_rate:60
\n“`<\/p>\n
—<\/p>\n
## Dialog Menu<\/p>\n
You can open the menu by pressing **G** or through command:<\/p>\n
“`mcfunction
\n\/dialog show @s animations:open_menu
\n“`<\/p>\n
Players need to choose the video resolution.<\/p>\n
* 1920\u00d71080 = 16:9
\n* 2560\u00d71080 = 16:10<\/p>\n
If you want to use the playback page, please select a language first in settings.<\/p>\n
—<\/p>\n
## Parameter Explanation<\/p>\n
### frame_zero<\/p>\n
Number of leading zeros before the frame number.<\/p>\n
Example:<\/p>\n
`video0000.png`<\/p>\n
Then:<\/p>\n
“`json
\n{frame_zero:”000″}
\n“`<\/p>\n
—<\/p>\n
### frame<\/p>\n
Current frame number.<\/p>\n
“`json
\n{frame:1}
\n“`<\/p>\n
—<\/p>\n
### path<\/p>\n
Output file path.<\/p>\n
“`json
\n{path:”animation:school\/”}
\n“`<\/p>\n
—<\/p>\n
### name<\/p>\n
Video prefix name.<\/p>\n
Example:<\/p>\n
`video0000.png`<\/p>\n
Then:<\/p>\n
“`json
\n{name:”video”}
\n“`<\/p>\n
Shorter names are recommended for better macro performance.<\/p>\n
—<\/p>\n
### blender<\/p>\n
Enable if the sequence was exported from Blender.<\/p>\n
“`json
\n{blender:true}
\n“`<\/p>\n
—<\/p>\n
### blender_name<\/p>\n
Leave empty when using Blender.<\/p>\n
“`json
\n{blender_name:””}
\n“`<\/p>\n
—<\/p>\n
### frame_rate<\/p>\n
Original frame rate of the video.<\/p>\n
Used for adaptive frame rate.<\/p>\n
For servers:<\/p>\n
“`txt
\nfunction-permission-level=3
\n“`<\/p>\n
—<\/p>\n
### sound<\/p>\n
Audio event name defined in `sounds.json`.<\/p>\n
—<\/p>\n
### sound_switch<\/p>\n
Enable or disable sound playback.<\/p>\n
“`json
\n{sound_switch:true}
\n“`<\/p>\n
—<\/p>\n
### max_frame<\/p>\n
Maximum frame count.<\/p>\n
—<\/p>\n
### slot<\/p>\n
Equipment slot used for overlay.<\/p>\n
Supported values:<\/p>\n
* head
\n* body
\n* chest
\n* feet
\n* legs
\n* mainhand
\n* offhand
\n* saddle<\/p>\n
—<\/p>\n
### dialog<\/p>\n
#### video_list_show<\/p>\n
Whether the video is shown in the menu.<\/p>\n
“`json
\n{video_list_show:true}
\n“`<\/p>\n
—<\/p>\n
### resolution<\/p>\n
Used for multiple aspect ratio support.<\/p>\n
Path format:<\/p>\n
“`txt
\npath\/resolution\/frame.png
\n“`<\/p>\n
Example:<\/p>\n
“`txt
\nanimation:school\/16:9\/0001.png
\n“`<\/p>\n
#### switch<\/p>\n
Enable multi-resolution mode.<\/p>\n
“`json
\ntrue \/ false
\n“`<\/p>\n
#### default_size<\/p>\n
Default ratio key.<\/p>\n
“`txt
\ndefault_size:1
\n“`<\/p>\n
#### size_list<\/p>\n
* 1 = 16:9
\n* 2 = 16:10
\n* 3 = 3:2
\n* 4 = 4:3<\/p>\n
—<\/p>\n
### language<\/p>\n
Used for translated names in the dialog menu.<\/p>\n
#### default_language<\/p>\n
“`txt
\n1: en-us
\n2: zh-cn
\n3: zh-hk
\n4: zh-mo
\n5: zh-sg
\n6: zh-tw
\n7: en-au
\n8: en-ca
\n9: en-in
\n10: en-gb
\n11: fr-fr
\n12: de-de
\n13: ja
\n14: kn
\n15: es-es
\n16: ar
\n17: ko
\n18: in-in
\n“`<\/p>\n
#### Translation Text<\/p>\n
Format:<\/p>\n
“`txt
\nlanguage_code:”Translated Text”
\n“`<\/p>\n
Example:<\/p>\n
“`txt
\nen-us:”School”
\n“`<\/p>\n
—<\/p>\n
## Example<\/p>\n
### Video Configuration<\/p>\n
“`mcfunction<\/p>\n
data merge storage video:school
\n{video:
\n {
\n frame_zero:”000″,
\n frame:”0″,
\n path:”animation:school\/”,
\n name:”school”,
\n blender_name:””,
\n frame_rate:”60″,
\n sound:””,
\n sound_switch:false,
\n max_frame:740,
\n blender:true,
\n slot:”head”,
\n dialog:{
\n video_list_show:true
\n },
\n resolution:{
\n switch:false,
\n default_size:1,
\n size_list:{
\n 1:true,
\n 2:false,
\n 3:false,
\n 4:false
\n }
\n },
\n language:{
\n default_language:”en-us”,
\n en-us:”School”,
\n zh-cn:”\u5b66\u6821”
\n }
\n }
\n}<\/p>\n
function animations:video_add\/main with storage video:school video<\/p>\n
“`<\/p>\n
> The last `function` line must be placed at the end of the config file, and the name after `video:` must match the `name` value.<\/p>\n
—<\/p>\n
## sounds.json<\/p>\n
“`json
\n{
\n “video_text”: {
\n “sounds”: [
\n {
\n “name”: “animation:video\/video_text”,
\n “stream”: true,
\n “volume”: 0.8,
\n “weight”: 1
\n }
\n ]
\n }
\n}
\n“`<\/p>\n
Then use:<\/p>\n
“`json
\n{sound:”video_text”}
\n“`<\/p>\n
—<\/p>\n
## How It Works<\/p>\n
Based on Minecraft’s `camera_overlay` equipment component.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
### Start Playback<\/p>\n
“`mcfunction
\n\/function animations:start {video_name:”video_name”}
\n“`<\/p>\n
—<\/p>\n
### Stop Playback<\/p>\n
“`mcfunction
\n\/function animations:stop
\n“`<\/p>\n
—<\/p>\n
### Pause Playback<\/p>\n
“`mcfunction
\n\/function animations:pause
\n“`<\/p>\n
—<\/p>\n
### Resume Playback<\/p>\n
“`mcfunction
\n\/function animations:continue_play
\n“`<\/p>\n
—<\/p>\n
### Delete One Player’s Playback Data<\/p>\n
“`mcfunction
\n\/function animations:player_video_play\/storages\/delete\/delete_player {name:”player”}
\n“`<\/p>\n
—<\/p>\n
### Delete All Player Data<\/p>\n
“`mcfunction
\n\/function animations:player_video_play\/storages\/delete\/all_storages\/run
\n“`<\/p>\n
—<\/p>\n
### Delete One Video Config<\/p>\n
“`mcfunction
\n\/function animations:video_list\/delete_only {name:”video”}
\n“`<\/p>\n
—<\/p>\n
### Delete All Video Configs<\/p>\n
“`mcfunction
\n\/function animations:video_list\/delete_all
\n“`<\/p>\n
—<\/p>\n
## About Image Sequences<\/p>\n
You can export image sequences with:<\/p>\n
* Adobe Animate
\n* Premiere Pro
\n* Apple Motion
\n* Processing
\n* Aseprite<\/p>\n
Export them as PNG sequences.<\/p>\n
—<\/p>\n
## Recommended Resolution<\/p>\n
Minecraft supports adaptive textures.<\/p>\n
Recommended size:<\/p>\n
**960 \u00d7 540**<\/p>\n
This reduces storage usage and resource pack size.<\/p>\n
—<\/p>\n
## Notes<\/p>\n
Due to a Mojang issue, played textures may remain in memory and cannot be fully cleared.<\/p>\n
This may cause memory overflow on low-memory systems.<\/p>\n
Bug Report:<\/p>\n
MC-277837<\/p>\n
—<\/p>\n
## Debug Mode<\/p>\n
Enable Debug Mode with:<\/p>\n
“`mcfunction
\n\/scoreboard players set #debug video_setting 1
\n“`<\/p>\n
> Only use Debug Mode when troubleshooting datapack issues or developing with this datapack.<\/p>\n","protected":false},"excerpt":{"rendered":"
Video Player driven by DataPack and Resource Pack<\/p>\n","protected":false},"featured_media":164751,"template":"","meta":{"_minecraft_slug":"vanilla-video-player","_minecraft_project_id":"yabrBAWB","_minecraft_author":"WindWaves_Sea","_minecraft_license":"MIT","_minecraft_downloads":89,"_minecraft_follows":1,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"vanilla-video-player.zip","_minecraft_size_bytes":26746257,"_minecraft_version_count":22,"_minecraft_updated_at":"2026-05-15T22:32:27.147711Z","_minecraft_date_created":"2026-03-22T04:13:09.494440Z","_minecraft_date_modified":"2026-04-19T02:02:11.971236Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/vanilla-video-player","_minecraft_icon_attachment_id":164751,"_minecraft_imported_at":"2026-06-09T17:21:41+00:00","_minecraft_import_hash":"b9229998002cc4a05c0ba8c1cb33a908","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,873,6,92],"mod_loader":[86,9],"minecraft_version":[41,83,167,163],"class_list":["post-164750","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-library","mod_category-minecraft","mod_category-utility","mod_loader-datapack","mod_loader-minecraft","minecraft_version-1-21-11","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n