Note: this page is in development. Additions welcome.
Two major aspects relating to currency are buying and selling money units (i.e. by clicking the currency display in the top-right hand corner of most viewers) and buying and selling land.
These involve calls to a pair of external PHP scripts. The names of these scripts (currency.php and landtool.php) are actually hard-coded (!) in the viewer source. However, third-party viewers will allow the path to be changed if we specify it in the economy parameter of the [GridInfo] section of Robust.ini (or Robust.HG.ini, config-include/StandaloneCommon.ini).
Buying and selling money
OpenSimulator does not come with a working currency implementation, though there is a very limited sample money module that works in standalone mode only.
You can find third party currency implementations on the Related Software page. The OpenSimulator project cannot supply any support for these modules.
Clicking the currency display in a viewer generates a request to currency.php following whatever path has been set up in the economy [GridInfo] section of Robust.ini.
Buying and selling land
Buying and selling land also requires the grid to have a landtool.php page that services a preflightBuyLandPrep XMLRPC call.
For an OpenSimulator standalone installation, the SampleMoneyModule will supply the required minimal functionality (TODO: properly document this.).
Unfortunately, this is not available in ROBUST at this time. A grid installation will need to supply an external implementation of the preflightBuyLandPrep XMLRPC function.
There is a very minimal version of this (with installation instructions) at https://github.com/justincc/opensimulator-helper. This allows $0 transfers.
A slightly more fleshed out example can be found at http://download.osgrid.org/helper_tools_opensim.zip.
Both these files ultimately derive from an original implementation at:
- http://opensim-users.2152040.n2.nabble.com/Buying-and-Selling-Land-What-module-is-needed-td7578626.html - A mailing list thread on getting landtool.php working.