StrawAuction · Guide · StrawIO Docs

Browse, list, buy and recover auction items.

Before you install

Java 21.
Paper / Folia 1.21.11 — the baseline named in this plugin's setup notes. Check version compatibility before choosing a newer version.
Economy-dependent features use Vault and a registered economy provider. Missing provider disables financial actions only; uncertain outcomes require reconciliation.

01Install the plugin

Stop your server before adding or replacing a plugin JAR. Back up existing plugin data when updating.
Place StrawAuction-1.0.0.jar in the server's plugins/ folder. Install only one variant of this product.
Install the required dependencies listed above, then start the server once.

02Add your license key

Open StrawIO Panel to view and manage your product license. Copy the key for StrawAuction.

Stop the server and open plugins/StrawAuction/license.yml. Paste the key into the existing top-level key value; do not add an extra license: section.

SERVER File location

plugins/StrawAuction

config.yml
gui/
lang/
license.yml← Open this file
presentation.yml
sounds.yml
storage.yml

plugins/StrawAuction/license.yml

key: "YOUR-KEY-HERE"

What to change

←
Line 1
Paste your product license key between the quotes.

Example values — replace them with your own.

Save the file. Keep your real key private; do not include it in support screenshots. GUI and language defaults may appear after successful activation.

03Choose storage

NOTE
Shared storage is implemented, but this package does not establish live multi-server validation. Test your network before using it for player data.

For one server, leave mode: single in storage.yml. The supplied SQLite setup works without MySQL credentials.

For shared network data, choose mode: multi, fill in the MySQL connection fields, and use a different server-id on every server. Configure this before accepting player data.

plugins/StrawAuction/storage.yml

mode: multi
multi:
  type: mysql
  host: "YOUR-DATABASE-HOST"
  port: 3306
  database: "YOUR-DATABASE"
  username: "YOUR-USER"
  password: "YOUR-PASSWORD"
  server-id: "UNIQUE-SERVER-ID"

What to change

←
Line 1
Use multi only when configuring shared storage.
←
Line 4
Enter the host supplied by your database provider.
←
Line 8
Keep database credentials private.
←
Line 9
Choose a different ID for each server.

Example values — replace them with your own.

NOTE
Updating an existing installation? Storage settings already present in config.yml take precedence. Compare them before moving settings; do not accidentally switch databases.

Full storage reference. Back up existing data before changing storage mode.

04Review the essentials

Language: language: en in config.yml; message files are under lang/.

Browse configuration when you need the complete reference.

05Start and verify

Start the server and check its console for activation or dependency errors.
Join the server and run /ah — Browse, list, buy and recover auction items..
Run /strawauction help to check the available commands.

If an action is unavailable, check the permission reference before changing operator access.

Reloading and common setup mistakes

After ordinary settings edits, use /strawauction reload.
Restart for JAR replacement.
If activation fails, check that the saved key belongs to this product in Panel.
Keep existing data and customized configuration when upgrading; read the upgrade guide.

Need help? Join Discord.