Note that the advice on this pages covers getting JOverseer up and running. If you have any questions about using the software, check out our user guides, or ask our Discord community for help!
Firstly, please make sure you have the latest version of JOverseer installed. Then try the steps below.
Windows Users
If JOverseer won’t open
Fix One
If you have just run an update, close the update window, then try opening JOverseer again.
Fix Two
Try opening JOverseer using joverseer.exe (not by clicking on one of your game files or via a link). This is usually found in program files (x86) / JOverseer.
Fix Three
Delete recent games row from regegit.
There are two ways to do this.
1) Directly in regedit:
search/run regedit
Go to Computer\HKEY_CURRENT_USER\Software\JavaSoft\Prefs\org\joverseer\ui\
Delete the row: recent/Games
Deleting this row is safe, but but please be careful, as making a mistake when using regedit and changing any other lines can harm your computer. GSI take no responsiblility if you make other changes!
2) Or via Powershell:
Run powershell (type powershell into your computer search). Then copy the following line of text and hit enter:
Remove-ItemProperty -Path ‘Registry::HKCU\SOFTWARE\JavaSoft\Prefs\org\joverseer\ui’ -Name recent/Games
Fix Four
Try opening JOverseer using the joverseer.bat file file instead of the exe, found in: program files (x86)/Joverseer.
Fix Five
If that doesn’t work, create an empty text file, save it with the name:
DontUse3d.txt
Then move the file to the JO directory of your computer: program files (c86)/JOverseer. (You might need to enable admin privileges on your computer to do this.)
Then run joverseer.bat
Nothing helping?
If, after following all the steps, JOverseer is still not working for you, then please get in touch with us at GSI, so we can assist. We need to know the OS you are using, and also for you to send us a copy of the latest JOverseer log file, which can be found by doing the following:
Open the ‘Run’ window by pressing ‘Windows Key + R’
Type %temp% and press OK.
Sort by date (so the most recent files are at the top)
Copy the most recent ‘joverseer_ text document and send it to us by email.
Whilst waiting for support you can revert to a previous version of JOverseer here: https://gamesystems.com/software/joverseer/joverseer-setup-java-1.18.19.exe
If you have duplicated/overlapping windows
Firstly, please make sure you are running the latest version of JOverseer.
Then try opening JOverseer using the joverseer.bat file file instead of the exe, found in: program files (x86)/Joverseer.
If that doesn’t work, create an empty text file, save it with the name:
DontUse3d.txt
Then move the file to the JO directory of your computer: program files (c86)/JOverseer. (You might need to enable admin privileges on your computer to do this.)
Then run joverseer.bat
If your Antivirus is stopping JOverseer from running or sending orders
Some users have reported that the JOverseer mailsender program is being blocked by their Antivirus or Firewall software.
If this happens, you need to set your software to allow the MailSender.exe program, which can normally be found in c:/program files (x86)/JOverseer/bin/mailSender folder.
Alternatively, if you go to send orders then choose save file, you can save the order file to a folder of your choice, then email it to us as an attachment.
If the auto-updater is not working within JOverseer
Go into your files, and find where joverseer is installed (usually that looks something like “C:\Program Files (x86)\JOverseer”).
Find jOverseerUpdater.exe and right click on it, then click run as administrator.
Mac Users
If Joverseer won’t open
Fix One
If you have just run an update, close the update window, then try opening JOverseer again.
Fix Two
Make sure you are trying to open JOverseer directly, not by clicking on one of your game files or via a link.
Fix Three
Go to Applications. Right Click on JOverseer.app and ‘show package contents’.
Open the MacOS folder and double click on universalJavaApplicationStub.
Fix Four
If JOverseer loads the splash screen, and then goes away or becomes invisible, reset your joverseer preferences:
use finder, or in a terminal (in one line):
mv ~/Library/Preferences/org.joverseer.ui.plist ~/old.org.joverseer.ui.plist
That should let jOverseer start properly.
There might be an invisible copy of joverseer still running in the background, that might cause problems. Which is probably best fixed by a quick reboot.
Fix Five
If you are using a new Apple processor, from a command line / terminal window this should work:
java -Xmx512M -Djava.net.preferIPv4Stack=true -jar joverseer.jar
Fix Six
Or try stripping the quarantine flag that macOS adds to downloaded apps:
xattr -cr /Applications/JOverseer.app
Nothing helping?
If, after following all the steps, JOverseer is still not working for you, then please get in touch with us at GSI, so we can assist. We need to know the OS you are using, and also for you to send us a copy of the latest JOverseer log file, which can be found by following the advice on this page:
https://support.apple.com/en-gb/guide/console/cnsl664be99a/mac
Whilst waiting for support you can revert to a previous version of JOverseer here: https://gamesystems.com/software/joverseer/joverseer-setup-java-1.18.19.exe
If Joverseer won’t find your results
Some Mac users have reported difficulties with a folder in the root directory or My Documents folder. But putting a “MEPBM” folder into /Users worked.
Non English-Language Users
Multi-language support is incomplete.
JOverseer will assume the orders are submitted in the same language as the computer it is running on.
If you want to override this and use English:
1. Right-click on the JOverseer shortcut icon on your desktop, then choose Properties from the context menu.
2. The Shortcut tab of the Properties dialog box is displayed by default. Notice the Target textbox. You’ll find something like “c:\Program files(x86)\JOverseer\joverseer.exe”. Add: -L EN at the end, after the double quotation.
3. Apply and Accept. Then double-click on the shortcut to start JOverseer as usual.
Linux Users
Please get in touch with us, and we can send you a build for Linux.