G-Ready Blender Addon Documentation

Tools to streamline common hard-surface and SubD modeling tasks.

Object Mode Buttons:

• Add Mirror: Adds a Mirror Modifier (X-Axis, Bisect, Clip).
• Add Bevel: Adds a Bevel Modifier (Limit: Weight, Segments: 1).
• Add SubD: Adds a Subdivision Surface Modifier (Levels: 2).
• Add Decimate: Adds a Decimate Modifier (Mode: Un-Subdivide, Iterations: 2) to selected objects and any other objects sharing the same mesh data.

Edit Mode Buttons (requires mesh selection):

• Bevel W (Slider & Apply): Applies the slider value as Bevel Weight to selected edges.
• X (next to Bevel W): Resets Bevel Weight to 0 for selected edges.
• Crease (Slider & Apply): Applies the slider value as Crease to selected edges.
• X (next to Crease): Resets Crease to 0 for selected edges.

Manage modifiers and object properties across multiple selections.

SubD Level:

• Sync (UV Sync Icon): Syncs SubD levels of selected objects (and linked-data instances) to match the active object's SubD level.
• +/- Buttons: Increases/decreases SubD levels for all selected objects (and linked-data instances).

Toggle Modifiers:

Quickly show/hide modifiers in the viewport. These toggles affect selected objects and any other objects sharing the same mesh data.

• Toggle Booleans: Toggles all Boolean modifiers. Also hides/unhides linked-data-only objects that weren't part of the initial selection.
• Toggle SubD & Bevel: Toggles all Subdivision Surface and Bevel modifiers.
• Toggle Decimate: Toggles all Decimate modifiers.
• Toggle Last Boolean: Toggles only the last Boolean modifier in the stack, provided its operand object matches the last Boolean operand of the active/reference object. Useful for iterating on specific cuts.

Tools for manipulating beveled edges.

• Bevel Select: A shortcut for mesh.loop_multi_select with ring=True, useful for selecting bevel edge loops.
• ReBevel: Unbevels the selected edge chains to a sharp edge, merges the resulting vertices, and then immediately starts Blender's interactive Bevel tool (Shift+Ctrl+B).
• UnBevel: Interactively removes the selected unbevel "segment" (the inner edges of a bevel).
  • Move mouse left/right to control the unbevel amount (from original to fully merged).
  • Edge Slide (Checkbox): When enabled, the unbevel operation attempts to slide the outer vertices along their adjacent edges, helping to preserve the surrounding curvature. When disabled, vertices move linearly towards a calculated pivot.

Usage for UnBevel/ReBevel: Select the inner edges of a bevel chain (not the outer "rail" edges).

Advanced selection operators.

Easy Loop (Factor Edge Select):

• Selects edge loops based on angle similarity. Adjust the Threshold Factor (0 = 0°, 1 = 180°) to control how sharp an angle the selection can turn.
• Usage: Select one or more starting edges of a loop.

Select Surface:

• Selects connected faces based on the angle between their normals. Set the Angle Threshold (Degrees).
• Usage: Select one or more starting faces. The operator will expand the selection to adjacent faces as long as the angle between them is less than the threshold AND the connecting edge is marked as "smooth".

• Boolean Cleanup: An interactive tool to help resolve n-gons often created by Boolean operations.
• Usage: Select a loop of edges that forms the boundary of an n-gon (or a problematic area). The operator will:
  1. Attempt to identify two "sides" (Group A & B) of the selected edge loop.
  2. Enter an interactive mode where you can adjust a Distance Limit with the mouse (left/right). Vertices from one group (mover) will snap to the closest vertices of the other group (target) if they are within this limit.
  3. Mouse Wheel: Swaps which group is the mover.
  4. LMB: Confirms the merge. Vertices are snapped, and then Merge by Distance is applied to the affected area.
  5. RMB/ESC: Cancels.

Purpose: Quickly set up a material for faked edge highlights using Cycles' Bevel Node. This is useful for high-poly visualizations or bakes where you don't want actual bevel geometry.

Controls:

• Radius (Slider): Controls the radius of the Bevel Node effect.
• Apply Bevel Shading:
  • Sets Render Engine to Cycles and configures GPU, samples, denoising.
  • Sets Viewport to Rendered, disables scene lights/world, and sets a specific studio light (city.exr).
  • Modifies the active material of selected objects:
    • Ensures a Principled BSDF is connected to the Material Output.
    • Sets Principled BSDF: Metallic to 1.0, Roughness to 0.3, Base Color to a mid-grey (#7C7C7C), unless inputs are already linked by textures.
    • Adds or updates a Bevel Node, connecting it to the Principled BSDF's Normal input.
• Remove Bevel: Removes the Bevel Node from the materials of selected objects and attempts to reconnect any previous normal inputs.

Purpose: Prepare objects for high-to-low poly baking by renaming them according to common conventions (e.g., ObjectName_low, ObjectName_high, ObjectName_cage) and moving them into corresponding collections.

Controls:

• Auto Rename Selected (Button):
  • Pairs selected meshes based on Poly Count (to determine low/high) and optionally Bounding Box Similarity and/or Pivot Point Proximity (controlled by checkboxes and thresholds).
  • Rename Mode:
    • Numerical: Pairs are named 0_low, 0_high, 1_low, 1_high, etc.
    • High -> Low: Base name is taken from the identified high-poly object.
    • Low -> High: Base name is taken from the identified low-poly object.
  • Moves renamed objects to "Low", "High", and "Cage" collections.
  • Matches selected _cage objects to their corresponding final _low objects.

Purpose: A comprehensive baking toolkit supporting various workflows.

Baking Operations:

• Use GPU (Checkbox): Toggles Cycles device between GPU and CPU.
• Create Cages:

  • To enable "Create Cage" button, create 2 collections with exact names of "Low" and "High" (case sensitive). Include your low and high poly meshes in corresponding collections. Button will be active.

  • Duplicates objects from the "Low" collection to create cage meshes.
  • Moves them to a "Cage" collection.
  • Applies a Cage Offset (Shrink/Fatten).
  • Optionally applies a "No Skew" (Edge Split modifier with Angle/Sharp Edges) before offsetting to improve cage quality on hard edges.
  • Sets object colors for Low (white), High (red), Cage (green) and sets viewport shading to Object Color.
• Visualize Ray Distance (Eye Icon next to Max Ray Distance): Creates visualizer objects that show the current Max Ray Distance setting as a solidify modifier. Updates live. Click again or use Remove Max Ray Distance Visualization to remove them.

Bake Settings:

• Bake Mode:
  • High to Low: Standard selected-to-active baking. Requires selecting _low suffixed objects. High-polys are found by name (_high, _high.xxx).
  • Low Only: Bakes properties from the object itself (e.g., Ambient Occlusion on the low-poly).
• Bake Map Type: Standard Blender bake types (Normal, AO, Combined, etc.).
• Normal Format (if Bake Type is Normal): OpenGL (+Y) or DirectX (-Y).
• Resolution Preset / Custom Width/Height: Output texture size.
• Anti-Alias Output (Compositor): EXPERIMENTAL. Renders the baked image through the Compositor's Anti-Aliasing node. Slower, clears existing Compositor setup.
• Samples: Cycles baking samples.
• Margin (px): Pixel margin for the bake.
• Use Cage Object / Extrusion / Max Ray Distance: Standard Blender bake cage settings.

Save Image:

• Output Directory: Where to save baked maps (in a "baked_maps" subfolder).
• Image Format & Format Options: PNG, JPEG, TIFF, etc., with relevant compression, bit depth, and color mode settings.

Bake Buttons:

• Bake Selected (Closest Hit):
  • Performs a standard Blender bake.
  • In High-to-Low mode, it bakes all found _high and _high.xxx meshes for a given _low object simultaneously onto the _low object.
  • Uses a single shared image texture for all selected _low objects being baked to.
• Matrix Bake:
  • EXPERIMENTAL. For batch baking multiple assets.
  • High-to-Low: Duplicates all _low/_high/_cage trios found in the scene, distributes them in a grid, joins all low-polys into one, all high-polys into one, etc., then bakes these combined meshes.
  • Low Only: Duplicates selected meshes, distributes, joins, then bakes.
  • Keep Combined After Bake: If checked, the temporary combined meshes used for baking are not deleted.
• Decal Bake (Sequential):
  • For High-to-Low mode only.
  • Bakes multiple _high.xxx meshes onto a single _low mesh sequentially, one after another, in numerical order of the suffix (e.g., _high, then _high.001, then _high.002).
  • Uses a smaller margin (1px) for _high.xxx meshes, and the user-defined margin for the base _high mesh.
  • Ideal for baking layered details like decals or panel lines where later bakes should precisely overlay earlier ones.

Purpose: Apply vertex colors to selected mesh components using Blender's Vertex Paint operators behind the scenes.

Controls:

• Color Picker & Apply: Sets selected vertices to the chosen color.
• Random: Applies a unique random color to the selected vertices. Ensures the color is not already present (within tolerance) on other parts of the mesh.
• Select by Color: Selects faces with an average vertex color similar to the initially selected face(s). Adjustable Tolerance in the Redo Last panel.

Note: These operators automatically set viewport shading to "Vertex Color" to visualize results.

Purpose: Generate a specified number of Level of Detail (LOD) meshes from selected objects.

Controls:

• Max LOD Level: Number of LODs to generate (e.g., 3 creates LOD0, LOD1, LOD2, LOD3).
• Generate LODs:
  1. The selected object is renamed to BaseName_LOD0 and moved to an "LOD0" collection.
  2. For each subsequent LOD level (LOD1, LOD2, ...):
     1. LOD0 is duplicated.
     2. A Decimate modifier (Collapse, Triangulate) is applied with a progressively smaller ratio (e.g., LOD1=0.5, LOD2=0.25).
     3. The decimated mesh is moved to a corresponding "LODx" collection.
  3. After all LODs (1-N) are generated, the following batch operations are applied only to LOD1 through LODN:
     1. Clear Custom Split Normals data.
     2. Shade Auto Smooth (default 30 degrees).
     3. Convert to Mesh (to apply auto smooth).
     4. Add Weighted Normal modifier.
     5. Enable "Keep Sharp" on the Weighted Normal modifier.
     6. Convert to Mesh again (to apply weighted normal).

• Links to Pivot Point's YouTube and X (Twitter).
• Button to copy Farid Mammadov's contact email to the clipboard.