Understanding Sketchup Guides Gptg
Sketchup Guides Gptg is a Ruby extension for SketchUp that automates the placement and management of reference guides. Most people use it when they need to set up repetitive dimensioning across multiple views — layouts for floor plans, section cuts, elevation studies. It's not part of the official SketchUp library, and you won't find it in Extension Warehouse. The source is typically pulled from a GitHub repo or shared directly between teams. I found myself dealing with it around three years ago on a commercial tenant improvement project. The architect on the team had 40+ rooms, each needing consistent grid markers at 4-foot intervals. Doing that manually through the standard Guides tool would have taken me most of a week. The script cut it down to something manageable in a single afternoon.
Sketchup Guides Gptg
The installation is straightforward but not foolproof. Download the .rbz file from the repository, then go to Extensions > Extension Manager > Install. Point it at the file. If you're running SketchUp 2021 or later and the extension doesn't appear after installation, check the console — type View > Console from the menu. Common error is a dependency issue with the SketchUp API version. The author usually notes which build versions are supported in the README. Once installed, the tool appears under the Extensions menu. The interface is minimal — mostly a dialog box where you define guide parameters. You set spacing, orientation (horizontal, vertical, or both), and the area of application. The key workflow is selecting geometry first, then running the command. The script creates guide lines at your specified intervals within the bounding box of your selection. Here is where things get slightly messy. I ran into a problem recently where the guides would not appear in Section Cut views. Turns out the extension creates guides in the model's Z-up plane by default, but certain section cuts with non-standard angles don't render them correctly. The workaround is to create a fresh layer, assign the guide geometry to it, and then toggle visibility per view. It adds a step, but it's the only reliable fix I've found without modifying the source code directly.
Another thing nobody really warns you about: the extension does not create construction lines that are truly parametric. These are static guide placements. If you modify the geometry after running the script, the guides do not update. You have to delete and re-run. I learned that the hard way when a client changed wall locations mid-project and I spent twenty minutes tracing back which guides were now misaligned. For people who need adaptive guides, the alternative is to use SketchUp's native Layers combined with a custom Ruby script that references component definitions. It takes more setup time upfront, but the payoff is that your guides move with the model instead of staying stuck in place. If your workflow involves frequent design changes, that difference matters a lot. The scripting side of Sketchup Guides Gptg is accessible if you know basic Ruby. The core logic sits in a single file, and the author has included comments throughout. You can tweak interval calculations, add offset values, or modify how the bounding box is determined. I added a small patch that lets you specify a margin offset so the guides don't extend past the selection boundary — saves me from cleaning up stray guide lines every time.
Get the Full Details
Performance is generally fine for models up to around 50,000 guide lines. Beyond that, your viewport starts to lag noticeably. I've seen users push this to 200,000+ guides on large campus master plans, and the response time becomes unusable. In those cases, breaking the work into smaller viewports or using the native guide tool in stages is the only practical approach. If you're just starting out with this tool, I'd recommend keeping a backup of your model before running any bulk guide operations. One bad click on the wrong selection can scatter hundreds of guide lines across the wrong part of your model, and undo history in SketchUp only goes so deep. I've lost work to that more times than I want to admit.
