Installation - Revision history

Ryo Sangnoir at 17:21, 6 January 2025

2025-01-06T17:21:53Z

← Older revision		Revision as of 17:21, 6 January 2025
Line 25:		Line 25:
	If that returns something like this, you should be good to go.		If that returns something like this, you should be good to go.

	<code>Michaels-MBP:~ mcroft$ java -version<br />openjdk version "21.0.4" 2024-07-16<br />OpenJDK Runtime Environment (build 21.0.4+7-Ubuntu-1ubuntu224.04)<br />OpenJDK 64-Bit Server VM (build 21.0.4+7-Ubuntu-1ubuntu224.04, mixed mode, sharing)		<code>Michaels-MBP:~ mcroft$ java -version<br />openjdk version "21.0.4" 2024-07-16<br />OpenJDK Runtime Environment (build 21.0.4+7-Ubuntu-1ubuntu224.04)<br />OpenJDK 64-Bit Server VM (build 21.0.4+7-Ubuntu-1ubuntu224.04, mixed mode, sharing)</code>

	== Troubleshooting Runtime Issues==		== Troubleshooting Runtime Issues==

Ryo Sangnoir: Java 21

2025-01-06T17:21:17Z

Java 21

← Older revision		Revision as of 17:21, 6 January 2025
Line 13:		Line 13:
	== Dependencies==		== Dependencies==

	===Java 17 or higher===		===Java 21 or higher===
	KoLmafia depends on Java 17 or higher The recommended version is linked at the top of every page of kolmafia.us. If you are executing KoLmafia from a jarfile, you will need to install Java first.		KoLmafia depends on Java 21 or higher The recommended version is linked at the top of every page of kolmafia.us. If you are executing KoLmafia from a jarfile, you will need to install Java first.

	If you do not have a recent version of Java, the recommended version (as of this writing) is [https://adoptium.net/index.html Java 17].		If you do not have a recent version of Java, the recommended version (as of this writing) is [https://adoptium.net/index.html Java 21].

	Oracle may have issues, for simplicity use [https://adoptium.net/temurin/releases/ Adoptium]. Any OpenJDK build should be okay too like [https://www.azul.com/downloads/#zulu Zulu Java].		Oracle may have issues, for simplicity use [https://adoptium.net/temurin/releases/ Adoptium]. Any OpenJDK build should be okay too like [https://www.azul.com/downloads/#zulu Zulu Java].
Line 25:		Line 25:
	If that returns something like this, you should be good to go.		If that returns something like this, you should be good to go.

	<code>Michaels-MBP:~ mcroft$ java -version<br />openjdk version "16.0.1" ~~2021~~-04-20<br />OpenJDK Runtime Environment ~~Zulu16.30+15-CA~~ (build 16.0.1+9)<br />OpenJDK 64-Bit Server VM ~~Zulu16.30+15-CA~~ (build 16.0.1+9, mixed mode, sharing)~~</code>~~		<code>Michaels-MBP:~ mcroft$ java -version<br />openjdk version "21.0.4" 2024-07-16<br />OpenJDK Runtime Environment (build 21.0.4+7-Ubuntu-1ubuntu224.04)<br />OpenJDK 64-Bit Server VM (build 21.0.4+7-Ubuntu-1ubuntu224.04, mixed mode, sharing)

	== Troubleshooting Runtime Issues==		== Troubleshooting Runtime Issues==

NISEMONO: Suggest not using Oracle for ease

2023-08-08T17:10:40Z

Suggest not using Oracle for ease

← Older revision		Revision as of 17:10, 8 August 2023
Line 17:		Line 17:

	If you do not have a recent version of Java, the recommended version (as of this writing) is [https://adoptium.net/index.html Java 17].		If you do not have a recent version of Java, the recommended version (as of this writing) is [https://adoptium.net/index.html Java 17].

			Oracle may have issues, for simplicity use [https://adoptium.net/temurin/releases/ Adoptium]. Any OpenJDK build should be okay too like [https://www.azul.com/downloads/#zulu Zulu Java].

	====Testing your Java installation====		====Testing your Java installation====

Heeheehee: /* Java 11 or better (Java 17 recommended) */ Reflect that Java 17 is required, not merely recommended.

2022-09-12T21:45:25Z

Java 11 or better (Java 17 recommended): Reflect that Java 17 is required, not merely recommended.

← Older revision		Revision as of 21:45, 12 September 2022
Line 13:		Line 13:
	== Dependencies==		== Dependencies==

	===Java 11 or ~~better (Java 17 recommended)~~===		===Java 17 or higher===
	KoLmafia depends on ~~finding~~ Java 11 or ~~better.~~ The recommended version is linked at the top of every page of kolmafia.us. If you are executing KoLmafia from a jarfile, you will need to install Java first.		KoLmafia depends on Java 17 or higher The recommended version is linked at the top of every page of kolmafia.us. If you are executing KoLmafia from a jarfile, you will need to install Java first.

	If you do not have a recent version of Java, the recommended version (as of this writing) is [https://adoptium.net/index.html Java 17].		If you do not have a recent version of Java, the recommended version (as of this writing) is [https://adoptium.net/index.html Java 17].
Line 24:		Line 24:

	<code>Michaels-MBP:~ mcroft$ java -version<br />openjdk version "16.0.1" 2021-04-20<br />OpenJDK Runtime Environment Zulu16.30+15-CA (build 16.0.1+9)<br />OpenJDK 64-Bit Server VM Zulu16.30+15-CA (build 16.0.1+9, mixed mode, sharing)</code>		<code>Michaels-MBP:~ mcroft$ java -version<br />openjdk version "16.0.1" 2021-04-20<br />OpenJDK Runtime Environment Zulu16.30+15-CA (build 16.0.1+9)<br />OpenJDK 64-Bit Server VM Zulu16.30+15-CA (build 16.0.1+9, mixed mode, sharing)</code>

	== Troubleshooting Runtime Issues==		== Troubleshooting Runtime Issues==
	=== Java Errors===		=== Java Errors===

Mcroft: /* Scaling support on HiDPI Monitors */

2021-12-28T18:05:41Z

Scaling support on HiDPI Monitors

← Older revision		Revision as of 18:05, 28 December 2021
Line 32:		Line 32:
	===Scaling support on HiDPI Monitors===		===Scaling support on HiDPI Monitors===

	~~The default builds target Java and use Java Swing to provide its user interface~~. ~~Java Swing~~ support for HiDPI on Linux requires that you execute the '.jar' file with an option set as follows: <code>java -Dsun.java2d.uiScale=<multiplier> -jar <jarfile></code> ;e.g. ~~in my case, '<~~multiplier~~>' should be '2'~~.		If the KoLmafia application is unexpectedly small on a [https://techterms.com/definition/hidpi HiDPI]/Retina Display monitor, then support for HiDPI should enabled. This should only be required on Linux, since HiDPI support is enabled automatically on Windows and MacOS.

			On Linux, using HiDPI with a Java Swing application (such as KoLmafia) requires that you execute the '.jar' file with an option set as follows: <code>java -Dsun.java2d.uiScale=<multiplier> -jar <jarfile></code>

			Depending on the screen size, a multiplier of 1.6 or 2.0 may be appropriate. You may need to experiment to find the ideal scaling multiplier for your screens.

	[[Category:Tech Support]]		[[Category:Tech Support]]
	[[Category:New User Help]]		[[Category:New User Help]]

Mcroft: /* Scaling support on HiDPI Monitors */ removed outdated instructions

2021-12-28T17:38:37Z

Scaling support on HiDPI Monitors: removed outdated instructions

← Older revision		Revision as of 17:38, 28 December 2021
Line 32:		Line 32:
	===Scaling support on HiDPI Monitors===		===Scaling support on HiDPI Monitors===

	The default builds target Java and use Java Swing to provide its user interface. ~~This means that~~ Java Swing support for HiDPI on Linux is not present. Java 9's Swing includes support for HiDPI. Thus to have HiDPI support one needs to compile it targeting Java 9. To do so, checkout the source from the sourceforge repository using subversion. Ensure that you have some version of JDK 9 installed and configured on your computer as the default java compiler, and also an up-to-date version of Apache Ant. Change the line in 'build.properties' from 'target="1.6"' to 'target="1.9"'. This compiles the source into a version that has support for HiDPI; the built jar will be located at the 'dist' folder. Finally, execute the '.jar' file with an option set as follows: <code>java -Dsun.java2d.uiScale=<multiplier> -jar <jarfile></code> ;e.g. in my case, '<multiplier>' should be '2'.		The default builds target Java and use Java Swing to provide its user interface. Java Swing support for HiDPI on Linux requires that you execute the '.jar' file with an option set as follows: <code>java -Dsun.java2d.uiScale=<multiplier> -jar <jarfile></code> ;e.g. in my case, '<multiplier>' should be '2'.

	[[Category:Tech Support]]		[[Category:Tech Support]]
	[[Category:New User Help]]		[[Category:New User Help]]

Mcroft: Restructured a bit.

2021-12-28T17:17:49Z

Restructured a bit.

← Older revision		Revision as of 17:17, 28 December 2021
Line 24:		Line 24:

	<code>Michaels-MBP:~ mcroft$ java -version<br />openjdk version "16.0.1" 2021-04-20<br />OpenJDK Runtime Environment Zulu16.30+15-CA (build 16.0.1+9)<br />OpenJDK 64-Bit Server VM Zulu16.30+15-CA (build 16.0.1+9, mixed mode, sharing)</code>		<code>Michaels-MBP:~ mcroft$ java -version<br />openjdk version "16.0.1" 2021-04-20<br />OpenJDK Runtime Environment Zulu16.30+15-CA (build 16.0.1+9)<br />OpenJDK 64-Bit Server VM Zulu16.30+15-CA (build 16.0.1+9, mixed mode, sharing)</code>
	==== ~~Troubleshooting~~ Java====		== Troubleshooting Runtime Issues==
			=== Java Errors===
	Please be aware that some older versions of Java do not get completely replaced when installing a newer version. Usually this happens with Java 8 JRE and Java 11+ JDKs. If that makes no sense, just delete Java 8.		Please be aware that some older versions of Java do not get completely replaced when installing a newer version. Usually this happens with Java 8 JRE and Java 11+ JDKs. If that makes no sense, just delete Java 8.

	If you get a message like this:<code>Error: A JNI error has occurred, please check your installation and try again.</code> Please [https://kolmafia.us/threads/java-11-now-required-for-kolmafia-java-17-recommended.26579/ read this announcement].		If you get a message like this:<code>Error: A JNI error has occurred, please check your installation and try again.</code> Please [https://kolmafia.us/threads/java-11-now-required-for-kolmafia-java-17-recommended.26579/ read this announcement].

	===HiDPI ~~Support~~===		===Scaling support on HiDPI Monitors===

	The default builds target Java and use Java Swing to provide its user interface. This means that Java Swing support for HiDPI on Linux is not present. Java 9's Swing includes support for HiDPI. Thus to have HiDPI support one needs to compile it targeting Java 9. To do so, checkout the source from the sourceforge repository using subversion. Ensure that you have some version of JDK 9 installed and configured on your computer as the default java compiler, and also an up-to-date version of Apache Ant. Change the line in 'build.properties' from 'target="1.6"' to 'target="1.9"'. This compiles the source into a version that has support for HiDPI; the built jar will be located at the 'dist' folder. Finally, execute the '.jar' file with an option set as follows: 'java -Dsun.java2d.uiScale=<multiplier> -jar <jarfile>'; e.g. in my case, '<multiplier>' should be '2'.		The default builds target Java and use Java Swing to provide its user interface. This means that Java Swing support for HiDPI on Linux is not present. Java 9's Swing includes support for HiDPI. Thus to have HiDPI support one needs to compile it targeting Java 9. To do so, checkout the source from the sourceforge repository using subversion. Ensure that you have some version of JDK 9 installed and configured on your computer as the default java compiler, and also an up-to-date version of Apache Ant. Change the line in 'build.properties' from 'target="1.6"' to 'target="1.9"'. This compiles the source into a version that has support for HiDPI; the built jar will be located at the 'dist' folder. Finally, execute the '.jar' file with an option set as follows: <code>java -Dsun.java2d.uiScale=<multiplier> -jar <jarfile></code> ;e.g. in my case, '<multiplier>' should be '2'.

	[[Category:Tech Support]]		[[Category:Tech Support]]
	[[Category:New User Help]]		[[Category:New User Help]]

Mcroft: /* Java 11 or better (Java 17 recommended) */

2021-12-28T17:14:59Z

Java 11 or better (Java 17 recommended)

← Older revision		Revision as of 17:14, 28 December 2021
Line 14:		Line 14:

	===Java 11 or better (Java 17 recommended)===		===Java 11 or better (Java 17 recommended)===
	KoLmafia depends on finding Java 11 or better. The recommended version is linked at the top of every page of kolmafia.us.		KoLmafia depends on finding Java 11 or better. The recommended version is linked at the top of every page of kolmafia.us. If you are executing KoLmafia from a jarfile, you will need to install Java first.

	If you do not have a recent version of Java, the recommended version (as of this writing) is [https://adoptium.net/index.html Java 17].		If you do not have a recent version of Java, the recommended version (as of this writing) is [https://adoptium.net/index.html Java 17].

Mcroft at 17:14, 28 December 2021

2021-12-28T17:14:06Z

← Older revision		Revision as of 17:14, 28 December 2021
Line 1:		Line 1:
	{{TOCright}}		{{TOCright}}
	The latest source build can be downloaded from [http://builds.kolmafia.us/ builds.kolmafia.us] or the [https://github.com/kolmafia/kolmafia/releases GitHub releases page].
			== How to Download the latest version. ==
			The latest source build can be downloaded from the following locations:

			# [http://builds.kolmafia.us/ builds.kolmafia.us]
			# the [https://github.com/kolmafia/kolmafia/releases GitHub releases page].

			Both of these sources have tested versions that are posted shortly after developers change code.

	The GitHub releases page contains both the KoLmafia-xxxxx.jar java binaries and installers for an experimental version that includes a bundled version of Java. If you use the installers, they manage the Java dependency listed below, but it can be more difficult to troubleshoot issues.		The GitHub releases page contains both the KoLmafia-xxxxx.jar java binaries and installers for an experimental version that includes a bundled version of Java. If you use the installers, they manage the Java dependency listed below, but it can be more difficult to troubleshoot issues.

Mcroft: Total rewrite for Java 11+ codebase

2021-12-28T17:12:10Z

Total rewrite for Java 11+ codebase

← Older revision		Revision as of 17:12, 28 December 2021
Line 1:		Line 1:
	{{TOCright}}		{{TOCright}}
	The latest ~~stable version~~ can be downloaded ~~at the Sourceforge KoLmafia~~ [http://~~sourceforge~~.~~net~~/~~projects~~/kolmafia/~~files~~/ ~~files~~ page].		The latest source build can be downloaded from [http://builds.kolmafia.us/ builds.kolmafia.us] or the [https://github.com/kolmafia/kolmafia/releases GitHub releases page].

	The ~~latest daily build~~ can be ~~downloaded from [http://builds.kolmafia.us/ here]~~.		The GitHub releases page contains both the KoLmafia-xxxxx.jar java binaries and installers for an experimental version that includes a bundled version of Java. If you use the installers, they manage the Java dependency listed below, but it can be more difficult to troubleshoot issues.

	~~For more information on download options, please see the [http://kolmafia.sourceforge.net/manual.html Sourceforge Manual].~~		== Dependencies==

	== ~~Windows Installation~~ ==		===Java 11 or better (Java 17 recommended)===
			KoLmafia depends on finding Java 11 or better. The recommended version is linked at the top of every page of kolmafia.us.

	~~Windows users~~ have the ~~option~~ of ~~using either an~~ .~~exe file or a~~ .~~jar file~~.		If you do not have a recent version of Java, the recommended version (as of this writing) is [https://adoptium.net/index.html Java 17].

	~~For those uncomfortable with checking on advanced~~ Java ~~settings and configuration~~, ~~using the .exe is recommended. The .exe file is always available with the latest stable release, and weekly builds of the .exe are also posted each Sunday night on the Daily Builds page.~~		====Testing your Java installation====
			From a Command Prompt (or Terminal) window, enter <code>java -version</code>

	~~: Mafia will automatically create sub-directories at the location where it is run~~, ~~so it is inadvisable~~ to ~~run it from your desktop~~.		If that returns something like this, you should be good to go.

			<code>Michaels-MBP:~ mcroft$ java -version<br />openjdk version "16.0.1" 2021-04-20<br />OpenJDK Runtime Environment Zulu16.30+15-CA (build 16.0.1+9)<br />OpenJDK 64-Bit Server VM Zulu16.30+15-CA (build 16.0.1+9, mixed mode, sharing)</code>
			==== Troubleshooting Java====
			Please be aware that some older versions of Java do not get completely replaced when installing a newer version. Usually this happens with Java 8 JRE and Java 11+ JDKs. If that makes no sense, just delete Java 8.

	~~== Mac Installation ==~~		If you get a message like this:<code>Error: A JNI error has occurred, please check your installation and try again.</code> Please [https://kolmafia.us/threads/java-11-now-required-for-kolmafia-java-17-recommended.26579/ read this announcement].

	If you are running Mac OS X 10.4.x or higher, you do not need to download or install a separate JRE. If you are running Mac OS X 10.3.9, then you will need to upgrade your Java to 1.4 by going here: [http://support.apple.com/downloads/Java_for_Mac_OS_X_10_3_Update_5 Java Update for Mac OS X v10.3.] If you are running Mac OS X 10.2.6, then you will need to upgrade your Java to 1.4 by going here: [http://docs.info.apple.com/article.html?artnum=~~120242 Java Update for Mac OS X v10.2.6.] If you are running an older version of Mac OS, unfortunately, KoLmafia will likely not run on your system.~~		===HiDPI Support===

	~~Once you~~ have ~~made sure~~ you have an ~~operating system and~~ version of ~~Java high enough~~ to ~~run KOL mafia~~, ~~[http~~:~~//sourceforge~~.~~net/projects/kolmafia/files/ you can download it here~~.]		The default builds target Java and use Java Swing to provide its user interface. This means that Java Swing support for HiDPI on Linux is not present. Java 9's Swing includes support for HiDPI. Thus to have HiDPI support one needs to compile it targeting Java 9. To do so, checkout the source from the sourceforge repository using subversion. Ensure that you have some version of JDK 9 installed and configured on your computer as the default java compiler, and also an up-to-date version of Apache Ant. Change the line in 'build.properties' from 'target="1.6"' to 'target="1.9"'. This compiles the source into a version that has support for HiDPI; the built jar will be located at the 'dist' folder. Finally, execute the '.jar' file with an option set as follows: 'java -Dsun.java2d.uiScale=<multiplier> -jar <jarfile>'; e.g. in my case, '<multiplier>' should be '2'.

	From this page choose the .dmg file and the download will start. Once the download is finished, a finder window will open. Drag the KoLmafia icon into the Applications alias. Then on your sidebar choose Applications, and find KoLmafia. Then you're good to go!		[[Category:Tech Support]]
			[[Category:New User Help]]

	: Unlike in the windows version that the DMG and JAR KoLmafia application saves out your session, scripts, and user data '''NOT''' in the same folder as the launcher. The files are located at - /Users/'''username'''/Library/Application Support/KoLmafia

	Tip - if you wish to sync your KoLmafia script/data folders automatically to say dropbox and other computers you can easily do this by using a Symbolic Link between the two locations, example command given below:

	~~ln -s /Users/'''username'''/Library/Application\ Support/KoLmafia/ /Users/'''username'''/Documents/Dropbox/Files/~~

	~~Information to create the link gotten from this location - [http://www.macosxhints.com/article.php?story=20090929052128498]~~


	~~== Linux Installation ==~~

	~~For a Linux user, the .jar versions of KoLMafia are ideal. Simply download the .jar, and place it in whatever directory you wish.~~

	~~: KoLMafia will store its data in ~/.kolmafia, and any scripts you want to access through the Scripts menu should be installed into ~/.kolmafia/scripts.~~

	~~If clicking on the .jar in your favorite file manager does not invoke it:~~
	*Make sure you have a recent Java VM installed (Sun or Blackdown both work. The target Java version for KoLMafia is currently 1.6)
	*Make sure your desktop environment knows to use 'java -jar' to invoke .jars

	~~=== HiDPI Support ===~~

	The default builds target Java 6 and use Java Swing to provide its user interface. This means that Java Swing support for HiDPI on Linux is not present. Java 9's Swing includes support for HiDPI. Thus to have HiDPI support one needs to compile it targeting Java 9. To do so, checkout the source from the sourceforge repository using subversion. Ensure that you have some version of JDK 9 installed and configured on your computer as the default java compiler, and also an up-to-date version of Apache Ant. Change the line in 'build.properties' from 'target="1.6"' to 'target="1.9"'. This compiles the source into a version that has support for HiDPI; the built jar will be located at the 'dist' folder. Finally, execute the '.jar' file with an option set as follows: 'java -Dsun.java2d.uiScale=<multiplier> -jar <jarfile>'; e.g. in my case, '<multiplier>' should be '2'.


	[[Category:Tech Support]][[Category:New User Help]]