The Cycon Online Game (COG) Engine

Introduction News Documentation Development Screenshots Online Games Downloads Links
Developer's Guide Player's Guide


The Cog Engine Project - Player's Guide


The Cog Engine

    The Cog Engine Project is about helping people to create their own video games. It is about showing them how to build worlds and adventures out of their imagination, and share those worlds and adventures with others. At the center of the project is the Cog Engine itself. The Cog Engine allows games to be played in a web browser over the internet, without requiring the user to install any software on their own. This guide is meant to instruct the casual user on how to begin playing video games created for the Cog Engine.


The Cycon Odyssey

    The Cycon Odyssey is the first game available for the Cog Engine. It is meant to serve as both an introduction to the Project, as well as an example as to what is possible, but it also stands on its own as a playable game. The Cycon Odyssey will be used as an example throughout this guide. The basics of the game were layed out when the author was in the sixth grade, thought many aspects of the game have evolved since then.

    As the player, you wake up alone on a beach, with no recollection of how you arrived there, much less where you are. The goal of the game is to explore as much of the island as possible, and to overcome any obstacles you encounter. You will have to find, use, and combine items in various ways in order to accomplish this goal.


Loading the Game


    In order to play the Cycon Odyssey you will need a Java-enabled web browser. Any version of Netscape from 3.0 on and any version of Internet Explorer from 4.0 on should work without any modifications on the part of the user. In some cases however, one will need to either turn on Java capabilities or download and install a plug-in. In that case, you should refer to your browser’s own documentation.

    All you should have to do to begin playing an online video game is to point your browser at the correct web address, and wait while the program downloads itself. This can take anywhere from a few seconds on a fast connection to as much as five minutes on a slow one. Please be patient while the download occurs.


User Interface

    The Cog Engine permits the use of a variety of interface components. The following example is taken from the Cycon Odyssey, which makes use of all of those components. When game developers create their own modules, they have the option of turning off some of these features, so don’t be surprised if they game you are playing looks somewhat different from the screenshot below. Some developers may choose to only have a command line and output window (their games will only have textual interaction), and in the future developers will be able to create games that are played using only the image window!



Label Descriptions

A - Information Window

The information window provides status data about the player. This can include the player’s name, how many points they have accumulated, their current health level, how much experience they’ve earned, or any other statistic the game developer decides to use in their game.

B - Inventory List

This window contains a list of all of the items a player’s inventory contains. Sometimes extra information about the item will be displayed here as well, for instance, if a player has a flashlight in their inventory, an “off” or “on” tag might be included to let the player know whether they are currently using the item.

C - Command Line

The command line is normally used to manipulate the game’s environment, and the objects it contains. You can enter commands to move the player around in the game, or accomplish certain goals. For more information, refer to the “Moving Around” and “Interacting with Objects” sections below.

D - Navigation Compass

    The navigation compass is used as both a shortcut for moving the player around within a game, as well as a quick visual reference for the player’s environment. Although a game developer can make their own compass look any way they choose, under the Cycon Odyssey, the default compass works like this:

Orange and Yellow Compass Points - The player can move in this direction by clicking on the compass point.

Grey Compass Points - The player is unable to move in this direction

Red Compass Points - The player is obstructed from moving in this direction. The player may need to perform a specific action or solve a puzzle in order to move in this direction.

Green Dot in Center of Compass - This indicates that an item is present in the current room.

E - Image Window

    The image window is where the game’s graphics are displayed. Sometime manipulating the game environment will change this graphic, and game developers can choose to have graphics for items and obstruction layered on top of the room graphic. It may be helpful to realize that amateur game developers may not always have a graphic which perfectly suits the current room’s environment, so don’t be surprised if the textual description and actual picture don’t completely match up! (For instance, in the first room of the Cycon Odyssey, you are described as looking at a forest with a beach behind you, while the actual picture only shows a beach)

F - Output Window

    The output window gives descriptions of the player’s current room, objects in the game, the results of the player’s actions, and any messages the game developer wishes to display there. This window will scroll as messages are displayed, so a player should always be able to see what path they have taken, and what actions they have performed over the course of their game. As a special note, in certain web browsers, if you click inside this window, the text will stop automatically scrolling. In order to fix this you normally need to scroll down as far as you can go, and click at the end of the last character on the last line. There is nothing that can be done about this problem; it is specific to the web browser.


Moving Around

    Moving around a game’s environment is normally accomplished by using either the navigation compass or the command line. The navigation compass will change color depending on whether or not a player is able to move in a certain direction (refer to the “Navigation Compass” entry in the “User Interface” section above for details). If a player is able to move in a certain direction, they only need to click on the button.

    If a player wants to move by using the command line, typing the name of the direction followed by the enter key will tell the game to move. Normally, an abbreviation of the direction can also be used, frequently the first letter of the direction’s name. For instance, if you are playing a game and are in a room in which you are able to move “North” you should be able to enter either “north” or “n” to move in that direction. (Notice that the command line ignores whether you enter command in capital letters or not)


Interacting with Objects

    Since the goal of many games such as the Cycon Odyssey is to explore as much of the player’s environment as possible, it will frequently be necessary to interact with the objects the player comes across in order to proceed. An “object” in the game can come in two forms: “items” and “obstructions.” Items include any objects that can be picked up, used, manipulated, and/or combined with other items in the game to form new ones. Obstructions include any objects that block the player from moving in a certain direction, such as a boulder blocking their pathway, or a ten-eyed monster that can turn the player into stone with a single touch. The Cog Engine does not currently include a fighting engine, so getting past the ten-eyed monster may only require using a specific item on it, such as the glowing arrow of fire (or whatever else the game developer’s imagination has come up with!).

    Each game module for the Cog Engine comes with its own set of “verbs,” which is basically a list of all of the actions you can perform in the game. Clicking on the “Help” button of the navigation compass (or typing “help” at the command line) will normally list some of these verbs, but not necessarily all of them (a game developer may decide that listing a certain verb may be too strong of a hint, and elect to not display that verb). Common verbs are “look,” “get,” “drop,” “examine,” “combine,” “spilt,” and “use.” Commands can be entered into the command line as short sentences, such as “attack black knight with the sword.” Game developers are advised to keep their list of possible verbs short, as it is not much fun to play “guess the word” when you know how to solve a particular puzzle, but are not necessarily thinking of the same word the game developer had in mind when they were creating their game.


Introductory Walkthrough

Here is a short walkthrough for the beginning of the Cycon Odyssey. There aren’t any significant secrets given away by this walkthrough, and reading it may be helpful if you don’t know where to start. You should try entering the commands yourself into a web browser, so that you can see how the Cog Engine works.

  • Begin a new game. You will start out on a beach, where you can move in five different directions (north, northeast, southeast, southwest, and northwest). Notice how the navigation compass is colored orange and yellow in the directions you are able to move, but grey in the directions you cannot. Read the game introduction and room description, and then move northwest.
  • You will find yourself in a room with a “savage.” (or so you think - people and situations are rarely what they appear in video games, much as in real life). This person prevents you from moving west, as described in the output window, and as indicated by the western compass point turning red. You can get a more detailed description of this person by entering “look savage” or “examine savage” at the command line. When you are ready, move to the south.
  • You are now standing at the edge of the water, where a small alcove between the rocks has formed to the west. Move into the alcove.
  • You are now standing inside the alcove. The output window states that there is a rock on the ground here, and the center of the compass window will show a green dot to indicate this. Enter “get rock” to try and pick up the rock. The rock is a little too heavy for you to pick it up, but when you roll it aside, you find a dagger hidden underneath. You can pick up and add the dagger to your inventory by typing either “get dagger” or “get all.” “Get all” is a nice shortcut you can use to attempt to pick up every item in the room. You can also use “drop all” to empty your inventory into the current room. You can get a more detailed description of either the dagger or the rock by using the “look” or “examine” command on the item. After you pick up the dagger, move back to the east.
  • You might notice that the text description for this room has shortened. Every time you visit a room for the first time, the Cog Engine will print out a full description of the room. When you return to a room that you have already visited, a shorter description will be displayed. This is meant to save space, and the reader’s time. You can get a room’s full description at any time by typing the word “look” into the command line, or by clicking the center compass point. Move north back to the room with the “savage.”
  • You will notice that you are still prevented from moving west by the savage. If you type “use dagger on savage” a short description of the events that follow will be displayed. The “savage” which you attacked (without provocation!) will leave behind a bow and arrow which you can then add to your inventory by typing “get all” at the command line. You will also notice that the compass point leading west is no longer red. You can now move to the west.
  • After moving to the west, you will find a rope tied to a tree branch hanging off of the top of the cliff above your head. If you type “get rope” the branch will break, they’ll both fall to your feet, and you will add the rope to your inventory. You now have a variety of items in your inventory and can begin experimenting by using them on each other. Depending on how the game developer wrote the game, the verbs “use” and “combine” may mean the same thing, but it may be necessary to try both. In this case you can “combine rope and arrow” to produce a new item. You will notice that both the rope and the arrow have been removed from your inventory list, replaced by the “rope tied to arrow” item. You can get your rope and arrow back again by entering “split rope tied to arrow.” Sometimes you can refer to items by a single word (such as “split rope” in this case) and produce the same action, but if there is any ambiguity (if you have two different items with the word “rope” in their name) you may need to use the full title. If you are not sure, it is usually best to use the full name.
  • This concludes the introductory walkthrough of the Cog Engine. There is a great deal more to the Cycon Odyssey, and many of the puzzles will not be quite so simple to solve! Take some time to continue exploring the island, and see how far you can get.


Final Comments

    You should now have a pretty good idea of how games written for the Cog Engine work. The Cycon Odyssey is only the first in a series of games which will be based on the Cog Engine Project, and the game itself will evolve as the Cog Engine grows more complex. A goal for the next version of the Cog Engine is to eliminate the necessity of using the keyboard, so that games can be played in an entirely graphical manner, with the user clicking on the screen to move in a particular direction, and items and obstructions can be clicked on and manipulated directly. Features such as saving and loading games in progress, a fighting engine that allows the creation of Role-Playing Games (RPG’s), and even multi-user environments are planned to be added in the future.

    If you have any questions, comments, or suggestions about the Cog Engine Project, the Cycon Odyssey, or this or any other document, please feel free to contact the author, Steve Castellotti, by email at

SourceForge Logo