Technology

Boat configurator logic: option rules, trailer and clearance check on the 3D model

How a boat configurator links length, helm layout and equipment by rules, shows the trailer and compares the rig height with an entered clearance.

Short answer: a boat configurator needs three kinds of rule: "only with" (a T-top only with a centre console), "not with" (a large display not in the side console) and "switches to" (when a choice becomes invalid, it moves to the nearest one that fits, with a note). With a trailer, a dimension check comes on top: the height of boat and trailer from the 3D model is compared with a clearance the buyer enters. Our example configurator shows both with example values of a fictional boat.

Boat configurator – preview of the example configurator
Example configurator · fictional product · example values. Loads only when you click. Open the demo page →

Which options does the example have?

OptionExample valuesAffects
Length overall5.5, 6.2 or 6.9 m (beam 2.15, 2.35 or 2.50 m)whole hull, trailer length, engine classes
Helm layoutcentre console, side console, small cabinsuperstructure, seating, top, display, rod holders
Hullsix colours including natural aluminium; stripe none, pinstripe, double line or wide band in five colourstopsides
Deck and seatingfour deck finishes, four cushion colours; bow cushions, leaning post, rear bench each on or offcockpit, cushions
Equipmentno top, T-top or bimini; display 7, 9, 12 or 16 inch; rod holders none, 4 in the gunwale or 4 + 4 up high; swim laddersuperstructure, helm, transom
Engine and trailerfictional outboard in classes S, M, L and XL, three colours; trailer on or offstern, boat on land, height check
Clearance height2.0 to 4.0 m in 0.1 m steps, default 2.6 mheight check

All values are example values of a fictional boat. The engine classes carry a horsepower figure only as an example label; the demo makes no statement on speed, fuel use, load, number of people, design category or safety. For the display, the demo shows the screen size in 16:10 format, for example 25.8 × 16.2 cm at 12 inch.

What do length and helm layout change?

Length is not a scaled copy of one fixed model. The hull is rebuilt for each length with its own beam, depth and sheer rise, and the trailer grows with it. The helm layout sets the deck plan: the centre console has a walk-around deck, the side console puts the helm to starboard and leaves more open deck, and the cabin sits forward with the helm behind it.

The labels change with the helm layout too. With the cabin, the bow cushions become a sun pad on the cabin roof; with the side console or cabin, the leaning post becomes a helm seat.

Which option rules does the example apply?

Example ruleTypeWhat happens
T-top only with a centre consoleonly withdisabled for side console and cabin, with the reason on the button; switching layout with a T-top selected moves to the bimini
16 inch not in the side consolenot withdisabled for the side console; switching to the side console with 16 inch selected moves to 12 inch
Rod holders up high need a T-top, leaning post or cabinonly withotherwise disabled, with the reason on the button; if the condition goes away, it moves back to 4 in the gunwale
Engine class XL from 6.2 m onlynot withdisabled at 5.5 m, with the reason on the button; switching to 5.5 m with XL selected moves to class L
Stripe colour without a stripeswitches tothe pinstripe is switched on so the colour shows
Cushion colour without seatingswitches tothe rear bench is switched on so the colour shows

Automatic switches come with a short note. An example of a chain: with a centre console, a bimini and "4 + 4 up high", the extra rod holders sit on the leaning post. Turn the leaning post off and they lose their condition, so the rod holders move back to 4 in the gunwale. Where the upper rod holders sit, on the T-top, the leaning post or the cabin roof, is stated in the review.

Because invalid combinations never come about, the review always reports "All selected options work together (example rules)". The rules themselves are short conditions in the program; the options and values live in a separate data file. In a project, your approvals come in, such as which engines are approved for which hull; the demo only shows one example rule for that.

What does the trailer show?

Without the trailer, the boat is in the water, and the review notes that delivery into the water or onto the buyer's own trailer is for the manufacturer to decide. With the trailer, the boat stands on land on a road trailer with bunks, keel rollers and winch post, outboard tilted up. "Launch" plays the launch in about seven seconds: the trailer reverses down the slipway with its pitch following the ground, the boat floats off and levels, the outboard tilts down and the empty trailer drives back up. "Retrieve" plays it in reverse. With reduced motion set in the system settings, the demo jumps straight to the end state.

How does the clearance check work?

With the trailer on, the engine step shows "Check a clearance height (e.g. garage, carport)". The buyer sets a height between 2.0 and 4.0 m with minus and plus. The demo compares it with the highest point of boat and trailer, measured on the 3D model on land: boat on the trailer, outboard tilted up, rods and light mast excluded. A height barrier stands in front of the rig, green or red, with a label.

  • Fits: a green message with the height on the trailer and the space to spare.
  • Too tall, with a T-top: a red message noting that the rig is lower without the T-top or with the bimini.
  • Too tall, without a T-top: a red message noting that the manufacturer decides which parts can be removed or folded for transport.

In the test log, the default set-up with a T-top gave a height on the trailer of 3.20 m. Against the default 2.60 m the check is red, and at 2.00 m as well; at 4.00 m it turns green with 0.80 m to spare. If the boat is in the water at that moment, pressing minus or plus puts it back on the trailer so barrier and rig can be seen together.

The check compares a height from the 3D model with a number the buyer types in. It does not say that a boat fits a particular garage. A folding bimini is not modelled. Transport dimensions are set by the manufacturer. In a project, the same logic can check other dimensions, such as rig length against the depth of a parking space.

What is in the review, the enquiry and the PDF?

The review lists 15 rows: length, beam, helm layout, hull colour, stripe, deck finish, seating, cushions, shade, display, rod holders, swim ladder, outboard, engine colour and trailer. With the trailer, the height on the trailer and the length and width of boat and trailer are added, both as example values from the 3D model. Below them are the example checks and the disclaimer.

In the enquiry step, the buyer can optionally enter name, company, email and phone and pick a use and a quantity, up to "Dealer programme". From this the demo creates a copyable text and a PDF with two images: the boat in the water and, with the trailer, on the trailer, otherwise a side view. The enquiry is not sent; text and PDF are created in the browser only.

Example configurator · fictional product

Boat configurator

Put together a console boat: length, centre or side console or cabin, hull colour and stripe, deck, cushions, T-top or bimini, display, rod holders, outboard and trailer – with a launch animation, a clearance check and a PDF enquiry.

Docks & marine · Dimensions and sizes · Colours · Materials and finishes

What does a project add?

For your range, your hull lines replace the parametric model, from an offsets table or from existing 3D data if it is suitable. Your deck layouts, superstructures and options come in as separate parts, your engine pairing table per hull replaces the example rule, and the enquiry carries your model codes and goes by email or webhook to sales or a dealer. How water, geometry and interaction are handled for marine products is covered in Implementing a dock configurator; the sales view for builders and dealers is in Boat configurator for boat builders and dealers. The project process is described on 3D configurator development, and the demo itself is on its library page.

Send us your equipment list with your combination rules, and we will reply with a proposal for the logic and a fixed-price quote.

Frequently asked questions

When does the configurator disable an option, and when does it switch?

An option that does not fit the current choice is disabled. If a later change makes an option you already picked invalid, the demo moves it to the nearest one that fits and says so in a short note.

Does the height check tell me whether the boat fits my garage?

No. It compares the height of boat and trailer in the 3D model with the clearance you enter, as an example calculation. Binding transport dimensions come from the manufacturer.

Can we add our own rules?

Yes. The "only with", "not with" and "switches to" pattern carries over to further options, and the height check is a template for other dimension checks.

Sources

  1. Demo features: "Live in this demo" list and note on the boat configurator library page, read 18 November 2026: modelwright.de/en/library/boat-configurator/
  2. Options, rules, height check and review: demo source code (data.js: LENGTHS, DISPLAY, ENGINE, CLEAR, DEFAULTS; app.js: rules, automatic switches, height calculation, review, PDF) and schema notes, read 18 November 2026; height values from the QA log of 17 November 2026, emulated devices.

Read next