Buldozer Manual

From Bohemia Interactive Community
Revision as of 19:05, 15 August 2014 by Tom 48 97 (talk | contribs) (text < Reset camera and object rotation)
Jump to navigation Jump to search

What's Buldozer

Buldozer is a viewer for the Virtual Reality Engine. It comes on some of sub program of the main application (here, Arma 3) that’s able to load environments and model in a basic setup to show a preview of your work from Object Builder and Terrain Builder.

Notes

Before anything, you must keep in mind that Buldozer won't work as expected if you run Object Builder from Steam or from Arma 3 Tools Launcher if this last was ran from Steam. The best case of use is to run Arma 3 Tools Launcher from the installation directory and run Object Builder from it. This is because Steam doesn’t support the fact tools and buldozer don’t share the same App id and prevent an app (e.g.: tools) to run another app (e.g.: buldozer) as a child process or even allow communication between these applications.

You will probably need to mount the drive P after each startup of your workstation, no worry, this takes no more than 2 seconds.

How to install

Substitute Drive P

What's that?

Firstly, you will need the famous P:Drive, created (mounted) by MapDisk and populate by DevP. P is not a virtual drive but a substitute drive, the concept is very simple: It associates a path (from anywhere in your file system) to a drive letter, in some kind, a shortcut, a letter for a directory. P is well known to be used even necessary to use Bulldozer. To explain a little, most of the tools are prepared with P in mind because it’s simple for everyone, the community and us (BI developers). The first iteration of the tools (without P: drive) was more meant for expert users who should be able to set their own working drive according to their needs in all tools (and may name it even differently than P: drive).

Installation

  1. Acquisition: Download Arma 3 Tools from Steam (Tools library)
  2. Installation: Run (play say Steam) Arma 3 Tools at least once from Steam to perform the installation (registry and other additional stuff like binMakeRules)
  3. Preparation: (optional) By default, the P drive will be located in the root directory of Arma 3 Tools (e.g.: F:\Program Files\Steam\SteamApps\common\Arma 3 Tools) but with all the tools installed, it could difficult to find what you’re looking for in this jungle.
    Here, two methods:
    1. Run Arma3Tools.exe, click “Preferences” >> “Edit Settings” (or CTRL+E), then, go into P Drive tab, uncheck “Use default” and define your path
      a3ct settings.jpg
    2. You can also edit your file settings.ini (root directory of Arma 3 Tools) manually, the result will the same with an additional risk of error.
  4. Test: Now, let’s mount P, just to be sure it’s working. If arma3tools.exe is opened, just Mount P: Drive (or “Misc” >> “Mount P”). Otherwise, in the root directory, you will find mapDisk.bat, just run it

Buldozer installation

If at this stage, you were able to mount your P, you’re good for the next. So, now, it’s time to install Buldozer.

  1. From Arma3Tools.exe, at the bottom, there is a group called “misc”, click over “P: Drive (DevP)”
  2. “default” and click “Run”
    a3ct mainExe devp.jpg
  3. This step is automatic, you just need to wait (generally, it takes from 30 seconds to 2 minutes)
  4. Let’s check if it succeeded, at this step, you should have a working P: Drive containing:
    “p:\A3\”
    “p:\Bin\”
    “p:\Core\”
    “p:\Buldozer.exe”
    “p:\ PhysX3*.dll” (4 files)
    “p:\steam_api.dll”
    “p:\steam_appid.txt”

Or you can also use an alternate method

  • Copy the executable of the game “Arma3.exe” to P and rename it to “buldozer.exe”
  • Use BankRev -f to extract bin.pbo of the game into P:\Bin
  • Use BankRev -f to extract core.pbo of the game into P:\Core
  • Copy converted \A3\Data_F\halfa.paa to P:\A3\Data_F\halfa.paa (this file available in the directory “Samples_F\Data_F”
  • Copy every “PhysX3*.dll” from the Arma 3 directory to P:\
  • Copy Steam_api.dll and steam_appid.txt to P:\

Buldozer configuration

This is almost done, you just need to generate the configuration and set the path and startup parameters from Object Builder and/or Terrain Builder, depends on what you need. This step is really quick!

  1. Run Buldozer Configurator
  2. Select the preset you want and click apply configuration
  3. Buldozer is configured!
    a3ct buldozerConfigurator.jpg

Or you may want to handle the process manually, as usual, there is an additional risk of error:

  • Open Object Builder, go into “File” >> “Options”
  • Set the following parameters:
    a3ct objectBuilder options.jpg
    • External Viewer: P:\buldozer.exe -buldozer -name=Buldozer -window -noLand -exThreads=0 -noLogs -noAsserts -mod= -cfg=p:\buldozer.cfg
    • DLL Folder: <steamPath>\steamapps\common\Arma 3 Tools\ObjectBuilder

(replace <SteamPath> with the full path to your Steam directory), in the end, this must points the root directory of Object Builder.

    • Path for textures: P:\
  • Open Terrain Builder, go into “Tools” >> “Preferences”
  • Set the following parameters:
    a3ct terrainBuilder options.jpg
    • .exe file path: P:\Buldozer.exe
    • Launch parameters: -buldozer -name=Buldozer -window -exThreads=0 -disableSteam -noAsserts -cfg=p:\buldozer.cfg
    • Data Directory: P:\

Notes

Here some details about the startup (launch) parameters for buldozer:

-buldozer Force to run the subprogram “Buldozer”, otherwise, it will run in normal mode (Arma3 game)
-window we want to run windowed
-noLand (Object Builder Only) Load the program without world entry (a grey world is generated)
-exThreads=0 When omitted Buldozer loads 20 times slower
-noLogs we don't want to log events and slowdown Buldozer
-noAsserts we don't want to be bothered with asserts in Buldozer
-mod= force to use local directory (e.g. P:\ArmA3) instead of your Steam library installation
-cfg=p:\buldozer.cfg alternative placement for per-user .cfg


How to use it?

From Object Builder

Run Buldozer and basics

You need to have a loaded model (p3d), then, just click on the “red icon” (this is the icon of the very first game of the series: Arma: Cold War Assault) and click “Start/Restart”.

a3ct objectBuilder toolbar.jpg

From this red icon, you can refine what Buldozer shows, here an example with hidden textures & materials and shown wireframe & shadow:

a3ct samples House01.jpg

Use Buldozer

You can use keyboard and mouse to perform actions: Take note that you can define have a look at the controls from the game (Configure >> Controls >> Keyboard >> “Show” development)

A, W Change height

Z, Q, S, D Move the camera

E Move the camera forward (faster than Z)

X, C Lateral move of the camera

(Num. pad) 5 Reset camera and object rotation

(Num. pad) 2,4,6,8 Rotate the object (the camera won't move)

(Num. pad) + Zoom in

(Num. pad) – Zoom out

Mouse wheel (animate the selection)

*Keys may differ from a keyboard map to another

a3ct samples house01 FrontDoor.jpg

From Terrain Builder

Run Buldozer and basics

Soon

Use Buldozer

Soon

Conclusion

For some of you, Buldozer will be a bit difficult to take in hand but in the end, it's a really powerful asset for your creations, and after all, it's always better to see a creation in live! If you have any question, feedback or request, we invite you to give a look at our forums.


Contextual ressources: