Holon Golf

Realistic multiplayer golf for Minecraft 1.21.1 (Fabric). Build your own courses, pick your clubs, and play a full round with your friends.

Features

A real golf swing, without the hassle

• Walk up to your ball with a club and right-click (or press G) to address it. The camera moves to a swing view and the HUD gets out of the way.
• Aim with the mouse. The aim starts pointed at your hole's pin.
• Swing with three clicks on a minimal power gauge:
  1. Start the backswing.
  2. Lock the power. The gauge runs from white (short) to red (long), and the distance is shown as you swing.
  3. Hit the impact line for a pure strike. Early fades or slices; late draws or hooks.
• A ball camera follows every shot with a live distance counter. Then you see the total distance, carry, your new lie and the distance to the pin.

Shot trace

• A thin, transparent red line shows where a perfectly struck shot will go.
• Full swings show the arc up to where the ball first lands.
• Putts show the line over the ground, following slopes and steps.
• Toggle it any time with V.

Seven clubs

• Putter, Wedge, Short Iron, Long Iron, Hybrid, 3 Wood and Driver, each with its own distance, launch and spin.
• The mod suggests a club for the distance. Scroll to change club while addressing the ball.
• Driver: 150 blocks carry. Wedge: 50. Putter: 22 blocks of roll on the green.

Club customisation (cosmetic only)

• Club + dye: grip colour (all 16 colours).
• Club + dye + stick: shaft. Satin, gunmetal or bronze steel, or coloured graphite.
• Club + dye + iron nugget: head finish. Satin chrome, mirror chrome, gunmetal, black PVD, blue ion, racing green, gold, copper or raw bronze.
• Club + paper: back to stock.
• Styles never change how a club plays, and enchantments are kept.

Course surfaces

Every surface plays differently, and it's all driven by block tags, so datapacks can change it.

• Green: moss. Fast, true roll.
• Fairway: grass. Full distance.
• Rough: grass with plants on it. Shorter shots, wider misses, less spin.
• Bunker: sand. The ball plugs. The Sand Wedge gets you out.
• Water: the ball sinks (penalty).
• Out of bounds: white concrete and barriers by default (penalty).
• Anything else plays as hard, bouncy ground.

Penalties and scoring

• Water hazard, out of bounds, lost ball and unplayable lie (/golf unplayable), each for one stroke.
• Hole-out results (Birdie, Par, Bogey...) on screen and in chat for nearby players.
• Scorebook: a full scorecard of your current round (front nine, back nine, to par) and a history of every round you've played. Click a past round to see it hole by hole.

Build your own courses

• Place tee markers and a golf flag for each hole.
• Use the Course Planner on a flag and it links the nearest free tee markers. You can aim anywhere near the pole, and while you hold the planner, the flag and its tees are highlighted before you click.
• Each hole gets its own colour, so you can see which tees belong to which flag.
• The Course Manager lets you create several courses of up to 18 holes each, with names, par, hole order and colours.
• Flags work on full blocks, slabs, half slabs, carpets and stacks of them. The cup always sits right at the surface.

Course building blocks

• Grass, sand and moss slabs, half slabs (layers) and carpets that stack on top of each other.
• Full Grass Block with grass on every side (no dirt).
• Rolling balls ride up carpets and slabs.
• Carpets and layers let light through, for lit greens and bunkers.

Golf bag

• Holds 12 clubs, so you have to choose your set.
• Worn on your back as a Trinket and visible to other players. Press B to open it.
• Clubs in the bag can be selected with the scroll wheel while addressing the ball.
• Place it on the ground as a standing bag.
• 17 styles: dye it any colour, or craft it with a fern for the original camo.

Golf cart

• A drivable two-seat cart with two bag slots at the back.
• It climbs blocks, stairs and slabs and tilts to follow the ground.
• Strap your bag on and pick clubs straight from the cart.
• Paint it with any dye.

Floodlights for night golf

• Light up your fairways after dark. The beam is invisible, but the ground gets lit.
• Adjustable beam angle and tilt. Trapdoors work as barn doors.
• Hostile mobs don't spawn within 30 blocks.

Enchantments

• Pitching Wedge, 52° Gap Wedge, Sand Wedge, 58° Lob Wedge: turn the wedge into a specific wedge type.
• Distance Plus I-III: +6% carry per level on the Hybrid, 3 Wood and Driver.

Built for multiplayer

• Ball physics run on the server, so everyone sees the same shot.
• Balls never collide with each other, and other players' balls can't be clicked, so nobody gets in your way.
• Each player has one ball in play, and scores are saved per player.
• Tested on dedicated servers with several players.

Getting started

1. Everything is in the Holon Golf creative tab, and every item has a crafting recipe.
2. Craft some clubs, a golf ball and a golf bag.
3. Place a golf ball on the ground and walk up to it with a club. Right-click to address the ball, then use the three clicks to swing.
4. To build a course, place tee markers and a flag, then use the Course Planner on the flag.

Controls

All keys can be changed in Controls, under "Holon Golf".

• G: address your ball
• B: open your golf bag
• C: switch camera view while addressing
• V: toggle the shot trace
• K: open the scorebook

Requirements

• Minecraft 1.21.1
• Fabric Loader 0.16 or newer
• Fabric API
• GeckoLib 4.8 or newer (for the golf cart)
• Trinkets 3.10.0 or newer (for wearing the golf bag)

The mod is needed on both the client and the server.