Installation
Get AlphaSell running, and update it without losing player progress.
On this page
Requirements
| What | Needed | Notes |
|---|---|---|
| Server software | Paper or Folia | Folia support is declared. |
| Minecraft | 1.21.11 or newer | Jars are built per Minecraft version, see Choose the right jar. |
| Java | 21 or 25 | 1.21.x servers use Java 21. 26.x servers use Java 25. |
| Vault + an economy plugin | To pay players | Without a provider, payouts are paused until one registers. |
| Network | Outgoing HTTPS | Needed for server approval. |
| ShopGUIPlus, EconomyShopGUI | Optional | For shop-driven prices. See Pricing. |
Choose the right jar
Jars are built per Minecraft version, and the file name tells you which one:
AlphaSell-<version>-mc-<minecraft>-java<java>.jar
AlphaSell-2.1.0-mc-1.21.11-java21.jar
AlphaSell-2.1.0-mc-26.2-java25.jar
Use the jar whose mc- part matches your server. A jar built for 26.x is compiled for Java 25 and will not load on Java 21.
Install
- Stop the server and put the jar in
plugins/, with Vault and your economy plugin. - Start it. The plugin creates
plugins/AlphaSell/withconfig.yml,tools-config.ymlandlang/. - Get approved. A new server is pending and the plugin stays off. The console prints your server id. Send it to AlphaStudio, wait for approval and restart. See Server approval.
- Test a sale. Run
/sell, put an item in, and press the sell button.
Update
- Back up
plugins/AlphaSell/.storage/holds every player's category progress and sell history when you use the default storage. - Replace the jar and restart.
/alphasell reloadnever loads a new jar. - Check the lang files. If a lang file has a newer
lang-version, yours is saved as*.oldand the new one replaces it. The console says when that happens. Config files you edited are not rewritten.
Upgrading from 1.x: license keys no longer exist. 2.0.0 needs the server to be approved in the AlphaStudio panel, and an unapproved server will not run the plugin. Read Server approval before updating a live server.
A
config.yml written by the first release can still carry a gold theme. It is ignored, and the loader warns. Set your accent under theme if you want to change it.