Configuring Plugin Parameters
Each plugin has parameters that control its behavior during the build. Some are required (the build won’t work without them), others are optional with sensible defaults.
Opening Plugin Configuration
Section titled “Opening Plugin Configuration”- Double-click a machine to enter machine edit mode
- Click on a plugin in the build sequence
- The parameter configuration panel opens
Parameter Types
Section titled “Parameter Types”Parameters come in several types, each with a purpose-built editor:
| Type | Editor | Use Case |
|---|---|---|
| String | Text input | Simple values like usernames, IP addresses, domain names |
| Number | Numeric input | Ports, counts, timeouts |
| Boolean | Toggle switch | Enable/disable features |
| String Block | Code editor | Scripts, config files, multi-line content |
| CSV | Spreadsheet editor | Tabular data like user lists, IP tables |
String Block Editor
Section titled “String Block Editor”For string block parameters, you get a full code editor (Monaco — the same engine as VS Code) with syntax highlighting. Use the language selector to switch between:
- PowerShell, Bash/Shell, Batch
- Python, JavaScript, TypeScript
- YAML, JSON, XML, SQL
- Dockerfile, Plain Text
CSV Editor
Section titled “CSV Editor”For CSV parameters, you get a spreadsheet-style editor. The editor validates your CSV data on input, so you’ll catch formatting issues before the build runs.
Required vs Optional
Section titled “Required vs Optional”Each parameter shows whether it’s required or optional:
- Required parameters must have a value set before you can build. They show a warning indicator when empty.
- Optional parameters have default values that will be used if you don’t set them.
The plugin card in the build sequence shows a status indicator:
- Yellow — some required parameters are missing
- Green — all parameters are configured
Cross-Machine Dependencies
Section titled “Cross-Machine Dependencies”Some plugins depend on plugins running on other machines. For example, a Domain Join plugin on a workstation depends on a Domain Controller plugin running on a separate server.
When you open a plugin with cross-machine dependencies, the configuration panel shows which plugins on other machines this plugin depends on. Make sure those dependencies are configured and ordered correctly in the build sequence.
Rogue Oracle (AI Assistant)
Section titled “Rogue Oracle (AI Assistant)”For string block and CSV parameters, you can use Rogue Oracle — the AI assistant — to help generate parameter values. Click the Oracle icon to open a conversation sidebar where you can describe what you need, and the AI will generate the content.
Suggestions appear as a diff view so you can review the changes before accepting them. This requires the AI Builder permission.
Saving Parameters
Section titled “Saving Parameters”Parameters save individually. After setting a value, it’s persisted immediately. If you navigate away with unsaved changes, you’ll be prompted to confirm.