Introducing OdinOnDemand 1.0: The Ultimate Media Experience for Valheim!
OdinOnDemand (OOD) adds tons of unique mediaplayers to Valheim that allow you to watch YouTube, direct video files, listen to Soundcloud, music, and dynamic radio stations all on in-game screens and radios! It's fully multiplayer synced, low resource, and easy to use.
Please enjoy OdinOnDemand 1.0! Moddy
Found a bug? -> Nexus || GitHub Issue Tracker
ValMedia recommends playing without bloom while watching cinema for the best viewing experience.
If you are enjoying the mod, please consider donating to my Ko-Fi.
YouTube error reporting has been completely changed to increase verbosity. If you find harmless exceptions that could be classified as a user UI message, please open up a suggestion on GitHub. Please report any other issues on the Nexus or GitHub tracker.
Installation of the plugin is fairly straightforward, just install into Bepinex/plugins or use r2modman. It must be installed on both server and client.
In game, place down a mediaplayer. Interact with it to open the GUI.
You can paste direct links into the URL field to play online remote files. The linked file should be of a compatible codec. You can also paste youtube/youtu.be links and the plugin will process this for you on all mediaplayers.
All mediaplayers have the added ability to play audio files of compatible codecs, as well as soundcloud.com links - some SoundCloud songs are unavailable, depending on the artist and how they upload/license their art.
Mediaplayers can play files from your computer's local filesystem. You can use absolute and relative path lookup for local files.
Absolute path lookup includes a drive letter, and is not synced over multiplayer unless players have identical file path structures (which is unlikely). For example, C:\videos\bunny.mp4 or file://C:\videos\bunny.mp4
Relative path lookup begins searching for files from OdinOnDemand's folder. Relative path lookup must include prefix local:// or local:\\
To load files from the plugin's folder, identify your media location - for example, a media subfolder in OdinOnDemand's plugin folder - here the path would belocal://movies/media.mp4 <- insert this into the URL field in-game.
This would translate into F:\SteamLibrary\steamapps\common\Valheim\BepInEx\plugins\Valmedia-OdinOnDemand\movies\media.mp4 or wherever the user's Valheim installation may reside.
You can bundle video files with your modpacks or instruct Vikings to place files in appropriate locations for easier synced local playback. Play them in-game for events and lore and more. You can pull from anywhere in the local plugin folder.
Mediaplayers have support for Youtube playlists. When a playlist is set, new info will appear in the UI. The Viking who initially sets the playlist handles playlist logic, so if they leave the area or disconnect playlist playback will stop. It is multiplayer synced. Do not skip through tracks too fast. You can choose to shuffle or loop the playlist. If looping, the whole playlist will loop - not individual videos. The last video played will be saved as the autoplay video.
Mediaplayers will regularly send out requests to sync time with current mediaplayer (ZDO) owner. You can configure the time between requests sent in the Config file.
To manually seek to a time in the media, use the "Set Time" button under the Cog wheel settings menu. Input time in seconds.
Mediaplayers can be controlled from a distance with a remote control. A remote control can be crafted with 1 bronze. Simply equip, point at a Mediaplayer and click. Point and click at Bard's Wagon to use it. Point and click at no other mediaplayer with Skald's Girdle equipped to use it. Admins can point and click at other player's Skald's Girdle. You can link speakers with mediaplayers using the secondary remote control action. Select a speaker, then select a mediaplayer to pair. Repeat this process to unpair. You can view speaker count and unlink all speakers from the mediaplayer's settings panel. Config options include key configs, max controller distance, and an option to make remote control access private.
Mediaplayers can be locked in the top right corner of the menu. When a Mediaplayer is locked, Vikings can only access it if they have access to the private area created by a Ward. Admins can lock down mediaplayers from the cog menu, preventing normal Vikings from interacting with specific screens.
The cog button in the bottom right displays extra options. Options for admin only access, listening distance and master volume exist here.
Default values and client sided master volume values can also be changed in the config.
Most features are synced over multiplayer through RPC events including player time. Volume is client sided.
You can configure the scale factor of the audio waveform visualizer from the config settings. If you play with the volume turned down, you will want to turn this up.
To use the Dynamic Audio Loader, you need to prepare your audio files and additional assets in a specific format. You can create your own station from an asset bundle or from a folder containing audio files, then distribute them via mod repositories or modpacks.
Note: File names cannot include the character "#".
Prepare Asset Bundle:
title text asset that contains the name of your station.thumbnail sprite asset to represent your station visually. Ensure it is set to "Sprite" type asset in the properties Inspector.shuffle text asset.
Loading Station:
Prepare Folder:
.ogg, .wav, .mp3, .flac) in a single folder.title.txt file containing the name of your station and place it in the same folder.thumbnail with one of the supported extensions (.png, .jpg, .jpeg, .bmp, .tga, .gif) to be used as the station's thumbnail.shuffle.txt in the folder.Loading Station:
To create a custom radio station addon for easy distribution, follow these simple steps:
odinondemand.txt file in your station's folder.title.txt file in your station's folder and write your station's name in it.When you the game world is initialized, the Server Station Manager initiates the playback simulation:
Track Selection: If shuffle mode is enabled, the tracks are shuffled to create a random playback order. Otherwise, tracks are played in the order they appear in the station.
Synchronization: In multiplayer games, the Station Manager ensures that all players hear the same track at the same time, creating a shared audio experience. This is done by regularly syncing the current track and playback time with all players.
Track Advancement: Tracks are played in sequence. When one track ends, the next one begins. If shuffle is enabled, the order will change after each full cycle through the station tracklist.
Looping: The station continuously loops through its tracklist. Once the last track finishes, playback returns to the first track (or a shuffled track if shuffle is enabled).
The server will simulate station playback position or "time" and send this to players when needed. Once a player initiates playback of a station via a mediaplayer, they receive the most recent station data from the server, load the radio station client side, and play the media.
Clients and servers must have identical files for proper playback.
Starting with OOD 1.0, config files are now stored in BepInEx\config\OdinOnDemand
The config includes settings for YouTube API selection, volume control, distance parameters for audio playback, server and client-side configurations, remote control functionalities, VIP mode settings, and audio fade options. It allows for extensive customization of media player behavior in the game, including options for enabling or disabling certain features, adjusting volumes, setting distances for audio reception, and specifying admin-only settings.
Recipes (piece and items) can now be tweaked through a json file located at BepInEx\config\recipes.json & recipes_item.json. the mod will automatically create these. However the default recipe files can be found here if needed.
Some helpful links to help you edit this file are here
Beautify/Validate JSON Valheim Item List
Do not change item names unless you want them removed. If you have any issues keep in mind you can delete your .json file and the mod will re-create it with default values.
When enabled, Only VIPs can place, remove, and interact with OdinOnDemand Pieces (admins excluded)
Enabled via Config files. Set VIP Mode to True, and add SteamIDs for VIPs. You may customize the message as well. The system is very barebones, so please provide any feedback to Github or Nexus.
If the mod fails to play any sort of video file, not just YouTube - Please check your GPU driver's control panel and make sure the vertical sync setting is either identical your in-game settings or set to "match application setting". You can also check your Player.log. If there are errors about Direct3D and refresh rate / v-sync you may have to do this.
Build by DanAugust Last picture is with back-light setting turned off.
For any tech-savvy Vikings out there, there is a backup YouTube api that can be self hosted using Node and youtube-dl. This is completely optional and not required as long as the built in library is maintained (YouTubeExplode)