Recover Pal Spheres

Check out my other mod Unlimited Active Skills that let's you use more than 3 moves with all your pals![hr][/hr]

Recover Pal Spheres v2.0

by VykosX

[h1] FULLY UPDATED AND CONFIRMED WORKING WITH PALWORLD 1.0.2 - NOW WITH FULL MULTIPLAYER SUPPORT![/h1][hr][/hr] Recover Pal Spheres gives missed Pal Spheres back instead of letting them disappear, transforming them into world pickups or returning them directly to your inventory. It supports hand throws and all the different sphere launchers.

What it does

[*] A missed hand-thrown sphere (of any grade) becomes a pickup near the place where it stopped. [*] Misses from the Sphere Launcher and Homing Sphere Launcher are also recovered. Scatter Sphere Launcher shots are counted separately, so only the spheres that actually missed are returned. [*] Spheres that land underwater are moved to the water surface. [*] Spheres that are too far away, too high or low, or cannot be placed safely are returned directly to your inventory.[/list]

Demonstration

Sphere Throwing Single Shot Launcher Scattershot Launcher Homing Sphere Launcher Underwater Sphere Recovery

Requirements

UE4SS Experimental

Configuration

The settings are in config.json. Changes are picked up in real-time without having to restart the game. [*] sphere_recovery_percentage: Percentage chance that a missed sphere is recovered. Default: 100. [*] return_sphere_min_distance_x: Maximum horizontal distance in metres, at which a missed sphere is placed as a pickup. Beyond this distance it goes directly to your inventory. Default: 60 [*] return_sphere_min_distance_y: Maximum vertical distance in metres, at which a missed sphere is placed as a pickup. Beyond this distance it goes directly to your inventory. Default: 120. [*] notify_inventory_return: When true, Palworld shows its normal item received message for spheres returned directly to the inventory, otherwise they're returned silently. Default: true. [*] sphere_launcher_pickups: Allow Single/Homing Launcher pickups for standalone players and coop hosts. Treated as false for dedicated-server players and remote co-op players. Default: true. [*] max_pickup_lifetime: How long a recovered pickup stays in the world before it is returned automatically to your inventory. -1 keep pickups indefinitely, 0 disables pickups altogether and returns every recovered sphere directly to your inventory, positive values are the number of seconds before an uncollected pickup is returned automatically to the inventory.[/list]

Dedicated Servers

Use the version from Nexus Mods and install directly to your server's UE4SS/Mods folder. Only the server needs the mod, clients are not required to install it for everything to work correctly.

Changelog

[*] 2.0

• Spheres should now always be returned to the player that owns them
• Duplication glitches caused by catching Pals beyond the maximum distance were resolved
• Multiplayer issues with the different sphere launchers were addressed and prevented
• Rewritten the code for spawning pickups for remote hosts for improved reliability
• Fixed occasional crashes when the game's process is terminating [/list]
• 1.0
• [list][*] Initial Release, fully compatible with Palworld 1.0.x [/list]

The mod isn't working/I have an issue

Please follow the instructions below to correct or report issues: [olist][*] Are you sure you installed the mod correctly, are you running the correct linked Okaetsu Palworld specific fork of UE4SS Experimental? Is the mod enabled in your game and in mods.txt? [*] Double check that the mod's files are correctly present in your "Palworld\Mods\NativeMods\UE4SS\Mods" folder. If the files are missing, close the game, unsubscribe, launch the game, verify the mod is gone from your mods list, close the game, resubscribe and enable the mod in the game menu, let the game restart then verify if everything works correctly now. Alternatively, obtain the mod from Nexus Mods and place them in this folder and add the corresponding "RecoverPalSpheres : 1" entry to your mods.txt file in the UE4SS\Mods folder. [*] Ensure the mod is actually being loaded: Do you see the line "Starting Lua mod 'RecoverPalSpheres'" in your UE4SS.log followed by a bunch of hooks and no errors until the next mod loads? [*] Describe your issue in detail. Are you playing in single player, coop (are you the host or a remote player) or a dedicated server? Is the game on the latest version? Does the game perform exactly like vanilla, do some things work but others don't, what were you doing in-game and what appears to cause the problem? Provide all the relevant details of your issue so that I am able to reproduce it and fix it on my end. [*] Enable the debug config in the config.json file, reopen the game and test all the functionality of the mod, throwing different spheres, using sphere launchers, etc, then close the game and attach or upload your UE4SS.log file to Pastebin or Gist so I can have a look at it.[/olist]

Messages simply saying "it doesn't work for me" will be ignored, the mod works fine.