&7The complete guide

What is Hypixel Housing? The complete guide

Housing is Hypixel’s build-anything game mode. Every player gets a free plot to shape, open to guests, and wire up with a surprisingly deep scripting system. This guide covers the whole picture: joining, setting up your first house, commands, cookies, permissions, the actions system, the rules, and how to grow a house players come back to.

Updated By CTG123456 ~22 min read
  • mc.hypixel.net
  • Java Edition, 1.8.9 or latest
  • Free to play
&6The basics

What is Hypixel Housing?

Hypixel Housing is a game mode on the Hypixel Minecraft server that gives every player a plot of their own, called a house, to build on, customize, and open to guests. At its simplest, it’s a creative space you share with friends. At its most ambitious, it’s a platform: houses grow into hangout hubs, parkour maps, roleplay worlds, and complete mini-games built with Housing’s own event and action tools.

That range is why Housing has stayed popular for so long. Builders come for the plot, hosts come for the community, and technical players come for the systems: variables, functions, custom menus, and event triggers that behave like a lightweight game engine inside Minecraft.

Where to play
mc.hypixel.net on Minecraft: Java Edition, using 1.8.9 or the latest release
Cost
Free for every player. Housing+ is an optional one-time upgrade.
Made for
Building, hosting communities, and creating your own mini-games
Key systems
Events and actions, variables, teams, custom menus, permissions, and cookies
&aGetting started

Joining Hypixel Housing

Housing lives on the Hypixel server, so the first step is connecting to Hypixel on Minecraft: Java Edition with the address mc.hypixel.net. Once you’re in, type /l housing to jump straight to the Housing lobby, or pick Housing from the game menu in any lobby.

The Housing lobby is the front door to everything. From there you can open the house browser to find active houses, use /visit <player> to see a specific player’s houses, or run /home to open your My Houses menu. Every Hypixel player gets a house at no cost, so there’s nothing to unlock before you start placing blocks.

Which Minecraft version should I use?

Hypixel recommends 1.8.9 or the latest Minecraft release, and Housing works on both. Players report that houses still use the classic 1.8-era block set, though, so some newer blocks from the Creative menu won’t place even on the latest version. If a feature behaves strangely, try the same thing on the other version before assuming it’s broken.

Bedrock, console, and mobile players can’t join, since Hypixel is a Java Edition server.

&eYour first house

Setting up your first house

A few minutes of setup makes a big difference in how your house feels to visitors. Here’s a simple order to do it in.

  1. Create the house. Run /home to open My Houses, then click an empty slot. Right-clicking a house in that menu lets you change its icon, duplicate it, or delete it.
  2. Name it. Use /housing name <name>. Names can be up to 32 characters, and color codes count toward that limit. The color codes and font generator on this site help a short name stand out.
  3. Pick a theme. Open the Housing Menu (the Nether Star in your hotbar) and choose Themes to change your plot’s terrain and sky. Some themes are free, and others cost Mystery Dust.
  4. Set the spawn. Stand where guests should arrive and run /setspawn. It no longer requires a rank.
  5. Choose who can visit. Set your visiting rules to Public, Friends, Guild, Party, or Private from the Housing Menu, or run /visitingrule public. Strangers can only find public houses.
  6. Help the right players find you. Add house tags and set your house language in House Settings.
  7. Test it as a visitor. Ask a friend to join and watch their first minute. Check what your default group can and can’t do before you open the doors.

More houses and bigger plots

Your first house is free. Ranks unlock extra house slots, and more can be bought from the Hypixel Store, so you can keep separate projects in separate houses. Plots start at 31x31x31 blocks and can be expanded in House Settings up to 101x101x101, and Housing+ unlocks a 255x255x255 plot. Bigger plots work with every theme, though some theme scenery can end abruptly at the larger sizes.

Before a big rebuild, run /save and then duplicate the house into a spare slot from My Houses. It gives you a copy to fall back on if the experiment goes wrong.

&eCheat sheet

Essential Hypixel Housing commands

You can reach almost everything through menus, but these are the commands Housing players actually type. /h is short for /housing, so either one works.

Getting around

CommandWhat it does
/l housingTakes you to the Housing lobby from anywhere on Hypixel.
/homeOpens My Houses, where you join, create, or manage your houses.
/visit <player>Shows a player’s houses so you can pick one to join, even when they’re offline.
/housing randomDrops you into a random active house. Great for finding inspiration.
/stuckSends you back to the house spawn if you get trapped. Owners can turn it off, so it won’t work everywhere.
/parkour checkpointReturns you to your last parkour checkpoint. Use /parkour reset to start a run over.

Hosting and moderation

CommandWhat it does
/housing name <name>Renames your house, up to 32 characters including color codes.
/setspawnSets where guests arrive in your house.
/visitingrule publicOpens your house to everyone. Swap in friend, guild, party, or private.
/h kick <player>Removes someone from your house. They can rejoin.
/h mute /h unmuteStops someone chatting in your house, then lets them talk again.
/h ban /h unbanKeeps someone out of your house, then lets them back in.
/housing logShows the owner’s audit log of moderation and group changes.
/report <player>Reports a rule breaker to Hypixel staff.

Building and scripting

CommandWhat it does
//set //fillPro Tools: //set replaces every block in your selection, while //fill only fills the empty air.
//copy //pasteCopies a selection and pastes it where you stand. //undo reverses your own last edit.
/editOpens the Item Editor for the item in your hand: name, lore, item actions, and more.
/variablesViews and edits variables directly.
/functionsCreates and edits functions. /commands and /layouts do the same for custom commands and inventory layouts.
/placeholdersLists every placeholder. /testplaceholder checks one before you use it.
/limitsShows every system limit for your house, including variable storage.
/housing loggerShows the last 10 errors and warnings from your actions.

Owners can also create custom commands that run actions when guests type them: 10 by default, or five times that with Housing+. Mark a command as listed and it shows up in tab completion.

&6Discovery

Cookies and getting your house discovered

Cookies are Housing’s rating system and the clearest sign that players enjoy a house. When you join someone’s house, a cookie item appears in your hotbar, and right-clicking it gives that house a pack of cookies. Every player gets a limited number of packs each week, and higher Hypixel ranks give larger packs, so each one is a small vote for the houses you actually enjoy.

House cookie counts reset every week, which keeps things fresh and gives newer houses a real shot. The house browser lists houses that are public and active right now, so a house nobody is in won’t show up there. Being online and open is half the battle.

Don’t hide the cookie

If your house gives visitors an inventory layout, it can replace the hotbar slot where the cookie item normally sits. Cookies are a standard item in the Items menu, so add them to your layouts and guests can still show their support.

Two more notes for new owners: you can’t give cookies to your own house, and begging rarely works. The hosts who grow are the ones who make giving a cookie feel natural: a fun first minute, a visible goal, and a polite reminder at most.

&bYour plot

Building, permissions, and items

Ordinary blocks come from the Creative inventory, since builders can use Creative mode in Housing. Housing’s special objects, like NPCs, holograms, and action pads, live in the Items section of the Housing Menu instead. If something you need isn’t in one, check the other.

Groups and permissions

By default, your house is yours alone to edit, and visitors can look around but not build. Everything beyond that runs through groups: you create groups, choose what each one can do, and assign players to them. Building is the big permission, and there’s a separate one for building while you’re offline. Others cover Pro Tools, editing systems like regions, functions, commands, menus, and teams, and an Edit Actions permission for changing actions. It’s how a house goes from a solo plot to a team project, or to a Free Build where guests get build rights.

Pro Tools

Pro Tools are Housing’s WorldEdit-style building tools. Select two corners of an area, then use //set to replace every block in it or //fill to fill only the empty air. //copy and //paste duplicate builds, //walls and //wireframe outline a selection, and //undo reverses your own last edit. You can’t undo someone else’s edits, so only give Pro Tools to people you trust completely.

The Items menu

The Items menu adds the pieces vanilla Minecraft doesn’t have: NPCs that greet guests or run actions when clicked, holograms for floating text, action pads and action buttons that trigger your systems, teleport and launch pads, leaderboards, parkour blocks, trash cans, a biome stick, and a mailbox where guests can send the owner a written book.

The Item Editor

Hold any item and run /edit to change its name, lore, and other properties, or give it actions that run when it’s used. Lore can be added several lines at once by separating them with \n, and the color codes page keeps names and lore readable.

Parkour

Housing has a built-in parkour system. Place parkour blocks from the Items menu to build a timed course, then add a leaderboard so players can see the best times. Racers use /parkour checkpoint to return to their last checkpoint and /parkour reset to start over, and owners can choose which finishes get announced in chat. The Start Parkour event lets you run actions the moment a run begins.

&dThe engine

The actions system: Housing’s mini-game engine

The actions system is where Housing stops being a build plot and starts being a game platform. The idea is simple: something happens, and the house responds. Events fire when a player joins, quits, dies, gets a kill, takes damage, catches a fish, starts parkour, drops or picks up an item, sneaks, or changes the item in their hand. Each event can run actions: send a message, teleport the player, change a variable, give or remove items, apply an effect, play a sound, open a custom menu, and more.

One event works differently than its name suggests. The block break event runs when a player tries to break a block they aren’t allowed to, not when a builder successfully breaks one.

Conditions add logic. A conditional action checks things like a player’s team, gamemode, variables, or any numeric placeholder, then runs one set of actions if the check passes and another if it fails. You can require every condition to match, or just one.

Functions bundle actions you can reuse from anywhere, including from other actions, and a house can have 60 of them by default. Functions can also run automatically every set number of ticks, which makes timers and repeating game loops possible, and the Pause Execution action adds a delay partway through a list.

Example: a playtime counter

Create a function that adds 1 to a player variable called playtime, then set it to run automatically every 20 ticks, which is one second. Add the variable’s placeholder to your scoreboard, and every guest can see how long they’ve spent in your house.

Two features make bigger projects manageable. Any list of actions can be copied and pasted into another, and /housing logger shows the last 10 errors and warnings your actions produced. That’s the first place to look when something quietly stops working.

Everything here is configured through in-game menus, which is friendly to start with and fiddly at scale. That’s why the community built tools for writing actions as code, covered in the creator tools list below.

&bData

Variables, placeholders, and player data

Variables, called stats before April 2025, are Housing’s memory. They’re how houses track coins, kills, levels, and progress. Every variable belongs to a holder: a player, a team, or the house itself, which Housing calls global. Each one holds a whole number, a decimal number, or text up to 32 characters, and it keeps that type once it’s set.

Variables are changed with the Change Variable action, checked with conditions, and managed directly with /variables. Instead of a fixed number of keys, each holder gets storage space: 512 bytes by default, or five times that with Housing+. A whole number takes between 1 and 8 bytes depending on its size, and text takes about a byte per character, so there’s room for dozens of values per player. Run /limits to see how much space you’re using.

Placeholders

Placeholders drop live values into text. Variable placeholders start with %var., so %var.player/coins% shows a player’s coins in a message, hologram, or scoreboard line. Run /placeholders to see every available placeholder, and /testplaceholder to check one before you use it. Older stat placeholders still work in existing houses, but variable placeholders are the ones to use from now on.

Saving player progress

The Player Data options in House Settings control what Housing remembers about players after they leave: their variables, plus states like location, inventory, health, parkour progress, and active effects. You choose how long that data lasts, up to 30 days by default or up to a year with Housing+.

Scoreboards and leaderboards

The sidebar scoreboard shows information to each player, and the Scoreboard Editor (/scoreboard) builds its lines from text and placeholders. Leaderboards are different: they’re placed in the world and rank players by parkour times, player variables, or team variables.

&aSystems

Regions, teams, custom menus, and layouts

Regions

Regions are areas of your plot with their own rules. Each one can change PvP and damage behavior and run actions when players enter or leave. A classic setup is a safe spawn next to a combat arena: PvP stays off in the spawn region, turns on in the arena region, and an entry action hands players their kit.

Teams

Teams are separate from permission groups. Groups decide what players are allowed to do, while teams decide which side they’re on. Each team can have a name, a colored tag, friendly fire on or off, and its own team variables. Housing can auto-balance players onto teams as they join, keep parties together, and give each team its own chat.

Custom menus

Custom menus are inventory screens you design yourself. Pick a title and size, place items in the slots, and give each one click actions. Shops, game selectors, settings screens, and upgrade menus are all built this way, and the Display Menu action opens a menu from anywhere.

Inventory layouts

Inventory layouts are saved loadouts, custom items included, that you apply with actions. An arena region can hand players a kit on entry, and a lobby region can swap it back. Remember to include the cookie item in any layout you give visitors.

NPCs

NPCs can be players or many other mob types, each with separate left-click and right-click actions. Once a project grows, the NPCs list in the Systems menu lets you find, edit, and teleport to every NPC in the house.

&6Limits

Housing limits and Housing+

Every house has limits on how much of each system it can use. These are the defaults after Housing’s September 2025 update. Housing+ raises most of them, and /limits always shows the exact numbers for your house.

SystemDefault limit
Functions60
Inventory layouts60
Regions40
NPCs40
Holograms40
Custom menus40
Custom commands10
Variable storage512 bytes per player, team, or global holder
Player dataKept for up to 30 days

Last checked against Hypixel’s patch notes on .

What Housing+ adds

Housing+ is an optional one-time upgrade from the Hypixel Store. It doesn’t change how your house plays for guests, but it gives owners a lot more room:

  • A 255x255x255 plot, the largest size available
  • Five times the default limits for regions, holograms, NPCs, custom commands, functions, inventory layouts, and variable storage
  • Player data that can be kept for up to a year
  • The SkyBlock Pet Skins and Minion Skins skull packs, an Egg Hunt item, and a golden + prefix in Housing that you can turn off in /settings

Buying it? A verified creator code takes 5% off at checkout.

&aThe scene

Types of houses you’ll find

Browse the Housing lobby for a while and a few genres show up again and again. Free Builds hand build permissions to visitors and turn the plot into a shared canvas. They’re chaotic, social, and a format this site knows well. Hangouts are social hubs built around chat, music, and regulars. Mini-game houses use the actions system for PvP arenas, simulators, and original game ideas. Parkour maps lean on the built-in timer and leaderboards, and roleplay and themed builds turn the plot into a set: schools, cities, restaurants, whatever the community dreams up.

Free Build comes with a lot of community history and a lot of questions, so it has its own corner of this site: the Free Build hub, a guide for what to do if you’re banned while hosting, and an explainer on what “Well Known” actually means in that scene.

&eGuest counts

Growing your house: clarity, performance, consistency

There’s no single trick for guest counts. In our experience, though, houses most often lose new guests in the first minute, usually to confusion or lag, so those are the first things worth testing.

Make the first minute obvious

A guest who spawns in should know what the house is and what to do without asking. Try a clean spawn area, readable signs, and one clear path forward instead of five branching options. If your concept needs a tutorial, test a shorter one. Readable text helps more than it gets credit for, and well-placed color codes make instructions scannable instead of cluttered.

Keep it smooth when the house gets busy

Lag comes in two kinds. Client lag, a low frame rate, usually comes from heavy particles, crowds of entities, and big builds rendering at once. Server lag, where actions and movement feel delayed, usually means your systems are doing too much work, like functions that run every few ticks or long action chains that fire constantly. Test your core systems with several people in the house, watch what happens when they all trigger at once, and keep the area guests see first light. For bigger houses, the Dynamic option in the Max Players setting lets the player cap rise when the server can handle it.

Show up on a schedule

Discovery in Housing compounds: active houses earn cookies, and a house with players in it appears in the browser. Consistent hosting hours tend to beat occasional marathon sessions, because regulars are what carry a house between cookie resets. Give people a reason to come back, like a goal, an event, or a build that visibly grows.

Measure what’s working

House Analytics, in the Systems menu, shows how many unique players joined your house each day, week, month, and year, plus all time. Use it to check whether a change actually helped, and share it with trusted staff through the View Analytics permission.

Growth shortcuts that break the rules

Some shortcuts can get a house punished, so skip them:

  • Giveaways of in-game items, currency, or rewards
  • Rewards for joining a Discord server, following a channel, or engaging on another platform
  • Alt accounts or bots that inflate your player count
  • Casino-style games like slot machines or roulette, even with no real money involved
&cFix it

Troubleshooting and recovery

  • An action stopped working. Run /housing logger. It lists the last 10 action errors and warnings, and an error stops the rest of that action list from running.
  • You can’t add any more of something. Run /limits to see which system is full, including variable storage.
  • You need to know who changed something. /housing log opens the owner’s audit log, which covers bans, mutes, group changes, and changes to other house systems.
  • You’re about to make a big change. Run /save, then duplicate the house into a spare slot from My Houses. Check that everything you need came across before you rely on the copy.
  • Something works for some players but not others. Check their Minecraft version. Housing supports 1.8.9 and the latest release, and a few features have behaved differently between the two.
  • A guest is trapped. /stuck sends players back to spawn, unless the owner has turned it off.
  • Something is genuinely broken. Report it through Hypixel’s bug report process so the developers see it.
&cStay safe

Rules, reporting, and host responsibility

Houses are player-run, but they’re not lawless. Hypixel’s Housing content rules build on the regular server rules, and owners are responsible for the content in their plots, including what other players add. Hypixel also advises against giving other players full access to your house.

The main restrictions, in short:

  • No hateful, discriminatory, threatening, or harassing content
  • No gambling, including casino-style games and gambling themes, even simulated ones
  • No giveaways, and no rewards for joining or engaging with other platforms
  • No references to real-world tragedies like wars or terrorism, and no political figures or campaigns
  • No adult themes, such as drug references, explicit violence, or sexual content
  • No bots, alt accounts, or outside tools used to inflate player counts or interact with a house

Tools that write actions for you sit in a gray area. The rules currently allow limited use of macro mods that create Housing actions through normal game mechanics, at Hypixel’s discretion, and that could change. Tools that run bots or automate gameplay are a different matter, so check the rules before installing anything.

Reporting problems

Use /report <player> for a player breaking the rules. For an inappropriate sign, hologram, or NPC, look at it and run /worldreport. To report a whole house for its build or name, right-click the door in your hotbar and click the anvil. Reporting sends the problem to Hypixel staff, which is different from kicking or banning someone from your own house.

Hosting safely

The moderation commands exist for a reason: /h kick, /h mute, and /h ban are part of hosting, not an admission of failure. The stakes are highest for Free Build hosts, since build permissions mean trusting strangers not to build something rule-breaking on your plot. If the worst happens, the Free Build ban guide walks through what a punishment while hosting can mean and the sensible next steps. Treat the official rules and support articles as the source of truth. This site summarizes, and Hypixel decides.

&bToolbox

Hypixel Housing tools and resources

The pages on this site that Housing players reach for most, plus the community projects and official references worth bookmarking.

Community tools for creators

Each of these is independently owned and operated by its creators, and none is affiliated with Hypixel. Check each project’s own page for supported versions before installing.

Official references and community guides

Run a Housing-related project? Email ctg@hypixelhousing.com. Listings are free.

&7Glossary

Hypixel Housing glossary

Quick definitions for the terms Housing players use most.

House
A player-owned plot on the Housing server, sometimes just called a plot.
Housing Menu
The Nether Star menu where you manage settings, systems, items, themes, and permissions.
Group
A set of permissions, like who can build or kick, assigned to players in your house.
Team
A side players are on, with its own tag, color, chat, and variables. Separate from groups.
Variable
A stored value for a player, a team, or the whole house. Called a stat before 2025.
Event
Something that happens in your house, like a player joining, that can run actions.
Action
Something the house does in response, like sending a message or giving an item.
Function
A reusable list of actions you can run from anywhere or on a timer.
Region
An area of your plot with its own PvP rules and entry or exit actions.
Inventory layout
A saved loadout of items that you apply to players with actions.
Custom menu
A clickable inventory screen you design, like a shop or game selector.
Placeholder
A code like %var.player/coins% that shows a live value in text.
Cookie
Housing’s weekly rating vote. More cookies mean a more popular house.
Pro Tools
WorldEdit-style building tools like //set and //fill.
Housing+
An optional one-time upgrade with bigger plots and higher limits.
Free Build
A house where the owner gives visitors build permissions.
&6FAQ

Hypixel Housing FAQ

What is Hypixel Housing?

Hypixel Housing is a game mode on the Hypixel Minecraft server that gives every player a free plot, called a house, to build on, customize, and open to guests. Houses range from simple builds and hangouts to full mini-games made with Housing’s actions system.

How do I join Hypixel Housing?

Connect to Hypixel on Minecraft: Java Edition at mc.hypixel.net, then type /l housing or pick Housing from the game menu. From the Housing lobby you can browse houses, see a player’s houses with /visit, or open your own houses with /home.

What version of Minecraft do I need for Hypixel Housing?

Hypixel recommends playing on 1.8.9 or the latest Minecraft release, and Housing works on both. Players report that houses still use the classic 1.8-era block set, so some newer blocks won’t place even on the latest version.

Can I play Hypixel Housing on Bedrock, console, or mobile?

No. Hypixel is a Minecraft: Java Edition server, so you need Java Edition on a computer to join. Bedrock players on consoles, phones, and tablets can’t connect.

Is Hypixel Housing free?

Yes. Every Hypixel player gets a house at no cost, and all you need is a Minecraft: Java Edition account. Housing+ is an optional one-time upgrade with a bigger plot size and higher limits, but it isn’t required to build, host, or play.

What is Housing+?

Housing+ is a one-time upgrade from the Hypixel Store. It unlocks a 255x255x255 plot, five times the default limits for systems like functions, regions, and NPCs, longer player data storage, and a few cosmetic extras.

How many houses can I have in Hypixel Housing?

Every player gets one house for free. Ranks unlock extra house slots, and more can be bought from the Hypixel Store. You manage all of them from the My Houses menu, which opens with /home.

How do I make my house public?

Open the Housing Menu and set your visiting rules to Public, or run /visitingrule public. Only public houses with players in them show up in the house browser.

What are cookies in Hypixel Housing?

Cookies are Housing’s rating system. When you visit a house, a cookie item appears in your hotbar, and right-clicking it gives the house a pack of cookies. Each player has a limited number of packs per week, higher ranks give larger packs, and house cookie counts reset weekly.

What are variables in Hypixel Housing?

Variables, called stats before April 2025, are values Housing stores for a player, a team, or the whole house, like coins, kills, or a round number. Actions change them, conditions check them, and placeholders display them.

What Hypixel Housing commands should I learn first?

Start with /l housing to reach the Housing lobby, /home to open your houses, /visit followed by a player name to see their houses, and /h for owner commands like kick, mute, and ban. /stuck sends you back to spawn if you get trapped, unless the owner has turned it off, and /limits shows your house’s limits.

What is Free Build in Hypixel Housing?

Free Build is a genre of Housing where the owner gives visitors build permissions, so anyone who joins can place and break blocks. It’s one of the most social ways to play Housing, and hosting one comes with extra responsibility because owners are responsible for the content on their plot. Start with the Free Build hub.

Is HypixelHousing.com affiliated with Hypixel?

No. HypixelHousing.com is an independent, community-run resource website. It is not owned by, operated by, affiliated with, endorsed by, or sponsored by Hypixel Inc. or the Hypixel Minecraft server.

&7Sources

Sources and updates

This guide is written and maintained by CTG123456, an independent developer and community organizer in the Hypixel Housing scene and an early pioneer of the Free Build format. Facts that change, like commands, limits, and rules, were last checked against Hypixel’s official patch notes and support articles on .

Official sources

Changelog

  • Updated for Housing’s 2023 to 2025 updates, including variables, teams, custom menus, new limits, House Analytics, and NPC types. Added first-house setup, Pro Tools, limits, troubleshooting, reporting, a glossary, and newer community tools.
  • First published.

Pick your next step

Wherever you’re starting from, here’s where to go next.