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

1. Fork the Pine-boilerplate repository.
2. Read the setup guide in the README file
3. Customize the project to suit your needs

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