Ulises LicensesUlises Licenses
FeaturesPricingAPIAnnouncements
Solutions
Java & Kotlin LicensingMinecraft Plugin LicensingChoosing LicensingBuiltByBit IntegrationPolymart Integration
Discord
Dashboard
  • Overview
Using the SDK
  • Installation
  • Plugin Integration
  • Complete Example
  • API Methods
  • Connection Management
  • Auto-Update
  • Best Practices
Using the Endpoint
  • Endpoint Overview
  • Validate a License
  • Public Signing Key
  • Verify the Response
  • Endpoint Best Practices
  1. Docs
  2. /
  3. Best Practices

Integration Best Practices & Anti-Patterns

Recommended Implementation Architecture
  • Use infinite retry loops for connection issues
  • Display detailed license information on successful validation
  • Implement periodic checks (every 10 minutes)
  • Create configuration file with default values
Unsafe & Prohibited Integration Patterns
  • Disabling plugin on connection timeout
  • Hardcoding credentials in source code
  • Exposing error details to end users
  • Running validation on main thread

Best practices questions

Should my plugin disable itself when verification times out?

No. NETWORK_ERROR, TIMEOUT, SERVER_ERROR and similar codes are transient: retry with backoff. Disable only on definitive rejections, or after several consecutive definitive failures in periodic checks.

Can license checks run on the main thread?

Never. Verify asynchronously on startup and re-check every 10 minutes off the main thread.

What is safe to log about licenses?

Detailed license info on success is fine. Never log license keys, HWIDs, or URLs, and never expose error details to end users.

PreviousAuto-UpdateNextEndpoint Overview

Built by Ulises - Citymoon Dynamics

Ulises LicensesUlises Licenses

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
  • Endpoint Overview
  • Validate a License
  • Public Signing Key
  • Verify the Response
  • Endpoint Best Practices

History

  • Announcements
  • Citymoon Dynamics

Company

  • About
  • Security
  • Status
  • Contact

Solutions

  • Java & Kotlin
  • Minecraft Plugins
  • Choosing Licensing
  • BuiltByBit
  • Polymart

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