Vanilla Video Player

# Minecraft Vanilla Video Player (README/README_en.md) (README.md) > by WindWaves_Sea > > This article is also published on the author's (https://blog.windwaves.top/post/minecraft_vanilla_video_player), (https://www.bilibili.com/opus/1182083830058582057), the project's (https://github.com/WindWavesSea/Minecraft-Vanilla-Video-Player/) repository, and (https://modrinth.com/datapack/vanilla-video-player/) or (https://www.curseforge.com/minecraft/data-packs/video-playback-engine/). --- ## Introduction This project is based on a datapack and provides pseudo-video playback in vanilla Minecraft by displaying image sequences. Main purposes of this datapack: - Automatically calculate frame rates and batch process frame files. - Provide adaptive frame rate to improve performance. - Provide interfaces for quick configuration. - Play image sequences stored in resource packs. It also provides several **variables** for quickly adding image-sequence videos through resource packs. --- ### Warning This **datapack** uses the head equipment slot by default to trigger the camera overlay. If you do not want to use the head slot, you can modify it inside the datapack manually (currently required in V2.0). The resource pack includes a transparent model used as the equipped overlay item, creating a pseudo "no item equipped" playback effect. > **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. --- ## Download You can download this package from: - (https://modrinth.com/datapack/vanilla-video-player/) - (https://github.com/WindWavesSea/Minecraft-Vanilla-Video-Player/) - (https://www.curseforge.com/minecraft/data-packs/video-playback-engine/) --- ## Video Requirements Videos must be converted into **PNG image sequences**. --- ### Play 60 FPS Video with Increased Tick Rate 20 FPS videos are recommended. If using a 60 FPS video, set the tick rate to 60: ```mcfunction /tick rate 60 ```` This sets the target game tick speed. --- ### Play 60 FPS Video with Frame Interpolation Set the original frame rate in the config: ```txt frame_rate:60 ``` --- ## Dialog Menu You can open the menu by pressing **G** or through command: ```mcfunction /dialog show @s animations:open_menu ``` Players need to choose the video resolution. * 1920×1080 = 16:9 * 2560×1080 = 16:10 If you want to use the playback page, please select a language first in settings. --- ## Parameter Explanation ### frame_zero Number of leading zeros before the frame number. Example: `video0000.png` Then: ```json {frame_zero:"000"} ``` --- ### frame Current frame number. ```json {frame:1} ``` --- ### path Output file path. ```json {path:"animation:school/"} ``` --- ### name Video prefix name. Example: `video0000.png` Then: ```json {name:"video"} ``` Shorter names are recommended for better macro performance. --- ### blender Enable if the sequence was exported from Blender. ```json {blender:true} ``` --- ### blender_name Leave empty when using Blender. ```json {blender_name:""} ``` --- ### frame_rate Original frame rate of the video. Used for adaptive frame rate. For servers: ```txt function-permission-level=3 ``` --- ### sound Audio event name defined in `sounds.json`. --- ### sound_switch Enable or disable sound playback. ```json {sound_switch:true} ``` --- ### max_frame Maximum frame count. --- ### slot Equipment slot used for overlay. Supported values: * head * body * chest * feet * legs * mainhand * offhand * saddle --- ### dialog #### video_list_show Whether the video is shown in the menu. ```json {video_list_show:true} ``` --- ### resolution Used for multiple aspect ratio support. Path format: ```txt path/resolution/frame.png ``` Example: ```txt animation:school/16:9/0001.png ``` #### switch Enable multi-resolution mode. ```json true / false ``` #### default_size Default ratio key. ```txt default_size:1 ``` #### size_list * 1 = 16:9 * 2 = 16:10 * 3 = 3:2 * 4 = 4:3 --- ### language Used for translated names in the dialog menu. #### default_language ```txt 1: en-us 2: zh-cn 3: zh-hk 4: zh-mo 5: zh-sg 6: zh-tw 7: en-au 8: en-ca 9: en-in 10: en-gb 11: fr-fr 12: de-de 13: ja 14: kn 15: es-es 16: ar 17: ko 18: in-in ``` #### Translation Text Format: ```txt language_code:"Translated Text" ``` Example: ```txt en-us:"School" ``` --- ## Example ### Video Configuration ```mcfunction data merge storage video:school \ {video:\ {\ frame_zero:"000",\ frame:"0",\ path:"animation:school/",\ name:"school",\ blender_name:"",\ frame_rate:"60",\ sound:"",\ sound_switch:false,\ max_frame:740,\ blender:true,\ slot:"he