OdinOnDemand

OdinOnDemand (OOD) adds several forms of multimedia to Valheim that allow players to natively watch YouTube as well as direct video files on in-game screens. The mod also offers two types of musicplayers that can play YouTube, SoundCloud links, as well as direct audio files -- additionally, all of this is multiplayer compatible and seemingly relatively low-impact.

ValMedia recommends playing without bloom while watching for the best viewing experience.

0.9.80 adds a new Theater Screen, and persistent player variables such as listening distance, autoplay, and admin only! Click the little cog icon on mediaplayers to explore these new features! Thanks to all that have supported the project so far!

Features

• Cinema screens
  • Theater Screen, Flatscreen TV, Table TV, Monitor, Old TV, Laptop
  • Can play YouTube, Remote and Local files
• Musicplayers
  • Gramophone, Boombox
  • Can play SoundCloud, YouTube, Remote and Local files
• YouTube playlist support
• Remote control to use screens from a distance
• Multiplayer functionality
• Audio Control _{(Client Side)}
  • Individual mediaplayer listening distance _{(Server Side)}
• Forward Tracking _{(Client Side)}
• Looping
• Autoplay
• Admin Only Option
• Piece Recipe Configuration (item recipes coming soon)

This mod is in beta and has not been extensively tested. Please report any issues on the Nexus or GitHub tracker.

Installation

Installation of the plugin is fairly straightforward, just install into Bepinex/plugins or use r2modman. It must be installed on both server and client.

Recipes

Recipes can now be tweaked through a json file located at BepInEx\config\com.ood.valmedia.recipes.json, the mod will automatically make this. However the default recipe file can be found here if needed.

Some helpful links to help you edit this file are here

Beautify JSON to made it readable, and validate it here

Valheim Item List

Unless you know what you're doing, please only change the requirements section. If you have any issues keep in mind you can delete your .json file and the mod will re-create it with default values.

The remote control recipe can't be tweaked yet, you can always use a mod like WackysDB for the time being.

Use

In game, place down a cinema screen or boombox. Mediaplayers can be destroyed with the hammer or with damage to get materials back.

Interact with it to open the GUI.

For cinema screens, you must have either a direct link to a remote or local video file of a compatible codec or use a youtube/youtu.be link. YouTube should work natively. There is an optional self-hosted backup API, if interested check GitHub.

For boomboxes, you must have a direct link to a remote or local audio file of a compatible codec, a soundcloud.com link, or a youtube/youtu.be link. Through testing I've noticed some SoundCloud songs are unavailable. I think it depends on the artist and how they upload/license their art.

Local files are not synced over multiplayer.

Put the link into the input field and click set to set a file. Control playback with play, pause, and stop. Control individual player's volume with the slider and mute button. ">>" to track forward. There are also loop and shuffle toggles.

You can play YouTube playlists - when a playlist is set, new info will appear. You can choose to shuffle or loop the playlist. If you turn on looping while a playlist is active, the whole playlist will loop - not individual videos. The Viking who sets the playlist handles playlist logic, so if they leave the area or disconnect playlist playback will stop, but it is multiplayer synced. Try not to skip through tracks too fast. If you have autoplay enabled, the last video played will be saved as the autoplay video when the Viking unloads the mediaplayer object.

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. Config options include 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.

Click the cog icon in the bottom right for extra options. Here, you can enable autoplay, admin only access, control listening distance and control master volume.

Autoplay does not currently support playlists. If a viking is playing a playlist with autoplay enabled and unloads the mediaplayer object, the autoplay video will be set to the last played video. Autoplayed videos are not synced. Vikings will load videos upon mediaplayer load-in.

Each player can have it's own customized listening distance, limited via config. This limit is not enforced on admins. Master volume is a client sided setting that can also be changed in the mod's config.

Most features are synced over multiplayer through RPC events. Volume and tracking are client sided. Tracking will de-sync. Screens do not currently check for video sync or update to currently playing videos when connecting/loading new Mediaplayers (unless autoplay is enabled and a video is set)

Known Issues

Boomboxes are currently difficult to place. Just.. keep trying. They place easier on terrain it seems. I'm not quite sure why this is happening. Gramophones are not affected.

If you have V-Sync force enabled in your GPU driver control panel, the mod may not function.

If the mod fails to play any sort of video file, not just YouTube, check your Player.log. If there are errors about Direct3D and refresh rate / v-sync you may have to do this. 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"

Screenshots

_{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)

Tutorial Video

Github Instructions

Acknowledgements

• SoundCloudExplode | YouTubeExplode | youtube-exec-dl | nodejs | yt-dlp
• Inspired by Raft Cinema Mod

Versions:

1.0.6

• Fixed crash when attempting to listen to SoundCloud links

1.0.5

• Updated to new game version

1.0.4

• Added new settings buttons: Reload player, Sync Time
• Changed "SyncTime" repeated event to only broadcast if ZDO owner, instead of pinging server from each player
• Speakers now check for Owner & PrivateArea access
• Fix master volume mixer bug
• UI, Speaker Tweaks

1.0.3

• Audio Waveform Visualizer tweaks:
  • Added configurable waveform visualizer scale factors (turns out I have my volume settings very low)
  • Tweaked base values to fit default volume levels better, if you have volume turned down then adjust your scale factors as needed
  • Changes to height limits

1.0.2

• Changed radio station addons to search for .assetbundle files due to flat file structure download from Thunderstore

1.0.1

• Fixed missing directory issues
• Switch to OOD_LIB Dependancy package over Runtime Assembly Loading

1.0.0

• Change: Config files moved to BepInEx\config\OdinOnDemand[...]
• Improvement: Multiplayer - All videos and audio clips are now fully multiplayer time synced even upon fresh loading. Players will regularly sync time with current ZDO owner. All players "autoplay". This means that tracking forward and autoplay options have been removed. You can manually set seek time in seconds through the Cog wheel settings sub-menu.
• New Piece: Bard's Wagon - A mobile mediaplayer on wheels!
• New Item: Skald's Girdle - An equipable mediaplayer sold by Haldor.
  • Control Cart Player & Skald's Girdle via the Remote Control item. Looping always enabled.
• New Feature: Linkable Speakers - Speakers can now be (un)linked to all types of stationary mediaplayers via the remote control. This changes the center of their audio output, displayed briefly as a red circle.
• Improved Feature: Reciever is now a mediaplayer.
• New Feature: Dynamic Audio Stations - Create radio stations from folders and assetbundles that are simulated server-side. When players have the same radio stations, they hear the same songs at the same time.
• New Feature: Audio Waveform Visualizer - Enabled when listening to dynamic stations, audio files & soundcloud on cinema screens and radio displays.
• Improvement: All mediaplayers can play audio files and Soundcloud.
• Improvement: RPC overhaul to reduce server side network load
• Improvement: *Explode handling overhaul to lower amount of unexplained errors when using YouTube/Soundcloud Links. Increased error verbosity for YouTube/Soundcloud Explode. Removed timeout settings to opt for built in *Explode timeout.
• Improvement: Configurable Item json recipes added for Remote Control & Skald's Girdle
• Change: Relative path lookup now begins from OdinOnDemand plugin folder, no prefix needed.
• Refactor: Abstraction, Organization
• Fixed: Missing Remote Icon

0.9.96-beta

• Fixed master volume fluctuations caused by incorrect mixer in Radio prefab audioSource

0.9.95-beta

• New feature: In-Game Music Audio Crossfade based on distance [See config file]
• New feature: Configurable vertical volume drop-off [See Mediaplayer Settings Panel]
• Fixed missing meshes (How long was it like this?)
• Combined & Condensed Shaders
• Increased default YTExpolode Timeout

0.9.94-beta

• Hopefully fixed issues with new updates

0.9.93-beta

• Fixed local file unpause for real this time

0.9.92-beta

• Fixed relative/local path file unpause and playback issues

0.9.91-beta

• Config reorganized, now divided by categories.
• Piece recipe rework. Fixed file not saving, now auto-updates when certain recipes are missing. You can disable this in the config.

0.9.90-beta

• Fixed issues stemming from Bepinex removing unstripped corlibs (thanks OrianaVenture)
• VIP System Beta. Very barebones, meant for feedback. Prevents non-VIP users from placing and interacting with Mediaplayers. Please check/wipe config for new settings.

0.9.89-beta

• Fixed flow issue preventing remote recipe loading

0.9.88-beta

• Fixed missing GetMyID method

0.9.87-beta

• Fixed relative path audio file playback
• Radio mesh edit

0.9.86-beta

• Fixed SetURL behavior
• Fixed radio behavior, audio properties

0.9.85-beta

• Added prefabs:
  • New mediaplayer: Radio, a vintage style wooden radio
  • Studio Speaker, Standing Speaker, Receiver
    • Decorative pieces, with future planned mechanics
• Added relative path file lookup from plugin dir (local:// or local:\)
• Default recipe JSON is now properly formatted
• Autoplay YouTube and SoundCloud links are now stored and sent un-parsed, fixing old CDN video timeout
• Proper key config for Remote Control
• Modifications to YoutubeExplode Library
• Readme update
• Code refactoring

0.9.82-beta

• Added crash disclaimer from 2020.3.45 upgrade

0.9.81-beta

• Updated YoutubeExplode to version 6.2.12

0.9.80-beta

• Theater Screen
  • Very large screen roughly 16m x 9m for theater environments.
• Fixed ward locking behavior
• Fixed musicplayer volume mixer
• Added settings overlay, click the cog icon!
• Added ZDO for several variables
  • Distance, Autoplay/URL, Admin Only, isLocked, and isLooping are saved to world and synced over multiplayer.
  • This means each individual player can have it's own distance and properties, which will sync and persist after reloading world or areas!
  • Custom listening distance can be limited via config. This is not enforced on admins.
• Added admin only
• Added autoplay
  • Playlists are currently NOT supported.
  • .mp3/SoundCloud autoplay is currently NOT supported. Direct video links or youtube only.
  • Autoplayed videos are NOT SYCNED. The video will start upon object loading for every viking.
  • Please be aware that YouTube videos saved from autoplay will expire after an indeterminable amount of time. This is simply the nature of Google's content delivery and as such cannot be avoided.

0.9.76-beta

• Fixed playlist index string
• Fixed unnecessary debug logging

0.9.75-beta

• UI Redesign
  • Button icons, combined overflow menus, volume slider
• Ward interaction, when a media-player is Locked it will check for access with Wards. Media-players are locked by default. You may have to cycle the lock for newly loaded Vikings.
• Removed pickup button. All media-players can be destroyed via the Hammer just like any piece, you will get appropriate materials refunded.
• All media-players now have Wear N Tear - they can take damage, and be destroyed. Media-players are weak to pickaxes.
• Changed Screen Render Distance calculations to hopefully be more efficient. It no longer does any distance calculations and instead just uses collider OnTrigger events.

0.9.71-beta

• Fixed missing Monitor recipe. If your recipe file is outdated, the default one will be loaded. Check logs and delete recipe file if needed.

0.9.70-beta

• Monitor Prefab added, larger than Old TV but smaller than Table TV.
• Remote control for interacting with media-players from a distance
• Basic playlist support implemented
• Shuffle feature for playlists
• Fixed resources not refunding on destruction
• Media-player code refactoring
• More multiplayer code refactoring

0.9.60-beta

• First Gramophone prefab release
• Added custom recipes via json config
• Added looping with multiplayer sync
• Added Boombox YouTube support
• Added loading circle to cinema screens
• Greatly increased efficiency of how plugin finds media-players for multiplayer
• Changed volume handling, added default player volume
• Fixed Boombox volume bug
• Fixed boombox playing previous SoundCloud song on set video button press when song unavailable
• Cleaned up debug logging
• Cleaned up config

0.9.58-beta

• Fixed GUI not closing when media-player destroyed by other player.

0.9.57-beta

• Added Vulkan Support

0.9.56-beta

• Small adjustment in Rendering distance calculations

0.9.55-beta

• Fixed Screen volume bug
• Added "Screens Stop Rendering Out of Range" and config

0.9.51-beta

• Fix spelling mistake

0.9.5-beta

• Added native YouTube Functionality. No need to use an external server now, but it's still there if you want it. YouTube is now enabled by default and should work just fine. Let me know if you have any issues. Be sure to wipe configs.

0.9.1-beta

• Fixed Boombox Default Distance
• Separate Boombox Default Distance and Master Volume

0.9.0-beta Initial Release