imported>AntumDeluge: /* Ant on macOS */ fix anchor link

2026-01-21T02:16:16Z

Ant on macOS: fix anchor link

← Older revision	Revision as of 02:16, 21 January 2026
(No difference)

imported>AntumDeluge: /* Ant on macOS */ fix anchor link

2026-01-21T02:16:16Z

Ant on macOS: fix anchor link

← Older revision		Revision as of 02:16, 21 January 2026
Line 100:		Line 100:
	== Ant on macOS ==		== Ant on macOS ==

	For macOS, the same instructions for [[~~HowToBuildStendhal~~#Ant_on_Windows\|Windows]] can be used. Alternatively, it is also provided through Homebrew.		For macOS, the same instructions for [[{{PAGENAME}}#Ant_on_Windows\|Windows]] can be used. Alternatively, it is also provided through Homebrew.

	Example of installing on macOS using Homebrew:		Example of installing on macOS using Homebrew:
Line 106:		Line 106:
	$ brew install ant		$ brew install ant
	</pre>		</pre>


	= Node =		= Node =

imported>AntumDeluge: /* Node on Unix */

2026-01-12T23:51:46Z

Node on Unix

← Older revision	Revision as of 23:51, 12 January 2026
(No difference)

imported>AntumDeluge: /* Node on Unix */

2026-01-12T23:51:46Z

Node on Unix

← Older revision		Revision as of 23:51, 12 January 2026
Line 118:		Line 118:
	== Node on Unix ==		== Node on Unix ==

	Most Unix/Linux/BSD distributions have a version of Node available from the ~~default~~ package manager.		Most Unix/Linux/BSD distributions have a version of Node available from the system package manager.

	Example of installing on Ubuntu:		Example of installing on Ubuntu:

imported>AntumDeluge: Moving contents of "Build Tools" from page HowToBuildStendhal

2026-01-12T22:43:35Z

Moving contents of "Build Tools" from page HowToBuildStendhal

← Older revision	Revision as of 22:43, 12 January 2026
(No difference)

imported>AntumDeluge: Moving contents of "Build Tools" from page HowToBuildStendhal

2026-01-12T22:43:35Z

Moving contents of "Build Tools" from page HowToBuildStendhal

New page

= JDK =

The Stendhal server and legacy client are both written in [https://www.java.com/ Java]. To run either requires a [https://en.wikipedia.org/wiki/Java_virtual_machine Java Runtime Environment (JRE)]. To compile server or client, a [https://en.wikipedia.org/wiki/Java_Development_Kit Java Development Kit (JDK)] is necessary. Most JDK distributions include a JRE.

== JDK on Unix ==

Some Unix/Linux/BSD systems have a JDK pre-installed (usually [https://openjdk.org/ OpenJDK]). If not, most will have a version available from the system package manager.

Example of installing on Ubuntu:
<pre>
# install version 17
$ sudo apt install openjdk-17-jdk
</pre>

Example of installing on Arch:
<pre>
# install default version
$ sudo pacman -S jdk-openjdk

# install version 17
$ sudo pacman -S jdk17-openjdk
</pre>

Example of installing on FreeBSD:
<pre>
# install pre-built package of version 17
$ sudo pkg install openjdk17

# compile version 17 from Ports source
$ cd /usr/ports/java/openjdk17
$ sudo make install clean
</pre>

== JDK on Windows ==

Packages for Windows can be downloaded from either [https://www.oracle.com/java/technologies/downloads/ oracle.com] or for OpenJDK, from [https://jdk.java.net/ jdk.java.net]. If you download a portable .zip package, you will need to manually configure the PATH environment variable so the system knows where the ''java'' and ''javac'' executables are located. It may also be necessary to configure the ''JAVA_HOME'' environment variable. The recommended method is to use an installer package (.exe or .msi) as these will configure the necessary environment variables automatically.

Alternatively, a JDK can be installed from the [https://en.wikipedia.org/wiki/Windows_Package_Manager Windows Package Manager (WinGet)].

Example of installing on Windows using WinGet:
<pre>
:: install Oracle JDK version 17
> winget install Oracle.JDK.17

:: install OpenJDK version 17
> winget install ojdkbuild.openjdk.17.jdk
</pre>

== JDK on macOS ==

Packages for macOS can be downloaded from either [https://www.oracle.com/java/technologies/downloads/ oracle.com] or for OpenJDK, from [https://jdk.java.net/ jdk.java.net]. But the recommended method is to install from the [https://brew.sh/ Homebrew Package Manager] as it will configure the necessary environment variables automatically.

Example of installing on macOS using Homebrew:
<pre>
# install version 17
$ brew install openjdk@17
</pre>

= Ant =

[https://ant.apache.org/ Apache Ant] is the main tool for building from the command line. All components can be built using this method. However, some components are built using another tool to which Ant serves as a wrapper to call its commands. For example, the Android app is built using [https://gradle.org/ Gradle] (or a Gradle Wrapper). In this case, Gradle builds the app. Ant simply calls Gradle as a sub-command.

Apache provides executables for multiple systems from their [https://ant.apache.org/bindownload.cgi downloads page]. Alternatively, see the following instructions for specific systems.

== Ant on Unix ==

Most Unix/Linux/BSD distributions have a version of Ant available from the default package manager.

Example of installing on Ubuntu:
<pre>
$ sudo apt install ant
</pre>

Example of installing on Arch:
<pre>
$ sudo pacman -S ant
</pre>

Example of installing on FreeBSD:
<pre>
# install pre-built package
$ sudo pkg install apache-ant

# compile from Ports source
$ cd /usr/ports/devel/apache-ant
$ sudo make install clean
</pre>

== Ant on Windows ==

For Windows, follow these steps:

# Download one of the ''apache-ant-<version>-bin packages from the link above (Windows supports .zip archives by default).
# Extract the package contents to a unique directory.
# Add the directory path to your system's PATH environment variable.
# Open a command prompt (cmd). Type ''ant -version'' and press "enter". If it is set up correctly, version information will be printed.

== Ant on macOS ==

For macOS, the same instructions for [[HowToBuildStendhal#Ant_on_Windows|Windows]] can be used. Alternatively, it is also provided through Homebrew.

Example of installing on macOS using Homebrew:
<pre>
$ brew install ant
</pre>

= Node =

[https://nodejs.org/en Node.js] is the system used for building the Stendhal web client. Like other tools, Node.js build commands can be executed directly. But it is recommended to use the appropriate Ant wrapper command.

When Node is installed, the commands ''node'', ''npm'' (Node Package Manager), and ''npx'' (Node Package Executor) will be available. Optionally, from the Stendhal source code root directory, you can execute ''npm install --no-package-lock'' to install the required Node modules. If you do not, they will automatically be installed when you execute any build instructions for a component that uses the Node build system (such as the web client).

In addition to the instructions below, the [https://nodejs.org/en/download download page] includes instructions on how to install/manage Node using the Node Version Manager (NVM) for common desktop systems.

== Node on Unix ==

Most Unix/Linux/BSD distributions have a version of Node available from the default package manager.

Example of installing on Ubuntu:
<pre>
$ sudo apt install nodejs ant
</pre>

Example of installing on Arch:
<pre>
$ sudo pacman -S nodejs npm
</pre>

Example of installing on FreeBSD:
<pre>
# install pre-built version 24 package
$ sudo pkg install node24

# compile version 24 from Ports source
$ cd /usr/ports/www/node24
$ sudo make install clean
</pre>

== Node on Windows ==

Node for Windows can be downloaded as an installer or portable .zip package from the [https://nodejs.org/en/download download page] (.zip requires manual configuration of environment variables). It is also available from the Windows Package Manager.

Example of installing on Windows using WinGet:
<pre>
> winget install OpenJS.NodeJS.LTS
</pre>

== Node on macOS ==

Node for macOS can be downloaded as an installer or portable .zip package from the [https://nodejs.org/en/download download page] (.zip requires manual configuration of environment variables). It is also available from Homebrew.

Example of installing on macOS using Homebrew:
<pre>
$ brew install node
</pre>

= Gradle =

The software comes bundled with a [https://docs.gradle.org/current/userguide/gradle_wrapper.html Gradle Wrapper] which is used to build the Android game client app. So it isn't necessary to install a version of [https://gradle.org/ Gradle] on your system. But if you wish to, the instructions are similar to those of installing other build tools.

* Unix-like systems will have a version of Gradle available from the system package manager.
* Portable .zip packages can be downloaded directly from [https://gradle.org/releases/ gradle.org] which contain executables for multiple systems.

= IDE =

Alternatively to building from the command line, an Integrated Development Environment can be used to build and run the software. The recommended IDE is [https://www.eclipse.org/ Eclipse], but others may work as well.

== Eclipse ==

See [[Stendhal on Eclipse]] for setup instructions.

HowToBuildStendhal/BuildTools - Revision history

imported>AntumDeluge: /* Ant on macOS */ fix anchor link

imported>AntumDeluge: /* Ant on macOS */ fix anchor link

imported>AntumDeluge: /* Node on Unix */

imported>AntumDeluge: /* Node on Unix */

imported>AntumDeluge: Moving contents of "Build Tools" from page HowToBuildStendhal

imported>AntumDeluge: Moving contents of "Build Tools" from page HowToBuildStendhal