Developer Documentation

UlisesLib Integration

Protect your Java applications with license validation

UlisesLib.jar [October 30, 2025]

Add the UlisesLib library to your Java project to enable license validation.

Download UlisesLib.jar

Quick Start Guide

1. Add UlisesLib to your project

Place UlisesLib.jar in your project's libraries folder and add it to your build path.

2. Import the library

import pro.ulises.licenses.*;

3. Validate licenses

UlisesLib ulib = new UlisesLib();
String productId = "your-product-id-here";
String licenseKey = "user-license-key-here";

// Method 1: Simple validation (boolean)
if (ulib.isLicenseValid(productId, licenseKey)) {
    System.out.println("✓ License valid!");
} else {
    System.out.println("✗ License invalid!");
}

// Method 2: Detailed validation (with data)
UlisesLib.LicenseResponse response = ulib.verifyLicense(productId, licenseKey);
if (response.isSuccess()) {
    UlisesLib.LicenseData data = response.getData();
    UlisesLib.LicenseInfo license = data.getLicense();
    
    // Access license details
    String discordId = license.getDiscordId();
    String status = license.getStatus();
    
    System.out.println("License valid for: " + discordId);
} else {
    System.out.println("Error: " + response.getMessage());
}

Product ID Configuration

You have two options for handling the Product ID in your application:

Hardcode Product ID

Embed the Product ID directly in your code. Users only need to provide their license key.

String productId = "67890abcdef12345";

Simpler for end users

User-Provided Product ID

Let users provide both Product ID and license key. More flexible for multiple products.

String productId = config.getString("product-id");

More flexible configuration

Important Note

Product IDs are visible in the dashboard under "Products" section. Users can request their Product ID from you if needed.

Complete Implementation Example

Here's a complete example showing license validation with configuration file support and detailed data access:

public class YourApplication {
    private String licensedDiscordId;
    private String licenseStatus;
    
    public void enable() {
        // Load configuration from antileak.yml
        FileConfiguration config = loadAntileakConfig();
        
        // Get credentials from config
        String productId = config.getString("license.product-id", "");
        String licenseKey = config.getString("license.key", "");
        
        // Validate license with detailed response
        UlisesLib ulib = new UlisesLib();
        UlisesLib.LicenseResponse response = ulib.verifyLicense(productId, licenseKey);
        
        if (response.isSuccess()) {
            System.out.println("✓ License valid!");
            
            // Extract license data
            UlisesLib.LicenseData data = response.getData();
            UlisesLib.LicenseInfo licenseInfo = data.getLicense();
            UlisesLib.ProductInfo productInfo = data.getProduct();
            
            // Store license information
            this.licensedDiscordId = licenseInfo.getDiscordId();
            this.licenseStatus = licenseInfo.getStatus();
            
            // Display license information
            System.out.println("Initializing...");
            System.out.println("License Status: " + licenseStatus);
            System.out.println("Discord ID: " + licensedDiscordId);
            
            // Continue with your application logic
            initializeFeatures();
            
        } else {
            System.out.println("✗ License invalid! Reason: " + response.getMessage());
            System.out.println("Please check your credentials.");
            
            // Disable application
            disableApplication();
        }
    }
    
    private FileConfiguration loadAntileakConfig() {
        File configFile = new File(getDataFolder(), "antileak.yml");
        
        // Create config if it doesn't exist
        if (!configFile.exists()) {
            try {
                configFile.createNewFile();
                FileConfiguration config = YamlConfiguration.loadConfiguration(configFile);
                config.set("license.product-id", "your-product-id-here");
                config.set("license.key", "your-license-key-here");
                config.save(configFile);
                System.out.println("Created new antileak.yml configuration file");
            } catch (IOException e) {
                System.out.println("Failed to create antileak.yml: " + e.getMessage());
            }
        }
        
        return YamlConfiguration.loadConfiguration(configFile);
    }
    
}

Configuration File Example

Example antileak.yml configuration file for your users:

# antileak.yml
license:
  product-id: "your-product-id-here"
  key: "your-license-key-here"

Configuration Note

The configuration file will be automatically created with default values if it doesn't exist. Users should replace the placeholder values with their actual Product ID and License Key.

API Reference

boolean isLicenseValid(String productId, String licenseKey)

Simple validation method that returns a boolean. Use this when you only need to check if a license is valid.

Parameters:

productId - The unique identifier for your product (24-character hex string)
licenseKey - The user's license key (format: XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-discordid)

Returns:true if valid, false if invalid/expired/revoked

LicenseResponse verifyLicense(String productId, String licenseKey)

Detailed validation method that returns complete license information. Use this when you need access to license details.

Parameters:

productId - The unique identifier for your product
licenseKey - The user's license key

Returns:LicenseResponse object containing validation result and license data

Response Objects

LicenseResponse

boolean isSuccess() - Whether the validation was successful
String getMessage() - Success or error message
LicenseData getData() - Detailed license data (null if failed)

LicenseData

ProductInfo getProduct() - Product information
LicenseInfo getLicense() - License information

ProductInfo

String getId() - Product ID
String getName() - Product name
String getDescription() - Product description

LicenseInfo

String getDiscordId() - Discord ID of license owner
String getLicenseKey() - The license key
String getIssuedBy() - Who issued the license
String getExpiresAt() - Expiration date (ISO format)
String getStatus() - License status (active/revoked/expired)

String getLastError()

Returns the last error message if validation failed. Useful for debugging connection or validation issues.

Need help? Contact support or visit the dashboard

Developer Documentation

UlisesLib Integration

Protect your Java applications with license validation

UlisesLib.jar [October 30, 2025]

Add the UlisesLib library to your Java project to enable license validation.

Download UlisesLib.jar

Quick Start Guide

1. Add UlisesLib to your project

Place UlisesLib.jar in your project's libraries folder and add it to your build path.

2. Import the library

import pro.ulises.licenses.*;

3. Validate licenses

UlisesLib ulib = new UlisesLib();
String productId = "your-product-id-here";
String licenseKey = "user-license-key-here";

// Method 1: Simple validation (boolean)
if (ulib.isLicenseValid(productId, licenseKey)) {
    System.out.println("✓ License valid!");
} else {
    System.out.println("✗ License invalid!");
}

// Method 2: Detailed validation (with data)
UlisesLib.LicenseResponse response = ulib.verifyLicense(productId, licenseKey);
if (response.isSuccess()) {
    UlisesLib.LicenseData data = response.getData();
    UlisesLib.LicenseInfo license = data.getLicense();
    
    // Access license details
    String discordId = license.getDiscordId();
    String status = license.getStatus();
    
    System.out.println("License valid for: " + discordId);
} else {
    System.out.println("Error: " + response.getMessage());
}

Product ID Configuration

You have two options for handling the Product ID in your application:

Hardcode Product ID

Embed the Product ID directly in your code. Users only need to provide their license key.

String productId = "67890abcdef12345";

Simpler for end users

User-Provided Product ID

Let users provide both Product ID and license key. More flexible for multiple products.

String productId = config.getString("product-id");

More flexible configuration

Important Note

Product IDs are visible in the dashboard under "Products" section. Users can request their Product ID from you if needed.

Complete Implementation Example

Here's a complete example showing license validation with configuration file support and detailed data access:

public class YourApplication {
    private String licensedDiscordId;
    private String licenseStatus;
    
    public void enable() {
        // Load configuration from antileak.yml
        FileConfiguration config = loadAntileakConfig();
        
        // Get credentials from config
        String productId = config.getString("license.product-id", "");
        String licenseKey = config.getString("license.key", "");
        
        // Validate license with detailed response
        UlisesLib ulib = new UlisesLib();
        UlisesLib.LicenseResponse response = ulib.verifyLicense(productId, licenseKey);
        
        if (response.isSuccess()) {
            System.out.println("✓ License valid!");
            
            // Extract license data
            UlisesLib.LicenseData data = response.getData();
            UlisesLib.LicenseInfo licenseInfo = data.getLicense();
            UlisesLib.ProductInfo productInfo = data.getProduct();
            
            // Store license information
            this.licensedDiscordId = licenseInfo.getDiscordId();
            this.licenseStatus = licenseInfo.getStatus();
            
            // Display license information
            System.out.println("Initializing...");
            System.out.println("License Status: " + licenseStatus);
            System.out.println("Discord ID: " + licensedDiscordId);
            
            // Continue with your application logic
            initializeFeatures();
            
        } else {
            System.out.println("✗ License invalid! Reason: " + response.getMessage());
            System.out.println("Please check your credentials.");
            
            // Disable application
            disableApplication();
        }
    }
    
    private FileConfiguration loadAntileakConfig() {
        File configFile = new File(getDataFolder(), "antileak.yml");
        
        // Create config if it doesn't exist
        if (!configFile.exists()) {
            try {
                configFile.createNewFile();
                FileConfiguration config = YamlConfiguration.loadConfiguration(configFile);
                config.set("license.product-id", "your-product-id-here");
                config.set("license.key", "your-license-key-here");
                config.save(configFile);
                System.out.println("Created new antileak.yml configuration file");
            } catch (IOException e) {
                System.out.println("Failed to create antileak.yml: " + e.getMessage());
            }
        }
        
        return YamlConfiguration.loadConfiguration(configFile);
    }
    
}

Configuration File Example

Example antileak.yml configuration file for your users:

# antileak.yml
license:
  product-id: "your-product-id-here"
  key: "your-license-key-here"

Configuration Note

The configuration file will be automatically created with default values if it doesn't exist. Users should replace the placeholder values with their actual Product ID and License Key.

API Reference

boolean isLicenseValid(String productId, String licenseKey)

Simple validation method that returns a boolean. Use this when you only need to check if a license is valid.

Parameters:

productId - The unique identifier for your product (24-character hex string)
licenseKey - The user's license key (format: XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-discordid)

Returns:true if valid, false if invalid/expired/revoked

LicenseResponse verifyLicense(String productId, String licenseKey)

Detailed validation method that returns complete license information. Use this when you need access to license details.

Parameters:

productId - The unique identifier for your product
licenseKey - The user's license key

Returns:LicenseResponse object containing validation result and license data

Response Objects

LicenseResponse

boolean isSuccess() - Whether the validation was successful
String getMessage() - Success or error message
LicenseData getData() - Detailed license data (null if failed)

LicenseData

ProductInfo getProduct() - Product information
LicenseInfo getLicense() - License information

ProductInfo

String getId() - Product ID
String getName() - Product name
String getDescription() - Product description

LicenseInfo

String getDiscordId() - Discord ID of license owner
String getLicenseKey() - The license key
String getIssuedBy() - Who issued the license
String getExpiresAt() - Expiration date (ISO format)
String getStatus() - License status (active/revoked/expired)

String getLastError()

Returns the last error message if validation failed. Useful for debugging connection or validation issues.

Need help? Contact support or visit the dashboard