Getting Started with Region Modules
From OpenSimulator
(Difference between revisions)
| Line 3: | Line 3: | ||
This brief tutorial is intended to get people started with developing applications with/for opensim using region modules and the opensim API. The module available here writes "HELLO" in prims on every region of your opensim instance, and makes them move every 2 seconds or so. Please note: | This brief tutorial is intended to get people started with developing applications with/for opensim using region modules and the opensim API. The module available here writes "HELLO" in prims on every region of your opensim instance, and makes them move every 2 seconds or so. Please note: | ||
| − | * The opensim API is rapidly changing. The code available here works for SVN 7176, which corresponds to opensim 0.6.0. '''Please use a fresh install of | + | * The opensim API is rapidly changing. The code available here works for SVN 7176, which corresponds to opensim 0.6.0. '''Please use a fresh install of 7176 to run this example.''' The example assumes the default configuration of opensim out-of-the-box. If you try to run this example on custom configurations, you may get errors and/or warnings. Those errors/warnings can be easily fixed in the code of the example, once you understand how to work with the opensim API. But since I can't predict all combinations of configuration settings out there, the assumption here is a fresh install of opensim SVN 7176. Deviate at your own risk. |
To get started: | To get started: | ||
| − | # Download and install opensim svn 7176, and build it as normal. | + | # Download and install opensim svn 7176, and build it as normal. Run it once, so you create a default region and a default user. Then shut it down. |
# Get this zip file: http://www.ics.uci.edu/~lopes/opensim/HelloWorld.zip. Unzip it somewhere. | # Get this zip file: http://www.ics.uci.edu/~lopes/opensim/HelloWorld.zip. Unzip it somewhere. | ||
# Before you go changing the code of the application, see its effect inworld by doing this: | # Before you go changing the code of the application, see its effect inworld by doing this: | ||
| Line 16: | Line 16: | ||
Are you ready to explore the code now? | Are you ready to explore the code now? | ||
| + | |||
| + | Hold on. Before we do that, let me give you the 30-seconds introduction to Visual C#. | ||
Revision as of 08:11, 15 November 2008
Hello World
This brief tutorial is intended to get people started with developing applications with/for opensim using region modules and the opensim API. The module available here writes "HELLO" in prims on every region of your opensim instance, and makes them move every 2 seconds or so. Please note:
- The opensim API is rapidly changing. The code available here works for SVN 7176, which corresponds to opensim 0.6.0. Please use a fresh install of 7176 to run this example. The example assumes the default configuration of opensim out-of-the-box. If you try to run this example on custom configurations, you may get errors and/or warnings. Those errors/warnings can be easily fixed in the code of the example, once you understand how to work with the opensim API. But since I can't predict all combinations of configuration settings out there, the assumption here is a fresh install of opensim SVN 7176. Deviate at your own risk.
To get started:
- Download and install opensim svn 7176, and build it as normal. Run it once, so you create a default region and a default user. Then shut it down.
- Get this zip file: http://www.ics.uci.edu/~lopes/opensim/HelloWorld.zip. Unzip it somewhere.
- Before you go changing the code of the application, see its effect inworld by doing this:
- Grab HelloWorld/bin/Release/HelloWorld.dll and dump it in opensim/bin
- Start opensim as normal, and login to it.
You should see the word HELLO spelled out in prims, and moving every so often.
Are you ready to explore the code now?
Hold on. Before we do that, let me give you the 30-seconds introduction to Visual C#.
