McQuery
Minecraft is a game of endless possibilities, but sometimes you need to peek behind the curtain and access raw data about your world. Whether you are a server admin, a plugin developer, or just a curious tinkerer, McQuery opens up a whole new dimension of control. This add-on exposes a wealth of fun and useful information about your Minecraft world through an easy-to-use REST API, letting you query everything from player positions to block states in real time.
What Makes McQuery Stand Out?
Unlike traditional server wrappers or complex plugins, McQuery is designed to be lightweight and straightforward. It runs directly alongside your Minecraft game or server, providing a modern HTTP interface that any developer can interact with. Whether you want to build a custom web dashboard, integrate with Discord bots, or simply monitor your world from a phone, McQuery delivers the data you need.
Real-Time Data Access
McQuery exposes a variety of endpoints that return JSON-formatted data about your current world. You can retrieve information about loaded chunks, active players, entity positions, and even block states at specific coordinates. This real-time access means you are always working with the latest snapshot of your game, not stale logs or delayed exports.
Secure API with Token Authentication
Security is a top priority. The API requires an authentication token to be passed with every request, preventing unauthorized access to your world data. You set this token in the mcquery-common.toml configuration file, ensuring that only trusted applications can query your server. Without the correct token, all requests are denied, keeping your world safe from prying eyes.
Customizable Port Settings
By default, McQuery listens on port 8080, but you can change this to any port that fits your network setup. This flexibility is especially useful if you run multiple services on the same machine or need to comply with hosting provider restrictions. The configuration file makes it trivial to adjust the port and token, so you can get up and running in minutes.
How to Install McQuery for Minecraft
Getting started with McQuery is a breeze, especially if you are already familiar with modding Minecraft. The add-on is built for the Forge mod loader and supports Minecraft versions 1.16.5, 1.18.2, and 1.19.2. Here is a step-by-step guide to how to install it manually:
- Ensure you have the correct version of Forge installed for your Minecraft client or server.
- Download McQuery from the official mod repository. Look for the file named
mcquery-<version>.jar. - Place the downloaded JAR file into your Minecraft
modsfolder. For a server, this is themodsdirectory in the server root; for a client, it is the.minecraft/modsfolder. - Launch the game or server. McQuery will generate a default configuration file on first run.
If you prefer a more streamlined experience, the foxygame.net launcher offers a one-click installation for McQuery directly from its add-on catalog. This method automatically handles version compatibility and keeps the mod updated, so you never have to hunt for the right file again.
Configuring McQuery for Your World
Once installed, McQuery creates a configuration file named mcquery-common.toml in your config folder. This is where you set the API token and port. Without a token, the API will refuse all connections, so this step is essential.
Setting the API Token
Open the mcquery-common.toml file with any text editor and locate the apiToken field. Replace the default empty value with a strong, unique string. Treat this token like a password—anyone who knows it can access your world data. After saving the file, restart Minecraft or your server for the changes to take effect.
Changing the Default Port
In the same configuration file, you will find the port setting. If port 8080 is already in use or you prefer a different one, simply change the number and restart. The API will then be available at http://localhost:<your-port>. Remember to update any firewall rules if you plan to access the API from another device on your network.
Practical Uses for McQuery
Once your API is up and running, the possibilities are nearly endless. Here are just a few ways the community is already putting McQuery to work.
Server Monitoring and Dashboards
Server admins can build real-time dashboards that display player counts, server TPS, and world statistics. With a simple HTTP request, you can pull data into Grafana, a custom web panel, or even a mobile app. This makes it easy to keep an eye on server health without logging into the console.
Community Tools and Bots
Discord bots can use McQuery to fetch player locations, announce when a specific player logs in, or even track the status of in-game events. The REST API returns clean JSON, so integrating with any programming language is straightforward. Whether you are writing a Python script or a Node.js application, McQuery provides the data you need.
Future Updates and Community Involvement
The developer has hinted at exciting new features on the horizon. Planned additions include WebSocket support for real-time event streaming, which would allow your applications to receive instant updates when something changes in the world—no more polling. The project also welcomes feature requests, so if you have an idea for a new endpoint or data type, you can share it through the official issue tracker. The API documentation is already comprehensive, making it easy to explore all available endpoints and parameters.
For those who want to skip manual setup entirely, the foxygame.net launcher not only installs McQuery with a single click but also ensures that any future updates are applied automatically, so you always have the latest features and security patches without lifting a finger.
Conclusion
McQuery is a game-changer for anyone who wants to interact with their Minecraft world programmatically. Its clean REST API, token-based security, and simple configuration make it accessible to beginners while powerful enough for advanced projects. Whether you are building a server dashboard, a community bot, or just experimenting with world data, McQuery for Minecraft is the tool you need. Download McQuery today and start unlocking the hidden potential of your blocky universe.