Skip to content

HaxBall extension

See the pitch one frame ahead.

Shows where the ball is going, and where it would go if someone kicked now, before it happens. One panel, nine languages.

Desktop Brave and Chromium browsers with Manifest V2 support

A clip from a real matchThe red team passes its way forward. HaxBall Pro's dashed green line shows where the ball will go before it's struck; the shot follows that path into the goal and the score turns from 0-1 to 1-1.

Features

Each one does one thing well.

Turn on what you want and leave the rest. Everything starts off after install.

  • Ball path

    Draws the ball's path on the pitch: where it bounces off walls, where it stops, whether it goes in.

  • Auto Block

    Shortcut: B

    When an opponent crashes into you, you barely budge and keep your line.

  • Keeper mode

    Reads the line from the shooter's disc to the ball and steps onto it before the shot.

  • Turbo kick

    Shortcut: C

    Hold the key for rapid-fire kicks; it adjusts itself to the room's kick rate limit.

  • Kick assist

    Shortcut: G

    Press its key a little early and it waits, then kicks at full power the instant the ball touches you.

  • Smart go to ball and hold

    Shortcut: Z

    Hold the key: it cuts the ball off, circles behind it and pushes it the way you're pressing.

  • Jitter damper

    When the ball's position gets corrected, it slides into place instead of jumping.

  • Smooth opponents

    Late-arriving opponent moves glide instead of snapping; your own controls feel the same.

  • Pitch and sprite cache

    Stamps the pitch and the other players from ready-made images; frames get lighter, so your key presses can reach the screen sooner.

  • Camera

    Looks a little ahead of you and zooms in smoothly near the ball.

  • SOCD

    You turn the instant you press the opposite direction, no need to let go of the old key first.

  • Radar

    A small map of the pitch at the bottom of your screen: see where everyone is at a glance.

One panel

All inside the game's own settings.

No extra window. Open Settings and the HaxBall Pro section is right there; type to find anything.

Interactive preview: a copy of the extension's panel you can play with. Changes are not saved.

Settings

LanguageEnglish

Video
Viewport Mode
FPS Limit
Resolution Scaling
Use low latency canvas
Custom team colors enabled
Show chat indicators
Show player avatars
Chat opacity
Chat focus height
Chat background width
Camera
Camera speed

How fast the camera follows you and the ball. Default 1.5x: together with smooth opponents it keeps the screen calmest. Instant: locked, but it carries the ball's corrections into the whole screen and opponents shake. Lower values can briefly leave a distant ball off screen.

Look ahead

Shifts the camera slightly towards the way you are moving so you see more of what is ahead.

Auto zoom near ball

The view zooms in smoothly as the ball comes near and returns as it moves away, which makes fine touches more precise.

Zoom level

The zoom level the camera goes to while the ball is beside you. Higher means more precision but less pitch.

Zoom distance

How close the ball has to be before the zoom kicks in. A small value waits until the ball is almost at your feet, a large one zooms earlier.

Ball path
Ball path

Draws the ball's path onto the pitch: where it will bounce off walls, where it stops, a green target if it is going in. If a player is near the ball it also draws a 'what if they kicked now' estimate.

What to show

Travel only: where the ball goes at its current speed. Kick only: where it would go if the nearest player kicked now. Both (recommended): the kick estimate thick, the free travel thin.

Visibility

How much the line stands out. Subtle: thin dashed trail, no arrow. Medium: a little clearer, small arrow. Bold: thick line and full arrow head.

Path length

How many seconds ahead are drawn. The line fades as it goes.

Speed readouts
Speed on discs

Writes each player's speed instead of their avatar. The disc design is kept exactly, the game draws it, only the text changes.

On whom

Me only: writes on your own disc, the screen stays clean. Everyone: writes on all players so you also see the moment an opponent turns.

Format

How the number is written.

Speed on ball

Writes the ball's speed above it while it moves. Colour band: dark for dribbling, orange for pass speed, red for shot speed.

Format

How many decimals the number uses.

Trails and contact
Contact point

Marks the point on the ball you are about to touch. Yellow means closing in, green means you are in contact. The notch on the far side shows where that contact will send the ball, so you can correct your angle before kicking.

Key press trail

A marker appears on your disc the moment you press a game key: a white ring for a kick, a yellow line for a direction. This is the earliest moment the screen can show your press.

True ball position

Draws the ball's true position on top of the one you see. You can keep extrapolation high and still know where the ball actually is.

Scope

Ball only: the cleanest and most useful. Ball and players: opponents' true positions are marked too, which helps when marking but crowds the screen.

Indicators
Ring around you

Draws a faint white ring around your own player so you can find yourself in a crowd.

Opponent direction arrows

Shows the direction each opponent is pressing as a small arrow beside their disc. Visible only to you, it does not affect the game.

For whom

Opponents: only the other team's arrows are drawn. Everyone: team mates get arrows as well.

Momentum colour

Turns the arrow purple when an opponent is genuinely committed: they cannot turn, so now is the moment to go the other way. While they move consistently the arrow stays amber.

Radar
Radar

Shows a small map at the bottom of the screen. Players are dots in team colour, ball and goals in their own colour, you have a white ring. Visible only to you.

Radar size

How large the mini map is. Its height adapts to the pitch on its own.

Frame rate
Resolution scale

Draws the game at a lower resolution, which raises the frame rate. Geometry, aiming and assists do not change, only the image softens. Applied instantly.

Frame health readout

Shows a live chip in the top left: how many frames are being drawn and how many dropped in the last second.

Pitch layer cache

Draws the ground and pitch lines once and stamps them as a single image each frame. The grass texture is kept.

Player sprite cache

Turns each player's disc into a single image and stamps it with one draw call per frame.

Flat ground

Reduces the pitch grass to a flat colour, removing the full pitch texture sampling every frame.

Ground colour

Pick the colour of the flat ground. The last circle lets you choose your own.

Pause grey filter

Removes the filter that greys the screen when the game pauses.

Zoom and smoothing
Remap zoom shortcuts

Points the 1 and 2 keys at any zoom level you choose.

Key 1

The zoom level the 1 key jumps to.

Key 2

The zoom level the 2 key jumps to.

Jitter damper

Smooths where the ball is drawn. When a correction arrives because the prediction missed, the ball slides into place instead of jumping.

Install

On the pitch in four steps.

No store, no account. Install once and it's ready every time you open HaxBall.

  1. Download

    r136-b34440 KBzip

    SHA-25677f6e528378d9a879f1bf123ef97e62430a909447ce55ea08a15d653e64007ab

    Download and unzip

    Download the zip and extract the folder somewhere permanent. The extension runs from there, so don't move or delete it.

  2. brave://extensions

    Open the extensions page

    Type brave://extensions into the address bar. On Chromium, chrome://extensions.

  3. Turn on Developer mode

    Switch on Developer mode in the top-right corner.

  4. Load the folder

    Click “Load unpacked” and pick the meyzirik folder (the one with manifest.json inside). Open HaxBall; the panel is in Settings.

Updates

Always getting better.

What changed in each version, briefly.

NewImprovedFixedEach disc is one change
r136-b34Latest

Everything starts off

  • Improved

    On a fresh install every setting starts off; turn on only what you want. Existing settings stay as they are.

All updates (10)Show less
  1. r136-b34

    Latest

    Everything starts off

    • ImprovedOn a fresh install every setting starts off; turn on only what you want. Existing settings stay as they are.
  2. r136-b33

    Ball smoothing knows the walls

    • ImprovedBall smoothing now knows the walls: a ball bouncing off a wall touches it on screen too.
  3. r136-b31

    A calmer camera

    • ImprovedCamera speed now defaults to 1.5x: together with smooth opponents, it keeps the screen calmest.
    • FixedWith smooth opponents on, the gap between the ball and an opponent now looks right.
  4. r136-b29

    Smooth opponents are here

    • NewSmooth opponents: late-arriving opponent moves now glide instead of snapping.
    • NewOptional ball smoothing: sudden ball jumps on screen drop by about 65%.
  5. r136-b26

    Turbo kick stays smooth in busy rooms

    • FixedA direction key no longer gets stuck down after you let go.
    • ImprovedTurbo kick now runs smoothly in busy rooms and follows the room's kick limit.
  6. r136-b25

    A steadier Auto Block

    • ImprovedAuto Block Defend now only resists opponents; touching the ball no longer throws you off.
  7. r136-b24

    The panel opens where you left it

    • ImprovedThe settings panel reopens where you left it: same section, same scroll position.
    • FixedWith flat ground on, the area outside the pitch now matches your colour instead of staying green.
  8. r136-b23

    Keeper mode reads the shot early

    • ImprovedKeeper mode reads the shot early and rushes a loose ball by the shortest path.
    • FixedKeeper mode no longer jitters in place, so rooms don't kick you for sending too many inputs.
  9. r136-b20

    Pick your ground colour

    • NewFlat ground colours: six presets, or pick your own.
    • NewKeeper mode can play while you hold its key, or automatically.
    • ImprovedAuto Block Defend reworked: side pushes move you far less and you slide back to your spot.
  10. r136-b18

    Find rooms by country

    • NewPick countries by flag in the room list, one or several at once.
    • ImprovedSettings search works in all nine languages and finds results from any tab.

Pricing

Download free. Use all of it.

Everything is free right now. Monthly and Lifetime plans are coming soon.

  • Starter

    Recommended

    See the pitch more clearly.

    Freeforever

    • Every feature included, for now
    • Ball path and radar
    • Camera and flat ground colours
    • SOCD (instant direction change)
    • Settings panel in nine languages
    Download free
  • Monthly

    Every assist and every smoothness setting.

    Price coming soon

    • Everything in Starter
    • Auto Block, keeper mode, Turbo kick
    • Kick assist and smart go to ball
    • Smooth opponents and jitter damper
    • All updates
    Coming soon
  • Lifetime

    Pay once, keep it for good.

    Price coming soon

    • Everything in Monthly
    • Every future version
    Coming soon

FAQ

Questions you might have.

Is it safe? Does it ask for my account or password?

No. HaxBall Pro asks for no account or password, has no server of its own and collects no personal data. Its game features only run on haxball.com; the "all sites" permission your browser shows is for the F2 open-address shortcut. Your settings stay in your browser.

Is it really free? When do the paid plans open?

Yes. The download includes every feature, with no account, payment or trial period. The Monthly and Lifetime plans aren't open yet; when they are, they'll be announced in the pricing section and in the updates.

Which browsers does it work in?

On desktop Brave (tested up to 1.96) and Chromium-based browsers that still support Manifest V2. Recent Chrome versions have turned V2 extensions off. It doesn't run on mobile.

Can I use it in every room?

Some rooms and leagues ban automation in their rules. Assists start switched off after install and you choose what to turn on; following the room's rules is up to you.

How do I update? Will I lose my settings?

Replace game-min.js in the folder with the one from the new version, then restart the browser; refreshing the page isn't enough. Your settings live in the browser, so they stay as they are.

Will it slow the game down?

No. Features run inside the game's own frame loop, and options like flat ground can even raise the frame rate on weaker machines. The pitch and sprite cache also makes frames lighter; it is experimental, starts off, and the gain depends on your computer.

Can I move my settings to another computer?

Yes. Export your settings to a single file from the Backup section and import it on the other computer. Your ground colour comes along too.

What if I want to remove it?

Turn it off or remove it at brave://extensions; the game opens just as it normally does.