Install Storefront

Requirements

Requirement	Details
Server	Paper or Folia 26.1 or newer
Java	Java 25
Internet on first start	Storefront downloads its database libraries (HikariCP, SQLite and MySQL drivers) once through the server's library loader.
Vault + economy plugin	Optional. Needed to sell items for money (EssentialsX, CMI, ...).
PlaceholderAPI	Optional. Enables the Storefront placeholders.
Nexo / Oraxen / ItemsAdder	Optional. Sell custom items.

Single server

Place Storefront-1.0.0.jar in the plugins folder.
Start the server once so the default files are created, then stop it.
Paste your license key into license-key in plugins/Storefront/config.yml.
Start the server. The console shows License verified and [Storefront] Ready with the active preset, money and shards status.
Run /shop, buy something cheap, then check /shards and /dailyshop.

Several servers

Set type: mysql under storage: on every server and point them at the same database. Shard balances, the leaderboard and the item shop rotation are then shared, and every server shows the same daily items. Storage changes need a full restart.

Created files

File / folder	Purpose
`config.yml`	License key, currencies, shards, shard arenas, item shop and storage.
`messages.yml`	Every chat message and action bar text.
`presets/donut/`	The classic /shop preset: menu, buy screen, categories and regear.
`daily-presets/fortnite/`	The rotating item shop layout and item pool.
`arenas.yml`	Shard arenas (created by the arena commands).
`daily-seed.txt`	Random seed for this server's item shop rotation. Keep it to keep the same daily items.
`.installation-v2.key`	This server's license identity. Don't delete or copy it.

Default presets are only written once

Storefront never overwrites your presets. To get a fresh default copy, rename or delete the preset folder and restart. regear.yml is added automatically if it is missing.