Stencil

Author: Entropiex

Description

Stencil is a KSP editor addon that provides reference model visualization and advanced slicing capabilities for ship design analysis. Import 3D models (.STL) directly into the editor to overlay reference geometry for precise alignment and design verification.

Usage

Loading Models

1. Click the Stencil toolbar icon to open the panel
2. Click Choose File to browse Kerbal Space Program/Stencil/ folder
3. Select a model file (.stl, .obj, .fbx, .dae)
4. Click Import to load

Transform Controls

• Use Move step / Rotate step inputs to set nudge increments
• Click X±/Y±/Z± buttons to adjust position or rotation
• Quick Align buttons snap to cardinal directions
• Drag the panel window freely (no click-through to editor)

Display & Color

• Opacity: Control transparency (0-1)
• Scale: Uniform scaling control
• Display Mode:
• Outer: Opaque exterior shell
• Mixed: Semi-transparent display
• Color: Enter hex codes (#RRGGBB or #RRGGBBAA) or use preset buttons

Slicing Modes

Open the Slice Window to access cross-section analysis:

1. Mode: Select All / Half / Between
2. Direction (Half mode): Keep + (positive side) / Keep - (negative side)
3. Direction (Between mode): Keep + (between planes) / Keep - (outside planes)
4. Quick Cut: Front/Back/Left/Right/Up/Down (auto-centers on model)
5. Manual Plane Control: Position and rotate each plane independently
6. Plane A/B Position: X/Y/Z nudges (step = 1)
7. Plane A/B Rotation: X/Y/Z nudges (step = 15°)

Compatibility

• KSP Version: 1.9+
• .NET Framework: 4.7.2

Known Limitations

• Gizmo-based transform tools planned for future release
• Supported model formats: STL (binary/ASCII), OBJ, FBX, DAE (limited geometry parsing)

License

Open source. See LICENSE file for details.

For issues, feature requests, or contributions, please visit the project repository.