How To Use The SOE SWG God Client - SWG-Source/swg-main GitHub Wiki

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:

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
⚠️ **GitHub.com Fallback** ⚠️