Auto-Update Integration | Ulises Licenses

Section 05 / Distribution Lifecycle

Automated Binary Update & Integrity Verification

UlisesLib includes built-in methods for checking updates, downloading the latest jar, and verifying its integrity. All security validations (license status, HWID binding, IP limits) are handled automatically by the library.

boolean checkForUpdate(String productId, String licenseKey, String currentVersion)

Checks if a newer version of the product jar is available. Returns true if an update exists.

Invocation Example

Java

1String currentVersion = "1.0.0";2if (ulib.checkForUpdate(productId, licenseKey, currentVersion)) {3    getLogger().info("Update available! Downloading...");4    ulib.downloadUpdate(productId, licenseKey, hwid);5}

File downloadUpdate(String productId, String licenseKey, String hwid)

Downloads the latest jar file. Automatically handles HWID binding on first download. Returns the downloaded File, or null if download fails.

Invocation Example

Java

1String hwid = ulib._getHwid();2File updatedJar = ulib.downloadUpdate(productId, licenseKey, hwid);3if (updatedJar != null) {4    getLogger().info("Update downloaded: " + updatedJar.getName());5    if (ulib.verifyChecksum(productId, licenseKey, hwid, updatedJar)) {6        getLogger().info("Checksum verified!");7    }8}

boolean verifyChecksum(String productId, String licenseKey, String hwid, File jarFile)

Verifies the SHA-256 checksum of the downloaded jar file to ensure file integrity.

Invocation Example

Java

1File jarFile = new File("plugins/MyPlugin.jar");2boolean valid = ulib.verifyChecksum(productId, licenseKey, hwid, jarFile);3if (!valid) {4    getLogger().warning("Checksum mismatch! File may be corrupted.");5}

String getCurrentVersion(String productId, String licenseKey)

Returns the latest version string of the product jar available on the server.

Invocation Example

Java

1String latestVersion = ulib.getCurrentVersion(productId, licenseKey);2getLogger().info("Latest version available: " + latestVersion);

Automated Pre-Download Assertions

Each update payload download verifies the following conditions prior to file release:

License Status: Only active, non-expired licenses can download updates
HWID Binding: Hardware ID is validated and bound to the license on first download
IP Limit: Respects the IP limit configured per license

Complete Auto-Update Implementation Routine

checkAndApplyUpdate.java

Java

1private void checkAndApplyUpdate(String productId, String licenseKey) {2    String currentVersion = this.getDescription().getVersion();3    String hwid = ulib.getHardwareId();4 5    if (ulib.checkForUpdate(productId, licenseKey, currentVersion)) {6        String latestVersion = ulib.getCurrentVersion(productId, licenseKey);7        getLogger().info("New version available: " + latestVersion + " (current: " + currentVersion + ")");8 9        File updatedJar = ulib.downloadUpdate(productId, licenseKey, hwid);10        if (updatedJar != null) {11            if (ulib.verifyChecksum(productId, licenseKey, hwid, updatedJar)) {12                getLogger().info("Update downloaded and verified successfully!");13                getLogger().info("Restart the server to apply the update.");14            } else {15                getLogger().warning("Checksum verification failed. Update may be corrupted.");16            }17        }18    } else {19        getLogger().info("Plugin is up to date.");20    }21}

PREVIOUS MODULE← Connection Management NEXT MODULEBest Practices →

Built by Ulises - Citymoon Dynamics

1String currentVersion = "1.0.0";2if (ulib.checkForUpdate(productId, licenseKey, currentVersion)) {3 getLogger().info("Update available! Downloading...");4 ulib.downloadUpdate(productId, licenseKey, hwid);5}

1String hwid = ulib._getHwid();2File updatedJar = ulib.downloadUpdate(productId, licenseKey, hwid);3if (updatedJar != null) {4 getLogger().info("Update downloaded: " + updatedJar.getName());5 if (ulib.verifyChecksum(productId, licenseKey, hwid, updatedJar)) {6 getLogger().info("Checksum verified!");7 }8}

1File jarFile = new File("plugins/MyPlugin.jar");2boolean valid = ulib.verifyChecksum(productId, licenseKey, hwid, jarFile);3if (!valid) {4 getLogger().warning("Checksum mismatch! File may be corrupted.");5}

1private void checkAndApplyUpdate(String productId, String licenseKey) {2 String currentVersion = this.getDescription().getVersion();3 String hwid = ulib.getHardwareId();4 5 if (ulib.checkForUpdate(productId, licenseKey, currentVersion)) {6 String latestVersion = ulib.getCurrentVersion(productId, licenseKey);7 getLogger().info("New version available: " + latestVersion + " (current: " + currentVersion + ")");8 9 File updatedJar = ulib.downloadUpdate(productId, licenseKey, hwid);10 if (updatedJar != null) {11 if (ulib.verifyChecksum(productId, licenseKey, hwid, updatedJar)) {12 getLogger().info("Update downloaded and verified successfully!");13 getLogger().info("Restart the server to apply the update.");14 } else {15 getLogger().warning("Checksum verification failed. Update may be corrupted.");16 }17 }18 } else {19 getLogger().info("Plugin is up to date.");20 }21}