User Documentation
From OpenSimulator
(Difference between revisions)
m (Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name) |
(Removing outdated tutorial, never mind that it is a really bad one at that) |
||
(47 intermediate revisions by 11 users not shown) | |||
Line 1: | Line 1: | ||
+ | __NOTOC__ | ||
{{Quicklinks}} | {{Quicklinks}} | ||
− | |||
This is user documentation for OpenSimulator, mainly aimed towards administrators of the system rather than the ultimate end-users who access the environment through a viewer. If you can't find what you want here you might want to try looking in the [[Developer Documentation]]. | This is user documentation for OpenSimulator, mainly aimed towards administrators of the system rather than the ultimate end-users who access the environment through a viewer. If you can't find what you want here you might want to try looking in the [[Developer Documentation]]. | ||
For a summary of what features have been implemented in OpenSimulator, please see the [[Feature Matrix]]. | For a summary of what features have been implemented in OpenSimulator, please see the [[Feature Matrix]]. | ||
− | == | + | {| width="100%" cellpadding=10 margin: 10px 10px 10px 10px; |
+ | |- | ||
+ | |valign="top" | | ||
+ | {{Portal_Part|Setup| | ||
+ | {{Div col|colwidth=12em|rules=yes|gap=1em}} | ||
* [[Download]] - Download instructions | * [[Download]] - Download instructions | ||
* [[Dependencies]] - The other packages you need to install that OpenSimulator relies upon | * [[Dependencies]] - The other packages you need to install that OpenSimulator relies upon | ||
Line 13: | Line 17: | ||
* [[Configuring Regions]] - More details on configuring regions in Regions.ini | * [[Configuring Regions]] - More details on configuring regions in Regions.ini | ||
* [[Configuring Simulator Parameters]] - More details on the structure and configuration simulator parameters after the initial setup. | * [[Configuring Simulator Parameters]] - More details on the structure and configuration simulator parameters after the initial setup. | ||
+ | * [[Direct Service Requests]] - Details on how some requests that are by default handled by the viewer (e.g. GetTexture capability) could instead be handled directly by the service. | ||
+ | * [[Shared Services Configuration]] - An approach for sharing user, asset and inventory services between two otherwise separate grids. | ||
* [[Database Settings]] - Detailed configurations to connect to your database | * [[Database Settings]] - Detailed configurations to connect to your database | ||
+ | * [[Map]] - Information on configuring OpenSimulator to serve map tiles. | ||
+ | * [[Estate Support]] - Information about estates in OpenSimulator. | ||
+ | * [[Economy]] - Information (incomplete) on setting up the economy aspects of OpenSimulator (e.g. land sales). | ||
+ | * [[UserProfiles]] - Information on enabling the user profiles support included with OpenSimulator 0.7.6 onwards. | ||
* [[Upgrading]] - How to upgrade your OpenSimulator version so that you can use your existing data | * [[Upgrading]] - How to upgrade your OpenSimulator version so that you can use your existing data | ||
* [[Network Settings]] - NAT, Ports, Services and more. | * [[Network Settings]] - NAT, Ports, Services and more. | ||
* [[Firewall Settings]] - Incomplete operating system specific instructions on how to open firewall ports for external OpenSimulator access. | * [[Firewall Settings]] - Incomplete operating system specific instructions on how to open firewall ports for external OpenSimulator access. | ||
− | |||
* [[Tips]] - Useful tips from users like you | * [[Tips]] - Useful tips from users like you | ||
* [[OpenSim Graphics]] - Graphics that can be used on OpenSimulator websites, viewer login pages or products. | * [[OpenSim Graphics]] - Graphics that can be used on OpenSimulator websites, viewer login pages or products. | ||
* [[FAQ]] - Frequently Asked Questions | * [[FAQ]] - Frequently Asked Questions | ||
+ | {{Div col end}} | ||
+ | }} | ||
+ | {{Portal_Part|Optional Features| | ||
+ | {{Div col|colwidth=12em|rules=yes|gap=1em}} | ||
+ | * [[Feature Proposals/AutoBackup|AutoBackup]] - Module for automatically backing up a region to an OAR regularly using a different filename. | ||
+ | * [[Freeswitch Module]] - Using FreeSWITCH for voice in OpenSimulator. | ||
+ | * [[Mumble]] - Using Mumble/Whisper for voice in OpenSimulator. | ||
+ | * [[Enabling Groups]] - How to enable creating groups in your regions. | ||
+ | * [[JsonStore Module]] - Module for storing and sharing structured data among region modules and scripts. | ||
+ | * [[MuteList|MuteList Module]] - OpenSimMutelist is an add-on mutelist module for use with the Open Simulator project. | ||
+ | * [[Offline_Instant_Messaging_v2|Offline Instant Messaging]] - Module to store and later replay instant messages received by users that are offline. | ||
+ | * [[Trees Module]] - Module to populate region with different trees. | ||
+ | {{Div col end}} | ||
+ | }} | ||
− | |||
− | |||
− | + | {{Portal_Part|RealXtend (abandoned)| | |
− | + | The RealXtend modules for OpenSimulator have not been updated for a long time and should be considered dead. However, this information may be useful for historical purposes. | |
− | + | {{Div col|colwidth=12em|rules=yes|gap=1em}} | |
− | + | * [[ModRex]] - How to setup the RealXtend server module | |
− | + | * [[RealXtend Viewer Linux]] - This tutorial describes how to use the RealXtend viewer on Linux, using wine | |
− | * [[ | + | {{Div col end}} |
− | + | }} | |
− | * [[ | + | |
− | + | |valign="top" width="50%"| | |
− | + | ||
− | + | ||
− | + | ||
− | + | {{Portal_Part|Core Features| | |
+ | {{Div col|colwidth=12em|rules=yes|gap=1em}} | ||
* [[Feature Matrix]] - Matrix of features currently implemented by OpenSimulator. | * [[Feature Matrix]] - Matrix of features currently implemented by OpenSimulator. | ||
+ | * [[Access Control]] - Controlling user access to OpenSimulator. | ||
+ | * [[Attachments]] - Some information about avatar attachments. | ||
* [[Scripting Documentation]] - Everything you need to know about OpenSimulator scripting, and the list of sample scripts | * [[Scripting Documentation]] - Everything you need to know about OpenSimulator scripting, and the list of sample scripts | ||
+ | * [[ScriptEngines]] - Information about OpenSimulator's script engine. | ||
* [[OpenSim Archives]] - Loading and saving whole region archives with OpenSimulator | * [[OpenSim Archives]] - Loading and saving whole region archives with OpenSimulator | ||
* [[Inventory Archives|OpenSimulator Inventory Archives]] - Loading and saving user inventory items and folders with OpenSimulator | * [[Inventory Archives|OpenSimulator Inventory Archives]] - Loading and saving user inventory items and folders with OpenSimulator | ||
+ | * [[Mesh]] - Mesh support in OpenSimulator. | ||
* [[NPC]] - Use of Non Player Characters (NPCs) in OpenSim, also known as bots. | * [[NPC]] - Use of Non Player Characters (NPCs) in OpenSim, also known as bots. | ||
* [[Custom Libraries]] - Describes how to add custom content to your OpenSimulator server | * [[Custom Libraries]] - Describes how to add custom content to your OpenSimulator server | ||
Line 49: | Line 72: | ||
* [[GridInfo]] - how to provide information about your grid to smart clients | * [[GridInfo]] - how to provide information about your grid to smart clients | ||
* [[PhysicsEngines]] — Options for physics engines in OpenSimulator. | * [[PhysicsEngines]] — Options for physics engines in OpenSimulator. | ||
+ | * [[Media On A Prim]] - Media on a prim (shared media) functionality in OpenSimulator. | ||
+ | * [[Varregion]] - Support for regions greater (or smaller!) than 256m x 256m. Requires a compatible viewer. | ||
* [[:Category:Tech Reference|Technical Reference]] - Technical Reference Guide | * [[:Category:Tech Reference|Technical Reference]] - Technical Reference Guide | ||
+ | {{Div col end}} | ||
+ | }} | ||
− | == | + | {{Portal_Part|Troubleshooting| |
− | * [[ | + | {{Div col|colwidth=12em|rules=yes|gap=1em}} |
− | * [[ | + | * [[Troubleshooting]] - General troubleshooting tips and links to other pages. |
− | + | * [[Appearance Troubleshooting]] - Troubleshooting appearance specific issues (cloudy and grey avatars). | |
− | + | {{Div col end}} | |
+ | }} | ||
− | == | + | {{Portal_Part|User Guide| |
+ | {{Div col|colwidth=12em|rules=yes|gap=1em}} | ||
+ | * [[Connecting]] - How to connect a compatible viewer to OpenSimulator. | ||
+ | * [[Glossary]] - A glossary of terms used in OpenSimulator. | ||
+ | {{Div col end}} | ||
+ | }} | ||
− | + | {{Portal_Part|Integration| | |
+ | {{Div col|colwidth=12em|rules=yes|gap=1em}} | ||
+ | * [[RemoteAdmin]] - Using the XMLRPC administration interface for executing commands remotely. | ||
+ | * [[AuthIntegration]] - How to integrate external systems (such as web frontends) with OpenSimulator. | ||
+ | * [[UserManipulation]] - How to create users in OpenSimulator via external calls through ROBUST (only available when running in grid configuration). | ||
+ | * [[CABP And Attachments Manipulation]] - How to change clothing and body parts on offline avatars via ROBUST service calls. | ||
+ | * [[Known Web Interfaces within OpenSim]] - The set of [[CAPS]], XMLRPC, or REST entry points in the project. | ||
+ | {{Div col end}} | ||
+ | }} | ||
− | * [[ | + | {{Portal_Part|Administrator Guide| |
+ | {{Div col|colwidth=12em|rules=yes|gap=1em}} | ||
+ | * [[Server Commands]] - Commands to control OpenSimulator | ||
+ | * [[OpenSim.exe Command Line Options]] - Switches when you launch OpenSimulator. | ||
+ | * [[Directory Structure]] - Information about OpenSimulator's directory structure. | ||
+ | * [[Useful Queries]] - Some useful queries for manipulating the OpenSimulator database. | ||
+ | * [[Logging]] - Logging in OpenSimulator | ||
+ | * [[Monitoring]] - Monitoring OpenSimulator | ||
+ | * [[Threading]] - Information on the way that threads are used in OpenSimulator, including information on the thread tracking report. | ||
+ | * [[Automating Tasks]] - How to make administrating a walk in the park | ||
+ | * [[RestConsole]] - Using the remote console. | ||
+ | * [[Performance]] - How to tweak OpenSim's performance and some tips on scaling. | ||
+ | * [[Console-less OpenSim]] - How to run OpenSimulator without console | ||
+ | * [[Backups]] - How to backup your OpenSimulator data. | ||
+ | * [[AssetCache]] - Information about OpenSimulator's asset cache. | ||
+ | {{Div col end}} | ||
+ | }} | ||
− | + | |} | |
− | + | ||
− | + | ||
== Tutorials == | == Tutorials == | ||
Line 72: | Line 127: | ||
=== Platform specific === | === Platform specific === | ||
− | * [[ | + | * [[OSHT]] - OpenSim HowTo: Configuring a Grid. This tutorial describes how to install and configure OpenSimulator in grid mode on a Linux platform. |
* [[Wiimote]] - How to use a wiimote/nunchuk controller with the OpenSimulator viewer (Linux) | * [[Wiimote]] - How to use a wiimote/nunchuk controller with the OpenSimulator viewer (Linux) | ||
* [[Cacti]] - Generate Serverstats using the Cacti-Tool and SNMP (Linux) | * [[Cacti]] - Generate Serverstats using the Cacti-Tool and SNMP (Linux) | ||
Line 79: | Line 134: | ||
* [http://chapter-and-metaverse.blogspot.com Chapter & Metaverse] - Full suite of tutorials, tips and tricks, for the Windows user (Windows) Also very useful for Linux users! | * [http://chapter-and-metaverse.blogspot.com Chapter & Metaverse] - Full suite of tutorials, tips and tricks, for the Windows user (Windows) Also very useful for Linux users! | ||
+ | |||
+ | * [http://opensimulator.org/wiki/User:Emperor_Starfinder How to install osmodules on Windows using IIS] - How to install osmodules on windows using IIS | ||
+ | * [[Collectd]] Generate Serverstats using Collectd | ||
=== Cross-platform === | === Cross-platform === | ||
Line 84: | Line 142: | ||
* [[Using L3DT]] - How to create custom terrains | * [[Using L3DT]] - How to create custom terrains | ||
* [[Detailed cross-region terrain making]] - A workflow for creating large cross-region custom terrains | * [[Detailed cross-region terrain making]] - A workflow for creating large cross-region custom terrains | ||
− | * [http://update.multiverse.net/wiki/index.php/About_Terrain How to make a good Terrain (includes 4 programs to use)] | + | * [http://update.multiverse.net/wiki/index.php/About_Terrain How to make a good Terrain (includes 4 programs to use)] (broken link) |
− | * [http://www.nsl.tuis.ac.jp/xoops/modules/d3downloads/index.php?page=singlefile&cid=8&lid=22 Japanese Manual for Construction of OpenSimulator Server System on Linux] by NSL (Sorry, Japanese only) | + | * [http://www.nsl.tuis.ac.jp/xoops/modules/d3downloads/index.php?page=singlefile&cid=8&lid=22 Japanese Manual for Construction of OpenSimulator Server System on Linux] by NSL (Sorry, Japanese text only) |
=== Application === | === Application === | ||
* [http://www.scribd.com/doc/57959626/OpenSimulator-School-Quick-Start-Guide David W. Deeds' OpenSimulator School Quick Start Guide] - David W. Deeds' OpenSimulator School Quick Start Guide courtesy of Changchun American International School. Has lots of useful and interesting info, including lesson plans. | * [http://www.scribd.com/doc/57959626/OpenSimulator-School-Quick-Start-Guide David W. Deeds' OpenSimulator School Quick Start Guide] - David W. Deeds' OpenSimulator School Quick Start Guide courtesy of Changchun American International School. Has lots of useful and interesting info, including lesson plans. | ||
− | |||
− | |||
− | |||
− | |||
+ | |||
+ | |||
+ | <!-- | ||
+ | <cleanpage title=hide cats=hide /> | ||
+ | [[Category:Portals]] | ||
[[Category:Users]] | [[Category:Users]] | ||
[[Category:Support]] | [[Category:Support]] | ||
Line 101: | Line 160: | ||
[[Category:Getting Started]] | [[Category:Getting Started]] | ||
[[Category:Development]] | [[Category:Development]] | ||
+ | --> |
Latest revision as of 15:08, 26 February 2022
This is user documentation for OpenSimulator, mainly aimed towards administrators of the system rather than the ultimate end-users who access the environment through a viewer. If you can't find what you want here you might want to try looking in the Developer Documentation.
For a summary of what features have been implemented in OpenSimulator, please see the Feature Matrix.
Setup
Optional Features
RealXtend (abandoned) The RealXtend modules for OpenSimulator have not been updated for a long time and should be considered dead. However, this information may be useful for historical purposes.
|
Core Features
Troubleshooting
User Guide
Integration
Administrator Guide
|
[edit] Tutorials
If you've written a tutorial or guide on this wiki or on an external site, then please feel free to add a link here and/or on more specific topic pages.
[edit] Platform specific
- OSHT - OpenSim HowTo: Configuring a Grid. This tutorial describes how to install and configure OpenSimulator in grid mode on a Linux platform.
- Wiimote - How to use a wiimote/nunchuk controller with the OpenSimulator viewer (Linux)
- Cacti - Generate Serverstats using the Cacti-Tool and SNMP (Linux)
- Installing an openSUSE 11.1 Minimal server setup for an OpenSimulator server - Quick and Dirty setup on an openSUSE 11.1 server
- Streaming Media in OpenSim
- Chapter & Metaverse - Full suite of tutorials, tips and tricks, for the Windows user (Windows) Also very useful for Linux users!
- How to install osmodules on Windows using IIS - How to install osmodules on windows using IIS
- Collectd Generate Serverstats using Collectd
[edit] Cross-platform
- Getting Started with Region Modules - The Hello World of OpenSimulator application development
- Using L3DT - How to create custom terrains
- Detailed cross-region terrain making - A workflow for creating large cross-region custom terrains
- How to make a good Terrain (includes 4 programs to use) (broken link)
- Japanese Manual for Construction of OpenSimulator Server System on Linux by NSL (Sorry, Japanese text only)
[edit] Application
- David W. Deeds' OpenSimulator School Quick Start Guide - David W. Deeds' OpenSimulator School Quick Start Guide courtesy of Changchun American International School. Has lots of useful and interesting info, including lesson plans.