====== FAQ ====== ===== Requirements ===== * [[https://www.java.com/en/download/manual.jsp|Java Runtime Environment]] (version 8 or later) * Note: The x64 version should be used, if possible * You can use other vendors too: * [[https://adoptium.net/temurin/releases/|Adoptium Temurinβ„’]] * [[https://jdk.java.net/|OpenJDK]] (Available via your package manager on Linux) * [[https://www.eveonline.com/|Eve-Online]] account ===== How to run ===== ==== Windows ==== Double click on ''jeveassets.jar'' ==== MacOS ==== From your downloads folder, move the entire jEveAssets folder into the applications folder. Double click on ''jeveassets.jar'' ==== Linux ==== in terminal run:\\ ''java -jar /path/to/jEveAssets/jeveassets.jar''\\ where '/path/to' is the path on your computer to the jeveassets directory\\ or cd to jEveAssets directory and run:\\ ''java -jar jeveassets.jar''\\ ===== Manually updating jEveAssets to a new version ===== Simply overwrite all the old files with the new ones. Your settings and assets will stay untouched. ===== Sort columns ===== You need to double click to sort a new column. A single click will sub-sort the column. ===== Portable ===== See the [[cli|Command Line Arguments]] ===== Settings Location ==== Replace **USERNAME** with your username ==== Windows ==== **XP:** ''C:\Documents and Settings\**USERNAME**\.jeveassets\''\\ **Vista and later**: ''C:\Users\**USERNAME**\.jeveassets\''\\ ==== Linux==== ''/home/**USERNAME**/.jeveassets/ '' ==== Mac ==== ''~/Library/Preferences/JEveAssets'' ===== jEveAssets will not run ===== \_First ensure you're follow the instructions on [[faq#how_to_run|How to run]] \\ \_It's worth trying all the solution for your operation system. \\ \_If none of the solutions bellow works, please see how to get [[faq#feedback_and_help|help]] ==== Solution 1 ==== **On:** All\\ **Symptoms:** jEveAssets displays a splash screen momentarily then closes\\ Ensure jEveAssets isn't corrupted and unzipped - Download [[http://eve.nikr.net/jeveasset|jEveAssets]] - Unzip * How to unzip files: [[https://support.microsoft.com/en-us/windows/zip-and-unzip-files-8d28fa72-f2f9-712f-67df-f80cf89fd4e5|Windows]] [[https://support.apple.com/en-ie/guide/mac-help/mchlp2528/mac|MacOS]] [[https://linuxize.com/post/how-to-unzip-files-in-linux/|Linux]] - Next follow [[faq#how_to_run|How to run]] ==== Solution 2 ==== **On:** All\\ **Symptoms:** Nothing happens when starting jEveAssets or another program opens. Ensure Java is installed and it is the correct version - Uninstall all versions of java ([[http://www.java.com/en/download/uninstall.jsp|help]]) - Download the latest version of [[https://www.java.com/en/download/manual.jsp|java]] * The 64bit/x64 version should be used (unless you're on a 32bit system) - Install java ([[http://www.java.com/en/download/help/windows_manual_download.xml|help]]) - Next follow [[faq#how_to_run|How to run]] ==== Solution 3 ==== **On:** Windows\\ **Symptoms:** Nothing happens when starting jEveAssets or another program opens. Ensure Java is used to open jar files - Download [[https://johann.loefflmann.net/downloads/jarfix.exe|JarFix]] ([[https://johann.loefflmann.net/en/software/jarfix/index.html|more info]]) - Run the downloaded file ''jarfix.exe'' - Next follow [[faq#how_to_run|How to run]] Example: \\ {{:wiki:unable_to_launch_the_application.png|}} \\ //This is just one example// ==== Solution 4 ==== **On:** MacOS\\ **Symptoms:** jEveAssets displays a splash screen momentarily then closes\\ Ensure jEveAssets have permission to run - Move the ''jEveAssets'' directory into your ''Applications'' directory - Next follow [[faq#how_to_run|How to run]] Additional info: MacOS limits access to your Desktop, Documents, and Downloads directories preventing jEveAssets from running ==== Solution 5 ==== **On:** Windows\\ **Symptoms:** Nothing happens when starting jEveAssets Ensure jEveAssets have permission to run - Move the entire ''jEveAssets'' directory out of the ''Downloads'' directory into the applications directory - Next follow [[faq#how_to_run|How to run]] Additional info: Some anti-virus software block execution in Download directory ===== File Lock ===== File locks are necessary to prevent file corruption.\\ If jEveAssets is forcefully terminated while reading/writing a file, the file will never be unlocked.\\ This prevent jEveAssets from accessing the file.\\ - Close all instances of jEveAssets (You can restart your computer to be 100% sure all instances of jEveAssets is closed) - Run a single instance of jEveAssets (This will delete all existing file locks) ===== Add Character/Corporation ===== **Note:** step 1 and 2 can be skipped if you run jEveAssets for the first time. - Go to ''Options'' > ''Accounts...'' - Click ''Add'' - Select account type ''Character'' or ''Corporation''\\ Note: Scopes reset when changing account type - //(Optional)// Click ''Scopes'' and select the scopes you want to use\\ Note: jEveAssets will have limited functionality if you do not select all scopes. - Click ''Next > '' - The Eve SSO web page should open in your browser - Select your character by clicking on their portrait - Click ''Authorize'' on the web page - Return to jEveAssets and wait for the import process to finish - If you get an error see: [[faq#api_key_troubleshooting|API Key Troubleshooting]] - Click ''OK'' ===== API Key Troubleshooting ===== Solutions to common errors while importing API Keys ==== Proxy Server ==== If you're behind a proxy server, you need to enable it in jEveAssets. - In the menu select: ''Options'' > ''Options...'' - Select ''Proxy'' - Select your ''Proxy Type''\\ ''Direct'' = No proxy server\\ ''HTTP'' = Http proxy server\\ ''SOCKS'' = Socks proxy server - Enter your ''Proxy Address'' and ''Proxy Port'' ==== Firewall blocks Java ==== - Disable your firewall (at your own risk...) - Import API Keys in jEveAssets - Enable your firewall If you succeed, you need to add a firewall exception for Java (Please contact your firewall provider, for additional help) ==== API is down ==== - [[http://eve-offline.net/|Check if the API is down]] - Wait until it's back up... ==== API is unstable ==== Try a couple of times (Press `Previous` to retry...) ==== API Error ==== This is a CCP API Error. Feel free to [[faq#asking_for_help|ask for help]] (please include the error code) ==== I give up... ==== No problem! if you have tried everything above, please send a [[faq#bugs|bug report]] ===== Email Log ===== Please send an email to and include the following: * The ''jeveassets.log'' and ''jeveassets1.log'' (if it exist) in the [[faq#settings_location|settings location]] * \_Do not post the logs publicly (forum/discord/etc.). They contain private information. \\ Such as you character and corporation names. Only share them via email. * Instructions on how to reproduce the bug * Operation system name and version * jEveAssets version * Java version (if you know) ===== Feedback and Help ===== All feedback, bug reports, and feature suggestion are always very welcome! \\ They are a great way for users to give back to the jEveAssets project. Talking with the users of jEveAssets is my biggest motivation to keep working on jEveAssets. I always try my best to help everyone with their jEveAssets problems (as much as life allows). * \_Email is the only safe way to share jEveAssets logs: [[faq#email_log|Email Log]] * [[discord>8kYZvbM|Discord]] * ❔ Ask for help * πŸͺ² Bug Reports * πŸš€ Feature Suggestions * πŸ—¨οΈ Chat about jEveAssets * 😎 //I usually reply withing 24 hours and often much faster// * [[github>GoldenGnu/jeveassets/issues|GitHub]] * πŸͺ² Bug Reports * πŸš€ Feature Suggestions * πŸ‘€ //I read everything. I only reply if I have questions or need more information (1-3 days)// * [[eveforum>13255|Forum Thread]] * ❔ Ask for help * 🐌 //I usually reply within 1-3 days// * [[slack>|Tweetfleet Slack]] * πŸ—¨οΈ You are welcome to message or ping me @goldengnu, if you want to talk about jEveAssets or need help with the ESI asset endpoints