Platinum Arts Sandbox Free 3D Game Maker - User contributions [en]

MovieCube

2010-09-29T02:36:03Z

Offtools: /* Command Reference */

MovieCube is a Open Source Machinima production tool, based on the Cube 2 Engine, known from the game Sauerbraten. MovieCube is part of the Platinum Arts Sandbox Free 3D Game Maker project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Windows:''' Use the Launcher and select the MovieCube tab or click on MovieCube.bat 
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>

== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4,
AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10,
AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15
</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Command Reference ==
Listing of the current character commands available in Moviecube (27-09-2010)

<code>newcharacter [name]</code> - new character template

<code>listcharacters</code> - list character templates

<code>addcharacter [name]</code> - adds a new character based on template [name], returns a local uid

<code>deletecharacter [name] [force]</code> - deletes a character template

'''store commands in a character template:'''

<code>appendactionspawn [name] [state] [uid]</code> - set spawn point

<code>appendactiondestroy [name] [state]</code> - destroy character

<code>appendactionwait [name] [state] [duration]</code> - wait, duration in milliseconds

<code>appendactionmove [name] [state] [uid]</code> - move towards a waypoint

<code>appendactionspeed [name] [state] [speed]</code> - set character speed

<code>appendactionmodel [name] [state] [model]</code> - set character model, [model] = number of the model added by preloadplayermodel

<code>appendactionsetao [name] [state] [anim] [ao]</code> - animation overwrite

<code>appendactionsetgesture [name] [state] [anim]</code> - set animation for gesture

<code>appendactionsethold [name] [state] [anim]</code> - set hold animation

<code>appendactiongesture [name] [state] [duration]</code> - trigger gesture, duration in milliseconds

<code>appendactionattach [name] [state] [body] [model] [rule]</code> -

<code>appendactiondetach [name] [state] [body]</code>

<code>appendactioncommand [name] [state] [command]</code>

<code>appendactioncond [name] [state] [condtional] [command]</code>

<code>appendactioncondwait [name] [state] [condtional]</code>

<code>appendactionjump [name] [state]</code>

<code>appendactionface [name] [characterid]</code>

<code>appendactionexpect [name] [characterid] [raduis]</code>

<code>appendactionfollow [name] [characterid] [follow characterid]</code>

<code>loopcharacter [name] [loop]</code>

==== Special Commands ====
<code>appendactionproxy [command]</code>

<code>saveactions</code>

<code>clearactions</code>

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi
*type <code>movie</code> again to stop recording

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc website]

==== capture a sandbox movie with glc ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

=== capture with external Software on Windows ===

=== capture with external Software on Mac ===

== Record Demos ==

MovieCube

2010-09-28T20:54:47Z

Offtools: /* Command Reference */

MovieCube is a Open Source Machinima production tool, based on the Cube 2 Engine, known from the game Sauerbraten. MovieCube is part of the Platinum Arts Sandbox Free 3D Game Maker project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Windows:''' Use the Launcher and select the MovieCube tab or click on MovieCube.bat 
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>

== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4,
AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10,
AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15
</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Command Reference ==
Listing of the current character commands available in Moviecube (27-09-2010)

<code>newcharacter [name]</code>

<code>listcharacters</code>

<code>addcharacter [name]</code>

<code>deletecharacter [name] [force]</code>

<code>appendactionspawn [name] [state] [uid]</code>

<code>appendactiondestroy [name] [state]</code>

<code>appendactionwait [name] [state] [duration]</code>

<code>appendactionmove [name] [state] [uid]</code>

<code>appendactionspeed [name] [state] [speed]</code>

<code>appendactionmodel [name] [state] [model]</code>

<code>appendactionsetao, "siii [name] [state] [anim] [ao]</code>

<code>appendactionsetgesture [name] [state] [anim]</code>

<code>appendactionsethold [name] [state] [anim]</code>

<code>appendactiongesture [name] [state] [duration]</code>

<code>appendactionattach [name] [state] [body] [model] [rule]</code>

<code>appendactiondetach [name] [state] [body]</code>

<code>appendactioncommand [name] [state] [command]</code>

<code>appendactioncond [name] [state] [condtional] [command]</code>

<code>appendactioncondwait [name] [state] [condtional]</code>

<code>appendactionjump [name] [state]</code>

<code>appendactionface [name] [characterid]</code>

<code>appendactionexpect [name] [characterid] [raduis]</code>

<code>appendactionfollow [name] [characterid] [follow characterid]</code>

<code>loopcharacter [name] [loop]</code>

==== Special Commands ====
<code>appendactionproxy [command]</code>

<code>saveactions</code>

<code>clearactions</code>

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi
*type <code>movie</code> again to stop recording

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc website]

==== capture a sandbox movie with glc ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

=== capture with external Software on Windows ===

=== capture with external Software on Mac ===

== Record Demos ==

MovieCube

2010-09-28T20:54:05Z

Offtools: /* adding Attachments */

MovieCube is a Open Source Machinima production tool, based on the Cube 2 Engine, known from the game Sauerbraten. MovieCube is part of the Platinum Arts Sandbox Free 3D Game Maker project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Windows:''' Use the Launcher and select the MovieCube tab or click on MovieCube.bat 
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>

== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4,
AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10,
AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15
</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

=== Command Reference ===
Listing of the current character commands available in Moviecube (27-09-2010)

<code>newcharacter [name]</code>

<code>listcharacters</code>

<code>addcharacter [name]</code>

<code>deletecharacter [name] [force]</code>

<code>appendactionspawn [name] [state] [uid]</code>

<code>appendactiondestroy [name] [state]</code>

<code>appendactionwait [name] [state] [duration]</code>

<code>appendactionmove [name] [state] [uid]</code>

<code>appendactionspeed [name] [state] [speed]</code>

<code>appendactionmodel [name] [state] [model]</code>

<code>appendactionsetao, "siii [name] [state] [anim] [ao]</code>

<code>appendactionsetgesture [name] [state] [anim]</code>

<code>appendactionsethold [name] [state] [anim]</code>

<code>appendactiongesture [name] [state] [duration]</code>

<code>appendactionattach [name] [state] [body] [model] [rule]</code>

<code>appendactiondetach [name] [state] [body]</code>

<code>appendactioncommand [name] [state] [command]</code>

<code>appendactioncond [name] [state] [condtional] [command]</code>

<code>appendactioncondwait [name] [state] [condtional]</code>

<code>appendactionjump [name] [state]</code>

<code>appendactionface [name] [characterid]</code>

<code>appendactionexpect [name] [characterid] [raduis]</code>

<code>appendactionfollow [name] [characterid] [follow characterid]</code>

<code>loopcharacter [name] [loop]</code>

===== Special Commands =====
<code>appendactionproxy [command]</code>

<code>saveactions</code>

<code>clearactions</code>

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi
*type <code>movie</code> again to stop recording

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc website]

==== capture a sandbox movie with glc ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

=== capture with external Software on Windows ===

=== capture with external Software on Mac ===

== Record Demos ==

Main Page

2010-09-26T12:57:05Z

Offtools:

'''Platinum Arts Sandbox Free 3D Game Maker''' is a 3D game maker based on the Cube 2 engine that allows users to quickly and easily create and edit their own worlds in game, even cooperatively. It is free, open source, and easy to use for Kids and Adults. Sandbox logo by [http://sashazavisha.deviantart.com/art/young-creator-120946941 sashaZavisha].

<div style="width:49%;float:left;">

== General information ==

* [[Platinum Arts Sandbox|About Platinum Arts Sandbox]]
* [http://SandboxGameMaker.com Project homepage]
* [[FAQ]]
* [[Contact The Team]]
* [[cmdline arguments|Command line Arguments]]
* [[packaging guide|The Packaging Guide]]
* [[server list|List Of Sandbox Servers]]

== Installation ==

* [[Installing Platinum Arts Sandbox]]
* [[Compiling the source code]]
* [[package managers|Some Notes for package managers]]

== Development ==

* [[bug reports|Bug Reports]]
* [[Contributing]]
* [[development|Obtaining the development version]]
* [[content request| Content Request - Help us out!!]]

== Kid Friendly RPG ==
* [[Concept Document]]
* [[Brainstorming area]]

== Master Chef Ogro 2 ==
* [[Brainstorming]]

== Undercover Kids Game ==
* [[To Do List]]

</div>
<div style="width:49%;float:right;">

== Getting started ==

* [[Map Editing Basics]]
* [[Mapping Taboos]]
* [[Beginner's video tutorials]]
* [[Good free programs for Sandbox]]

== Advanced topics ==

* [[Cooperative Editing]] (Server set up)
* [[Adding Models to Sandbox]]
* [http://sandboxgamemaker.com/platinumartssandboxeditref.html Editing Reference Guide]
* [http://sauerbraten.org/docs/models.html Model Reference Guide]
* [[Configuration Reference Guide]]
* [[Cubescript]]
* [[Menu Editing]] ([[New menu editing|newui]])
* [[map_config|Map Configuration]]

== Example Modules ==

* [[FPS|FPS - First Person Shooter (default)]]
* [[RPG|RPG - Role Playing Game]]
* [[SSP|SSP - Side Scrolling Platformer]]
* [[MovieCube|MovieCube - Machinima Tool]]
* [[Vehicle Simulator]]

== Tutorials ==

*[[Tutorials List | Text Tutorials List]]
*[[Video Tutorials List]]

</div>

__NOTOC__

Main Page

2010-09-26T12:52:31Z

Offtools:

'''Platinum Arts Sandbox Free 3D Game Maker''' is a 3D game maker based on the Cube 2 engine that allows users to quickly and easily create and edit their own worlds in game, even cooperatively. It is free, open source, and easy to use for Kids and Adults. Sandbox logo by [http://sashazavisha.deviantart.com/art/young-creator-120946941 sashaZavisha].

<div style="width:49%;float:left;">

== General information ==

* [[Platinum Arts Sandbox|About Platinum Arts Sandbox]]
* [http://SandboxGameMaker.com Project homepage]
* [[FAQ]]
* [[Contact The Team]]
* [[cmdline arguments|Command line Arguments]]
* [[packaging guide|The Packaging Guide]]
* [[server list|List Of Sandbox Servers]]

== Installation ==

* [[Installing Platinum Arts Sandbox]]
* [[Compiling the source code]]
* [[package managers|Some Notes for package managers]]

== Development ==

* [[bug reports|Bug Reports]]
* [[Contributing]]
* [[development|Obtaining the development version]]
* [[content request| Content Request - Help us out!!]]

== Kid Friendly RPG ==
* [[Concept Document]]
* [[Brainstorming area]]

== Master Chef Ogro 2 ==
* [[Brainstorming]]

== Undercover Kids Game ==
* [[To Do List]]

</div>
<div style="width:49%;float:right;">

== Getting started ==

* [[Map Editing Basics]]
* [[Mapping Taboos]]
* [[Beginner's video tutorials]]
* [[Good free programs for Sandbox]]

== Advanced topics ==

* [[Cooperative Editing]] (Server set up)
* [[Adding Models to Sandbox]]
* [http://sandboxgamemaker.com/platinumartssandboxeditref.html Editing Reference Guide]
* [http://sauerbraten.org/docs/models.html Model Reference Guide]
* [[Configuration Reference Guide]]
* [[Cubescript]]
* [[Menu Editing]] ([[New menu editing|newui]])
* [[map_config|Map Configuration]]

== Example Modules ==

* [[FPS|FPS - First Person Shooter (default)]]
* [[RPG|RPG - Role Playing Game]]
* [[SSP|SSP - Side Scrolling Platformer]]
* [[Movie|MovieCube]]
* [[Vehicle Simulator]]

== Tutorials ==

*[[Tutorials List | Text Tutorials List]]
*[[Video Tutorials List]]

</div>

__NOTOC__

MovieCube

2010-01-24T14:43:10Z

Offtools: Undo revision 643 by Offtools (Talk)

MovieCube is a Open Source Machinima production tool, based on the Cube 2 Engine, known from the game Sauerbraten. MovieCube is part of the Platinum Arts Sandbox Free 3D Game Maker project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Windows:''' Use the Launcher and select the MovieCube tab or click on MovieCube.bat 
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>

== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4,
AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10,
AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15
</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi
*type <code>movie</code> again to stop recording

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc website]

==== capture a sandbox movie with glc ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

=== capture with external Software on Windows ===

=== capture with external Software on Mac ===

== Record Demos ==

MovieCube

2010-01-24T14:41:47Z

Offtools: Undo revision 642 by Offtools (Talk)

MovieCube is a Open Source Machinima production tool, based on the Cube 2 Engine, known from the game Sauerbraten. MovieCube is part of the Platinum Arts Sandbox Free 3D Game Maker project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Windows:''' Use the Launcher and select the MovieCube tab or click on MovieCube.bat 
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>

== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>registercharactermodel [path]</code>

<code>thirdperson 2; registercharactermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4,
AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10,
AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15
</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi
*type <code>movie</code> again to stop recording

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc website]

==== capture a sandbox movie with glc ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

=== capture with external Software on Windows ===

=== capture with external Software on Mac ===

== Record Demos ==

MovieCube

2010-01-21T21:56:00Z

Offtools: /* adding and changing Charactermodels */

MovieCube is a Open Source Machinima production tool, based on the Cube 2 Engine, known from the game Sauerbraten. MovieCube is part of the Platinum Arts Sandbox Free 3D Game Maker project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Windows:''' Use the Launcher and select the MovieCube tab or click on MovieCube.bat 
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>

== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>registercharactermodel [path]</code>

<code>thirdperson 2; registercharactermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4,
AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10,
AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15
</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

(this has changed)

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi
*type <code>movie</code> again to stop recording

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc website]

==== capture a sandbox movie with glc ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

=== capture with external Software on Windows ===

=== capture with external Software on Mac ===

== Record Demos ==

MovieCube

2010-01-21T21:54:53Z

Offtools: /* adding Attachments */

MovieCube is a Open Source Machinima production tool, based on the Cube 2 Engine, known from the game Sauerbraten. MovieCube is part of the Platinum Arts Sandbox Free 3D Game Maker project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Windows:''' Use the Launcher and select the MovieCube tab or click on MovieCube.bat 
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>

== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4,
AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10,
AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15
</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

(this has changed)

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi
*type <code>movie</code> again to stop recording

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc website]

==== capture a sandbox movie with glc ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

=== capture with external Software on Windows ===

=== capture with external Software on Mac ===

== Record Demos ==

MovieCube

2010-01-19T18:55:23Z

Offtools: /* using the engine */

MovieCube is a Open Source Machinima production tool, based on the Cube 2 Engine, known from the game Sauerbraten. MovieCube is part of the Platinum Arts Sandbox Free 3D Game Maker project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Windows:''' Use the Launcher and select the MovieCube tab or click on MovieCube.bat 
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>

== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4,
AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10,
AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15
</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi
*type <code>movie</code> again to stop recording

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc website]

==== capture a sandbox movie with glc ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

=== capture with external Software on Windows ===

=== capture with external Software on Mac ===

== Record Demos ==

MovieCube

2010-01-18T01:44:04Z

Offtools: /* high resolution capture with glc (linux) */

MovieCube is a Open Source Machinima production tool, based on the Cube 2 Engine, known from the game Sauerbraten. MovieCube is part of the Platinum Arts Sandbox Free 3D Game Maker project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Windows:''' Use the Launcher and select the MovieCube tab or click on MovieCube.bat 
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>

== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4,
AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10,
AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15
</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc website]

==== capture a sandbox movie with glc ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

=== capture with external Software on Windows ===

=== capture with external Software on Mac ===

== Record Demos ==

MovieCube

2010-01-18T01:42:45Z

Offtools: /* Record Movies */

MovieCube is a Open Source Machinima production tool, based on the Cube 2 Engine, known from the game Sauerbraten. MovieCube is part of the Platinum Arts Sandbox Free 3D Game Maker project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Windows:''' Use the Launcher and select the MovieCube tab or click on MovieCube.bat 
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>

== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4,
AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10,
AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15
</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc website]

==== capture a sandbox movie with glc ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

=== capture with external Software on Windows ===

=== capture with external Software on Mac ===

== Record Demos ==

MovieCube

2010-01-16T22:01:59Z

Offtools: /* Overwrite Animation (AO) */

MovieCube is a OpenSource Machinima production tool, based on the Cube2 Engine, known from the game Sauerbraten. It is part of the Platinum Arts Sandbox project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>
== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4,
AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10,
AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15
</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc opengl capture]

==== capture a sandbox movie with glc: ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback: ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding: ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

== Record Demos ==

MovieCube

2010-01-16T22:01:23Z

Offtools: /* Overwrite Animation (AO) */

MovieCube is a OpenSource Machinima production tool, based on the Cube2 Engine, known from the game Sauerbraten. It is part of the Platinum Arts Sandbox project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>
== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4, AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10, AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc opengl capture]

==== capture a sandbox movie with glc: ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback: ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding: ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

== Record Demos ==

MovieCube

2010-01-16T22:00:53Z

Offtools: /* adding and changing Charactermodels */

MovieCube is a OpenSource Machinima production tool, based on the Cube2 Engine, known from the game Sauerbraten. It is part of the Platinum Arts Sandbox project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>
== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4, AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10, AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc opengl capture]

==== capture a sandbox movie with glc: ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback: ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding: ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

== Record Demos ==

MovieCube

2010-01-16T18:40:09Z

Offtools: /* high resolution capture with glc (linux) */

MovieCube is a OpenSource Machinima production tool, based on the Cube2 Engine, known from the game Sauerbraten. It is part of the Platinum Arts Sandbox project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>
== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:
=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4, AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10, AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc opengl capture]

==== capture a sandbox movie with glc: ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback: ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding: ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

== Record Demos ==

MovieCube

2010-01-12T23:31:31Z

Offtools: /* How to use this */

MovieCube is a OpenSource Machinima production tool, based on the Cube2 Engine, known from the game Sauerbraten. It is part of the Platinum Arts Sandbox project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>
== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:
=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4, AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10, AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

== Record Demos ==

MovieCube

2010-01-12T23:30:57Z

Offtools: /* Tutorial on scripting commands */

MovieCube is a OpenSource Machinima production tool, based on the Cube2 Engine, known from the game Sauerbraten. It is part of the Platinum Arts Sandbox project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>
== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let the character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:
=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4, AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10, AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

== Record Demos ==

MovieCube

2010-01-12T22:52:24Z

Offtools: /* Quick Overview */

MovieCube is a OpenSource Machinima production tool, based on the Cube2 Engine, known from the game Sauerbraten. It is part of the Platinum Arts Sandbox project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>
== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===
*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>

*The "appendaction..." commands start with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:
=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4, AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10, AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

== Record Demos ==

MovieCube

2010-01-11T17:14:07Z

Offtools: /* Overwrite Animation (AO) */

MovieCube is a OpenSource Machinima production tool, based on the Cube2 Engine, known from the game Sauerbraten. It is part of the Platinum Arts Sandbox project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>
== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.
=== Tutorial on scripting commands ===
*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>

*The "appendaction..." commands start with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:
=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4, AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10, AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

== Record Demos ==

MovieCube

2010-01-11T17:11:53Z

Offtools: /* Tutorial on scripting commands */

MovieCube is a OpenSource Machinima production tool, based on the Cube2 Engine, known from the game Sauerbraten. It is part of the Platinum Arts Sandbox project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>
== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.
=== Tutorial on scripting commands ===
*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>

*The "appendaction..." commands start with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:
=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4, AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10, AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15</code>

<code>setao 13 50</code> - now animation 22 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

== Record Demos ==

MovieCube

2010-01-11T17:08:59Z

Offtools: /* Tutorial on scripting commands */

MovieCube is a OpenSource Machinima production tool, based on the Cube2 Engine, known from the game Sauerbraten. It is part of the Platinum Arts Sandbox project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>
== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.
=== Tutorial on scripting commands ===
*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>

*The "appendaction..." commands start with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> as last param.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:
=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4, AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10, AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15</code>

<code>setao 13 50</code> - now animation 22 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

== Record Demos ==

MovieCube

2010-01-11T17:00:14Z

Offtools:

MovieCube

2010-01-11T16:57:11Z

Offtools:

MovieCube

2010-01-11T16:55:36Z

Offtools:

MovieCube

2010-01-11T16:40:14Z

Offtools:

MovieCube

2010-01-11T14:02:22Z

Offtools: /* using the engine */

MovieCube intends to be in addition with other OpenSource Tools a free Machinima production tool.

== What is Machinima ==

== Start MovieCube ==

== Quick Overview ==

== Creating and adding Charactermodels ==

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

== Record Demos ==

MovieCube

2010-01-11T13:13:54Z

Offtools:

MovieCube intends to be in addition with other OpenSource Tools a free Machinima production tool.

== What is Machinima ==

== Start MovieCube ==

== Quick Overview ==

== Creating and adding Charactermodels ==

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - starts recording a movie
=== high resolution capture with glc (linux) ===

== Record Demos ==

MovieCube

2010-01-11T13:11:34Z

Offtools:

MovieCube intends to be in addition with other OpenSource Tools a free Machinima production tool.

== What is Machinima ==

== Start MovieCube ==

== Quick Overview ==

== Creating and adding Charactermodels ==

== Record Movies ==

=== using the engine ===

<code>moview 320</code> - set the width of your video clip
<code>movieh 240</code> - set the height of your video clip
<code>movie myclip</code> - starts recording a movie
=== high resolution capture with glc (linux) ===

== Record Demos ==

MovieCube

2010-01-11T13:09:08Z

Offtools:

MovieCube

2010-01-11T13:07:21Z

Offtools:

MovieCube intends to be in addition with other OpenSource Tools a free Machinima production application.

== What is Machinima ==

== Start MovieCube ==

== Quick Overview ==

== Creating and adding Charactermodels ==

Main Page

2010-01-11T13:04:45Z

Offtools:

'''Platinum Arts Sandbox''' is a 3D game maker based on the Cube 2 engine that allows users to quickly and easily create and edit their own worlds in game, even cooperatively. It is free, open source, and easy to use for Kids and Adults.

<div style="width:49%;float:left;">

== General information ==

* [[Platinum Arts Sandbox|About Platinum Arts Sandbox]]
* [http://SandboxGameMaker.com Project homepage]
* [[FAQ]]
* [[Contact The Team]]
* [[cmdline arguments|Command line Arguments]]
* [[packaging guide|The Packaging Guide]]

== Installation ==

* [[Installing Platinum Arts Sandbox]]
* [[Compiling the source code]]
* [[package managers|Some Notes for package managers]]

== Development ==

* [[bug reports|Bug Reports]]
* [[Contributing]]
* [[development|Obtaining the development version]]
* [[content request| Content Request - Help us out!!]]

== Getting started ==

* [[Map Editing Basics]]
* [[Mapping Taboos]]
* [[Beginner's video tutorials]]
* [[Good free programs for Sandbox]]

</div>
<div style="width:49%;float:right;">

== Advanced topics ==

* [[Cooperative Editing]] (Server set up)
* [http://sandboxgamemaker.com/platinumartssandboxeditref.html Editing Reference Guide]
* [[Configuration Reference Guide]]
* [[Translations|Engine/menu translations]]
* [[Adding Models to Sandbox]]
* [[Cubescript|Programming in Cubescript]]
* [[map_config|Map Configuration]]
* [[musicpacks|Music Pack Documentation]]

== Tutorials ==

* [[Mapmodels|Loading and adding mapmodels]]
* [[Menu Editing|How to modify the menu]]
* [[Lighting|How to light a map properly]] 
* [[Creating a shop script]]
* [[Wings3D to Sandbox flash tutorials]]
* [[Importing .OBJ files]]
* [[Adding custom textures to a new map]]
* [[Glowmaps]]
* [[MovieCube]]

== Kid Friendly RPG ==
* [[Concept Document]]
* [[Brainstorming area]]

== Master Chef Ogro 2 ==
* [[Brainstorming]]

== Undercover Kids Game ==
* [[To Do List]]

</div>

__NOTOC__

MovieCube

2010-01-11T12:49:10Z

Offtools: New page: MovieCube intends to be in addition with other OpenSource Tools a free Machinima production application. == What is Machinima ==

MovieCube intends to be in addition with other OpenSource Tools a free Machinima production application.

== What is Machinima ==