1. Click this link and download the latest Monticello package, save it to your computer and unzip the downloaded files.

2. Open your Croquet folder, double-click on the ‘package-cache’ folder and place all the files with the extension *.mcz you have unzipped here.

3. Go up one level to your Croquet folder and launch Croquet by double-clicking the MS-DOS Batch File named ‘Croquet’.

4. Click on an empty space in the Croquet window and select open.

5. Select Monticello Browser to launch the Monticello Browser window.

6. There are 2 panes in the Monticello Browser window, the left shows the list of installed packages and the right shows the list of default repository which are locations of the installed packages. The first location on the repository list is the location on your local disk in the ‘Croquet/package-cache folder’. Click once on that location and click on the ‘Open’ button above it.

7. A new window which shows all the packages contained in that repository will appear. If you have placed the mcz package file in the ‘Croquet/package-cache’ folder, it will be listed here.

8. Select and click the package according to the order below and install (click the Load button on top).

• StMath
• CADSM
• StCAD
• StGeo
• StMbD
• CADSM

**Note that you have to really follow the order and CADSM has to be loaded twice according to the order**

9. Once the packages has been loaded, you can close the browsers, your motion engine is now installed.

Below are the controls for the keyboard and mouse functions in FreeCAD/Croquet:-

Mouse

Left-click

• Click and draw objects
• Click and drag objects around

Right-click

• Drive the avatar around

Middle-Click or Alt + Left-click

• Used to show a pop-up menu in FreeCAD/Croquet

Keyboard

W - Move the camera front regardless of the viewing angle
S - Move the camera back regardless of the viewing angle
A - Move the camera left regardless of the viewing angle
D - Move the camera right regardless of the viewing angle
Shift+W - Tilt the camera upwards
Shift+S - Tilt the camera downwards
Shift+A - Rotate the camera left
Shift+D - Rotate the camera right
Up arrow key - Move the camera upwards
Down arrow key - Move the camera downwards
Ctrl+A - Change the camera view to third person
R - Reset the camera to ground position and view to front

You can view a higher resolution version here

The videos above shows how to draw a piston assembly in Freecad/Croquet. Follow the steps below for the complete guide.

• Click File>New>CAD Project. A new CAD Project frame will be added into the world at the ground position in front of the avatar. You will see the X, Y and Z axes representing the origin of the frame. You can also view the CAD Project you have added in the tree view menu on the left.

• Click File>New>Assembly. A new assembly frame will be added into the CAD Project frame.

• Click Insert>Part>New to add a part frame into the assembly frame.

• Click Insert>Sketch to insert a sketch frame into the part frame.

• Click Draw>Rectangle to start drawing a rectangle. The lightly tinted sketch frame on the X-Z plane will be visible at this point.

• Move the mouse over the sketch plane and you will see a pop-up showing the position of the mouse cursor.

• Adjust to the position you want the rectangle to be placed at then click and drag the mouse to extend the drawing. We will roughly draw the rectangle on the sketch board and adjust its properties later.

• Middle-click or use Alt+Left-Click on the rectangle to show the pop-up menu.

• Select ‘Position’ on the pop-up menu. A window will pop-up showing the attributes of the rectangle.

• Change the values to:-

X Position = 1
Y Position = 1
Z Position = 0
Angle        = 0
X Length   = 1
Y Length   = 0.2

• Remember to hit the ‘Enter’ or ‘Tab’ key on the keyboard after changing the values.

• Click the ‘OK’ button on the window when done. The changes on the rectangle will take effect immediately.

• You can adjust the camera’s view to see the drawing better, to do this, use the ‘W’, ‘A’, ‘S’, ‘D’ keys on the keyboard to move the camera forward, left, back and right. you can also tilt and rotate the camera by holding the ‘Shift’ key plus any of the ‘W’, ‘A’, ‘S’, ‘D’ keys. The up and down arrow keys will move the camera upwards and downwards.

• Click Insert>Feature>Extrusion to extrude the rectangle. In the Extrusion window, enter the values:-

zStart = -0.1
zEnd  =   0

• Remember to hit the ‘Enter’ or ‘Tab’ key on the keyboard after changing the values.

• Click the ‘OK’ button on the window when done. The changes on the rectangle will take effect immediately.

• Our first rectangle is done. To draw another rectangle click Insert>Sketch to insert another sketch into the part frame.

• Click Draw>Rectangle and roughly draw another rectangle on the sketch board.

• Middle-click or use Alt+Left-Click on the rectangle to show the pop-up menu.

• Select ‘Position’ on the pop-up menu. A window will pop-up showing the attributes of the rectangle.

• Change the values to:-

X Position = 2
Y Position = 1
Z Position = 0
Angle        = 0
X Length   = 1.5
Y Length   = 0.2

• Click Insert>Feature>Extrusion to extrude the rectangle.

• In the Extrusion window, enter the values:-

zStart = 0
zEnd  = 0.1

• The above values will create a solid positioned right above the first rectangle.

• Remember to hit the ‘Enter’ or ‘Tab’ key on the keyboard after changing the values.

• Click the ‘OK’ button on the window when done. The changes on the rectangle will take effect immediately.

• You can rotate the solid around the X, Y or Z axis using the Rotate window.

• To bring up the Rotate window, middle-click or use Alt+Left-Click on the rectangle to show the pop-up menu.

• Select ‘Rotate’ on the pop-up menu. The Rotate window has 3 scroll bars to adjust the rotation around the X, Y and Z axis respectively.

• Click and drag the scroll bar for Z Rotation to 110, use the left and right arrow buttons on the scroll bar to get the exact value.

• Click the ‘Close’ button when done.

• Next, we will draw a cylinder as the piston’s head. Click Insert>Sketch to insert another sketch frame.

• Click Draw>Circle

• Roughly draw a circle on the sketch plane by clicking and dragging on the plane.

• Middle-click or use Alt+Left-Click on the circle to show the pop-up menu.

• Select ‘Position’ on the pop-up menu. A window will pop-up showing the attributes of the circle.

• Change the values to:-

X Position = 1.5
Y Position = 2.5
Z Position = 0
Angle        = 0
Radius      = 0.5

• Click Insert>Feature>Extrusion to extrude the circle.

• In the Extrusion window, enter the values:-

zStart = 0
zEnd  =  1

• Middle-click or use Alt+Left-Click on the circle to show the pop-up menu.

• Select ‘Rotate’ on the pop-up menu.

• Click and drag the scroll bar for X Rotation to 270, use the left and right arrow buttons on the scroll bar to get the exact value.

• To move the solids around, click on it and drag. The pop-up shows the position of the solids. Align the piston head to the 2nd rectangle.

• The piston assembly is now complete.

FreeCAD/Croquet is curently under constant development and updates will constantly be added in the form of a Monticello package. To update your version of FreeCAD/Croquet, download the latest Monticello package here. The Monticello package will have a .mcz file extension. After downloading it, save it in your Croquet folder. The guide below shows the complete steps on downloading and installing FreeCAD/Croquet update using the Monticello browser :-

1. Click this link and download the latest Monticello package and save it to your computer.

2. Open your Croquet folder, double-click on the ‘package-cache’ folder and place the *.mcz file you have downloaded here.

3. Go up one level to your Croquet folder and launch Croquet by double-clicking the MS-DOS Batch File named ‘Croquet’.

4. Click on an empty space in the Croquet window and select open.

5. Select Monticello Browser to launch the Monticello Browser window.

6. There are 2 panes in the Monticello Browser window, the left shows the list of installed packages and the right shows the list of default repository which are locations of the installed packages. The first location on the repository list is the location on your local disk in the ‘Croquet/package-cache folder’. Click once on that location and click on the ‘Open’ button above it.

7. A new window which shows all the packages contained in that repository will appear. If you have placed the FreeCAD.mcz package file in the ‘Croquet/package-cache’ folder, it will be listed here.

8. Select and click the package you want to install listed on the right and click the Load button on top.

9. Once the package has been loaded, you can close the browsers, click on an empty space and select objects.

10. Choose Croquet from the green ‘objects’ window and drag the Kayef-FreeCAD world out and the updated FreeCAD/Croquet will load.

FreeCAD/Croquet is included in the latest Cobalt image. Follow the steps below to download Cobalt and launch FreeCAD/Croquet. Note that Cobalt is the latest Croquet development environment that is constantly being updated thus we have chosen to work with this image.

1. Click here to open the Cobalt downloads page.

2. There will be a list of links displayed. Click and download the current build which is the latest image.

3. After downloading, unzip the file and enter the folder you have just unzipped.

4.

Look for the MS-DOS-Batch File named ‘Croquet’. Double-click it.

5.

A window will open. Left-click on an empty space in the window to bring up a menu and select ‘objects’.

6.

A green window will open. Click on the rectangular box with the word ‘Croquet’ in it.

7.

A list of demo worlds will be shown in the green window. Left click on ‘KayefFreeCAD (Master)’ and drag the whole icon out while holding down the mouse. A blue rectangular box will appear. Release the mouse button once you have placed the world on a clear space. Wait a while and the world will appear.

The above steps are to download and launch FreeCAD/Croquet however, since FreeCAD/Croquet is under constant development, more updates will be released in the form of Monticello packages. Follow the instructions here to update your FreeCAD/Croquet.

To learn how to use FreeCAD/Croquet, browse the tutorials here.