Documentation

Learn how to install and use LiquidBounce with our comprehensive guides

Hats

Hats puts a shape above your head just for looks. You can pick a cone, a halo, flying orbs, a flower, a star or your own picture, and change its size, colors and spin. It does nothing in the game.

The hat can also show above your friends. It turns red for a moment when the player gets hurt. In first person it stays visible unless you turn off FirstPersonView, and it always shows while FreeLook is on. The hat moves up a bit when you wear a helmet. With HeightOffset you can make it float up and down.

Category: Render Enabled by default: No

Settings

SettingTypeDefaultRangeDescription
HeightOffsetSetting GroupMakes the hat float up and down.
HeightOffset → PeriodInteger100010 to 20000 msHow long one up-and-down move takes.
HeightOffset → SymmetricToggletrueMakes the way down the same as the way up.
HeightOffset → HeightCurveFlat at 0.2Progress 0 to 1, Offset 0 to 2How high the hat is at each point of the move.
ModeMode SelectorConeCone, Halo, Orbs, Flower, Star, ImageWhich hat to show.
Mode → (all) → FollowRotationTogglefalseTurns the hat with your head.
Mode → (all) → EquipmentOffset → ArmorOffsetDecimal0.10.0 to 1.0How much higher the hat sits when you wear a helmet.
Mode → (all) → ShowDamageToggletrueTurns the hat red when the player gets hurt.
Mode → (all) → FriendsOptions → ViewOnFriendToggletrueAlso shows the hat on your friends.
Mode → (all) → FriendsOptions → DistanceInteger648 to 512 blocksHow far away friends still get a hat.
Mode → (all) → FirstPersonViewToggletrueShows your own hat in first person.
Mode → Cone → HatSettings → PeakDecimal0.30.01 to 2.0How tall the cone is.
Mode → Cone → RadiusSettings → OuterRadiusDecimal0.60.1 to 2.0How wide the cone is.
Mode → Cone → Colors → SyncColorsToggletrueUses only the first color instead of mixing both.
Mode → Cone → Colors → FirstColorColorLiquidBounce blue, alpha 125The main color.
Mode → Cone → Colors → SecondColorColorLight LiquidBounce blue, alpha 125The second color, used when SyncColors is off.
Mode → Cone → Colors → SpinSpeedDecimal1.00.0 to 10.0How fast the colors move around the hat.
Mode → Halo → HatSettings → RadiusDecimal0.30.1 to 2.0Size of the ring.
Mode → Halo → HatSettings → ThicknessDecimal0.050.01 to 1.0How thick the ring is.
Mode → Halo → Colors → SyncColorsToggletrueUses only the first color instead of mixing both.
Mode → Halo → Colors → FirstColorColorLiquidBounce blue, alpha 125The main color.
Mode → Halo → Colors → SecondColorColorLight LiquidBounce blue, alpha 125The second color, used when SyncColors is off.
Mode → Halo → Colors → SpinSpeedDecimal1.00.0 to 10.0How fast the colors move around the hat.
Mode → Orbs → colorColorLiquidBounce blue, alpha 125Color of the orbs.
Mode → Orbs → HatSettings → RadiusDecimal0.50.0 to 2.0How far the orbs fly from your head.
Mode → Orbs → HatSettings → SpeedDecimal0.50.1 to 10.0How fast the orbs fly around.
Mode → Orbs → HatSettings → OrbsSizeDecimal0.10.01 to 0.5Size of each orb.
Mode → Orbs → HatSettings → OrbsCountInteger61 to 12How many orbs there are.
Mode → Orbs → HatSettings → SpinSpeedDecimal2.0-10.0 to 10.0How fast each orb spins. Below 0 it spins the other way.
Mode → Orbs → WaveToggleable GroupOnMakes the orbs go up and down as they fly around.
Mode → Orbs → Wave → WaveHeightDecimal0.10.01 to 1.0How far up and down they go.
Mode → Orbs → Wave → WaveSpeedDecimal2.00.1 to 10.0How fast they go up and down.
Mode → Flower → HatSettings → RadiusDecimal0.30.1 to 2.0Size of the flower.
Mode → Flower → HatSettings → ThicknessDecimal0.050.01 to 1.0How thick the flower's line is.
Mode → Flower → HatSettings → SharpnessDecimal0.60.1 to 0.9How pointy the petals are.
Mode → Flower → HatSettings → PetalCountInteger55 to 15How many petals there are.
Mode → Flower → HatSettings → SpinSpeedDecimal1.0-10.0 to 10.0How fast the flower spins. Below 0 it spins the other way.
Mode → Flower → Colors → SyncColorsToggletrueUses only the first color instead of mixing both.
Mode → Flower → Colors → FirstColorColorLiquidBounce blue, alpha 125The main color.
Mode → Flower → Colors → SecondColorColorLight LiquidBounce blue, alpha 125The second color, used when SyncColors is off.
Mode → Flower → Colors → SpinSpeedDecimal1.00.0 to 10.0How fast the colors move around the hat.
Mode → Star → HatSettings → RadiusDecimal0.30.1 to 2.0Size of the star.
Mode → Star → HatSettings → ThicknessDecimal0.050.01 to 1.0How thick the star's line is.
Mode → Star → HatSettings → SharpnessDecimal0.60.1 to 0.7How pointy the star is.
Mode → Star → HatSettings → PointsCountInteger55 to 15How many points the star has.
Mode → Star → HatSettings → SpinSpeedDecimal1.0-10.0 to 10.0How fast the star spins. Below 0 it spins the other way.
Mode → Star → Colors → SyncColorsToggletrueUses only the first color instead of mixing both.
Mode → Star → Colors → FirstColorColorLiquidBounce blue, alpha 125The main color.
Mode → Star → Colors → SecondColorColorLight LiquidBounce blue, alpha 125The second color, used when SyncColors is off.
Mode → Star → Colors → SpinSpeedDecimal1.00.0 to 10.0How fast the colors move around the hat.
Mode → Image → ImageFilePNG, JPGThe picture to use as your hat.
Mode → Image → ColorModulatorColorWhiteTints the picture. White keeps its own colors.
Mode → Image → ScaleVector1, 1Width and height of the picture.
Mode → Image → SpinSpeedDecimal1.0-10.0 to 10.0How fast the picture spins. Below 0 it spins the other way.
RenderChoicePlainPlain, ShaderPlain draws the hat normally. Shader draws it with a shader effect, and its Style setting picks how that looks. The Image hat is always drawn plain.

Last updated: 2026-11-11, based on source code