Hypixel guild bot
Your guild chat, everywhere your guild is.
Lodestone signs a spare Minecraft account into Hypixel and keeps it there. Guild chat lands in Discord, Discord lands in guild chat, and thirty-odd commands work identically on both sides. You run it; nobody else holds your keys.
Guild chat
#guild-chat on Discord
↑ one bot, both directions, same commands ↑
What you get on day one
The bridge and the basics
Two-way chat relay, all-time stats for every Hypixel game, guild lookups, who's online, announcements, join and leave notices. No key, no account, no expiry.
The parts that took the longest
Voice relay, AI answers, stat history over time, the whole SkyBlock suite, guild analytics, cheater tools, custom commands.
The free tier isn't a trial. It has no timer and no member cap — it's a complete guild bridge that a guild can run forever without paying.
Features
Everything it does, and which tier it's in.
Every command works in guild chat and in Discord. Names are optional — leave one out and it looks you up.
Free always on, no key
the bridge
Guild chat into Discord and back, with join, leave and officer-chat relays. Skins as avatars, mentions stripped so nobody gets pinged by a Minecraft message.
Free!bw !sw !duels !bb !mm !p
All-time stats for Bedwars, SkyWars, Duels, Build Battle, Murder Mystery, plus a one-line overview. Rendered as a Minecraft-styled card in Discord.
Free!g !gexp !online !seen
Guild info, GEXP, who's online right now grouped by guild rank with Hypixel ranks coloured in, and last-login lookups.
Free!announce !status !ping
Broadcast to guild and Discord at once, bot health, and live ping for anyone in the bot's lobby.
Free!restart !update !idle !apikey
Admin control from chat. Rotate your Hypixel key without touching a file — it's validated before it's saved and only accepted in a whisper.
FreeKeyed eight features, one key
!vc
The bot sits in a Discord voice channel around the clock. !vc on and you get live transcripts whispered in game; whisper back and it speaks for you. Plus an audio player — direct links, YouTube, playlists, Spotify tracks — with queue, loop, volume and ducking so speech cuts over music.
!ask
An AI that knows your guild — its name, ranks, GM and your own notes — answers in guild chat, searches the web when a question needs it, and can be switched off by an admin at any time.
Keyed!bwd !bww !bwm !bwy !bws
Stat history. The bot snapshots every guild member at the start of each day, week, month and year, so anyone can ask what they gained today or this month. Works on every game, not just Bedwars.
Keyed!sb !nw !skills !slayer !dungeons !mp
The SkyBlock suite: profile overview, net worth, skill averages, slayer levels, catacombs with class levels and secrets, and magical power decoded straight out of the accessory bag — families deduped, Hegemony and Rift Prism counted properly.
Keyed!weekly !inactive !compare
Guild analytics: the weekly GEXP report, a ranked list of who's fallen below your activity threshold, and head-to-head stat comparisons.
Keyed!snipe !sreport !denick
Cheater tools. Seraph's community database flags known snipers with a 🚩 on their stat card, !sreport files a report, and !denick resolves a nicked player from their finals and beds.
!cmd add
Custom commands your guild defines itself — rules, links, inside jokes — added from chat and stored per install.
KeyedWhen something's locked
One sentence, then it moves on. A missing key never stops the bot, never spams the channel, and never touches the bridge.
Pricing
One key per person, not per member.
Guild size never changes the price. A 5-man guild and a 125-man guild pay the same.
Core
Run it yourself, forever
Free
- Two-way chat bridge
- All-time stats, every game
- Guild lookups and
!online - Announcements and admin commands
- Unlimited members
- Voice, AI, SkyBlock
- Stat history and analytics
Keyed Popular
Everything unlocked, still your machine
$12 one-time
- Everything in Core
- Voice relay and audio player
- AI assistant
- Stat history over time
- SkyBlock suite
- Guild analytics
- Cheater tools, custom commands
- 3 machines, updates included
Hosted
We run it, you don't touch a server
$5 / month
- Everything in Keyed
- Always-on, no machine of your own
- Updates applied for you
- Restarts and crash recovery
- You still sign the Minecraft account in yourself
- No shell access
Prices here are placeholders until checkout is wired up. What matters is the shape: the bridge is free because a guild shouldn't have to pay to talk to itself, and the key is a one-time purchase because the bot runs on your hardware, not ours.
Setup
Three steps, about ten minutes.
The wizard runs in your browser on localhost. It never leaves your machine and nothing is sent anywhere.
Install and open the wizard
# Node 18 or newer git clone <your-repo> lodestone && cd lodestone npm install npm run setup # opens http://127.0.0.1:8765
Loopback only, with a fresh random token each run — nothing on your network can reach it.
Paste two keys
A Hypixel API key and a Discord bot token. Both are checked as you paste them, so a typo shows up now rather than at 3am. Give it your IGN and the wizard pulls your guild name, tag, GM and rank list straight from Hypixel — nothing to type twice.
No bridge channel yet? It can create #guild-chat for you, permissions and all.
Sign the bot's account in, once
./bot.sh start
A Microsoft device code appears in the log. Enter it once at
microsoft.com/link; the refresh token is cached locally at 0700 and
you never do it again. Your password is never typed into Lodestone and never stored.
Moving it to another machine
Copy the repo, not the state. These four never travel — they hold your keys, your Microsoft session and your guild's data:
# copy the repo (or git clone it fresh), then npm install # never copy .env · config.json · authcache/ · data/
Two machines can't share one Minecraft account — they'd kick each other off in a loop. Stop the first bot before starting the second, or give the second one its own alt.
Hosting
Where the bot actually lives.
It needs to stay online to stay in guild chat. That means a machine that doesn't sleep — which is the whole decision.
Your own machine
Free · you already own it
- Nothing to pay, nothing to set up
- Full control and shell access
- Best for trying it out
- Laptop sleeps, bot drops
- Your home IP does the connecting
Your own VPS
$4–6 / month · you rent it
- Online permanently
- 1 vCPU and 1 GB is plenty
- 2 GB if you want voice
- Still fully yours — root, logs, backups
- You handle updates and restarts
Hosted by us
$5 / month · nothing to run
- Your own container, your own config
- Restarts and updates handled
- Voice tools preinstalled
- Key included — no separate purchase
- No shell access
What a VPS needs
Any Linux box will do. The bot idles at well under 200 MB; the only real appetite is voice, where speech recognition wants a second core and a couple of gigabytes.
Bridge + stats
1 vCPU, 1 GB RAM, 10 GB disk. The cheapest tier anywhere handles it.
~$4/moWith voice
2 vCPU, 2 GB RAM. Whisper and Piper run locally, and the voice models are about a gigabyte on disk.
~$6/moSoftware
Node 18+, plus ffmpeg, whisper-cpp, piper and yt-dlp if you want voice. All linked on the API index page.
Keeping it up
./bot.sh start runs it under pm2 — it restarts on crash and comes back after a reboot.
One thing worth knowing before you rent: Hypixel is stricter with datacentre IP ranges than with home connections. Most VPS providers are fine, but if logins start failing from a new host, that's usually why — not the bot.
Signing in on a server with no browser
The Microsoft device-code flow is built for exactly this. Start the bot over SSH, read the code out of the log, and enter it on your phone. Nothing needs a browser on the server itself.
Security
Your keys stay on your machine.
There's no Lodestone account and no server of ours in the path. The bot talks to Hypixel, Discord and nothing else you didn't configure.
Secrets are locked down on disk
.env and config.json are written 0600, the Microsoft token cache 0700 — readable by your user and nobody else on the box. Both are gitignored, so a fork can't leak them.
The setup wizard can't be reached from outside
It binds 127.0.0.1 only and mints a random token per run. Same for the status endpoint — loopback, never 0.0.0.0.
Links are vetted before anything is fetched
Every URL passed to the audio player is resolved and checked first: private and loopback ranges are refused, redirects are re-checked at each hop, and the content type has to be audio. Someone in your Discord can't point the bot at your router.
Admin commands are whisper-only where it matters
!apikey is only accepted in a direct message, so a key pasted in guild chat is ignored rather than broadcast. Every admin command checks against the owner and admin list in your config, not against a Discord role someone can hand out.
Nothing phones home
With licensing off, the bot makes no request to us at all. With a key, it asks once a day whether the key is still good — the key and an anonymous machine hash, nothing else. If our server is down it keeps working for a week before it starts complaining.
Reference
Every key, and where to get it.
Two keys and a Discord app are all Lodestone needs. Everything below that is optional — it turns a feature on, and the bot says so plainly when one is missing.
Required
The API key behind every stat, guild and player lookup. Free, instant, one per account. Rotate it any time with !apikey <key>.
Create an application, add a bot, copy the token. Turn on Message Content Intent under Bot → Privileged Intents or the bridge stays silent.
A spare account for the bot to play on. You sign in once through microsoft.com/link; the token is cached locally and no password is ever stored.
Optional — turns a feature on
Powers !ask with Gemini. Free tier is generous but does run dry in a busy guild.
The alternative brain for !ask. Set either key — whichever is present gets used.
If you host there rather than on your own machine, this token lets !restart use their panel API.
Voice features — installed once, no account
Turns speech into text, on your machine. brew install whisper-cpp plus a model from Hugging Face.
Needed only for YouTube and Spotify links. Keep it current — YouTube changes things and old versions start failing.
No keyUsed automatically — nothing to sign up for
Hosting providers worth a look
The usual recommendation. Cheapest tier runs the bridge comfortably; the next one up handles voice.
VPSA genuinely free always-on ARM instance, if you can get one provisioned. Generous enough for voice.
VPSPanel hosting with a free tier earned by watching ads. Fine for the bridge; tight for voice.
PanelFAQ
The questions worth asking first.
Will the bot's account get banned?
Nobody can promise otherwise. It plays on 1.8.9 like a normal client, idles in a lobby and doesn't automate gameplay — but accounts that sit in a lobby all day do sometimes get chat-muted. Use a spare account, not the one your skins and ranks are on. That advice is worth more than any reassurance.
Does it need to be online all the time?
Yes — it can only relay guild chat while it's in guild chat. A laptop that sleeps means a bridge that stops. That's what the hosting page is about.
Can I run more than one guild from one install?
One Minecraft account is in one guild, so one install serves one guild. The voice side is different: it can sit in several Discord servers at once, and outside your home server only you can move it.
What happens to my data?
It stays in data/ on your machine — stat baselines, custom commands, IGN links, friend cache. Delete the folder and it's gone. None of it is uploaded anywhere.
What breaks if I never buy a key?
Nothing you were already using. The free tier has no timer and no member limit — the bridge, stats, guild lookups and admin commands run indefinitely. Paid features answer with one sentence explaining they're locked.
Is this affiliated with Hypixel?
No. Lodestone is an independent tool that uses Hypixel's public API. Not affiliated with or endorsed by Hypixel Inc. or Mojang.
Which Minecraft version?
1.8.9, which is what Hypixel's main lobbies run and what the bot is tested against. Newer protocol versions connect but behave inconsistently for a headless client.
Lodestone · runs on your machine · Terms of Service · not affiliated with Hypixel Inc. or Mojang