Tweaker Clarification : READ THIS FIRST

I would like to address some questions we have had about the documentation. Hopefully this forum post will be a way for beginning programmers to get the solutions they are looking for without becoming frustrated due to the technical requirements the tweaker requires for installation.

1) In the most recent version of the Plastic Tweaker, the build excluded the 'plastic' folder. Rename the folder 'TGE' or 'TGEA' to be 'plastic'. Follow instructions as provided for the appropriate engine. This only applies to the demo

2) When I use "YOURGAMEPROJECT" I mean it in an abstract sense. If you used starter.fps that would replace YOURGAMEPROJECT, if you choose to rename the folder to superAwesomeCoolGame you would you use that. I hope this clears up the confusion

3) Depending on the engine you will find different extensions .cc and .cpp for the source files

4) Because we only distribute the tweaker in .dso format you need to change the DeleteDSO.bat file otherwise the tweaker will be deleted. Because there are several file layouts even between the various engines I will provide an example HOW to change the bat file for TGE.This only applies to the demo, release now has .cs files

right click DeleteDSO.bat -> select edit change the existing command from

del /s *.dso

to something like

cd common
del /s *.dso
cd ..
cd show
cd del /s *.dso
cd ..
cd dedicated
cd del /s *.dso
cd ..
cd creator
del /s *.dso
cd ..

Essentially you are using dos prompt commands to change directory (cd) to a sub folder, erasing all the .dso from that folder and it������¢���¯���¿���½���¯���¿���½s sub folder, then going up the hierarchy and repeating for all folders EXCEPT the plastic folder Be sure to add commands to accommodate YOUGAMENAME folder

5) The tweaker now officially supported by TGB for licensed owners, the cs files should work with T3d but we have not started using that engine just yet.
6) A macroprocessor is a C side if statement

#ifdef TORQUE_TOOLS
//some code
#endif

The above states if this Macro called TORQUE_TOOLS is defined execute the code other wise it will be ignored when compiling. The visual clue to see what the current state of the macro is that the code within the macro is grey if the block of code is to be ignored (ie is not defined)

7) When looking for where to put the Pathcopy function go to the bottom of the file consolefileSystemFunctions.cpp or do a find in file for ������¢���¯���¿���½���¯���¿���½ConsoleFunctionGroupEnd( FileSystem );������¢���¯���¿���½���¯���¿���½ place the new code just before this line.

I hope this clears up some of the confusion.



T3d 1.2 FIX
in plastic/controls/comboBoxPopupControl.cs Change the ComboBoxPopupControl::createComboBoxPopupControl & ComboBoxPopupControl::onWake to look like this

function ControlFactory::createComboBoxPopupControl(%this, %class, %pos, %extent, %profile)
{
   if (%profile $= "")
      %profile = GuiPopUpMenuProfile;
      
   if (%class !$= ComboBoxPopupControl)
      %superClass = ComboBoxPopupControl;
         
   // first just create the popup...but create it INVISIBLE...   
   %ctrl = new GuiPopUpMenuCtrl()
   {
      superClass = %superClass;
      class = %class;
      profile = %profile;
      position = %pos;
      extent = %extent;
      //visible = false;
      visible = true; // IMPORTANT - must be visible so it will load the font, onWake will hide!
   };   
            
   return %ctrl;
}

// IMPORTANT - this is how we hide the popup controls now...
function ComboBoxPopupControl::onWake(%this)
{
   %this.setVisible(false);
}

Good Luck and Happy Tweaking

Related Tweaker Resources
Plastic Gem 35 : Plastic Tweaker
Plastic Gem 36 : Plastic Tweaker comments
Plastic Gem 37 : Plastic Tweaker Support
Plastic Gem 38 : Plastic Tweaker Application
Plastic Gem 39 : Plastic Tweaker Animated GUI