Installation

The Pine engine is distributed using GitHub Packages. The GitHub Packages docs contain more information about how it works.

Note

Some examples below might use an older version of Pine. Make sure you replace the version number with the latest version of Pine, or with whatever version you want to use.

All releases Latest release

Option 1: Use boilerplate project setup

This is the same as option 2, but with most of the work already done for you.

1. Fork the Pine-boilerplate repository
2. Follow the setup guide in the README file
3. Change the package name to something that suits your project (Optional)

Option 2: Install using Gradle

1. In your build.gradle file, add the following lines:

   Groovy

   build.gradle

     repositories {
       mavenCentral()
       maven {
         url "https://repo.gradle.org/gradle/libs-releases"
       }
       maven {
         url = uri("https://maven.pkg.github.com/prozilla/pine")
         credentials {
           username = project.findProperty("gpr.user") ?: System.getenv("USERNAME")
           password = project.findProperty("gpr.token") ?: System.getenv("TOKEN")
         }
       }
     }
   
     dependencies {
       implementation "dev.prozilla:pine:2.0.3"
     }

   Kotlin

   build.gradle.kts

     repositories {
       mavenCentral()
       maven {
         url = uri("https://repo.gradle.org/gradle/libs-releases")
       }
       maven {
         url = uri("https://maven.pkg.github.com/prozilla/pine")
         credentials {
           username = findProperty("gpr.user") as String? ?: System.getenv("USERNAME")
           password = findProperty("gpr.token") as String? ?: System.getenv("TOKEN")
         }
       }
     }
   
     dependencies {
       implementation("dev.prozilla:pine:2.0.3")
     }

2. Create a gradle.properties file or a .env file with your environment variables. Replace YOUR_USERNAME and YOUR_TOKEN with your GitHub username and token respectively.

   gradle.properties

   gradle.properties

   gpr.user=YOUR_USERNAME
   gpr.token=YOUR_TOKEN

   .env

   .env

   USERNAME=YOUR_USERNAME
   TOKEN=YOUR_TOKEN

   Make sure to add this file to .gitignore so it remains private.

Option 3: Install using Maven

1. In your pom.xml file, add the following lines:

   pom.xml

   <repositories>
     <repository>
       <id>gradle-releases</id>
       <url>https://repo.gradle.org/gradle/libs-releases</url>
     </repository>
   
     <repository>
       <id>pine-github</id>
       <url>https://maven.pkg.github.com/prozilla/pine</url>
     </repository>
   </repositories>
   
   <dependencies>
     <dependency>
       <groupId>dev.prozilla</groupId>
       <artifactId>pine</artifactId>
       <version>2.0.3</version>
     </dependency>
   </dependencies>

2. Create a global settings.xml file in your Maven configuration folder (.m2) that stores your GitHub credentials. Replace YOUR_USERNAME and YOUR_TOKEN with your GitHub username and token respectively.

   .m2/settings.xml

   <settings>
     <servers>
       <server>
         <id>pine-github</id>
         <username>YOUR_USERNAME</username>
         <password>YOUR_TOKEN</password>
       </server>
     </servers>
   </settings>

Option 4: Using JARs

It is possible to use Pine by downloading the JARs of Pine and its dependencies and adding them to the classpath. Sources and Javadoc JARs are also available.

1. Go to the Releases page and download the JAR of the version you want to use.

2. Download the JARs of each dependency:

   • LWJGL
     • Core
     • GLFW
     • OpenGL
     • OpenAL
     • stb
     • Natives (Determined by the target platform)
   • Jackson
     • Core
     • Databind
     • Annotations
   
   

3. Create a lib folder and move the JARs inside this folder

4. Add all JARs to your classpath

Minimal example

The following code can be used to verify whether the installation of Pine was succesful or not. If no exception is thrown and a blank window opens, that means everything is working.

public class Main {

  public static void main(String[] args) {
    new ApplicationBuilder().build().run();
  }

}