The syntax for the this feature is as follows:
3.8.2.8
GETCINEMATICHANDS=GunName GunFolder
Description: This sets the player’s weapon by defining the gun name and the
folder in which the gun exists. A placeholder entity must exist within the level for
this command to work. The place holder entity must be dynamic and must not
spawn at the start of the level.
Range: GunName = the name of the gun,
GunFolder = the file path to the gun from the generic guns folder.
Example: :state=1:getcinematichands=colt45 ww2\colt45
3.8.2.63
STARTCINEMATICHANDS=X Y
Description: This plays the play’s hand animation X and loops it Y times.
Range: X = 1 – start cinematic hands.
Y = >1 – number of times to loop cinematic hands.
Example: :state=1:startcinematichands=1 3
3.8.2.5
DISABLECINEMATICHANDSBUTTON=X
Description: This sets whether the blocking button can be used or not.
Range: X = 0 – blocking button is enabled,
X = 1 – blocking button is disabled.
Example: :state=1:disablecinematichandsbutton=1
The action command getcinematichands=GunName GunFolder is similar to GIVEPLRWEAPON=X with one big difference. First, you have to have the object that the player will be holding within the map and it must have the same name as "GunName". The "GunFolder" is the same as place holder "X" in the "giveplrweapon" command. Also you need to disable the RMB or the blocking mouse key because in order to use the object the player is holding you will need to press the RMB. When it's all set up and the player presses the RMB it will execute the cinematic hand movement.
The attached images show the player holding a beer bottle. This is the cinematic hand object. You will notice the message on bottom of screen let's the player know to press RMB. The second image shows the player taking a drink and the third shows the bottle coming back to the holding position. This was the first test model created. I can't remember who created it but he had great plans to make a whole pack of different "cinematic hands." Unfortunately Lee had different ideas and his whole project was scrapped. Although Lee decided to keep the commands in FPSC because they still can be used.
I am going to try and find the video of this to show the animation. It worked quite well. You can see that you can provide a loop for the animation. The animation can be as simple or as complex as one would like.
THEORY - you know everything but nothing works. PRACTICE - when everything works but don't know why.
For me, theory and practice are combined: nothing works and I don't know why.