JagProx - A Powerful Hypixel Proxy

Disclaimer: This is a third-party tool and is not affiliated with, endorsed, or supported by Hypixel Inc. Use at your own risk.

JagProx is a powerful, local Hypixel proxy built with Node.js that enhances your gameplay experience by adding custom quality-of-life features, advanced statistical analysis, and powerful automation tools directly to your Minecraft client, all managed through a sleek desktop launcher.

---

Join the Discord!

---

Key Features

• In-Game Stat Command (/sc):
  Check detailed stats for any player in any gamemode directly from your chat, complete with an ASCII art avatar.

• Advanced Friend Notifications (/superf):
  Track specific "super friends." Get custom, multi-line notifications when they log in or out. When they join, their stats for your predefined gamemodes are automatically fetched and displayed.

• Party Stat Check (/psc):

  Checks the stats of all players in your party for a specified game mode. If no game mode is provided, it defaults to the current game or Bedwars. This is useful for quickly assessing your party's skill level before starting a game.

  • /psc [gamemode]

• Modern Desktop Launcher:
  A sleek, standalone launcher to manage the proxy, view logs, and access tools without cluttering your game.

  • Start & Stop Control: Easily launch and stop the proxy with a single click.
  • Live Log & Chat Monitor: Keep an eye on system logs and the in-game chat in real-time.
  • Integrated Settings: Manage your API key, command aliases, and other settings directly within the launcher.
  • Player Search Tools: Look up detailed player stats and online status for any player on Hypixel.

• Secure & Local:
  The proxy runs entirely on your own machine. Your Minecraft account details are handled by the official minecraft-protocol library for authentication and are never sent to a third party.

---

Installation Guide

Follow these steps to get the JagProx devbuild up and running on your system. If you only want a working build, go to the releases tab and download the latest setup.exe file.

1. Prerequisites

Before you begin, ensure you have the following installed:

• Node.js: Version 22.12 or newer. Download here.
• Git: Required to clone the repository. Download here.
• A valid Minecraft: Java Edition account.
• A Hypixel API Key:
  1. Go to the Hypixel Developer Dashboard.
  2. Log in with your Minecraft account.
  3. Click on "Create a new API key" and copy the key securely.

2. Cloning the Repository

git clone https://github.com/JagHack/jagprox.git

3. Installing Dependencies

Navigate into the newly cloned folder and install the required packages.

cd jagprox
npm install

4. Configuration

On first launch, config.yml and aliases.json are created in the launcher's user-data folder (on Windows %APPDATA%\jagprox-launcher, on Linux ~/.config/jagprox-launcher). The copies in this repository are only the defaults. Auto GG, Discord RPC, your API key and aliases can be edited from the launcher; changes reach a running proxy within a few seconds.

Notable config.yml options:

• port / host: where the proxy listens (default 127.0.0.1:2107, so only your own PC can connect). Changing them needs a proxy restart.
• queue_stats: per-game automatic lobby stat checks (bw, skywars, duels).
• debug_mode: extra diagnostic lines in the log.
• stats_telemetry: off by default. When on, /sc shares the looked-up player's win count with the JagProx website.

5. Development

npm test      # unit tests
npm run lint  # ESLint
npm start     # run the launcher

---

Detailed Usage Guide

For a comprehensive guide on all features of the Jagprox Launcher, please refer to the GUIDE.md file.

---

3. In-Game Commands

• /sc <gamemode> <player> Check stats for a player. Example: /sc bedwars Notch

• /status <player> Check if a player is online and what game they are playing. Example: /status Notch

• /superf <add|remove|list> [player] [gamemodes...] Get notified when a friend joins one of the given games (checked once a minute; use any for every game). Example: /superf add Steve bedwars skywars duels

• /psc [gamemode] Fetch and display stats for everyone in your current party.

• /rq Re-queues the last /play command you used.

• /alert <add|remove|list> [player] Get a notification when a specific player appears in your lobby.

• /nickname <add|remove|list> [player] [nickname] Set a local, client-side nickname for a player that appears in chat and the tab list.

• /drpc Toggles the discord rich presence.

• /goal <set|view|cancel> Sets a stat goal, e.g. /goal set bedwars fkdr 5.

• /jagprox Displays the list of available custom commands.

• /gt | /gametrack [hour|day|log] [hour count if used with hour] Shows you the stats for the given hours/day or logs your last games.

---

Contributing

Contributions are welcome and have already been made! Huge shoutout to Yanice and TheMackabu for helping me with some stuff. If you have ideas for new features or find bugs, feel free to open an issue or submit a pull request on the GitHub repository.

---

License

This project is licensed under the MIT License. See the LICENSE file for details.