Bringing Your Server Economy to the Web with HyperConomy Web
Managing a thriving Minecraft server economy often means players need to check prices, stock levels, and market trends before they even log in. HyperConomy Web bridges that gap by generating a clean, accessible web page that mirrors your in-game HyperConomy shops. Whether you run a survival, towny, or roleplay server, this plugin gives your community a real-time window into the virtual marketplace, all without complex configuration.
What Exactly Does HyperConomy Web Do?
HyperConomy Web is a companion plugin for the popular HyperConomy economy system. Once both are installed, it automatically creates a web-based dashboard that lists every shop on your server. Players can click on any shop name to dive into a detailed view showing available items, current buy and sell prices, remaining stock, and even a price history graph if you have that feature enabled. The entire interface is customizable—you can tweak colors, fonts, and font sizes to match your server’s branding or simply make the data easier to read.
One of the smartest design choices here is the separation of the web server from the main HyperConomy plugin. Earlier versions bundled everything together, which meant every HyperConomy update required restarting the web component. Now, HyperConomy Web runs independently on any port you choose, saving bandwidth and reducing the need for frequent updates. It’s a lightweight, set-and-forget solution that just works.
Installation and First Steps
Getting started is refreshingly straightforward. There’s no complicated setup wizard or external database to configure. Simply drop the HyperConomy Web jar file into your server’s plugins folder alongside HyperConomy version .974 or later. Make sure you’ve already created at least one shop in HyperConomy—otherwise the web page will be empty. Once both plugins are running, the web interface becomes available at your server’s IP address or domain name, followed by the port specified in the config.yml file. By default, that port is 7777, so if your server IP is 888.777.666.555, you’d type 888.777.666.555:7777 into any browser to see the shop list.
For server administrators who prefer a streamlined setup, the foxygame.net launcher offers a flexible way to manage plugins and mods directly from its menu, making it simple to add HyperConomy Web alongside your other server tools. This modern launcher eliminates the hassle of manual file transfers, letting you focus on fine-tuning your economy rather than wrestling with FTP clients.
Customizing the Look and Feel
Out of the box, the web page uses a neutral, readable design, but you have full control over its appearance through in-game commands. Every visual element can be recolored using hexadecimal color codes, and you can even change the font family and size. This means you can match the page to your server’s website, forum, or Discord theme effortlessly. The following commands are available to any player with the hyperconomy.admin permission:
- /hcweb background [hex code] – Sets the overall background color.
- /hcweb tabledata [hex code] – Changes the color of the table cells containing item information.
- /hcweb fontcolor [hex code] – Adjusts the text color across the page.
- /hcweb border [hex code] – Modifies the border color around tables and sections.
- /hcweb header [hex code] – Sets the color of table headers.
- /hcweb increase [hex code] – Defines the background highlight when a price has risen.
- /hcweb decrease [hex code] – Defines the background highlight when a price has dropped.
- /hcweb font [font name] – Chooses an HTML font family (e.g., Arial, Verdana).
- /hcweb fontsize [size] – Sets the base font size in pixels.
- /hcweb port [number] – Changes the port the web server listens on.
If you ever want to revert to the original default settings, the /hcweb setdefault command instantly resets everything. There’s also a /hcweb refresh command to restart the web server manually, which can be handy after making bulk changes or if you suspect a temporary glitch.
Managing the Web Server
Beyond aesthetics, you have full control over the web server’s state. The /hcweb enable and /hcweb disable commands let you turn the page on or off without removing the plugin. This is useful during maintenance or when you want to temporarily hide shop data. Checking the current status is as simple as running /hcweb status, which tells you whether the server is running and on which port.
All these administrative commands require the hyperconomy.admin permission node. You can grant this to trusted staff members through your permissions plugin (like LuckPerms) to delegate web page management without giving full operator status.
What You Need to Run It
HyperConomy Web has minimal dependencies. The only hard requirement is HyperConomy version .974 or newer. If you’re using an older HyperConomy build that still had the web server embedded, you’ll need to update the main plugin first. Also, remember that the web page will display nothing unless you’ve actually created shops within HyperConomy. The plugin reads existing shop data, so setting up your in-game economy comes first.
For those who like to test cutting-edge features, development builds are available through the project’s continuous integration server. These builds haven’t been reviewed by official BukkitDev staff, so use them cautiously and always back up your server before trying them out.
Why HyperConomy Web Matters for Your Server
In a multiplayer environment, transparency builds trust. When players can see real-time stock and pricing outside the game, they make smarter trading decisions and feel more connected to the server’s economy. Shop owners can monitor their competitors, and new players can browse available goods before they even join, which can be a powerful recruitment tool if you share the link on your website or social media.
The plugin’s lightweight nature also means it won’t bog down your server’s performance. Since the web server runs on its own port and only serves static-looking (but dynamically generated) pages, the impact on TPS is negligible. You can even host the web page on a different machine by pointing the port through a proxy, though that’s entirely optional.
Final Thoughts
HyperConomy Web takes an already robust economy plugin and extends its reach beyond the Minecraft client. The zero-configuration startup, combined with deep visual customization and straightforward commands, makes it accessible even to server admins who aren’t web developers. Whether you’re running a small community server or a large network, giving your players a browser-based view of the economy adds a layer of professionalism and convenience that’s hard to beat. Drop it into your plugins folder, set your colors, and let your shops shine online.