OpenSimulator - User contributions [en]

Varregion

2017-09-03T04:42:30Z

LauraEss: /* Configuration */ Added not on ExternalHostName

{{MainPageQuicklinks}}

'''Varregion'''

__TOC__
"Varregion" is a feature of OpenSimulator that enables region sizes larger than 256x256. The region is just larger so it acts like a regular region but with borders farther apart.

The implementation uses the [http://aurora-sim.org Aurora] large region protocol extensions so the existing [http://firestormviewer.org Firestorm] and [http://singularityviewer.org Singularity] Aurora support will now work for OpenSimulator.

This is different from the older [[Megaregions]] large region feature which does not require extra viewer support (above that already implemented by Linden Lab) but which relies on a number of fragile hacks to make a viewer work in a way that Linden Lab never supported. Megaregions also contain a number of extant simulator-side bugs.

A growing list of protocol changes to implement "varregion" is at [[varregion/Protocol|Varregion Protocol]].

==Restrictions==
Some restrictions apply:
* The dimensions must be a multiple of 256 and less than or equal to 8192.
* The dimensions must be equal so regions are square
* Adjacent regions must be the same size unless they are all version 0.9. For instance, you can have multiple 512x512 regions adjacent (and see into the other region and border cross). There seems to be a viewer problem where, if regions of different size are within view distance, crashes can happen. Consider having regions of only the same size 'in view'. Remember that the region coordinates are specified in 256m region count so a group of four 512x512 regions would be specified at 8000/8000, 8000/8002, 8002/8000, and 8002/8002, for instance.
* With versions prior to 0.9 you must use BulletSim (0.9 ODE engines support varregions).
** You must use BulletSim's height map terrain implementation. As of 20140128, BulletSim has been modified to force heightmap terrain implementation if region size is greater than 256 on any side. The setting can be forced by adding to your INI files:
<source lang="ini">
[BulletSim]
TerrainImplementation = 0
</source>

* If you were previously using [[megaregions]] you must ensure that CombineContiguousRegions is now set to false.

<source lang="ini">
[Startup]
CombineContiguousRegions = false
</source>

==Configuration==
The size is be specified in the <tt>Region.ini</tt> file:
<pre>
[MyRegionName]
RegionUUID = 95ec77ec-58c5-4ce2-9ff3-b6d1900d78a2
Location = 1000,1000
SizeX = 1024
SizeY = 1024
InternalAddress = 0.0.0.0
InternalPort = 9200
AllowAlternatePorts = False
ExternalHostName = SYSTEMIP
</pre>
If size is not specified it will default to the legacy size of 256.

If the given dimensions do not fit the restrictions, acceptable values are computed and warning and error messages are output into the log.

If you leave ExternalHostName at the default 'SYSTEMIP' then this will become the LAN network address of the machine (e.g. 192.168.1.2). This is fine if you are connecting only from within your LAN. If you want to connect to it from a client on the internet, this should be the External IP Address of your router. Fully Qualified Domain Names (FQDNs) can also be used though they will be converted to a numeric IP address before being sent to the viewer.

If converting from a mega-region, remember to set "<tt>CombineContiguousRegions = false</tt>".

For llRezObject to work beyond 256m set "ScriptDistanceLimitFactor = 512.0" (for 512mx512m) in the [Xengine] section of OpenSim.ini.

If you have a very large region you might need to set the database maximum size to a larger value. For instance, a 2816x2816 region (11x11 legacy regions) turns into a 56 megabyte heightmap and, for MySQL, you would need to set <tt>max_allowed_packet</tt> to something like 64M. Version 0.9 stores terrain in compressed format so this depends on terrain complexity.

==Loading Terrain==
The usual terrain console commands work with varregions. If you have set up a larger region, you can load BMP/RAW/PNG heightmap files of the dimensions of the region and fill the whole region. For instance, a 1024x1024 region terrain would be completely initialized by "terrain load 1024.bmp" if '1024.bmp is a 1024x1024 bitmap.

==Varregions and OAR Files==
The objects and terrain are stored in an OAR file as if it was one region. That is, if you save a 1024x1024 region in an OAR file, you can later restore the objects and terrain into a 1024x1024 sized region. If you load an OAR file from a smaller region into a larger region, the unspecified terrain space will default to 25m.

To make conversion to varregions easier, [[Load_Oar|load oar]] now has a '--displacement "<x,y,z>"' parameter. This displaces all of the objects and the terrain from the oar file when loading them into the new region. For instance, say you have four OAR files from four adjacent 256x256 regions (oar00.oar, oar01.oar, oar10.oar, and oar11.oar). You create a new 512x512 varregion named 'bigregion'. The following commands place the four regions of objects, terrains and parcels
into the new larger region:

<pre>
change region bigregion
load oar oar00.oar
load oar oar01.oar --displacement "<0,256,0>" --merge --force-terrain --force-parcels
load oar oar10.oar --displacement "<256,0,0>" --merge --force-terrain --force-parcels
load oar oar11.oar --displacement "<256,256,0>" --merge --force-terrain --force-parcels
</pre>

Note the new "--force-terrain" and "--force-parcels" parameters. "--merge", used by itself, is for merging together the objects from multiple OARs. Merging also suppresses the loading of terrain and parcel data which is just what you want when merging objects. But, if loading multiple OARs to create a new, larger region, the terrain and parcel information must be loaded. Thus the new parameters.

==Things Known to be Broken==
* There is some problem with teleporting in and out of larger region. It works for some configurations and not others.
* While adjacent regions are usually viewable, sometimes they are not. They appear when you cross over into the region.

==Implementation Discussion==
Since this will be a major change to OpenSimulator that touches a
lot of different parts, subsequent posts, will discuss the changes I'm making.

===TerrainData===
(note that following comments may not apply to version 0.9)
One major problem is passing the terrain data from the region to the
protocol stack. The existing implementation passed an array of floats
that were presumed to be a 256x256 array of region terrain heights.
The
<tt>TerrainChannel</tt>
class is an attempt to hide the terrain implementation
from
<tt>TerrainModule</tt>
.
<tt>TerrainChannel</tt>
can't be passed into the protocol
stack (LLClientView) because
<tt>TerrainChannel</tt>
is defined as part of
<tt>OpenSim.Region.Framework</tt>
which is not visible to the protocol code.

My solution is to create the
<tt>TerrainData</tt>
class in
<tt>OpenSim.Framework.</tt>
<tt>TerrainData</tt>
just wraps the data structure for the terrain and additionally has
the attributes giving X and Y size.

I didn't want to change the signature of IClientAPI since so many external modules
rely on it.
It should be changed to pass <tt>TerrainData</tt> rather than a <tt>float[]</tt>.
I decided to not change IClientAPI but rather have <tt>LLClientView</tt> ignore
the passed array and instead reach back into the associated scene and fetch the
<tt>TerrainData</tt> instance.

There is one subclass of <tt>TerrainData</tt>: <tt>HeightmapTerrainData</tt> which keeps the terrain as a compressed heightmap. The height of each point is stored as a <tt>short</tt> which is <tt>height * compressionFactor</tt> where <tt>compressionFactor</tt> is usually "100". This creates a compact storage of the terrain heights with two decimal points of resolution.

The LLLP ("Linden Lab Legacy Protocol") sends terrain height data in
compressed "patches" of 16x16 areas of the terrain
height. This is a protocol feature that is implemented in <tt>TerrainChannel</tt>.
I feel that underlying protocol optimizations shouldn't appear up the
stack so, in creating <tt>TerrainData</tt>, I tried to hide terrain patches.
I mean, someday terrain will be generalized meshes. Right? (wrong :p )

===Terrain in the Database===
Previously, terrain height maps were saved in the database as a blob of 256x256 doubles. To have different region sizes, that format had to change. There is an existing database field <tt>revision</tt> that stored the time the terrain was saved. This revision information wasn't used for anything so this field was co-opted to contain a revision code for the height field blob.

There are three forms for the height map blob: legacy, compressed2D and regular2D. "legacy" is, of course, the previous 256x256 collections of doubles. "regular2D" contains the X, Y dimensions and enough floats for that area's heights. "compressed2D" contains the X,Y and compressionFactor followed by enough shorts for the height map.

The database readers and writers default to the legacy format and, if the region happens to have the dimensions 256x256, it is stored using the legacy format. This is an attempt to keep downward compatibility.

All of the database modules (MySQL, SQLite, MSSQL and PSQL) have been modified to store terrain this new way.

* some of this was removed in 0.9. Terrain is stored as a compressed array of floats (format V2DGzip).

===Sensing Border Crossing===
0.9 regions require 0.9 grid services. They can work on 0.8 grids, but keep view range above 256m

older versions:

Most of the ‘move to new region’ code is based on checking boundaries. There is much code related to computing if an object or avatar has crossed a region boundary and then computing the address of the next region from same. Introducing variable sized regions messes a lot of this computation up. That is, the code doing the arithmetic usually assumes it knows the address of the next region based on a known region size and then can compute the location of the next region based on that. With varregions those assumptions no longer hold. Varregion implementation means that the computation of region base locations and border locations moves to the GridService who is the entity who really knows the size of all the regions and what is adjacent to what.

The realization that location to region computation is really a GridService operation lead to a total rip apart of the grid boundary checking code and replacement of it with two functions: <tt>Scene.PositionIsInCurrentRegion(Vector3 pos)</tt> and then <tt>EntityTransferModule.GetRegionContainingWorldLocation(double X, double Y)</tt>. The former function tests to see if the object/avatar has moved out of the current region and the latter gets the region moved into. (Side note: <tt>GetRegionContainingWorldLocation</tt> should really be a function on <tt>IGridService</tt> but that exercise is left for future hacking).

These changes leave all the 'border' code in limbo -- the generation of the border lists is still there but it is not being used. This should eventually be cleaned up. Also, the computation of neighbor regions is scattered around with routines on <tt>IGridService</tt>, in <tt>EntityTransferModule</tt> and a bunch of bookkeeping in <tt>Scene</tt>. This too should be cleaned up.

==Implementation Notes==
Following is outdated for 0.9.

As of January 27, 2014, varregion is a feature of the 'master' repository branch.

===Stuff to Work On===
What follows are notes of things that might need work in OpenSimulator.

* ITerrainLoader implementations (mostly done)
** How to handle tiles.
** How to handle large regions sizes.
** Terrain/FileLoaders/*.cs all return an ITerrainChannel
** Need to fix all the file reader/writers
** FileLoaders/LLRAW.cs has several "256"s rather than constant references
* Teleporting: should be able to teleport to anywhere in a large region
** "MyRegion/550/687/40"
* HG code needs to allow addresses anywhere into large regions
* Need to look through RegionCombinerModule.cs and see what safety checks are needed
** Maybe just prevent combination if not legacy region size
* In LSL_Api.cs, llEdgeOfWorld() does some neighbor computation. Check for ok'ness.
* LandManagementModule.SendParcelOverlay sends land sale/ownership info for 4x4m areas
** Looks like it expects to send exactly one 1024 byte block (for the 256x256 legacy region
** Check viewer code for what will happen for larger regions
** New overlay types added
* LLClientView.SendMapBlockSplit() needs to have region size to send with the map info
* Region coords are sometimes 'int' and sometimes 'uint' with conversions EVERYWHERE
** pass over everything and convert region coordinates it 'uint's
** consider creating structures for world and region coordinates so there can be compile time checking

====Viewer====
* LLSurface is wired to expect adjacent regions of same size
* Terrain surface image is sized with a 'static": " static S32 sTextureSize; // Size of the surface texture"
* From FreeNode:#SingularityViewer 20131125:
<pre>
<Aleric> radams1, SianaGearz, frnic : I couldn't help myself doing a profile anyway.. The reason the viewer is slow is because it's busy "drawing" the terrain. "drawing" between quotes because my guess is that it is trying to draw ALL terrain and then clip that afterwards to the frustrum...
<Aleric> So, this could be greatly improved by disregarding terrain way way earlier when it is beyond the drawing range anyway.
<SianaGearz> OK
<Aleric> I disabled all rendering, even added a 'return' in terrain render
<Aleric> but.. no improvement of FPS!
<frnic> oops
<Aleric> LLSurfacePatch::updateVisibility() is still eating a lot of cpu.
<Aleric> LLSurface::updatePatchVisibilities does 97% of the calls to LLSurfacePatch::updateVisibility
<Aleric> which then spends most of it's time calling LLCamera::AABBInFrustumNoFarClip
</pre>
* Singularity commit for varregion: https://github.com/singularity-viewer/SingularityViewer/commit/ad8ea07a

==Testing==
* Terrain/parcel operations
** Default 256 standalone region
*** Clean database. Start single standalone region. Verify 'pimple' region. Verify one parcel. Flatten region.
*** Create parcels adjacent to each edge and standalone in middle. Change names of each parcel and verify. Restart simulator and verify parcels exist and work correctly.
*** Save five parcel region as OAR. Clear database. Restart region. Load oar. Verify 5 parcels of correct location, name and features.
** Adjacent 256 standalone regions
** 768x768 standalone region
** Changing land from 256 to 768
* Teleporting
* Adjacency
* Hypergrid

Using Leveller

2017-03-11T06:39:03Z

LauraEss: /Editing Terrain using Daylon Leveller/

== Daylon Leveller ==

[http://www.daylongraphics.com/products/leveller.php Dayton Leveller] is a powerful 3D terrain editor for windows from Daylon Graphics. With Leveller the user can "paint" terrain, use vectors to create contours (which can then create heightfields) and use a variety of filters and tools to create distinctive and realistic terrain features (see the website for a more complete list of features). Users can also import and export heightfields in a variety of formats, and the latest update includes the ability to import and export tilesets of regions (in Terragen format) from/to Opensimulator.

== External Tutorials ==

=== Official Tutorials ===

[http://www.daylongraphics.com/support/tutorials/filling_holes.php Filling Holes]

=== Harmonic Cycle ===
[http://harmoniccycle.com/hc/dem/lev/road_tut/LEV_road_tutorial.htm Import roads plug-in step by step]

=== Leveller for OpenSimulator ===
Part 1 - [http://asstnotesideas.blogspot.com.au/2017/02/leveller-for-opensimulator-part-1.html Importing from Opensimulator into Leveller]

Part 2 - [http://asstnotesideas.blogspot.com.au/2017/02/leveller-for-opensimulator-part-2.html Exporting from Leveller to Opensimulator]

Part 3 - [http://asstnotesideas.blogspot.com.au/2017/03/leveller-for-opensimulator-part-3.html Creating Terrain using shapes in Leveller]

Part 4 - [http://asstnotesideas.blogspot.com.au/2017/03/leveller-for-opensimulator-part-4.html Importing real life terrain] (uses terrain.party for source files)

Part 5 - [http://asstnotesideas.blogspot.com.au/2017/03/leveller-for-open-simulator-part-5.htmlMerging Leveller Documents] (uses terrain.party for source files)

Artist Home

2017-03-11T06:12:38Z

LauraEss: added Leveller link

{{Quicklinks}}

== Content Collections ==

Collections containing many different kinds of resources.

* [http://zadaroo.com/ Zadaroo.com]: Everything from skins and animations to complete sims as OAR files.
* [http://www.giessenict.nl/index.php/nl/opensimulator/opensimulator-downloads Giessen Opensimulator Projects]: Several kind of objects mostly under CC.
* [http://www.outworldz.com/Opensim/ Outworldz.com]: A large collection of stuff that you need. Ranging from mesh items to complete regions!
* [http://opensimcreativ.de/download/ opensimcreativ.de]: A collection of stuff that you need.

== Artist Documentation ==

This page contains information about content creation for OpenSimulator including best practices, guides, tools, examples, collaborative projects and of course Creative Commons licensed content.

Discussion group for people interested in creating content for Metaverse: [http://groups.google.com/group/open-content-for-metaverse Open Content for Metaverse]

Some useful resources of free material:

* A great summary sheet: [http://docs.google.com/View?docid=dgsbx7zg_9mzk6nxtc 3DCG for the hobbyist -- useful products and links]
* A hobbyist animators blog with all kinds of goodies: [http://www.cgspeed.com/ cgspeed]
* A source for free animations, 3d models, textures, etc.: [http://www.sharecg.com/ ShareCG]
* A huge 3d graphics source: [http://www.renderosity.com/ Renderosity]
* Runtime DNA: [http://www.runtimedna.com/forum/downloads.php www.runtimedna.com Free Downloads]

* [http://opengameart.org/ OpenGameArt] is an exceptional repository of permissively licensed content for game creation.
* [http://opensimcreativ.de/ OpenSimCreativ] Objects, Information and Downloads - Heightmaps,IAR,OAR.
This is not an exhaustive list, please add to it if you can!

I have tried to include sites which have free Poser/Opensim compatible content which could be used for "personal use" in your own "world". You must check the licensing for any commercial uses.

== Textures ==

Textures are images used to cover surfaces of 3d models and terrain. Textures can be anything form 1x1 to 1024x1024 images. Most of the textures for buildings, items and clothes are usually 512x512.

=== Best Practices ===

=== Guides ===



=== Tools ===

* [http://www.gimp.org/ GIMP] - [http://www.partha.com/ alternative GIMP] - GIMP is the GNU Image Manipulation Program for Linux, OS X and Windows.
* [http://www.getpaint.net/ PaintNET] [http://forums.getpaint.net/index.php?/forum/7-plugins-publishing-only/ Plugins] - Paint.NET is free image and photo editing software for Windows.
* [http://www.spiralgraphics.biz/ WoodWorkshop] - Wood Workshop is a free seamless texture editor for Windows.

=== Examples ===

=== Projects ===

=== Content Libraries ===
* [http://torley.s3.amazonaws.com/Torley-Textures.zip Torley Textures] is a collection of over 600 textures by Torley Linden.
* [http://www.cgtextures.com/ CGTextures] Some Great free textures (CC License)
* tonytextures 4000 free textures and Tutorials for 3D Modelling. [http://www.tonytextures.com/ English] - [http://www.tonytextures.de/ Deutsch]

== Models ==

Models are 3 dimensional objects which are formed from faces and textures. OpenSimulator supports three types of model: parametrized primitives, and sculpted primitives, and uploaded vertex mesh files.

To learn more about the model types, read the [[Models]] page.

=== Best Practices ===

=== Guides ===


=== Tools ===

* [http://www.blender.org/ Blender] - Blender is the free open source 3D content creation suite, available for all major operating systems under the GNU General Public License.
* [http://www.makehuman.org/ makehuman] - Realistic 3d humans, open source for Windows, OSX, Linux.
* [http://www.sketchup.com/ SketchUp] - SketchUp Make, free 3D drawing tool for OS X and Windows.
* [http://www.wings3d.com/ Wings 3d] - Sculpty editor

=== Examples ===
[[File:Biped.jpg]]

=== Projects ===

* [[OpenSimulator Avatar]]

=== Content Libraries ===

== Terrain ==

Currently OpenSimulator terrains consists of heightmap and textures for different directions and heights. OpenSimulator terrain can be imported in raw terrain format from several terrain editor tools.

=== Best Practices ===

=== Guides ===
* [[Tips#Terrain Tidbits|Terrain Tips]]
* [[Using L3DT]]
* [[Using Leveller]]
* [[Terrain making]]
* [[Detailed cross-region terrain making]]

=== Tools ===

* [http://www.bundysoft.com/L3DT/ L3DT] Windows-only tool to generate detailed terrain. Now has a specific Opensim export option, which exports in r32 format.
* [http://terrain.party/ Terrain.Party] Web-based tool for turning terrain from a real life world map into a height map which can be imported into Opensim using "terrain load <texture_name>.png". Note that the textures require resizing, since they are exported as 1081x1081 png files
* [http://www.daylongraphics.com/products/leveller.php/ Daylon Leveller] Windows-only tool for producing terrains from from a variety of sources (including Second Life, Terragen, and terrain.painter), and using painting-like tools and filters to create features. Imports and exports region(s) from/to Opensimulator, either as a tileset of one or more terragen files, or via PNG/RAW formats.

=== Examples ===

=== Projects ===

=== Content Libraries ===

* [[Free Terrains]]

<br />

=== Additional Terrain Resources ===

'''TERRAIN EDITING'''

There is now a Plugin made and available for the free program GIMP by Domino Designs which is easy to install and allows you to bring in RAW files and edit them. See http://dominodesigns.info/project/gimpterrain

GIMP is available free and downloadable at http://www.gimp.org/downloads/
GIMP is available for most Operating Systems and Platforms and is User Supported with many features and functions far beyond Terrain Editing.

'''REFERENCES / SUPPLEMENTAL SOURCES amd APPLICATIONS:'''
[[Tweaking]] Tutorial: Creating OpenSimulator terrain with Blender http://www.stringofbits.net/2009/09/tutorial-creating-opensim-terrain-with.html

Some free and some non-free terrains at http://www.rexxed.com/category/terrain

Tutorial on [http://tgib.co.uk/2010/05/07/how-to-create-raw-terrain-files-for-second-life-and-opensim-with-terragen/ creating terrain files with Terragen] as well as [http://tgib.co.uk/2010/06/05/how-to-create-megaregion-terrain-raw-files-for-second-life-and-opensim/ using Photoshop to edit terrain files and create megaregion terrain] with a library of [http://tgib.co.uk/category/creations/terrain-creations/ free terrain files]

Spinmass Virtual Creations, has two products for terrain making and generation which are free downloads. Look at Terrain Sculptor and Bailiwick. They are available from http://www.spinmass.com

'''Three easy to use Online Image Splitters'''

* http://www.chami.com/html-kit/services/is

* http://www.makeuseof.com/dir/online-image-splitter

== Sounds ==

Sounds clips can be used within (scripted) objects and as part of gestures. Current OpenSimulator sound formats are PCM WAVE (.wav) 16-bit/44.1KHz/mono or stereo with a maximum length of 10.00 seconds.

=== Best Practices ===

=== Guides ===

=== Tools ===

* [http://audacity.sourceforge.net/ Audacity] - Audacity® is free, open source software for recording and editing sounds. It is available for Mac OS X, Microsoft Windows, GNU/Linux, and other operating systems.
* [http://lmms.io/ LMMS] - Compose sound and music on Windows, Linux and OS X.

=== Examples ===

=== Projects ===

=== Content Libraries ===

* [http://www.freesound.org/ The Freesound Project] - The Freesound Project is a collaborative database of Creative Commons licensed sounds.

== Music ==

Music can be played via parcel media as either streamed or from a single music file.

=== Best Practices ===

=== Guides ===

=== Tools ===

* [http://lmms.io/ LMMS] - Compose sound and music on Windows, Linux and OS X.

=== Examples ===

=== Projects ===

=== Content Libraries ===

* [http://www.jamendo.com/ Jamendo] - Jamendo is a community of free, legal and unlimited music published under Creative Commons licenses.

== Animations ==

=== Best Practices ===

=== Guides ===

=== Tools ===
* [http://davedub.co.uk/bvhacker/ BVHacker] - Animation for OpenSimulator avatars.
* [http://www.qavimator.org/ QAvimator] - Animation for OpenSimulator avatars.
* [http://tali.appspot.com/bvh/bvhmirror.html/ BVH Mirror] - This is an online service to mirror a BVH animation/pose file. That is, looking left becomes looking right, the pose of the left arm becomes the pose of the right arm, etc..

=== Examples ===

=== Projects ===

=== Content Libraries ===

Related Software

2017-03-11T06:05:04Z

LauraEss: /* Terrain */

{{Quicklinks}}
{{thirdparty}}
= Introduction =
This is a page which lists software packages that are related to OpenSimulator but are not part of the core project. Opensimulator is not responsible for the content referenced by these links.

= Viewers =
These are the client programs that allow you to connect to an OpenSimulator installation and interact with it.

See [[Connecting]].

= Distributions =
These are projects that take the OpenSimulator core system and add more functionality or tailor it for a specific purpose.

See [[Download#Other_Distributions]].

= Services =

These can be divided into projects that provide a completely replacement for the ROBUST services backend or individual services.

== Complete replacements ==

* [https://github.com/openmetaversefoundation/simiangrid/commits/master SimianGrid] - A ROBUST services replacement which replaces the whole ROBUST stack with an alternative implementation based on PHP. The necessary support for SimianGrid is included in core OpenSimulator.

== Individual services ==

OpenSimulator services are architected such that an individual service (e.g. the asset service) can be replaced or added without having to change other services.

* [https://github.com/coyled/sras Simple Ruby Asset Service (SRAS)] - This is a replacement for the ROBUST asset service. It stores assets on disk, does compression and deduplication of identical assets. Some installation instructions are [http://onikenkon.com/sras/ here].
* [https://github.com/mcortez/flotsam Flotsam Groups] - This was the only available groups service until [[V2 Groups]] was added to core.

= Web Interfaces=

These are web frontends for OpenSimulator, either to allow users to register and perform other functions or for administrators to control the OpenSimulator installation (or both!).

See [[Webinterface]]

= Region Modules =
These are region modules which can be added to the OpenSimulator core distribution to provide extra functionality.

* [https://github.com/aduffy70/opensim-experimental/tree/master/Chat-Logger Chat-Logger] - An OpenSimulator region module to log chat traffic. Includes visitor alerts (when logging starts, stops, or new visitors enter the region) so the logging is transparent. Developed as a tool for meetings, training sessions, or educational environments.
* [https://github.com/justincc/EventRecordingModule EventRecordingModule] - Another event recording module that can log user login, logout, movement between simulators, chat and IM events to the log or a separate database for later analysis.
* [https://github.com/justincc/GenericMessagingModule GenericMessagingModule] - An example module to illustrate how an OpenSimulator extension can use the LLUDP GenericMessage packet to convey arbitrary data between a client/viewer and the simulator.
* [https://github.com/JakDaniels/OpenSimTide OpenSimTide] - An OpenSimulator region module which adds tides to your regions. You can control the tide period and height change via settings in OpenSim.ini and enable tide info to be chatted to the region for use in scripts in boats and waves. Tides only render properly on regions that are not adjacent, i.e. 1x1 islands.

= OpenSimulator Forge Projects =

OpenSimulator now has a [http://forge.opensimulator.org/gf/ forge] for related software. However, this is now deprecated. Please host projects elsewhere (e.g. Github) and add a link to this page. The projects that remain on the forge are there for legacy purposes.
* [http://forge.opensimulator.org/gf/project/osinstaller OpenSimulator Installers]
* [http://forge.opensimulator.org/gf/project/opensimwi/ OpenSimWi(Redux)]
* [http://forge.opensimulator.org/gf/project/openterrains/ Open Source Terrain Textures]
* [http://forge.opensimulator.org/gf/project/osraw/ Open Source RAW Terrain Textures]
* [http://forge.opensimulator.org/gf/project/sllauncher/ SL Launcher]
* [http://forge.opensimulator.org/gf/project/openusermanual/ Open User Manual]

== These are old projects that no longer appear to be maintained ==
* [http://forge.opensimulator.org/gf/project/deepservers/ DeepServer (ASP.NET Grid Server)]
* [http://forge.opensimulator.org/gf/project/modrex/ realXtend Modules]
* [http://forge.opensimulator.org/gf/project/ogp/ OGP Patches]
* [http://forge.opensimulator.org/gf/project/ostray/ OSTray]

= Tools =

== Archives ==

* [https://github.com/justincc/opensimulator-tools/tree/master/analysis/oarinfo oarinfo] - Currently a very basic python script that prints out some OAR information (e.g. number of contained assets).

== Control ==
* [https://github.com/justincc/opensimulator-tools/tree/master/infrastructure/control/osimctrl osimctrl] - A set of scripts to allow start, stop, restart, autorestart, etc. of an OpenSimulator instance from the command line using the GNU screen utility.

== Inventory ==

* [http://www.secondinventory.com/ Second Inventory] - A Windows based client that can be used to back up and restore objects from Second Life™ as well as from various OpenSimulator based grids. It allows you to back up objects from the Second Life™ main grid, and restore them into OpenSimulator grids. It is still a bit primitive and sometimes can be flaky.
* [http://was.fm/opensim:rake Rake] - Created as an alternative to Second Inventory, but OpenSource and free to use. Rake is meant to dump assets (textures, animations, notecards, scripts, etc...) from either Second Life™ or OpenSim to your local hard-drive.

== Log Analysis ==

* [https://github.com/justincc/opensimulator-tools/tree/master/analysis/opensimulator-log-analyzer Ola] - A very simple Python script that print out some stats given a simulator or robust service log (chiefly unique user numbers).

* [http://www.spellscape.co.uk/home/news/logview OSLogView] - A C# application for displaying log files with the same color coding as the console itself. Includes error highlighting and UUID highlighting.

== Monitoring ==
* [https://github.com/justincc/opensimulator-tools/tree/master/analysis/opensimulator-stats-analyzer Osta] - OpenSimulator stats analysis programs. Operates on saved stats information to produce summary and graph data of OpenSimulator session performance.

== Regions ==

* [[RegionGenerator]] - Generates Region XML Files

== Scripting ==

* A list of alternative LSL editors is at http://wiki.secondlife.com/wiki/LSL_Alternate_Editors#Notepad.2B.2B

== Terrain ==

* [http://www.ics.uci.edu/~lopes/terraingen/ Terraingen] - Tool for producing OpenSimulator terrains from USGS DEM files.
* [http://terrain.party/ Terrain.Party] Web-based tool for turning terrain from a real life world map into a height map which can be imported into Opensim using "terrain load <texture_name>.png". Note that the textures require resizing, since they are exported as 1081x1081 png files
* [http://www.daylongraphics.com/products/leveller.php/ Daylon Leveller] - Tool for producing OpenSimulator terrains from from a variety of sources, and using painting-like tools and filters to create features. Uses Terragen file format.

Note that you can export and import terrain using the console in Terragen format, as well as r32. Terragen format files (.ter) can be import provided that their dimensions match that of the region, and they have no heights less than zero. See terrain save and terrain load commands.

== Assets ==

* [http://opensim-asset.org/ opensim-asset.org] - show your opensim assets on your website as images.

= Other related software =

* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?sl_proxy%20%28E%29 sl_proxy] - sl_proxy is a Proxy System for Second Life™ and OpenSimulator to beyond firewall by NSL.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?OpenSim%2FMoneyServer DTL/NSL Money Server] - This Money Server is modified version of "DTL Currency Processing" for Linux/Unix by NSL.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?Rinions Rinions] - This is a real-time animation tool for Second Life™/OpenSim. Rinions sends animation data from Kinect to Viewer in real time using shared memory and over the Network by NSL.
* [https://github.com/talat77/opensimmaps/ OpenSim Maps] - Completely re-written for Google Maps API v3 from the v2 version included with [http://forge.opensimulator.org/gf/project/opensimwi/ OpenSimWi(Redux)] and now includes support for larger regions e.g. varregions.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?OpenSim%2FWind&word=Wind Fluid Solver Wind Module] by NSL
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?OAR%20Converter OARConv] This software converts from OAR to collada files for Unity3D by NSL.

= Concepts =

* [http://www.cs.cmu.edu/~johnny/projects/wii/ 3D Head Tracking Software] - The idea here is that Johnny has written an application that will allow real3d perspective using a WiiMote & a modified set of safety glasses. Johnny includes all of the source and several sample applications to get this moving forward. Would someone like to pick this up and build us a real3D interface for the SL browser? It's not as hard as you think.
* [http://en.wikipedia.org/wiki/Edusim Edusim on Opensim] - Edusim is a [http://en.wikipedia.org/wiki/Cave_Automatic_Virtual_Environment Cave Automatic Virtual Environment] based concept of lesson driven 3D virtual worlds on the ''classroom interactive whiteboard or classroom interactive surface''. Currently Edusim on Opencobalt Cobalt exists but tweaking a client and making Opensim "finger friendly" would seem to be a relatively straight forward task.

= See Also =

* [[:Category:Development|Development]]

[[Category:Users]]
[[Category:Support]]
[[Category:Tech Reference]]
[[Category:Help]]
[[Category:Configuration]]
[[Category:Getting Started]]
[[Category:Development]]

Artist Home

2017-03-11T06:03:49Z

LauraEss: /* Tools */

{{Quicklinks}}

== Content Collections ==

Collections containing many different kinds of resources.

* [http://zadaroo.com/ Zadaroo.com]: Everything from skins and animations to complete sims as OAR files.
* [http://www.giessenict.nl/index.php/nl/opensimulator/opensimulator-downloads Giessen Opensimulator Projects]: Several kind of objects mostly under CC.
* [http://www.outworldz.com/Opensim/ Outworldz.com]: A large collection of stuff that you need. Ranging from mesh items to complete regions!
* [http://opensimcreativ.de/download/ opensimcreativ.de]: A collection of stuff that you need.

== Artist Documentation ==

This page contains information about content creation for OpenSimulator including best practices, guides, tools, examples, collaborative projects and of course Creative Commons licensed content.

Discussion group for people interested in creating content for Metaverse: [http://groups.google.com/group/open-content-for-metaverse Open Content for Metaverse]

Some useful resources of free material:

* A great summary sheet: [http://docs.google.com/View?docid=dgsbx7zg_9mzk6nxtc 3DCG for the hobbyist -- useful products and links]
* A hobbyist animators blog with all kinds of goodies: [http://www.cgspeed.com/ cgspeed]
* A source for free animations, 3d models, textures, etc.: [http://www.sharecg.com/ ShareCG]
* A huge 3d graphics source: [http://www.renderosity.com/ Renderosity]
* Runtime DNA: [http://www.runtimedna.com/forum/downloads.php www.runtimedna.com Free Downloads]

* [http://opengameart.org/ OpenGameArt] is an exceptional repository of permissively licensed content for game creation.
* [http://opensimcreativ.de/ OpenSimCreativ] Objects, Information and Downloads - Heightmaps,IAR,OAR.
This is not an exhaustive list, please add to it if you can!

I have tried to include sites which have free Poser/Opensim compatible content which could be used for "personal use" in your own "world". You must check the licensing for any commercial uses.

== Textures ==

Textures are images used to cover surfaces of 3d models and terrain. Textures can be anything form 1x1 to 1024x1024 images. Most of the textures for buildings, items and clothes are usually 512x512.

=== Best Practices ===

=== Guides ===



=== Tools ===

* [http://www.gimp.org/ GIMP] - [http://www.partha.com/ alternative GIMP] - GIMP is the GNU Image Manipulation Program for Linux, OS X and Windows.
* [http://www.getpaint.net/ PaintNET] [http://forums.getpaint.net/index.php?/forum/7-plugins-publishing-only/ Plugins] - Paint.NET is free image and photo editing software for Windows.
* [http://www.spiralgraphics.biz/ WoodWorkshop] - Wood Workshop is a free seamless texture editor for Windows.

=== Examples ===

=== Projects ===

=== Content Libraries ===
* [http://torley.s3.amazonaws.com/Torley-Textures.zip Torley Textures] is a collection of over 600 textures by Torley Linden.
* [http://www.cgtextures.com/ CGTextures] Some Great free textures (CC License)
* tonytextures 4000 free textures and Tutorials for 3D Modelling. [http://www.tonytextures.com/ English] - [http://www.tonytextures.de/ Deutsch]

== Models ==

Models are 3 dimensional objects which are formed from faces and textures. OpenSimulator supports three types of model: parametrized primitives, and sculpted primitives, and uploaded vertex mesh files.

To learn more about the model types, read the [[Models]] page.

=== Best Practices ===

=== Guides ===


=== Tools ===

* [http://www.blender.org/ Blender] - Blender is the free open source 3D content creation suite, available for all major operating systems under the GNU General Public License.
* [http://www.makehuman.org/ makehuman] - Realistic 3d humans, open source for Windows, OSX, Linux.
* [http://www.sketchup.com/ SketchUp] - SketchUp Make, free 3D drawing tool for OS X and Windows.
* [http://www.wings3d.com/ Wings 3d] - Sculpty editor

=== Examples ===
[[File:Biped.jpg]]

=== Projects ===

* [[OpenSimulator Avatar]]

=== Content Libraries ===

== Terrain ==

Currently OpenSimulator terrains consists of heightmap and textures for different directions and heights. OpenSimulator terrain can be imported in raw terrain format from several terrain editor tools.

=== Best Practices ===

=== Guides ===
* [[Tips#Terrain Tidbits|Terrain Tips]]
* [[Using L3DT]]
* [[Terrain making]]
* [[Detailed cross-region terrain making]]

=== Tools ===

* [http://www.bundysoft.com/L3DT/ L3DT] Windows-only tool to generate detailed terrain. Now has a specific Opensim export option, which exports in r32 format.
* [http://terrain.party/ Terrain.Party] Web-based tool for turning terrain from a real life world map into a height map which can be imported into Opensim using "terrain load <texture_name>.png". Note that the textures require resizing, since they are exported as 1081x1081 png files
* [http://www.daylongraphics.com/products/leveller.php/ Daylon Leveller] Windows-only tool for producing terrains from from a variety of sources (including Second Life, Terragen, and terrain.painter), and using painting-like tools and filters to create features. Imports and exports region(s) from/to Opensimulator, either as a tileset of one or more terragen files, or via PNG/RAW formats.

=== Examples ===

=== Projects ===

=== Content Libraries ===

* [[Free Terrains]]

<br />

=== Additional Terrain Resources ===

'''TERRAIN EDITING'''

There is now a Plugin made and available for the free program GIMP by Domino Designs which is easy to install and allows you to bring in RAW files and edit them. See http://dominodesigns.info/project/gimpterrain

GIMP is available free and downloadable at http://www.gimp.org/downloads/
GIMP is available for most Operating Systems and Platforms and is User Supported with many features and functions far beyond Terrain Editing.

'''REFERENCES / SUPPLEMENTAL SOURCES amd APPLICATIONS:'''
[[Tweaking]] Tutorial: Creating OpenSimulator terrain with Blender http://www.stringofbits.net/2009/09/tutorial-creating-opensim-terrain-with.html

Some free and some non-free terrains at http://www.rexxed.com/category/terrain

Tutorial on [http://tgib.co.uk/2010/05/07/how-to-create-raw-terrain-files-for-second-life-and-opensim-with-terragen/ creating terrain files with Terragen] as well as [http://tgib.co.uk/2010/06/05/how-to-create-megaregion-terrain-raw-files-for-second-life-and-opensim/ using Photoshop to edit terrain files and create megaregion terrain] with a library of [http://tgib.co.uk/category/creations/terrain-creations/ free terrain files]

Spinmass Virtual Creations, has two products for terrain making and generation which are free downloads. Look at Terrain Sculptor and Bailiwick. They are available from http://www.spinmass.com

'''Three easy to use Online Image Splitters'''

* http://www.chami.com/html-kit/services/is

* http://www.makeuseof.com/dir/online-image-splitter

== Sounds ==

Sounds clips can be used within (scripted) objects and as part of gestures. Current OpenSimulator sound formats are PCM WAVE (.wav) 16-bit/44.1KHz/mono or stereo with a maximum length of 10.00 seconds.

=== Best Practices ===

=== Guides ===

=== Tools ===

* [http://audacity.sourceforge.net/ Audacity] - Audacity® is free, open source software for recording and editing sounds. It is available for Mac OS X, Microsoft Windows, GNU/Linux, and other operating systems.
* [http://lmms.io/ LMMS] - Compose sound and music on Windows, Linux and OS X.

=== Examples ===

=== Projects ===

=== Content Libraries ===

* [http://www.freesound.org/ The Freesound Project] - The Freesound Project is a collaborative database of Creative Commons licensed sounds.

== Music ==

Music can be played via parcel media as either streamed or from a single music file.

=== Best Practices ===

=== Guides ===

=== Tools ===

* [http://lmms.io/ LMMS] - Compose sound and music on Windows, Linux and OS X.

=== Examples ===

=== Projects ===

=== Content Libraries ===

* [http://www.jamendo.com/ Jamendo] - Jamendo is a community of free, legal and unlimited music published under Creative Commons licenses.

== Animations ==

=== Best Practices ===

=== Guides ===

=== Tools ===
* [http://davedub.co.uk/bvhacker/ BVHacker] - Animation for OpenSimulator avatars.
* [http://www.qavimator.org/ QAvimator] - Animation for OpenSimulator avatars.
* [http://tali.appspot.com/bvh/bvhmirror.html/ BVH Mirror] - This is an online service to mirror a BVH animation/pose file. That is, looking left becomes looking right, the pose of the left arm becomes the pose of the right arm, etc..

=== Examples ===

=== Projects ===

=== Content Libraries ===

Artist Home

2017-03-11T06:02:40Z

LauraEss: /* Tools */

{{Quicklinks}}

== Content Collections ==

Collections containing many different kinds of resources.

* [http://zadaroo.com/ Zadaroo.com]: Everything from skins and animations to complete sims as OAR files.
* [http://www.giessenict.nl/index.php/nl/opensimulator/opensimulator-downloads Giessen Opensimulator Projects]: Several kind of objects mostly under CC.
* [http://www.outworldz.com/Opensim/ Outworldz.com]: A large collection of stuff that you need. Ranging from mesh items to complete regions!
* [http://opensimcreativ.de/download/ opensimcreativ.de]: A collection of stuff that you need.

== Artist Documentation ==

This page contains information about content creation for OpenSimulator including best practices, guides, tools, examples, collaborative projects and of course Creative Commons licensed content.

Discussion group for people interested in creating content for Metaverse: [http://groups.google.com/group/open-content-for-metaverse Open Content for Metaverse]

Some useful resources of free material:

* A great summary sheet: [http://docs.google.com/View?docid=dgsbx7zg_9mzk6nxtc 3DCG for the hobbyist -- useful products and links]
* A hobbyist animators blog with all kinds of goodies: [http://www.cgspeed.com/ cgspeed]
* A source for free animations, 3d models, textures, etc.: [http://www.sharecg.com/ ShareCG]
* A huge 3d graphics source: [http://www.renderosity.com/ Renderosity]
* Runtime DNA: [http://www.runtimedna.com/forum/downloads.php www.runtimedna.com Free Downloads]

* [http://opengameart.org/ OpenGameArt] is an exceptional repository of permissively licensed content for game creation.
* [http://opensimcreativ.de/ OpenSimCreativ] Objects, Information and Downloads - Heightmaps,IAR,OAR.
This is not an exhaustive list, please add to it if you can!

I have tried to include sites which have free Poser/Opensim compatible content which could be used for "personal use" in your own "world". You must check the licensing for any commercial uses.

== Textures ==

Textures are images used to cover surfaces of 3d models and terrain. Textures can be anything form 1x1 to 1024x1024 images. Most of the textures for buildings, items and clothes are usually 512x512.

=== Best Practices ===

=== Guides ===



=== Tools ===

* [http://www.gimp.org/ GIMP] - [http://www.partha.com/ alternative GIMP] - GIMP is the GNU Image Manipulation Program for Linux, OS X and Windows.
* [http://www.getpaint.net/ PaintNET] [http://forums.getpaint.net/index.php?/forum/7-plugins-publishing-only/ Plugins] - Paint.NET is free image and photo editing software for Windows.
* [http://www.spiralgraphics.biz/ WoodWorkshop] - Wood Workshop is a free seamless texture editor for Windows.

=== Examples ===

=== Projects ===

=== Content Libraries ===
* [http://torley.s3.amazonaws.com/Torley-Textures.zip Torley Textures] is a collection of over 600 textures by Torley Linden.
* [http://www.cgtextures.com/ CGTextures] Some Great free textures (CC License)
* tonytextures 4000 free textures and Tutorials for 3D Modelling. [http://www.tonytextures.com/ English] - [http://www.tonytextures.de/ Deutsch]

== Models ==

Models are 3 dimensional objects which are formed from faces and textures. OpenSimulator supports three types of model: parametrized primitives, and sculpted primitives, and uploaded vertex mesh files.

To learn more about the model types, read the [[Models]] page.

=== Best Practices ===

=== Guides ===


=== Tools ===

* [http://www.blender.org/ Blender] - Blender is the free open source 3D content creation suite, available for all major operating systems under the GNU General Public License.
* [http://www.makehuman.org/ makehuman] - Realistic 3d humans, open source for Windows, OSX, Linux.
* [http://www.sketchup.com/ SketchUp] - SketchUp Make, free 3D drawing tool for OS X and Windows.
* [http://www.wings3d.com/ Wings 3d] - Sculpty editor

=== Examples ===
[[File:Biped.jpg]]

=== Projects ===

* [[OpenSimulator Avatar]]

=== Content Libraries ===

== Terrain ==

Currently OpenSimulator terrains consists of heightmap and textures for different directions and heights. OpenSimulator terrain can be imported in raw terrain format from several terrain editor tools.

=== Best Practices ===

=== Guides ===
* [[Tips#Terrain Tidbits|Terrain Tips]]
* [[Using L3DT]]
* [[Terrain making]]
* [[Detailed cross-region terrain making]]

=== Tools ===

* [http://www.bundysoft.com/L3DT/ L3DT] Windows-only tool to generate detailed terrain. Now has a specific Opensim export option, which exports in r32 format.
* [http://terrain.party/ Terrain.Party] Web-based tool for turning terrain from a real life world map into a height map which can be imported into Opensim using "terrain load <texture_name>.png". Note that the textures require resizing, since they are exported as 1081x1081 png files
* [http://www.daylongraphics.com/products/leveller.php/ Daylon Leveller] Windows-only tool for producing terrains from from a variety of sources, and using painting-like tools and filters to create features. Imports and exports region(s) from/to Opensimulator, either as a tileset of one or more terragen files, or via PNG/RAW formats.

=== Examples ===

=== Projects ===

=== Content Libraries ===

* [[Free Terrains]]

<br />

=== Additional Terrain Resources ===

'''TERRAIN EDITING'''

There is now a Plugin made and available for the free program GIMP by Domino Designs which is easy to install and allows you to bring in RAW files and edit them. See http://dominodesigns.info/project/gimpterrain

GIMP is available free and downloadable at http://www.gimp.org/downloads/
GIMP is available for most Operating Systems and Platforms and is User Supported with many features and functions far beyond Terrain Editing.

'''REFERENCES / SUPPLEMENTAL SOURCES amd APPLICATIONS:'''
[[Tweaking]] Tutorial: Creating OpenSimulator terrain with Blender http://www.stringofbits.net/2009/09/tutorial-creating-opensim-terrain-with.html

Some free and some non-free terrains at http://www.rexxed.com/category/terrain

Tutorial on [http://tgib.co.uk/2010/05/07/how-to-create-raw-terrain-files-for-second-life-and-opensim-with-terragen/ creating terrain files with Terragen] as well as [http://tgib.co.uk/2010/06/05/how-to-create-megaregion-terrain-raw-files-for-second-life-and-opensim/ using Photoshop to edit terrain files and create megaregion terrain] with a library of [http://tgib.co.uk/category/creations/terrain-creations/ free terrain files]

Spinmass Virtual Creations, has two products for terrain making and generation which are free downloads. Look at Terrain Sculptor and Bailiwick. They are available from http://www.spinmass.com

'''Three easy to use Online Image Splitters'''

* http://www.chami.com/html-kit/services/is

* http://www.makeuseof.com/dir/online-image-splitter

== Sounds ==

Sounds clips can be used within (scripted) objects and as part of gestures. Current OpenSimulator sound formats are PCM WAVE (.wav) 16-bit/44.1KHz/mono or stereo with a maximum length of 10.00 seconds.

=== Best Practices ===

=== Guides ===

=== Tools ===

* [http://audacity.sourceforge.net/ Audacity] - Audacity® is free, open source software for recording and editing sounds. It is available for Mac OS X, Microsoft Windows, GNU/Linux, and other operating systems.
* [http://lmms.io/ LMMS] - Compose sound and music on Windows, Linux and OS X.

=== Examples ===

=== Projects ===

=== Content Libraries ===

* [http://www.freesound.org/ The Freesound Project] - The Freesound Project is a collaborative database of Creative Commons licensed sounds.

== Music ==

Music can be played via parcel media as either streamed or from a single music file.

=== Best Practices ===

=== Guides ===

=== Tools ===

* [http://lmms.io/ LMMS] - Compose sound and music on Windows, Linux and OS X.

=== Examples ===

=== Projects ===

=== Content Libraries ===

* [http://www.jamendo.com/ Jamendo] - Jamendo is a community of free, legal and unlimited music published under Creative Commons licenses.

== Animations ==

=== Best Practices ===

=== Guides ===

=== Tools ===
* [http://davedub.co.uk/bvhacker/ BVHacker] - Animation for OpenSimulator avatars.
* [http://www.qavimator.org/ QAvimator] - Animation for OpenSimulator avatars.
* [http://tali.appspot.com/bvh/bvhmirror.html/ BVH Mirror] - This is an online service to mirror a BVH animation/pose file. That is, looking left becomes looking right, the pose of the left arm becomes the pose of the right arm, etc..

=== Examples ===

=== Projects ===

=== Content Libraries ===

Artist Home

2017-03-11T05:59:40Z

LauraEss: Added Daylon Leveller

{{Quicklinks}}

== Content Collections ==

Collections containing many different kinds of resources.

* [http://zadaroo.com/ Zadaroo.com]: Everything from skins and animations to complete sims as OAR files.
* [http://www.giessenict.nl/index.php/nl/opensimulator/opensimulator-downloads Giessen Opensimulator Projects]: Several kind of objects mostly under CC.
* [http://www.outworldz.com/Opensim/ Outworldz.com]: A large collection of stuff that you need. Ranging from mesh items to complete regions!
* [http://opensimcreativ.de/download/ opensimcreativ.de]: A collection of stuff that you need.

== Artist Documentation ==

This page contains information about content creation for OpenSimulator including best practices, guides, tools, examples, collaborative projects and of course Creative Commons licensed content.

Discussion group for people interested in creating content for Metaverse: [http://groups.google.com/group/open-content-for-metaverse Open Content for Metaverse]

Some useful resources of free material:

* A great summary sheet: [http://docs.google.com/View?docid=dgsbx7zg_9mzk6nxtc 3DCG for the hobbyist -- useful products and links]
* A hobbyist animators blog with all kinds of goodies: [http://www.cgspeed.com/ cgspeed]
* A source for free animations, 3d models, textures, etc.: [http://www.sharecg.com/ ShareCG]
* A huge 3d graphics source: [http://www.renderosity.com/ Renderosity]
* Runtime DNA: [http://www.runtimedna.com/forum/downloads.php www.runtimedna.com Free Downloads]

* [http://opengameart.org/ OpenGameArt] is an exceptional repository of permissively licensed content for game creation.
* [http://opensimcreativ.de/ OpenSimCreativ] Objects, Information and Downloads - Heightmaps,IAR,OAR.
This is not an exhaustive list, please add to it if you can!

I have tried to include sites which have free Poser/Opensim compatible content which could be used for "personal use" in your own "world". You must check the licensing for any commercial uses.

== Textures ==

Textures are images used to cover surfaces of 3d models and terrain. Textures can be anything form 1x1 to 1024x1024 images. Most of the textures for buildings, items and clothes are usually 512x512.

=== Best Practices ===

=== Guides ===



=== Tools ===

* [http://www.gimp.org/ GIMP] - [http://www.partha.com/ alternative GIMP] - GIMP is the GNU Image Manipulation Program for Linux, OS X and Windows.
* [http://www.getpaint.net/ PaintNET] [http://forums.getpaint.net/index.php?/forum/7-plugins-publishing-only/ Plugins] - Paint.NET is free image and photo editing software for Windows.
* [http://www.spiralgraphics.biz/ WoodWorkshop] - Wood Workshop is a free seamless texture editor for Windows.

=== Examples ===

=== Projects ===

=== Content Libraries ===
* [http://torley.s3.amazonaws.com/Torley-Textures.zip Torley Textures] is a collection of over 600 textures by Torley Linden.
* [http://www.cgtextures.com/ CGTextures] Some Great free textures (CC License)
* tonytextures 4000 free textures and Tutorials for 3D Modelling. [http://www.tonytextures.com/ English] - [http://www.tonytextures.de/ Deutsch]

== Models ==

Models are 3 dimensional objects which are formed from faces and textures. OpenSimulator supports three types of model: parametrized primitives, and sculpted primitives, and uploaded vertex mesh files.

To learn more about the model types, read the [[Models]] page.

=== Best Practices ===

=== Guides ===


=== Tools ===

* [http://www.blender.org/ Blender] - Blender is the free open source 3D content creation suite, available for all major operating systems under the GNU General Public License.
* [http://www.makehuman.org/ makehuman] - Realistic 3d humans, open source for Windows, OSX, Linux.
* [http://www.sketchup.com/ SketchUp] - SketchUp Make, free 3D drawing tool for OS X and Windows.
* [http://www.wings3d.com/ Wings 3d] - Sculpty editor

=== Examples ===
[[File:Biped.jpg]]

=== Projects ===

* [[OpenSimulator Avatar]]

=== Content Libraries ===

== Terrain ==

Currently OpenSimulator terrains consists of heightmap and textures for different directions and heights. OpenSimulator terrain can be imported in raw terrain format from several terrain editor tools.

=== Best Practices ===

=== Guides ===
* [[Tips#Terrain Tidbits|Terrain Tips]]
* [[Using L3DT]]
* [[Terrain making]]
* [[Detailed cross-region terrain making]]

=== Tools ===

* [http://www.bundysoft.com/L3DT/ L3DT] Windows-only tool to generate detailed terrain.
* [http://terrain.party/ Terrain.Party] Web-based tool for turning terrain from a real life world map into a height map which can be imported into Opensim using "terrain load <texture_name>.png". Note that the textures require resizing, since they are exported as 1081x1081 png files
* [http://www.daylongraphics.com/products/leveller.php/ Daylon Leveller] Windows-only tool for producing terrains from from a variety of sources, and using painting-like tools and filters to create features. Features import and export plugins from/to Opensimulator.

=== Examples ===

=== Projects ===

=== Content Libraries ===

* [[Free Terrains]]

<br />

=== Additional Terrain Resources ===

'''TERRAIN EDITING'''

There is now a Plugin made and available for the free program GIMP by Domino Designs which is easy to install and allows you to bring in RAW files and edit them. See http://dominodesigns.info/project/gimpterrain

GIMP is available free and downloadable at http://www.gimp.org/downloads/
GIMP is available for most Operating Systems and Platforms and is User Supported with many features and functions far beyond Terrain Editing.

'''REFERENCES / SUPPLEMENTAL SOURCES amd APPLICATIONS:'''
[[Tweaking]] Tutorial: Creating OpenSimulator terrain with Blender http://www.stringofbits.net/2009/09/tutorial-creating-opensim-terrain-with.html

Some free and some non-free terrains at http://www.rexxed.com/category/terrain

Tutorial on [http://tgib.co.uk/2010/05/07/how-to-create-raw-terrain-files-for-second-life-and-opensim-with-terragen/ creating terrain files with Terragen] as well as [http://tgib.co.uk/2010/06/05/how-to-create-megaregion-terrain-raw-files-for-second-life-and-opensim/ using Photoshop to edit terrain files and create megaregion terrain] with a library of [http://tgib.co.uk/category/creations/terrain-creations/ free terrain files]

Spinmass Virtual Creations, has two products for terrain making and generation which are free downloads. Look at Terrain Sculptor and Bailiwick. They are available from http://www.spinmass.com

'''Three easy to use Online Image Splitters'''

* http://www.chami.com/html-kit/services/is

* http://www.makeuseof.com/dir/online-image-splitter

== Sounds ==

Sounds clips can be used within (scripted) objects and as part of gestures. Current OpenSimulator sound formats are PCM WAVE (.wav) 16-bit/44.1KHz/mono or stereo with a maximum length of 10.00 seconds.

=== Best Practices ===

=== Guides ===

=== Tools ===

* [http://audacity.sourceforge.net/ Audacity] - Audacity® is free, open source software for recording and editing sounds. It is available for Mac OS X, Microsoft Windows, GNU/Linux, and other operating systems.
* [http://lmms.io/ LMMS] - Compose sound and music on Windows, Linux and OS X.

=== Examples ===

=== Projects ===

=== Content Libraries ===

* [http://www.freesound.org/ The Freesound Project] - The Freesound Project is a collaborative database of Creative Commons licensed sounds.

== Music ==

Music can be played via parcel media as either streamed or from a single music file.

=== Best Practices ===

=== Guides ===

=== Tools ===

* [http://lmms.io/ LMMS] - Compose sound and music on Windows, Linux and OS X.

=== Examples ===

=== Projects ===

=== Content Libraries ===

* [http://www.jamendo.com/ Jamendo] - Jamendo is a community of free, legal and unlimited music published under Creative Commons licenses.

== Animations ==

=== Best Practices ===

=== Guides ===

=== Tools ===
* [http://davedub.co.uk/bvhacker/ BVHacker] - Animation for OpenSimulator avatars.
* [http://www.qavimator.org/ QAvimator] - Animation for OpenSimulator avatars.
* [http://tali.appspot.com/bvh/bvhmirror.html/ BVH Mirror] - This is an online service to mirror a BVH animation/pose file. That is, looking left becomes looking right, the pose of the left arm becomes the pose of the right arm, etc..

=== Examples ===

=== Projects ===

=== Content Libraries ===

Related Software

2017-02-03T12:32:54Z

LauraEss: Added Daylon Leveller entry and

{{Quicklinks}}
{{thirdparty}}
= Introduction =
This is a page which lists software packages that are related to OpenSimulator but are not part of the core project. Opensimulator is not responsible for the content referenced by these links.

= Viewers =
These are the client programs that allow you to connect to an OpenSimulator installation and interact with it.

See [[Connecting]].

= Distributions =
These are projects that take the OpenSimulator core system and add more functionality or tailor it for a specific purpose.

See [[Download#Other_Distributions]].

= Services =

These can be divided into projects that provide a completely replacement for the ROBUST services backend or individual services.

== Complete replacements ==

* [https://github.com/openmetaversefoundation/simiangrid/commits/master SimianGrid] - A ROBUST services replacement which replaces the whole ROBUST stack with an alternative implementation based on PHP. The necessary support for SimianGrid is included in core OpenSimulator.

== Individual services ==

OpenSimulator services are architected such that an individual service (e.g. the asset service) can be replaced or added without having to change other services.

* [https://github.com/coyled/sras Simple Ruby Asset Service (SRAS)] - This is a replacement for the ROBUST asset service. It stores assets on disk, does compression and deduplication of identical assets. Some installation instructions are [http://onikenkon.com/sras/ here].
* [https://github.com/mcortez/flotsam Flotsam Groups] - This was the only available groups service until [[V2 Groups]] was added to core.

= Web Interfaces=

These are web frontends for OpenSimulator, either to allow users to register and perform other functions or for administrators to control the OpenSimulator installation (or both!).

See [[Webinterface]]

= Region Modules =
These are region modules which can be added to the OpenSimulator core distribution to provide extra functionality.

* [https://github.com/aduffy70/opensim-experimental/tree/master/Chat-Logger Chat-Logger] - An OpenSimulator region module to log chat traffic. Includes visitor alerts (when logging starts, stops, or new visitors enter the region) so the logging is transparent. Developed as a tool for meetings, training sessions, or educational environments.
* [https://github.com/justincc/EventRecordingModule EventRecordingModule] - Another event recording module that can log user login, logout, movement between simulators, chat and IM events to the log or a separate database for later analysis.
* [https://github.com/justincc/GenericMessagingModule GenericMessagingModule] - An example module to illustrate how an OpenSimulator extension can use the LLUDP GenericMessage packet to convey arbitrary data between a client/viewer and the simulator.
* [https://github.com/JakDaniels/OpenSimTide OpenSimTide] - An OpenSimulator region module which adds tides to your regions. You can control the tide period and height change via settings in OpenSim.ini and enable tide info to be chatted to the region for use in scripts in boats and waves. Tides only render properly on regions that are not adjacent, i.e. 1x1 islands.

= OpenSimulator Forge Projects =

OpenSimulator now has a [http://forge.opensimulator.org/gf/ forge] for related software. However, this is now deprecated. Please host projects elsewhere (e.g. Github) and add a link to this page. The projects that remain on the forge are there for legacy purposes.
* [http://forge.opensimulator.org/gf/project/osinstaller OpenSimulator Installers]
* [http://forge.opensimulator.org/gf/project/opensimwi/ OpenSimWi(Redux)]
* [http://forge.opensimulator.org/gf/project/openterrains/ Open Source Terrain Textures]
* [http://forge.opensimulator.org/gf/project/osraw/ Open Source RAW Terrain Textures]
* [http://forge.opensimulator.org/gf/project/sllauncher/ SL Launcher]
* [http://forge.opensimulator.org/gf/project/openusermanual/ Open User Manual]

== These are old projects that no longer appear to be maintained ==
* [http://forge.opensimulator.org/gf/project/deepservers/ DeepServer (ASP.NET Grid Server)]
* [http://forge.opensimulator.org/gf/project/modrex/ realXtend Modules]
* [http://forge.opensimulator.org/gf/project/ogp/ OGP Patches]
* [http://forge.opensimulator.org/gf/project/ostray/ OSTray]

= Tools =

== Archives ==

* [https://github.com/justincc/opensimulator-tools/tree/master/analysis/oarinfo oarinfo] - Currently a very basic python script that prints out some OAR information (e.g. number of contained assets).

== Control ==
* [https://github.com/justincc/opensimulator-tools/tree/master/infrastructure/control/osimctrl osimctrl] - A set of scripts to allow start, stop, restart, autorestart, etc. of an OpenSimulator instance from the command line using the GNU screen utility.

== Inventory ==

* [http://www.secondinventory.com/ Second Inventory] - A Windows based client that can be used to back up and restore objects from Second Life™ as well as from various OpenSimulator based grids. It allows you to back up objects from the Second Life™ main grid, and restore them into OpenSimulator grids. It is still a bit primitive and sometimes can be flaky.
* [http://was.fm/opensim:rake Rake] - Created as an alternative to Second Inventory, but OpenSource and free to use. Rake is meant to dump assets (textures, animations, notecards, scripts, etc...) from either Second Life™ or OpenSim to your local hard-drive.

== Log Analysis ==

* [https://github.com/justincc/opensimulator-tools/tree/master/analysis/opensimulator-log-analyzer Ola] - A very simple Python script that print out some stats given a simulator or robust service log (chiefly unique user numbers).

* [http://www.spellscape.co.uk/home/news/logview OSLogView] - A C# application for displaying log files with the same color coding as the console itself. Includes error highlighting and UUID highlighting.

== Monitoring ==
* [https://github.com/justincc/opensimulator-tools/tree/master/analysis/opensimulator-stats-analyzer Osta] - OpenSimulator stats analysis programs. Operates on saved stats information to produce summary and graph data of OpenSimulator session performance.

== Regions ==

* [[RegionGenerator]] - Generates Region XML Files

== Scripting ==

* A list of alternative LSL editors is at http://wiki.secondlife.com/wiki/LSL_Alternate_Editors#Notepad.2B.2B

== Terrain ==

* [http://www.ics.uci.edu/~lopes/terraingen/ Terraingen] - Tool for producing OpenSimulator terrains from USGS DEM files.
* [http://www.daylongraphics.com/products/leveller.php/ Daylon Leveller] - Tool for producing OpenSimulator terrains from from a variety of sources, and using painting-like tools and filters to create features. Uses Terragen file format.

Note that you can export and import terrain using the console in Terragen format, as well as r32. Terragen format files (.ter) can be import provided that their dimensions match that of the region, and they have no heights less than zero. See terrain save and terrain load commands.

== Assets ==

* [http://opensim-asset.org/ opensim-asset.org] - show your opensim assets on your website as images.

= Other related software =

* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?sl_proxy%20%28E%29 sl_proxy] - sl_proxy is a Proxy System for Second Life™ and OpenSimulator to beyond firewall by NSL.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?OpenSim%2FMoneyServer DTL/NSL Money Server] - This Money Server is modified version of "DTL Currency Processing" for Linux/Unix by NSL.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?Rinions Rinions] - This is a real-time animation tool for Second Life™/OpenSim. Rinions sends animation data from Kinect to Viewer in real time using shared memory and over the Network by NSL.
* [https://github.com/talat77/opensimmaps/ OpenSim Maps] - Completely re-written for Google Maps API v3 from the v2 version included with [http://forge.opensimulator.org/gf/project/opensimwi/ OpenSimWi(Redux)] and now includes support for larger regions e.g. varregions.
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?OpenSim%2FWind&word=Wind Fluid Solver Wind Module] by NSL
* [http://www.nsl.tuis.ac.jp/xoops/modules/xpwiki/?OAR%20Converter OARConv] This software converts from OAR to collada files for Unity3D by NSL.

= Concepts =

* [http://www.cs.cmu.edu/~johnny/projects/wii/ 3D Head Tracking Software] - The idea here is that Johnny has written an application that will allow real3d perspective using a WiiMote & a modified set of safety glasses. Johnny includes all of the source and several sample applications to get this moving forward. Would someone like to pick this up and build us a real3D interface for the SL browser? It's not as hard as you think.
* [http://en.wikipedia.org/wiki/Edusim Edusim on Opensim] - Edusim is a [http://en.wikipedia.org/wiki/Cave_Automatic_Virtual_Environment Cave Automatic Virtual Environment] based concept of lesson driven 3D virtual worlds on the ''classroom interactive whiteboard or classroom interactive surface''. Currently Edusim on Opencobalt Cobalt exists but tweaking a client and making Opensim "finger friendly" would seem to be a relatively straight forward task.

= See Also =

* [[:Category:Development|Development]]

[[Category:Users]]
[[Category:Support]]
[[Category:Tech Reference]]
[[Category:Help]]
[[Category:Configuration]]
[[Category:Getting Started]]
[[Category:Development]]

Server Commands

2017-01-25T23:56:16Z

LauraEss: Added "set water height" which was missing from list of commands.

{{Quicklinks}}

= What are server commands? =

Server commands are those you can type on the console to make the server do various things.

Commands can be divided up into those that apply to the simulator (simulator commands) and those that apply to grid services (service commands).

On a standalone system, both simulator and service commands will be available on the single standalone system console.

On a grid architecture, the simulator commands will be available on the simulators, whilst the service commands will be available on the ROBUST console.

'''Disclaimer''': some commands may not work as expected, some may not work at all, and there is a chance that you may even lose all your settings/contents. This summary quickly goes out of date - the best place to find commands is by typing "help" on the region console.

Except where noted, this list should be accurate for OpenSimulator 0.7.1 onwards.

= Commands =

== General Server Commands ==

These commands are available in both simulator and robust consoles.

=== General ===

* command-script [scriptfile] - Runs a command script containing console commands.
* quit - shutdown the server.
* show info - show server information (version and startup path). Before OpenSimulator 0.7.5 this is only available on the simulator console.
* show uptime - show server startup time and uptime. Before OpenSimulator 0.7.5 this is only available on the simulator console.
* show version - show server version. Before OpenSimulator 0.7.5 this is only available on the simulator console.
* shutdown - synonym for quit
* get log level - In OpenSimulator 0.7.5 and later, print the current console logging level. In OpenSimulator 0.7.4 and earlier please use the "set log level" command instead without a level parameter.
* set log level [level] - change the console logging level only. For example, off or debug. See [[Logging]] for more information. In OpenSimulator 0.7.4 and earlier, if called without the level argument prints the current level. In OpenSimulator 0.7.5 and later please use the "get log level" command instead. Only available on ROBUST console from OpenSimulator 0.7.5.

=== Debug ===

* debug http [<level>] - Turn on/off extra logging for HTTP request debugging. Only available on robust console from commit 94517c8 (dev code post 0.7.3.1). In current development code (for OpenSimulator 0.7.5) this is debug http in|out|all [<level>] since outbound HTTP messages can also now be logged (this was only possible for inbound before). For more information on this command, see [[Debugging]].

* debug threadpool level <level> - Turn on/off logging of activity in the main threadpool. For more information, see [[General-Purpose Threadpool]].

== Simulator Commands ==

=== General ===

* change region <region name> - subsequent commands apply only to the specified region. If region name is "root" then all regions are selected
* debug packet <level> - Turn on packet debugging, where OpenSimulator prints out summaries of incoming and outgoing packets for viewers, depending on the level set
* emergency-monitoring - turn emergency debugging monitoring mode on or off.
* help [<command>] - Get general command list or more detailed help on a specific command or set of commands
* link-mapping - Set a local grid co-ordinate to link to a remote hypergrid
* link-region - Link a HyperGrid region. Not sure how this differs from link-mapping
* modules list - List modules
* modules load <name> - Load a module
* modules unload <name> - Unload a module
* monitor report - Returns a variety of statistics about the current region and/or simulator
* set terrain heights <corner> <min> <max> [<x>] [<y>] - Sets the terrain texture heights on corner #<corner> to <min>/<max>, if <x> or <y> are specified, it will only set it on regions with a matching coordinate. Specify -1 in <x> or <y> to wildcard that coordinate. Corner # SW = 0, NW = 1, SE = 2, NE = 3.
* set terrain texture <number> <uuid> [<x>] [<y>] - Sets the terrain <number> to <uuid>, if <x> or <y> are specified, it will only set it on regions with a matching coordinate. Specify -1 in <x> or <y> to wildcard that coordinate.
* show caps - show all registered capabilities URLs
:NOTE: In OpenSimulator 0.7.1, "show capabilities" is shown as a result for help command, but actually only "show caps" will be accepted. ([http://opensimulator.org/mantis/view.php?id=5467 #5467])
* set water height # - sets the height simulator wide (rather than single regions as viewer tools do).
* show circuits - Show agent circuit data
* show connections - show connections data
* show http-handlers - show all registered http handlers
* show hyperlinks - list hg regions
* show modules - show module data
* show pending-objects - show number of objects in the pending queues of all viewers
* show pqueues [full] - show priority queue data for each client. Without the 'full' option, only root agents are shown. With the 'full' option child agents are also shown.
* show queues - Show queue data for agent connections.
* show threads - shows the persistent threads registered with the system. Does not include threadpool threads.
* show throttles [full] - Show throttle data for each client connection, and the maximum allowed for each connection by the server. Without the 'full' option, only root agents are shown. With the 'full' option child agents are also shown.
* unlink-region <local name> - unlink a hypergrid region

=== Appearance Commands ===

* appearance show - Show information about avatar appearance. Currently just checks whether the baked texture is "OK" or "corrupt". Still in development. Only exists in development code at the moment.

=== Archive Commands ===

* load iar <first> <last> <inventory path> <password> [<archive path>] - Load user inventory archive. See [[Inventory Archives]].
* load oar [filename] - load an OpenSimulator archive. This entirely replaces the current region. Default filename is '''region.oar'''. See [[OpenSim Archives]].
* load xml [-newIDs [<x> <y> <z>]] - Load a region's data from XML format (0.7.*: DEPRECATED and may be REMOVED soon. Use "load xml2" instead)
:those xml are the result of the export save or *export save-all
* load xml2 [filename] - optional parameters not supported for XML2 format as at 1-Jul-2008
* save iar <first> <last> <inventory path> <password> [<archive path>] - Save user inventory archive. See [[Inventory Archives]]
* save oar [filename] - save the current region to an OpenSimulator archive. Default filename is '''region.oar'''. See [[OpenSim Archives]].
* save prims xml2 [<prim name> <file name>] - Save named prim to XML2
* save xml [filename] - save prims to XML
* save xml2 [filename] - save prims to XML (Format 2 - rearrangement of some nodes, to make loading/saving easier)

=== Asset Commands ===

The fcache commands only currently appearance if you are using the fcache asset cache. This is the default on OpenSimulator.

* fcache assets - Attempt a deep scan and cache of all assets in all scenes
* fcache clear [file] [memory] - Remove all assets in the cache. If file or memory is specified then only this cache is cleared.
* fcache expire <datetime> - Purge cached assets older then the specified date/time
* fcache status - Display cache status
* j2k decode <ID> - Do JPEG2000 decoding of an asset.

=== Config Commands ===

* config get [<section>] [<key>] - Get the current configuration, either for a particular key, a particular section or the whole config.
* config save <path> - Save the current configuration to a file.
* config set <section> <key> - Set a particular configuration value. On the whole, this is useless since neither OpenSimulator nor modules dynamically reload config values.
* config show [<section>] [<key>] - Synonym for 'config get'

=== Land Commands ===

* land show - Shows all parcels on the current region.

=== Map Commands ===

* export-map [<path>] - Save an image of the world map (default name is exportmap.jpg)
* generate map - Regenerates and stores map tile. Only in development code post 0.7.6.

=== Object Commands ===

* backup - Persist currently unsaved object changes immediately instead of waiting for the normal persistence call. This shouldn't normally be required - the simulator persists region objects automatically at regular intervals and on shutdown.
* delete object creator <UUID> - Delete a scene object by creator
* delete object name [--regex] <name> - Delete a scene object by name.
* delete object outside - Delete all scene objects outside region boundaries. This is currently if z < 0 or z > 10000. Object outside these bounds have been known to cause issues with OpenSimulator's use of some physics engines (such as the Open Dynamics Engine).
* delete object owner <UUID> - Delete a scene object by owner
* delete object uuid <UUID> - Delete a scene object by uuid. In current dev code (post 0.7.5) this is "show object id" and also allows a local ID.
* dump object id <UUID-or-localID> - Dump the serialization of the given object to a file for debug purposes.
* edit scale <name> <x> <y> <z> - Change the scale of a named prim
* force update - Force the region to send all clients updates about all objects.
* show object name [--regex] <name> - Show details of scene objects with the given name.
* show object uuid <UUID> - Show details of a scene object with the given UUID. In current dev code (post 0.7.5) this is "show object id" and also allows a local ID.
* show part name [--regex] <name> - Show details of scene object parts with the given name.
* show part uuid <UUID> - Show details of a scene object parts with the given UUID. In current dev code (post 0.7.5) this is "show object id" and also allows a local ID.

=== Estate Commands ===
* reload estate - reload estate data

=== Region Commands ===
* change region <region name> - subsequent commands apply only to the specified region. If region name is "root" then all regions are selected
* create region [name] [filename] - Create a new region
* delete-region <name> - Delete a region from disk.
* region get - Post OpenSimulator 0.8.0.*. Show region parameters (Region Name, Region UUID, Location, URI, Owner ID, Flags).
* region restart abort [<message>] - Abort a scheduled region restart, with an optional message
* region restart bluebox <message> <delta seconds>+ - Schedule a region restart. If one delta is given then the region is restarted in delta seconds time. A time to restart is sent to users in the region as a dismissable bluebox notice. If multiple deltas are given then a notice is sent when we reach each delta.
* region restart notice <message> <delta seconds>+ - Schedule a region restart. Same as above except showing a transient notice instead of a dismissable bluebox.
* region set - Post OpenSimulator 0.8.0.*. Set certain region parameters. Currently, can set
** agent-limit - The current avatar limit for the region. More usually this is set via the region/estate dialog in a typical viewer. This persists over simulator restarts.
** max-agent-limit - The maximum value that agent-limit can have. Unfortunately, setting it here does not currently persist over server restarts. For that to happen it must be separately set as the MaxAgents parameter in the region config file.
* remove-region - remove a region from the simulator
* restart - Restarts all sims in this instance
* set region flags <Region name> <flags> - Set database flags for region
* show neighbours - Shows the local regions' neighbours
* show ratings - Show rating data
* show region - Show region parameters (Region Name, Region UUID, Location, URI, Owner ID, Flags).
* show regions - Show regions data (Region Names, XLocation YLocation coordinates, Region Ports, Estate Names)

=== Scene Commands ===

* debug scene - Turn on scene debugging
* rotate scene <degrees> - Rotates scene around 128,128 axis by x degrees where x=0-360.
* scale scene <factor> - Scales all scene objects by a factor where original size =1.0.
* translate scene <x,y,z> - Translate (move) the entire scene to a new coordinate. Useful for moving a scene to a different location on either a Mega or Variable region.
(please back up your region before using any of these commands and be aware of possible floating point errors the more they are used.)

=== Script Commands ===

These currently only exist in git master OpenSimulator development code post the 0.7.2 release.

* scripts resume [<script-item-uuid>] - Resumes all suspended scripts
* scripts show [<script-item-uuid>] - Show script information. <script-item-uuid> option only exists from git master 82f0e19 (2012-01-14) onwards (post OpenSimulator 0.7.2).
* scripts start [<script-item-uuid>] - Starts all stopped scripts
* scripts stop [<script-item-uuid>] - Stops all running scripts
* scripts suspend [<script-item-uuid>] - Suspends all running scripts

=== Stats Commands ===

* show stats - show useful statistical information for this server. See [[#Frame Statistics Values|Frame Statistics Values]] below for more information.
* stats show - a synonym for "show stats" (OpenSimulator dev code only post 19th March 2014).
* stats record - record stats periodically to a separate log file.
* stats save - save a snapshot of current stats to a file (OpenSimulator dev code only post 19th March 2014).

=== Terrain Commands ===

Note that some of these may require a sim restart to show properly.
* terrain load - Loads a terrain from a specified file.
* terrain load-tile - Loads a terrain from a section of a larger file.
* terrain save - Saves the current heightmap to a specified file.
* terrain fill - Fills the current heightmap with a specified value.
* terrain elevate - Raises the current heightmap by the specified amount.
* terrain lower - Lowers the current heightmap by the specified amount.
* terrain multiply - Multiplies the heightmap by the value specified.
* terrain bake - Saves the current terrain into the regions revert map.
* terrain revert - Loads the revert map terrain into the regions heightmap.
* terrain newbrushes - Enables experimental brushes which replace the standard terrain brushes. WARNING: This is a debug setting and may be removed at any time.
* terrain stats - Shows some information about the regions heightmap for debugging purposes.
* terrain effect - Runs a specified plugin effect.
* terrain modify - Performs terrain modifications in a bounded area in the heightmap.

=== Tree Commands ===

* tree active - Change activity state for the trees module
* tree freeze - Freeze/Unfreeze activity for a defined copse
* tree load - Load a copse definition from an xml file
* tree plant - Start the planting on a copse
* tree rate - Reset the tree update rate (mSec)
* tree reload - Reload copse definitions from the in-scene trees
* tree remove - Remove a copse definition and all its in-scene trees
* tree statistics - Log statistics about the trees

=== User Commands ===

* alert <message> - send an in-world alert to everyone
* alert-user <first> <last> <message> - send an an in-world alert to a specific user
* bypass permissions <true / false> - Bypass in-world permission checks
* debug permissions - Turn on permissions debugging
* force permissions - Force permissions on or off.
* kick user <first> <last> [message]: - Kick a user off the simulator
* login disable - Disable user entry to this simulator
* login enable - Enable user entry to this simulator
* login status - Show whether logins to this simulator are enabled or disabled
* show users [full]- show info about currently connected users to this region. Without the 'full' option, only users actually on the region are shown. With the 'full' option child agents of users in neighbouring regions are also shown.
* teleport user <destination> - Teleport a user on this simulator to a specific destination. Currently only in OpenSimulator development code after the 0.7.3.1 release (commit bf0b817).

=== Windlight/[[LightShare]] Commands ===

* windlight load - Load windlight profile from the database and broadcast
* windlight enable - Enable the windlight plugin
* windlight disable - Enable the windlight plugin

== ROBUST Service Commands ==

These can also be accessed on the simulator command console itself in standalone mode.

=== Asset Service ===

* delete asset - Delete an asset from the database. Doesn't appear to be implemented.
* dump asset <ID> - Dump an asset to the filesystem. OpenSimulator 0.7.3 onwards.
* show digest <ID> - Show summary information about an asset. From OpenSimulator 0.7.3 onwards this will be renamed to "show asset"

=== Grid Service ===

* set region flags <Region name> <flags> - Set database flags for region
* show region <Region name> - Show the details of a given region. This command is renamed to "show region name" in development versions of OpenSimulator.

The following commands currently only exist in development versions of OpenSimulator (post 0.7.3.1). These are currently found in the "Regions" help section.

* deregister region id <Region UUID> - Deregister a region manually. This can be helpful if a region was not properly removed due to bad simulator shutdown and the simulator has not since been restarted or its region configuration has been changed.
* show region at <x-coord> <y-coord> - Show details on a region at the given co-ordinate.
* show region name <Region name> - Show details on a region
* show regions - Show details on all regions. In standalone mode this version of the command is not currently available - the simulator version of "show regions" is used instead, which shows similar information.

=== User Service ===
* create user [first] [last] [passw] [RegionX] [RegionY] [Email] - creates a new user and password
:or just: create user - and server prompts for all data
:
:'''Note for use of create user in standalone mode:''' use the user default coordinates
:of 1000,1000 for Start Region X and Y position otherwise server
:gives error of "[LOGIN]: Not found region"

* reset user password - reset a user's password.
* show account <firstname> <lastname> - show account details for the given user name (0.7.2-dev)

=== Login Service ===
* login level <value> - Set the miminim userlevel allowed to login.
* login reset - reset the login level to its default value.
* login text <text to print during the login>
* set user level <firstname> <lastname> <level> - Set UserLevel for the user, which determines whether a user has a god account or can login at all (0.7.2-dev)

== Details of Terrain Module Commands ==

==== terrain load ====
Loads a terrain from a specified file.

Parameters
* filename (String)
The file you wish to load from, the file extension determines the loader to be used. Supported extensions include: .r32 (RAW32) .f32 (RAW32) .ter (Terragen) .raw (LL/SL RAW) .jpg (JPEG) .jpeg (JPEG) .bmp (BMP) .png (PNG) .gif (GIF) .tif (TIFF) .tiff (TIFF)

==== terrain load-tile ====
Loads a terrain from a section of a larger file.

Parameters
* filename (String)
The file you wish to load from, the file extension determines the loader to be used. Supported extensions include: .r32 (RAW32) .f32 (RAW32) .ter (Terragen) .raw (LL/SL RAW) .jpg (JPEG) .jpeg (JPEG) .bmp (BMP) .png (PNG) .gif (GIF) .tif (TIFF) .tiff (TIFF)
* file width (Integer)
The width of the file in tiles
* file height (Integer)
The height of the file in tiles
* minimum X tile (Integer)
The X region coordinate of the first section on the file
* minimum Y tile (Integer)
The Y region coordinate of the first section on the file

==== terrain save ====
Saves the current heightmap to a specified file.

Parameters
* filename (String)
The destination filename for your heightmap, the file extension determines the format to save in. Supported extensions include: .r32 (RAW32) .f32 (RAW32) .ter (Terragen) .raw (LL/SL RAW) .jpg (JPEG) .jpeg (JPEG) .bmp (BMP) .png (PNG) .gif (GIF) .tif (TIFF) .tiff (TIFF)

==== terrain fill ====
Fills the current heightmap with a specified value.

Parameters
* value (Double)
The numeric value of the height you wish to set your region to.

==== terrain elevate ====
Raises the current heightmap by the specified amount.

Parameters
* amount (Double)

==== terrain lower ====
Lowers the current heightmap by the specified amount.

Parameters
* amount (Double)
The amount of height to remove from the terrain in meters.

==== terrain multiply ====
Multiplies the heightmap by the value specified.

Parameters
* value (Double)
The value to multiply the heightmap by.

==== terrain bake ====
Saves the current terrain into the regions revert map.

==== terrain revert ====
Loads the revert map terrain into the regions heightmap.

==== terrain newbrushes ====
Enables experimental brushes which replace the standard terrain brushes. WARNING: This is a debug setting and may be removed at any time.

Parameters
* Enabled? (Boolean)
true / false - Enable new brushes

==== terrain stats ====
Shows some information about the regions heightmap for debugging purposes.

==== terrain effect ====
Runs a specified plugin effect

Parameters
* name (String)
The plugin effect you wish to run, or 'list' to see all plugins

==== terrain modify ====
Allows area-of-effect and tapering with standard heightmap manipulations.

General command usage:
:''terrain modify <operation> value [<mask>] [-taper=<value2>]''

:Parameters
:* value: base value to use in applying operation
:* mask:
:** -rec=x1,y1,dx[,dy] creates a rectangular mask based at x1,y1
:** -ell=x0,y0,rx[,ry] creates an elliptical mask centred at x0,y0
:* taper:
:** rectangular masks taper as pyramids
:** elliptical masks taper as cones

Terrain Manipulation (fill, min, max)
:* value represents target height (at centre of range)
:* value2 represents target height (at edges of range)

Terrain Movement (raise, lower, noise)
:* value represents a delta amount (at centre of range)
:* value2 represents a delta amount (at edges of range)

Terrain Smoothing (smooth)
:The smoothing operation is somewhat different than the others, as it does not deal with elevation values, but rather with strength values (in the range of 0.01 to 0.99). The algorithm is simplistic in averaging the values around a point, and is implemented as follows:

:The "strength" parameter specifies how much of the result is from the original value ("strength" * map[x,y]).
:The "taper" parameter specifies how much of the remainder is from the first ring surrounding the point (1.0 - "strength") * "taper". There are 8 elements in the first ring.
:The remaining contribution is made from the second ring surrounding the point. There are 16 elements in the second ring.
:e.g.
:''terrain modify smooth 0.5 -taper=0.6''
:* the original element will contribute 0.5 * map[x0,y0]
:* each element 1m from the point will contribute ((1-0.5)*0.6)/8 * map[x1,y1]
:* each element 2m from the point will contribute ((1-0.5)*0.4)/16 * map[x2,y2]

Notes:
:The "taper" value may need to be exaggerated due to the integer math used in maps.
:e.g. To create a 512x512 var island:
:''terrain modify min 30 -ell=256,256,240 -taper=-29''

Example:
: https://www.youtube.com/watch?v=pehyqr3H8I0

== Details of Hypergrid Commands ==

For full details and explanations of Hypergrid Commands, see the [http://opensimulator.org/wiki/Installing_and_Running_Hypergrid#Linking_regions_.28Optional.29 Linking Regions] sections of the [http://opensimulator.org/wiki/Installing_and_Running_Hypergrid Installing and Running Hypergrid] page.

'''show hyperlinks'''

This command will show a list of all hypergrid linked regions.

'''link-region <Xloc> <Yloc> <host> <port> <location-name>'''

* Use Xloc and Yloc that make sense to your world, i.e. close to your regions, but not adjacent.
* replace osl2.nac.uci.edu and 9006 with the domain name / ip address and the port of the region you want to link to

E.g. link-region 8998 8998 osl2.nac.uci.edu 9006 OSGrid Gateway

'''unlink-region <local region name>'''

This command will unlink the specified hypergrid linked region - be sure to use the exact local name as reported by the "show hyperlinks" command.

link-mapping

== Frame Statistics Values ==

The labels of the Frame Statistics values shown by the console command "show stats" are a bit cryptic. Here is a list of the meanings of these values:

* Dilatn - time dilation
* SimFPS - sim FPS
* PhyFPS - physics FPS
* AgntUp - # of agent updates
* RootAg - # of root agents
* ChldAg - # of child agents
* Prims - # of total prims
* AtvPrm - # of active prims
* AtvScr - # of active scripts
* ScrLPS - # of script lines per second
* PktsIn - # of in packets per second
* PktOut - # of out packets per second
* PendDl - # of pending downloads
* PendUl - # of pending uploads
* UnackB - # of unacknowledged bytes
* TotlFt - total frame time
* NetFt - net frame time
* PhysFt - physics frame time
* OthrFt - other frame time
* AgntFt - agent frame time
* ImgsFt - image frame time

[[Category:Support]]
[[Category:Help]]
[[Category:Configuration]]
[[Category:Getting Started]]
[[Category:Development]]