Note: To search plugins click here!
Create or Modify PE Builder plugins
If you want to build your own plugin, this is the first document you should read. You can use other plugins that come along with BartPE to help you gat started. A plugin is essentially an inf file that you create. There may be additional files supporting a plugin such as a help document and an xml file (eg.ghost_nu2menu.xml) that is used to create an entry in the nu2menu (the default shell of BartPE). In addition you may need other plugin specific files such as the executable files for an application.
PE Builder v3 plugin helpPE Builder Copyright (c) 2002-2003 Bart Lagerweij. All rights reserved.
Last updated: Dec 22, 2003
IntroductionThis document should help to create or modify PE Builder plugin files. The main .inf file for PE Builder is pebuilder.inf file. Please do not edit this file! If you want to change something use a plugin file. All plugins are located in the plugin directory. Every .inf file in the plugin directory (doesn't matter in which folder) with a "pebuilder" section is considered a valid plugin for PE Builder. Use the Enable/Disable button in the plugin dialog to turn plugin on/off.
Creating a pluginA plugin .inf file must be an ascii file, not unicode. Lines starting with a ";" (semicolon) are ignored (used for comment).
Every plugin file should start with the lines shown below:
; PE Builder v3 plug-in INF file ; Created by Bart Lagerweij ; http://www.nu2.nu/pebuilder/ ; ; Short description of that the plugin does... [Version] Signature= "$Windows NT$" [PEBuilder] Name="NiceNameOfPlugin" Enable=0 Help="pehelp.php"You should change the name, url and other settings, this is just an example...
Please note that you must include the [Version] Signature= "$Windows NT$" information. Otherwise the setupapi functions cannot open the .inf file. Please use the information below to add more section to your plugins...
WinntDirectories sectionSection WinntDirectories is in the following format:
[WinntDirectories] ; Always create a folder in the root called "Bart" a="Bart",3 ; Create a folder in the root called "Project\Bart\Source" b="Project\Bart\Source",3 ; Create a folder in the i386 directory called "extra\files" c="extra\files",1
Here is a list of the (most used) directories ID's:
PE Builder uses directory id's starting from 30000. Where id 30000 is used for the output root directory. 30001 and up are dynamically used by PE Builder.
The section SourceDisksFiles uses the following format:
filename=directoryID[, filenameRenamed][, attribute]
The section SourceDisksFolders uses the following format:
[WinntDirectories] a="Programs\openoffice",2 [SourceDisksFolders] ; when openoffice folder is in plugin directory openoffice=a [SourceDisksFolders] ; when openoffice folder is at c:\ c:\openoffice=a
Add registry keys to the "Software" registry hive. This section is in the following format:
regType, regKey, regValue, regData
0x1, "Microsoft\Windows NT\CurrentVersion\Fonts", "Tahoma (TrueType)","TAHOMA.TTF" 0x2, "Control Panel\desktop", "WallPaper", "%systemroot%\system32\nu2.bmp" 0x3, "ControlSet001\Control\TimeZoneInformation", "DaylightStart",\ 00,00,04,00,00,01,00,02,00,00,00,00,00,00,00,00 0x4, "ControlSet001\Control\GraphicsDrivers\DCI", "Timeout", 0x7 0x7, "ControlSet001\Services\VgaSave\Device0", "InstalledDisplayDrivers","vga", "framebuf", "vga256", "vga64k"
Add registry keys to the "SetupReg.hiv" registry hive. Same syntax as Software.AddReg
Add registry keys to the "Default" registry hive. Same syntax as Software.AddReg
Delete registry keys from the "Software" registry hive. This section is in the following format: regKey[, regValue]
Delete registry keys from the "Default" registry hive. Same syntax as Software.DelReg
The lines in the AddLine section have the following format:
"netmscli.inf", "MSClient.DelReg", "HKLM, Software\Microsoft\Rpc\SecurityService, 9"
The lines in the DelLine section have the following format:
"netmscli.inf", "MSClient.Browser.AddReg", "HKR, Parameters, MaintainServerList,"
The lines in the SetValue section have the following format:
"netmscli.inf", "Alerter_Service_Inst", "StartType", "3"
Use Filename,Section,Key to remove a key
Use Filename,Section to remove a complete section
The lines in the Append section have the following format:
PEBuilder sectionIf you are creating a plugin, your .inf file must have an [PEBuilder] section!
This section has the following fields:
Copyright (c) 2000-2004 by Nu2 Productions. All rights reserved.