PalCinema - Open-Source Animation Framework 0.0.2

To install simply drag the "Pal" folder into your Palworld installation folder

 

 

 

 

Or manually install each of the components as noted in the following steps

Put PalCinema.pak in the LogicMods folder, if you use PalMagic you will need to update PalMagic to 0.2.4 as well

• PalCinema can work without PalMagic/DynamicPals, but the SpecialFlags requirements beyond a few automatic ones will be ignored

 

 

 

PalCinema Animation JSON files go in the new MovieJSON folder in the ~mods folder

 

 

 

Put the included JsonFileLister in the UE4SS Mods folder

This Lua helper script allows PalCinema and newer versions of PalMagic to not require a _ManifestList.json file neither a .bat script to create it! Just put the JSON files in their respective folders and that’s it!

 

 

Main UI

 

This is PalCinema’s main UI, it has the following features:

• To open the menu press Numpad * or Shift + `
• You can exit this menu by clicking the Exit button or clicking outside the menu
• The button banner on the left shows the buttons to switch between the MovieData section and the Settings section

 

MovieData Section

• Selected Actors: This section shows which actors have been selected from the Select Actors button menu, click on the Select Actors button and you will be presented with the following window to select the actors you want to participate in the animation
  • NOTE: animations that contain several of the same character and/or dynamic animations need to be selected in a proper order to be able to be played, this is an issue that’s currently being worked on

 

                    

 

Clicking on the names of the characters will select them for the animation, once finished; click the Select Actors button to return to the main UI

• You can click outside this menu to close it

 

    

 

• You can click Available Movies and select the animation you want to play from the list by clicking the Play Movie button if the animation is compatible!
  • You can stop the animation anytime by pressing Tab or Escape

 

• You may see some animations marked as [Locked], these are animations that didn’t pass the compatibility check but are animations that are “playable” by the selected actors

    

 

Clicking on any of these [Locked] animations will show which conditions didn’t pass to let you know what you need to be able to play the animation

 

 

The MovieTags are clickable, and when clicked they will be added to the blacklist, blacklisted animations will appear [Locked] and won’t appear in the QuickMovie UI

 

 

 

Settings Section

This section is for setting up the configuration settings for PalCinema as well as a bit of feedback on version and how many movies are loaded

 

 

• PalCinema Version: A simple string to identify which version of PalCinema is running
• MovieCount: How many animations could be read and loaded from the JSONs
• NSFW Allowed: This checkbox enables and disables NSFW animations, this doesn’t affect SFW animations from playing
• Item Rewards Active: This checkbox enables and disables the items awarded by animations
• Status Effects Active: This checkbox enables and disables the status effects applied by animations
• Override Compat Checker: Enabling this will disable the secondary compatibility checks, ie. If the Characters match, it will allow to be played regardless of other conditions
• Manual Loop Advance: If the player is in an animation and this checkbox is enabled, PalCinema will play the loop sections until Spacebar/Xbox X button is pressed
• Movie Loop Count: How many loops should each loop section play for, this applies to all animations if Manual Loop Advance is disabled, and will continue to apply to animations the player is not part of even if Manual Loop Advance is enabled
• Movie Time Limit: A hardcap on how long should an animation play for in seconds, this is mostly a safeguard in case an animation doesn’t end properly so the participants aren’t stuck in the animation
• Blacklist Tags: A list of all the blacklisted tags, clicking one of the tags will remove it from the blacklist
• Reload JSONs button: This feature is for making JSON edition and adjustments easier, you can edit the JSON files while in-world and pressing this button will reload the animations with the new adjusted JSON data without having to exit and relog into the world, clicking this will close the UI without saving the settings to reload the JSONs

 

 

QuickMovieUI

          

 

The QuickMovie UI is useful to quickly start an animation with the closest character to the player character and has the following features:

• To open the menu press Numpad  –, Shift + V or holding down D-Pad Down briefly
• It will list the animations available between the Player character and the closest character to the player after secondary compatibility checks are applied
• To navigate
  • W/Right Stick Up: Go up in the selection menu
  • S/Right Stick Down: Go down in the selection menu
  • Spacebar/Xbox X button: Play selected animation
  • Click outside/Xbox B button: Cancel and close menu