Troubleshooting and FAQ
Players see a still poster instead of the video.
They declined the pack, the download failed, or they are on Bedrock. Run /ha pack status and check the self-test. The most common cause is a closed port 8163 or a wrong resource-pack.host.public-address. Then ask the player to rejoin and click Yes. Use /ha pack send <player> to re-send the pack.
The self-test fails or the pack never downloads.
Open the TCP port in resource-pack.host.port (default 8163) in your firewall and host panel. Set resource-pack.host.public-address to the IP or domain players connect with, run /ha reload, then check /ha pack status again. If your host cannot open an extra port, upload the zip from plugins/HyperAdsPlus/pack/ to your own web host and put its link in resource-pack.url, remembering to re-upload after every rebuild.
A video has no sound.
Give it sound with an audio file of the same name (for example promo.zip plus promo.mp4), or with a mono .ogg. Check that /ha video list shows audio for it, and that audio.enabled is true and the billboard audio mode is not OFF.
The sound is too quiet or too loud.
Use /ha edit <name> volume <0-200>. Values above 100 need a louder copy made by ffmpeg, which the plugin downloads automatically. The Audio tab shows the status of that copy.
Sound does not fade with distance.
Stereo .ogg files play but do not fade. Use a mono .ogg, or let the plugin convert the audio with ffmpeg.
My video was rejected or came out blurry.
Videos are limited by videos.max-seconds, videos.max-file-size-mb and the client memory budget (videos.texture-budget-mb). Longer clips automatically get a lower resolution. For the best quality, use frame images at 20 fps, and raise max-width, max-height and the budget if you can afford the memory.
The pack is too big.
Clients refuse packs above 250 MB. Lower videos.fps, max-width or max-seconds, or remove media you no longer use, then run /ha pack rebuild.
The picture is slightly off the wall grid.
Adjust screen.nudge-x and screen.nudge-y (in blocks) in config.yml.
My billboard will not build.
Both corners must be clicked on the same flat wall face, every block between them must be empty air, and the maximum is 400 frames.
Can I delete the old videos_frames folder?
Yes. If you upgraded from version 1.0.0, the videos_frames/ folder is no longer used.