You are on page 1of 3

Welcome to Cobalt Updated on 10/05/08 ªCobaltº is a very early stage open source software application being developed to m ake it possible

for people to easily create, publish, access, and participate in sharable virtual worlds.  Currently in pre-alpha and built using the Croquet open source software platform, Cobalt uses peer-based messaging to eliminate the nee d for virtual world servers and makes it very simple to create and share secure virtual worlds that run on all major software operating systems. To Get Started To launch Cobalt, simply unzip the archive (or untar it if you are on a Linux ma chine), open the Cobalt main directory, and drag the Cobalt Image icon onto the Cobalt Virtual Machine icon.  In this pre-alpha build, Cobalt will startup in its software development environment characterized by the presence of a dark gray wo rkspace, several tabs along the edge of the workspace, and a Cobalt logo at the lower left hand corner.  To launch Cobalt from the development environment, simply click and drag the Cobalt logo toward the center of the desktop and then releas e the mouse button.  The initial default Cobalt space will then appear in a small window on the desktop.  This window can be resized to full screen by selecting Tog gle Full Screen from the Cobalt Menu.  Eventually, we will configure Cobalt to sta rtup directly in a default virtual world at full screen.  For now, it is advantage ous to startup in the development environment as we continue to develop Cobalt's functionality. The User Interface Now that you have Cobalt running, you should take some time to explore Cobalt's various menu options and placeholder preferences panels.  The overall menuing inte rface has been developed as a starting point for the Cobalt application.  As you e xplore the existing menu options, you will find that some items work while other s do not. There are three types of menu options in this pre-alpha build: 1) menu items in black font representing functionalities presently available in the current build (hey, they actually work!), 2) menu items items in black font followed by an as terisk (*) representing as yet incompletely implemented functionalities, and 3) ghosted menu items in gray font that either represent functionalities that exist within Croquet and which have yet to be connected to the user interface, or in most cases functionalities not yet implemented in either Cobalt or Croquet. The reason we have released Cobalt in this way is because the overall menu syste m design and associated information/preferences panels are intended to provide a scaffolding for software development activities by the community.  It is intended to be a `living' design document of sorts. Its very easy to see what still needs to be done! If we all work on a piece of the puzzle, we can make possible a UI that will ena ble extremely deep and powerful capabilities within the full release of the Coba lt application.  We hope that individual developers will rise to the challenge of identifying areas of functionality to address - and then 'hooking up' those func tionalities for the benefit of the larger community. Better yet, we hope that de velopers will identify additional functionalities that can further enhance Cobal t!  You can really help our emerging community by helping to add functionality whe re needed. There is a quicktime movie of how to use the inter-world linking here: http://w ww.duke.edu/~mccahill/inter-world-linking.mov Keyboard Assignments w,a,s,d the traditional forward, rotate left, backward, rotate right ctrl-shift-d toggle developer tool accessibility ctrl-a change camera "person-ness" ctrl-h Go to space home up arrow fly up down arrow fly down

a SqueakDebug. the problems in need of addressing are relatively simple and straightforward. When you report a bug.iam.html. type-ins. With some successes in these areas.  Well-written bug reports can be an especially useful contribution by non-developers who are interested in advancing this effor t during these early stages of Cobalt development.  Specifically . please make sure to provide information about how to reproduc e the bug.  There are several things that you could get started working on almost immed iately. Wor king on these things will provide you with a way to begin becoming familiar with the wonderful programming environment that Squeak offers . Sign up here for an account. you can then expand to address more complex concerns. if you have any additional information (such as screenshots. We recommend working through the first half of this online book:  http://www.  To determine where best to focus your efforts.shift-up arrow move camera in shift-down arrow move camera out shift-rmb rotate camera angle/avatar with mouse How to Help So. Once you're famili ar enough with the environment.  The effort would also greatly benefit from some really nice examples of con tent-rich worlds. Contributing Code To actively contribute to Cobalt you will need a mantis account . Reporting Bugs Software testing and bug reporting is a very important contribution to the effor t. you want to help with this exciting effort? First thing to do would be to be come familiar enough with the Squeak programming environment behind Cobalt/Croqu et so that you can begin addressing the implementation of some basic functionali ties. log into Mantis. In most cases.s etting up or completing various dialog boxes. Once you have the account.  They involve connecting UI elements (menu choices in Cobalt) to already existing functionalities/classes present within the Croquet SDK. The only two items that absolute ly must be filled in are the summary and the description of the bug (the other f eatures can be left at their default if you are uncertain what to fill in).unibe. and click on "Report bug".  We hope that many of the commu nity's software developers will consider taking on bug fixes. individuals can make an important contribution to the effort by either . Other Contributions Contributing code is only one of many ways to contribute to the Cobalt effort. The Mantis bug tracker is central place for submitting bug reports and tracking the state of Cobalt development. feature additions. and on weekly teleconference calls hosted by the Duke University Office of Information Technology (see the Cobalt Group section below for details on when these take place). All of these items are extremely useful when trying to fix any problems.  Co ntributing content (3D models. textures) for Cobalt worlds is also impor tant. For beginning Squeak developers.  These discussions take place on the Cobalt Google G roup.) please attach it to the bug report.and it will also ser ve to give you familiarity with the various classes/instances in Croquet. and information/preferen ces panels for spaces and objects in spaces. Also. and bug fixes. choose "Cobalt" as y our default project. you should take part in discussions with others who are wor king to bring Cobalt forward.log etc.sign up here.  Doing so will help the Cobalt development community to identify areas in need of programming and re-engineering. place a changeset in the monticello source code repository's c ontributions area and then reference that changeset from an bug report in the ma ntis bug tracker. To contribute code.  Given that Cobalt worlds are able to be saved as templates to w eb directories and then accessed by people using Cobalt from anywhere over the I nternet. meshes. then you can begin on a relatively straightforwa rd task of setting up or modifying some user interface elements.ch/~scg/SBE/index.

To subscribe to cobalt-dev. or by contributing . WHETHER IN AN ACTION OF CONTRACT.  If you arrive a fter the top of the hour. Cobalt Listserve Cobalt-Developer . Inc. The call begins at 21:00 GMT/UTC (5:00 PM EST. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.com. to any person obtaining a copy of this software and associated documentation files (the "Software"). 4:00 PM CST. THE SOFTWARE IS PROVIDED "AS IS". you will first need to contact John Dougan skype id: johnrdougan by chat about 5 minutes before the conference is scheduled to be gin.The primary mailing list for discussions and announcements ar ound the community-based development of the Cobalt application. including without limitation the rights to use. OUT OF OR IN CONNECTION WIT H THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. TORT OR OTHERWISE.hosting world templates at their own URL. and to permit persons to whom the Software is furnished to do so. License Copyright © 2002-2008 by The Croquet Consortium. distribute. and other individual. INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY. EXPRESS OR IMPLI ED. publish.. CroquetTM is a trademark o f The Croquet Consortium. 2:00 PM PST or you can look up your local time here).com) that is also based on Croquet t echnology. corpor ate.blogspot. use the chat to ask to join. subj ect to the following conditions: The above copyright notice and this permission notice shall be included in all c opies or substantial portions of the Software. The blog is a good place to get a sense of what's up and avai lable. To join. sublicense. merge. modify.qwaq. Permission is hereby granted.  The very best worlds contributed t o the Cobalt effort will be made available by Duke University through its Cobalt template directory. John will conference call everyone who is in his chat. click here. copy.  You should especially check out the work done by the Southeast Kansas Educ ational Resources group. To send email: cobalt-dev@duke. WITHOUT WARRANTY OF ANY KIND. You might also want to look at the commercial and propr ietary Qwaq Forums service (http://www.   . ARISING FROM. Inc. 3:00 PM MST. and/or sell copies of the Software. Then.org and follow up to date postings about Croquet-related efforts at http://jlo mbardi. IN NO EVENT SHALL THE AUTHORS OR COPYR IGHT HOLDERS BE LIABLE FOR ANY CLAIM. DAMAGES OR OTHER LIABILITY. free of charge. Where to Learn More You can read more information about the Croquet project at http://croquetconsort ium. and institutional contributors who have collectively contributed elements o f the CroquetTM software code to the Croquet Project.edu. Weekly Teleconferences Cobalt developers meet weekly via Skype teleconference.C3D templates to t he project under the Creative Commons license. to deal in th e Software without restriction.