Ember Tutorial World Editing

From WorldForgeWiki
Jump to: navigation, search

This page is a work in progress,
meaning things are incomplete, unfinished, not fully thought out, might disappear again, and generally are subject to change.
Do not rely on any of this just yet!

Editing the world in Ember

This is a short tutorial of how to edit the world in Ember. You will learn how to log in as admin, how to create new entities in the world, how to create matching model definitions for your entities and finally how to edit the terrain.

Logging in as admin

N.B. If you're going to edit the world, you must have access to a server where you have the ability to log on as admin. Please refer to http://wiki.worldforge.org/wiki/Installing_Cyphesis for information on running your own server.

Note: The Public Sandbox Server is an open server which allows newcomers to try out the world editing features of WorldForge using the Ember game client. Please refer to the page listed for details on how to access the administrative accounts on the open server.


The first thing you'll see when you start up Ember is the server browser
Error creating thumbnail: Unable to save thumbnail to destination
The server browser
. This will show all the servers currently registered with the main meta server. By double clicking on one of the servers you'll connect to it. You can also manually enter a server in the lower left edit box. This can be useful if you're running a local testing server that you don't want to be publically available.

Once you're connected to the server, you need to log in. All cyphesis servers by default comes with an "admin" account. The password for this can be set on the server by running the "cypasswd" command without any arguments, or running "cypasswd -s admin".

Error creating thumbnail: Unable to save thumbnail to destination
The login window

The admin account

The admin account is a bit different from other accounts as it allows you to create characters of many different classes, whereas any other type of account is restricted to a few (currently "settler" and "skeleton"). However, when we want to edit the world we want to log in as a "creator". Ember therefore provides a quick button labelled "Use creator"
Error creating thumbnail: Unable to save thumbnail to destination
Character creation when logged in as admin
. Press it.

This will create a new character of the type "creator". This entity differs from most other entities in that it's given almost unlimited ability to edit the world. Additionally, the entity is automatically destroyed upon disconnection (note that everything in the inventory of the creator entity is also destroyed. In Ember it's represented by a flame. Note the "Admin" window that has appeared down to the left. This provides some quick shortcuts to the most common tools you'll be using when in admin mode.

Error creating thumbnail: Unable to save thumbnail to destination
Entered the world as a creator

Switching camera

The first thing we want to do is to switch to a free flying camera, so we're not bound to the entity. Click on "Switch camera" to toggle between free flying mode and bound mode. When in free flying mode you can move the camera around using the regular "wasd" key combination. Also, the keys "r" and "f" can be used for moving up and down.

Error creating thumbnail: Unable to save thumbnail to destination
The camera in free flying mode

The object of this tutorial is to create a castle, so we'll look for a large expanse of flat land. There's such a place in the distance. We now have to move our creator entity over to this place.

Error creating thumbnail: Unable to save thumbnail to destination
Some open space in the distance

Moving entities

Error creating thumbnail: Unable to save thumbnail to destination
The action menu when clicking on the Creator

In order to move an entity, left click on it. This will bring up the entity action menu. Select "move" in the menu. While in "entity movement mode", mouse movement will move the entity. Using the scroll wheel will rotate it around the y-axis. Pressing "shift" while moving will shift the rate of movement. Pressing "q" will allow you to change vertical position. You can still click the right mouse button to switch to "camera movement mode", allowing you to reposition the camera while moving. Pressing "esc" will cancel the whole move operation.