How buyers get their key
Inserted into the download, verified on first start
Code changes needed
The standard license check
A customer buys your premium resource on Voxel Shop (Polymart) and downloads it.
Voxel Shop inserts its placeholders into the download file for that buyer.
When the plugin enables for the first time, MC License verifies the purchase against Voxel Shop's API using your API key.
If the purchase checks out, it becomes a managed MC License license with your plugin's default settings. If not, validation is rejected.
From then on you can edit, disable, or revoke the license from your dashboard like any other.
Create a plugin in the MC License dashboard using your Voxel Shop (Polymart) resource URL.
Add your Voxel Shop (Polymart) API key on the Keys page of the dashboard.
Step-by-step screenshots are in the Voxel Shop (Polymart) setup guide.
Marketplace automation doesn't need any Voxel Shop-specific code. Add the library and validate on enable, exactly as you would for any plugin.
1. Add the library
<repository>
<id>flyte-repository-releases</id>
<url>https://repo.flyte.gg/releases</url>
</repository>
<dependency>
<groupId>org.mclicense</groupId>
<artifactId>library</artifactId>
<version>1.5.1</version>
<scope>compile</scope>
</dependency>2. Validate in onEnable
@Override
public void onEnable() {
if (!MCLicense.validateKey(this, "yourPluginId")) {
Bukkit.getPluginManager().disablePlugin(this);
return;
}
// Licensed: load the rest of your plugin as normal
}3. Your customer pastes their key into the mclicense.txt file the library creates. On BuiltByBit and Voxel Shop it's already in the jar they download.
Automation issues licenses for legitimate purchases, which is almost all of them. Refunds and chargebacks don't disable a license automatically, and moving a key to a different buyer is still a manual edit. Both take one click from your dashboard. Read how marketplace automation works for the full picture.
No. Voxel Shop inserts the details into the download, and the plugin validates on first start without the buyer doing anything.
On first start, MC License checks the purchase against Voxel Shop's API with your API key. A download that fails that ownership check is rejected, and the validation shows up with an invalid_polymart status.
Yes. Polymart is now Voxel Shop, and the MC License integration works with resources listed there.
No. The integration in your plugin is the standard MC License license check, exactly the same as for any other plugin.
Stop generating keys by hand
Create an account, link your Voxel Shop store, and let every sale license itself.
Sell somewhere else too?