Ulises Licenses | Ulises SoftwareUlises Licenses
FeaturesPricingAPIAnnouncements
Solutions
Java & Kotlin LicensingMinecraft Plugin LicensingBuiltByBit IntegrationPolymart Integration
Discord
Dashboard
  • Overview
  • Installation
  • Plugin Integration
  • Complete Example
  • API Methods
  • Connection Management
  • Auto-Update
  • Best Practices
  1. Docs
  2. /
  3. Connection Management

Backend Connectivity & Fault Tolerance

Automatic Reconnection

The library retries transient failures automatically before giving up

  • Built-in Retry: On network errors, timeouts, or 5xx responses, verifyLicense retries up to 5 times with backoff and reports NETWORK_ERROR, TIMEOUT, or SERVER_ERROR only if all attempts fail
  • Clear Codes: Use getLastErrorCode() to tell transient failures (NETWORK_ERROR, TIMEOUT, SERVER_ERROR, MAX_RETRIES) apart from definitive rejections (LICENSE_ERROR, HWID_MISMATCH, PRODUCT_MISMATCH)
  • Graceful Handling: Only disable the plugin for definitive rejections, or after several consecutive definitive failures in periodic checks. Never disable on a single transient error
NOTICE: Important Note for Plugin Developers
Your plugin should continue running normally during connection issues. Only disable the plugin when there are actual license validation failures (expired, revoked, invalid). Connection problems should trigger retry attempts, not immediate shutdown. Never log license keys, HWIDs, or URLs to the console.
PREVIOUS MODULE← API MethodsNEXT MODULEAuto-Update →

Built by Ulises - Citymoon Dynamics

Ulises Licenses | Ulises SoftwareUlises Licenses | Ulises Software

License management for Minecraft plugins and Java applications.

Discord

Legal

  • Terms of Service
  • Privacy Policy
  • Refund Policy
  • DPA

Docs

  • Overview
  • Installation
  • Plugin Integration
  • Complete Example
  • API Methods
  • Connection Management
  • Auto-Update
  • Best Practices

History

  • Announcements
  • Citymoon Dynamics

Company

  • About
  • Security
  • Status
  • Contact

Solutions

  • Java & Kotlin
  • Minecraft Plugins
  • BuiltByBit
  • Polymart

© 2025-2030 Citymoon Dynamics (citymoon.org). All rights reserved.