BuiltByBit Integration

When a customer downloads your plugin from BuiltByBit, ILicence automatically generates a license key and BuiltByBit injects it into the JAR. Fully automatic, zero manual work.

How It Works

BuiltByBit supports "External License Key" placeholders. At download time, BuiltByBit calls the ILicence API to get a fresh license key, then injects it into the downloaded JAR before delivering it to the buyer.

1.Customer buys your plugin on BuiltByBit

2.Customer clicks Download

3.BuiltByBit calls ILicence API with buyer info

4.ILicence generates a license key and returns it

5.BuiltByBit injects the key into the JAR via %%__BBB_LICENSE__%%

6.Plugin starts, ILicence SDK verifies the key normally

Key difference with Polymart

With Polymart, the verification happens after download (pull-based). With BuiltByBit, the license is created at download time (push-based). Both approaches are fully automatic for the buyer.

Setup (Step by Step)

Generate a Webhook Secret in ILicence

In your ILicence dashboard, go to Settings. In the BuiltByBit Webhook Secret section, click Generate. Copy the generated secret.

Create your plugin with BuiltByBit URL

Create a plugin in ILicence (or edit an existing one). In the Marketplace Automation section, paste your BuiltByBit resource URL (e.g., https://builtbybit.com/resources/my-plugin.1234).

Configure default license settings

Set the default license type (Permanent or Time Limited), max servers, and duration. These will be used for every license automatically generated from BuiltByBit downloads.

Create the placeholder on BuiltByBit

Go to builtbybit.com/placeholders/ and create a new placeholder:

Placeholder: %%__BBB_LICENSE__%%

Type: External license key

URL: https://ilicence.ch/api/v1/builtbybit/license

Secret: The secret from Step 1

Use the placeholder in your plugin code

In your plugin's Java code, use the BuiltByBit placeholder as the license key:

// BuiltByBit replaces this with a real ILicence key at download

ILicence.verify(this, "%%__BBB_LICENSE__%%", "my-plugin");

Upload your plugin to BuiltByBit

Upload the compiled JAR to BuiltByBit as a premium resource. Every buyer will automatically receive a JAR with a valid ILicence key injected.

What BuiltByBit Sends

When a customer downloads, BuiltByBit sends a POST request to ILicence with:

Field	Description
`builtbybit`	Always "true"
`user_id`	Buyer's BuiltByBit user ID
`resource_id`	Your resource ID on BuiltByBit
`version_id`	Version ID of the download
`version_number`	Semantic version string
`secret`	Your webhook secret (for authentication)

ILicence validates the secret, creates a license, and returns the key as plain text. If something goes wrong, BuiltByBit shows an error message to the buyer asking them to contact you directly.