jEveAssets

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 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 java 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/<nowiki>JEveAssets</nowiki>''

===== jEveAssets will not run =====

<wrap round info></wrap>\_First ensure you're follow the instructions on [[faq#how_to_run|How to run]] \\
<wrap round info></wrap>\_It's worth trying all the solution for your operation system. \\
<wrap round help></wrap>\_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:** <nowiki>MacOS</nowiki>\\
**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: <nowiki>MacOS</nowiki> 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 <niklaskr@gmail.com> and include the following:  

  * The ''jeveassets.log'' and ''jeveassets1.log'' (if it exist) in the [[faq#settings_location|settings location]]
    * <wrap round important></wrap>\_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).

  * <wrap round important></wrap>\_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