Install NekoVideo

Follow these steps on every Paper instance that will host streamed media.

1. Upload the plugin

1. Download the latest build from the NekoSoft portal.
2. Copy NekoVideo.jar into the server's plugins/ folder.
3. Restart the server to generate plugins/NekoVideo/ assets.

2. Provision codecs

Option	Usage
Bundled FFMpeg	Ships with out-of-the-box presets for 1080p30 and 720p60. Suitable for most installs.
System FFMpeg	Point video.ffmpegPath at a system binary if you already manage codec pipelines.
Cloud encoder	Set video.encoder=remote to offload transcoding to NekoSoft's managed service.

3. Register asset storage

Update storage.yml with:

provider: s3
bucket: nekosoft-media
region: us-east-1
credentialsProfile: production
cacheTTL: 900 # seconds

Local disk caching is enabled automatically for frequently replayed clips.

4. Open network ports

• websocketPort: default 9450
• assetCdnPort: default 9451

Expose these ports internally between your proxy layer (Velocity/BungeeCord) and each Paper node. Use TLS if the traffic crosses hosts you do not trust.

5. Validate

Run /nekovideo diag to ensure codecs, storage, and ports are reachable. The command prints actionable hints when misconfigurations are detected.