Plugin Installation

The FluxStore plugin runs on your Minecraft server and maintains a WebSocket connection to the FluxStore platform. It executes commands instantly when customers make purchases.

Supported Platforms

Platform Feature Matrix

All platforms deliver purchase commands instantly, react to player joins, and support the loyalty points command and join balance reminder. The remaining gaps are ecosystem limits: inventory GUIs and PlaceholderAPI only exist on Bukkit, and there is no Votifier implementation for Fabric/Forge servers.

A few notes on the differences:

• Permissions. Spigot/Paper and the proxies use permission nodes (fluxstore.points.give, etc.). Fabric/Forge/NeoForge have no node system, so viewing another player’s balance and giving points require vanilla permission level 2 (op), and the admin commands require level 4. On proxies, viewing your own balance is open to everyone since proxies have no default-true permission concept.
• Vote rewards. Spigot/Paper listens for Votifier votes; BungeeCord and Velocity listen for NuVotifier votes on the proxy. There is no Votifier implementation for Fabric/Forge servers, so vote rewards there must go through the REST vote-reward endpoint.
• Inventory slot conditions. Proxies can’t see player inventories, so the slot check is skipped there and the command runs regardless.
• Proxy command execution. BungeeCord and Velocity execute commands on the proxy console, which is useful for network-wide plugins (e.g. proxy-side permissions), not for giving in-game items.

If a feature you need is missing on your platform, the plugin is open source. See the Plugin Protocol to extend it or build your own.

Installation

1. Download the build for your platform from Servers in your store dashboard (click Download Plugin)
2. Place the jar in your server’s plugins/ folder (Spigot/Paper, BungeeCord, Velocity) or mods/ folder (Fabric, Forge, NeoForge)
3. Start (or restart) your server. The plugin generates its configuration file on first launch.
4. Run /fluxstore setup <server-key> in-game or from the console, using the server key shown when you created the server in your dashboard. The plugin saves the key and connects immediately, no restart needed.

Alternatively, paste the key into the config file by hand and restart:

See Server Setup for how to create a server and get its key.

Verifying the Connection

After installation, check two things:

1. Console: look for a successful connection message from the FluxStore plugin in your server console output. If you see an error, refer to Troubleshooting. You can also run /fluxstore info to see the connection status and mode.
2. Dashboard: navigate to Servers in your store dashboard. Your server should show a green Online status indicator.

Updating

To update the plugin:

1. Download the latest version from Servers in your dashboard
2. Stop your server, replace the old jar with the new one, and restart

Your configuration is preserved across updates. You don’t need to reconfigure the server key unless the update notes say otherwise.

Next Steps

• Server Setup: add servers and manage server keys in the dashboard
• Troubleshooting: resolve common installation and connection issues
• Plugin Protocol: build a custom plugin for unsupported platforms