Network/Connectivity Troubleshooting

Sometimes you may fail to connect to the PlayerSync service or may have issues when uploading/downloading files.

This type of behavior typically comes from some kind of network issue, either your ISP, an ISP on the path to get to the PlayerSync servers, or other network issues like Cloudflare R2 routing. You can also have network connectivity issues if you have any type of filter or firewall blocking access to the IPs and ports used by PlayerSync.

Make sure you have whitelisted the following domains:

• playersync.io
• sync.playersync.io
• fs-na-01.playersync.io
• mirror.playersync.io
• 54cfada9aee2c44d7e67f5769a0a9301.r2.cloudflarestorage.com

You will also need TCP port 443 open outbound for secure communication to the services.

If you follow this guide and are still running into issues, you can open a ticket on the Discord in the #report-an-issue channel. For the tech savvy, you can also use the in-game command: "/psync diag" for a more detailed analysis.

Server Connectivity Troubleshooting

If your plugin never connects to the service, you can try the optional proxy server that takes a different route to reach PlayerSync.

File Server Connectivity Troubleshooting

If you are having issues with uploading or downloading PlayerSync (download bars stuck for users, etc.) you can try changing your Cloudflare R2 storage bucket.

• For players in North and South America, try changing it to UTC-0
• For the rest of the world, try changing it to UTC-5

ISP/Routing Troubleshooting

Sometimes the root cause of the issue falls outside of our control, in these situations, some players have found the best thing to do is to use a VPN service to work around Internet/ISP blocks and bad routing.

One VPN service we recommend and users have had success with is: https://one.one.one.one/

Performance Issues

PlayerSync can be a pretty hefty plugin and mods put a lot of strain on your Internet, CPU, memory, GPU, and storage (SSD/HDD). There are some things you can do if you are running into PC limitations/performance issues, but ultimately you must work within the limits of your hardware.

Internet

PlayerSync leverages Cloudflare's R2 storage with near limitless bandwidth, if left unchecked, the downloads and uploads can consume your entire Internet line. On a slower connection, this may result in getting disconnected from the game altogether.

You can limit the downloads via the Settings → Transfers → Bandwidth options.

Storage (hard drive)

If you are sitting at a black screen for a long time when loading in or zoning into another area, or your game locks up frequently with a lot of players/modded players around, chances are you need to check what type of hard drive your game, Penumbra, and PlayerSync are running on.

1. Best - nVME (usually m.2)
2. Good - SSD (optionally an external USB drive that is an SSD/nVME)
3. Not recommended - HDD (traditional hard drive)

The issue of VRAM, compounded with system memory limits, can lead to a lot of read activity on your hard drive. Having the fastest drive possible, at least for Penumbra and PlayerSync, is critical in dealing with long load times/black screens and game stuttering.

GPU (graphics card)

Your graphics card stores textures and other modded resources being displayed on screen in what is called VRAM (video RAM). This is memory dedicated to your GPU and cannot be upgraded. Each GPU has a set amount of VRAM which you can check within task manager.

The reason people always say to “compress your mods” is to convert the modded textures to a format that uses less VRAM. Every player you see on screen (vanilla or modded) consumes VRAM, and once your GPU is out of its dedicated memory, it spills over into using your system RAM. The effect of this is a lot of lag/stutter when moving your camera, and a bit lower FPS. This effect is even worse if you are running a slower SSD/HDD.

There are only (2) real options to combat this issue, 1) have fewer modded pairs active at a time, and 2) get a newer GPU with more VRAM (at least 16GB is preferred). Pausing Syncshells or turning off ZoneSync can help lower your pairs and VRAM to a more manageable level. You can use the Player Analysis Viewer to get more details on player count and VRAM consumption.

Other plugins

Some plugins such as ReShade can have an effect on FPS and game performance. Not all shaders are the same, and some can be extremely taxing on your system and should only be used with gposing in small groups. If you are experiencing performance issues and use ReShade, try disabling it to see if it makes a notable difference.