**This Page is a Work In Progress**

## What is the God Client?
The God Client is a special version of the SWG Game Client that is used predominately for world-building, that is the placement and manipulation of world objects and the insertion of those objects into buildout datatables, which are used by the server to spawn the gameplay environment. For more information about buildouts, see About Buildouts (coming soon).

## Focus Views
When you first open the god client, you will note there are two views the **Game Focus** and the **God Client Focus**. When you are in Game Focus, this means your mouse cursor and input is locked inside the game client window, as though you are normally playing the game. When you are in God Client Focus, you can use the buttons and tools within the God Client user interface. To toggle between views, use the `Numpad Enter` key.

## Camera Positions
When toggling between focus views, you may notice your camera shifts to a third-person birds-eye view of your character. While in this view, you can use the `Arrow Keys` to move around. To reattach your camera back to your character so you can move your character around like you are in a normal client, press `Ctrl + Shift + F2`.

Other Camera Keybinds:
* Pan: `Alt + middle mouse`
* Move: `Alt + Left Click`
* Rotate: `Alt + Right Click`

## Adding New World Objects to the Scene
To add new objects, you can either use an admin command, like `/object createAt <template>` which will create the object where your character is standing, or you can find an object from the **Server Templates** browser and drag and drop it directly into the world.

## Selecting World Objects
While in God Client Focus, you can select world objects for manipulation by directly clicking on them. When you do, a red boundary box will appear:

![](https://i.imgur.com/j39n3mO.png)

## Manipulating World Objects
While in God Client Focus, you can manipulate an object you have selected in various ways. While manipulation is in progress, a teal boundary box will appear showing you the wireframe of the transformation. To see all options, `right click` the object inside the client frame while you have it selected.

* Move - `Drag and Drop it to its new position`
* Scale - `Ctrl + S` (limited to certain objects and mobiles)
* Rotate - `Ctrl + R`
* Transform XYZ Axis or Yaw/Pitch/Roll by specific amounts -  `Right Click > Set Transform`
* Drop to Terrain (for floating objects) - `Right Click > Drop to Terrain`
* Deselect Object - `Esc`

```
where left/right/middle are mouse buttons and G R S T are keyboard keys

R (Rotate)
    Left - Yaw
    Right - Roll
    Middle - Pitch

G (Ground Translate - move object around an area, stuck to the ground)
    Left - Move on up down left right 2D, X/Z Axis
    Right - Move up or down, 3D, Y axis
    Middle - Pull in direction of movement

T (Translate - move object around an area)
    Left - Move on up down left right 2D, X/Z Axis
    Right - Move up or down 3D, Y Axis
    Middle - Pull in direction of movement

S (Scale)
    Left - Scale the Y axis, taller or shorter
```

When you have made a change and you want to make it stick, use `Ctrl + T` to apply the transformation.

**NOTE**: Saving buildout from the god client is currently bugged. If you add a new object and want it to be there after you restart your server, you will need to persist it to the database with the admin command: `/object persist <oid>`

## Known Bugs
The following keystrokes are known to cause the client to crash:
* Show Console button
* Alt + Enter when tabbing in/out can popup the Exit subcontext menu, be careful.
* Double Escape Key press when targeting a world object to deselect