Hello and welcome, this tutorial will guide you through the long process of enabling units(the player) to use their own weapons in vehicles. Its completely different from simply adding the line "AnimatesUnitAsTurret", which can be found in the odf parameters and has absolutely no effect.

Allowing units to use their own weapons in vehicles
this functions just like a normal turret except that the units upper body is used as the aimer.
The unit's ammo and weapons arent displayed. The unit aims into the direction the controller aims and when shooting the muzzleflash is also displayed.
The unit is able to use its first primary weapon (with appropriate animation), its first secondary weapon (without animation). It can/has to reload aswell (without animation) and the weaponammo is calculated correctly.
The camera is automatically set to view the unit in 3rdperson as if it would be controlled normally.

The downsides are: the crosshair is displayed below the middle of the screen, even though the unit shoots in the middle. Also, when the vehicle takes off, the camera moves backwards and stays there which makes it pretty hard to aim.
The ai will not use their weapons, theyll simply stand/sit around.

What you will need:
- a vehicle with a hardpoint to which the unit can be attached
- good knowledge of the hierarchies and setup of a vehicle
- very good knowledge of odf-coding
- about half an hour time

So, lets start with this tedius task. It is one of the most complex things you can do with odf-coding so dont be discouraged if it doesnt work on first try and check all your steps from the beginning on to find the problem.

First step: the model
with custom model:
Create a hardpoint called "hp_passenger_1" or alike and place it where the unit will stand. You can rotate it along the y-axis but the more its rotated, the more the aiming will be limited.

without custom model:
You need a hardpoint to attach the unit to, the stock gunship for example already has them.
Open the model with ultimate unwrap 3d(and download the "Star Wars Battlefront MSH" plugin for it, you can choose it in the dropdown menu on the download page.
Now look for hardpoints, they should be called something like "hp_passenger".
Remember their name.

Second step: the odf
Open the vehicles odf and set up a turretslot (flyersection).
Now put this line within the section: you also have to specify the animation: this is the default passengeranimation, it doesnt matter that it includes the unit holding something above it because the upperbody animation will be overriden anyway.
A very important part are the turret and unit rotationvalues. these are: yaw defines the horizontal rotation and pitch the vertical.
and this is where it gets tricky: even though the unit may not be aligned along the z-axis (zero rotation around the y-axis), the camera/turret is. so if the unit is rotated around 90 degrees and you have a yaw limit of "-45 45" the units upper body will only be able to rotate in the region between 45 and 135 degrees. Therefore you should not rotate the hardpoint to which the unit is attached too much.

The next steps are the critical ones and they are rather complex, so i put them in hide-tags: thats it for the coding. take a deep breath and relax.

Here is an example of the final odf piece of the turretslot: Now after you have done all the process, save your odf, munge and enjoy shooting with our unit while sitting/standing in vehicles!
and again: if it doesnt work on first try: dont worry! it also took me quite some time to figure all this out.

Maybe you will discover how to position the crosshair in the middle of the screen or prevent the camera from moving away on takeoff! Please post your finding right here in this thread!

Holy Dr. Diet Pepper! How did you figure this was possible in the first place? Excellent find!

wow my friend, this is awesome, thx so much

Amazing!

Extremely useful great job

thanks
i found it out while setting up the improved gunship and browsing through the odfparameter-list and the stock gunships odf, its in it but commented out.

Wow, I will try this out for sure.

Would it be at all possible to make it so the unit crouches when the crouch key is pressed? The reason for this is that I'm trying to replicate the Mass Effect cover system for pretty obvious reasons. What I plan on doing is placing invisible turrets in cover spots and using your method for making it so units can shoot their normal weapons out of the turret.

Marth8880 wrote:Would it be at all possible to make it so the unit crouches when the crouch key is pressed? The reason for this is that I'm trying to replicate the Mass Effect cover system for pretty obvious reasons. What I plan on doing is placing invisible turrets in cover spots and using your method for making it so units can shoot their normal weapons out of the turret.

This was the "cover idea" that I was telling you about. Not sure about crouch, but here is how I was able to achieve a similar effect.
First, made a crate for the cover. Then put two nulls right over each other. (hp1 and hp2)
Hp1 uses the standing animation, and hp2 uses the crouching animation. In this way, you can switch between 'turrets' to make it look like you are standing and crouching, and still fire your weapon and throw nades. I was successful in making this work, to an extent; however, the system has many bugs. For example, after you leave the 'turret', the camera angle stays with the crate. Also, after you switch between positions a few times, the camera goes to the main hardpoint and stays there.

Hmm. I was thinking of a 9pose where the unit is crouching until it shoots, which it then stands, aims and shoots, and goes back into cover once it's no longer shooting.

Interesting; sounds feasible.

What about the AI not using the system at all? Could be interesting for some scripted SP campaign, but for larger-battle BF2 style gameplay I don't think it would work out so well.

Oh, no, yeah, of course not in Instant Action. Singleplayer campaign would be its only environment for its use, no doubt about that.

DarthD.U.C.K. wrote:...browsing through the odfparameter-list and the stock gunships odf, its in it but commented out.

So maybe there was more of a point in having units with rockets in space maps.

Somehow I sense a future of mine throwing vehicles... Did you try it with a hero?

[RDH]Zerted wrote:Somehow I sense a future of mine throwing vehicles... Did you try it with a hero?

Didn't Dann_Boeing have mine-throwing vehicles in a few of his maps?

Fiodis wrote:

[RDH]Zerted wrote:Somehow I sense a future of mine throwing vehicles... Did you try it with a hero?

Didn't Dann_Boeing have mine-throwing vehicles in a few of his maps?

Yes.

off-topic: curses, that reminds me that i forgot to add a mine layer vehicle to my mod... one of these days...