MineSkin, Cache, and License

How skin generation, cache systems, and license validation currently work.

MineSkin key resolution

ClothesPlus resolves the key in this order:

1. A real key in mineskin.api-key.
2. A bundled testing key if the config is blank or placeholder.
3. Missing/disabled if no key is available.

Placeholders include values such as urapikey, your-api-key, replace-me, changeme, and placeholder.

Use:

/clothes apikey <mineskin-api-key>

The command:

• requires wardrobeclothes.admin
• writes mineskin.api-key
• saves and reloads config.yml
• reloads the MineSkin client immediately
• disables bundled testing keys

Bundled testing keys

Bundled keys are intentionally only for first-boot testing. They can be rate-limited. Production servers should use their own MineSkin key.

Skin caches

shared_cache:
  enabled: true
creator_cache:
  enabled: true
base_skin_cache:
  enabled: true

• shared_cache stores shared clothing combinations and can bypass MineSkin for cache hits.
• creator_cache caches creator previews.
• base_skin_cache stores player-specific base-skin results.

DynamicUV preview avatars reduce MineSkin usage during preview/edit flows. Actual player skin application still needs a signed texture unless a cache hit exists.

Cache commands

/clothes cache status
/clothes cache stop
/clothes cache continue
/clothes cache delete [player]

Permission:

wardrobeclothes.cache

License file

Canonical location:

plugins/ClothesPlus/licensing/clothesplus-license.key

Legacy accepted location:

plugins/ClothesPlus/clothesplus-license.key

If a legacy root key exists, ClothesPlus copies it into the canonical licensing folder.

The old mclicense.txt file is removed on startup because it is no longer used.

License validation timing

After a successful validation:

• next server recheck is scheduled 5 to 6 days later
• the extra delay is deterministic jitter based on license/server identifiers
• cached validation is valid for a 7 day offline grace period
• transient validation-server failures retry after 12 hours

This avoids constant license checks and improves uptime when the license server is temporarily unreachable.