01 — Step-by-Step Installation & License Setup

This guide walks you through installing Lift.jar on your Minecraft server and activating your Krapple License Key.

---

1. Requirements

• Server Software: PaperMC 1.21+ (or Purpur / Pufferfish 1.21+)
• Java Version: Java 21 or newer
• Optional Dependency: PlaceholderAPI (if you want %player_name% and other placeholders inside chat/join messages)
• Network Access: Outbound HTTPS connection to https://api.krapple.studio for license verification

---

2. Step-by-Step Installation

Step 1: Drop Lift.jar into plugins/

1. Copy Lift.jar into your server's plugins/ folder:

   your-server/
   └── plugins/
       └── Lift.jar

2. Start (or restart) your server once.

Step 2: First Boot (license.yml Generated)

On the very first boot, Lift creates the plugins/Lift/ folder and generates only license.yml:

plugins/Lift/
└── license.yml       # Paste your Krapple License Key here first

Note: Until a valid license key is added and verified, Lift safely disables itself (leaving your server running) and does not generate any other .yml or .json files.

---

Step 3: Paste Your Krapple License Key in license.yml

Open plugins/Lift/license.yml and paste your license key:

# ==============================================================================
#  Lift - License Configuration
#  by Krapple Studio
# ==============================================================================
# Paste your Krapple License Key below and restart the server.
# Other plugin files (config.yml, gates.yml, lifts.yml, regions.yml, holograms.json)
# will be generated automatically once your license is verified.
license-key: "KRP-XXXXX-XXXXX-XXXXX-XXXXX-XXXXXX"

(Alternative options: plugins/Lift/license.txt, JVM flag -Dlift.license=..., or environment variable KRAPPLE_LICENSE_KEY=...)

---

Step 4: Restart the Server (Verifies License & Generates Remaining Files)

Restart your server. Once your license verifies, Lift starts and automatically generates the remaining configuration and data files:

plugins/Lift/
├── license.yml       # Verified license key
├── config.yml        # Main configuration (AFK, messages, chat, spawn, join items, GUI)
├── gates.yml         # Saved animated gates
├── lifts.yml         # Saved elevator platforms
├── regions.yml       # Saved teleport regions
└── holograms.json    # Saved 3D interactive call holograms

Console output on successful verification:

[Lift]   _      _____ ______ _______ 
[Lift]  | |    |_   _|  ____|__   __|
[Lift]  | |      | | | |__     | |   
[Lift]  | |      | | |  __|    | |   
[Lift]  | |____ _| |_| |       | |   
[Lift]  |______|_____|_|       |_|   
[Lift] By Krapple Studios
[Lift] Verification: OK — node authorized.
[Lift] Lift v1.0 (Unified Lift, Essentials & Prot) enabled successfully!

---

3. Troubleshooting License Errors

If verification fails, the plugin logs a status code in the console and disables itself without stopping the server:

Status	Meaning & Solution
INVALID	Either no key was entered (PUT-YOUR-LICENSE-KEY-HERE was left in license.yml) or the key has a typo. Double-check your key in plugins/Lift/license.yml.
HWID_MISMATCH	Your license key is bound to a different machine/node. Request an HWID reset from Krapple support or your license panel.
EXPIRED	Your license subscription has expired. Renew your license to re-enable the plugin.
SUSPENDED / REVOKED	The license has been suspended or revoked by an administrator.
UNREACHABLE	Your server could not reach https://api.krapple.studio. Check your server firewall/DNS settings.