Getting Started

Instalasi

Library NxGate tersedia melalui GitHub Packages. Ikuti langkah-langkah berikut untuk menambahkan dependency ke project Maven atau Gradle Anda.

Requirements

  • Java 8 atau lebih tinggi
  • Maven 3.x atau Gradle 6.x+
  • GitHub Account dengan Personal Access Token

Konfigurasi Wajib Sebelum Build

Karena NxGate di-host di GitHub Packages, Anda WAJIB mengkonfigurasi autentikasi GitHub terlebih dahulu sebelum menjalankan build. Tanpa konfigurasi ini, Maven/Gradle akan gagal dengan error 401 Unauthorized.

Cara membuat token:

  1. Buka GitHub Settings
  2. Klik Generate new token (classic)
  3. Centang scope read:packages
  4. Copy token dan simpan dengan aman

Maven

Step 1: Konfigurasi file ~/.m2/settings.xml:

~/.m2/settings.xml
1<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
2    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
3    xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
4                        https://maven.apache.org/xsd/settings-1.0.0.xsd">
5

6    <servers>
7        <server>
8            <id>github</id>
9            <username>YOUR_GITHUB_USERNAME</username>
10            <password>ghp_YOUR_PERSONAL_ACCESS_TOKEN</password>
11        </server>
12    </servers>
13</settings>

Penting: Ganti YOUR_GITHUB_USERNAME dan ghp_YOUR_PERSONAL_ACCESS_TOKEN dengan kredensial GitHub Anda yang sebenarnya.

Step 2: Tambahkan repository ke pom.xml:

pom.xml - Repository
1<repositories>
2    <repository>
3        <id>github</id>
4        <name>GitHub NoxlyDev Apache Maven Packages</name>
5        <url>https://maven.pkg.github.com/NoxlyDev/NxGate-Library</url>
6    </repository>
7</repositories>

Step 3: Tambahkan dependency NxGate:

pom.xml - Dependency
1<dependencies>
2    <dependency>
3        <groupId>xyz.noxlydev.nxgate</groupId>
4        <artifactId>nxgate</artifactId>
5        <version>1.0.0</version>
6    </dependency>
7</dependencies>

Gradle

Step 1: Konfigurasi file ~/.gradle/gradle.properties:

~/.gradle/gradle.properties
1# File: ~/.gradle/gradle.properties
2gpr.user=YOUR_GITHUB_USERNAME
3gpr.key=ghp_YOUR_PERSONAL_ACCESS_TOKEN

Step 2: Tambahkan repository ke build.gradle:

build.gradle - Repository
1repositories {
2    maven {
3        url = uri("https://maven.pkg.github.com/NoxlyDev/NxGate-Library")
4        credentials {
5            username = project.findProperty("gpr.user") ?: System.getenv("GITHUB_USERNAME")
6            password = project.findProperty("gpr.key") ?: System.getenv("GITHUB_TOKEN")
7        }
8    }
9}

Step 3: Tambahkan dependency:

build.gradle - Dependency
1dependencies {
2    implementation 'xyz.noxlydev.nxgate:nxgate:1.0.0'
3}

Verifikasi Instalasi

Setelah konfigurasi selesai, jalankan command berikut untuk memastikan dependency dapat di-download:

Maven

mvn dependency:resolve

Gradle

gradle dependencies

Langkah Selanjutnya

Setelah instalasi selesai, lanjutkan ke halaman Java Integration untuk mempelajari cara mengintegrasikan NxGate ke plugin Minecraft Anda.