Installation
Requirements#
- Paper 1.21.4 or newer, including 26.1.x
- Java 21 or newer
- One TCP port open to players for the built-in resource pack host (default 8163)
- PlaceholderAPI is optional and only needed for placeholders
- ffmpeg is optional. See below.
Steps#
- Put the jar in
plugins/and restart the server. - Open port 8163 (TCP) in your firewall or host panel, or pick another port with
resource-pack.host.port. - In
plugins/HyperAdsPlus/config.yml, setresource-pack.host.public-addressto the IP or domain players use to join. Run/ha reload. - Run
/ha pack status. On startup the plugin checks that players can reach the pack URL, and the result shows here. If it fails, the console explains how to fix it.
If public-address is empty, the plugin uses server-ip from server.properties, and if that is empty too it uses 127.0.0.1, which only works on the same machine. Players on other computers would fail to download the pack.
Is ffmpeg needed?#
No. Images, GIFs, frame folders, H.264 .mp4 videos and .ogg audio all work in pure Java. ffmpeg is only needed for other formats (webm, mkv, avi, mp3 or wav audio, and the sound inside video files). With ffmpeg-auto-download: true (the default) the plugin downloads an official static build the first time it needs one, checks it against its published checksum, and stores it in plugins/HyperAdsPlus/ffmpeg/. You can also put the binary there yourself, or point ffmpeg-path at it.
Demo media#
On the first start, three demo clips with beat-synced jingles are installed, one per source type: hyperads_demo (frame folder), hyperads_demo_gif (GIF) and hyperads_demo_mp4 (MP4). Delete them whenever you like, or set demo.install: false.