RemoteAdmin:admin create region
From OpenSimulator
(Difference between revisions)
(→admin create region) |
(→Notes) |
||
| Line 96: | Line 96: | ||
== Notes == | == Notes == | ||
{{multicol}} | {{multicol}} | ||
| − | *When adding a region to a | + | *When adding a region to a existing estate in the estate database, then one does not need to specify the estate owner. If the estate is does not exist or the estate exists with diffrent estate owners, then one has to use the ''estate_owner_uuid'' or ''estate_owner_first'' + ''estate_owner_last''. |
| − | *When using the optional ''persist'' parameter the region configs will be saved to the default region file. You can specify | + | *When using the optional ''persist'' parameter the region configs will be saved to the default region file. You can specify the file using the parameter region_file if you dont want to use the default |
{{multicol-end}} | {{multicol-end}} | ||
| − | |||
== Example == | == Example == | ||
Revision as of 07:18, 9 October 2011
admin_create_region remotely allows to create a new regions and add them to an estate.
Contents |
Enabling admin create region
To use admin_create_region one needs to enable the function in the [RemoteAdmin] section
enabled_methods = admin_create_region
Paramenters
Required paramenters
These parameters are required
| parameter | Description | Values |
|---|---|---|
| region_name | Name of the new region | |
| listen_ip | listen ip to be used by region | |
| listen_port | integer value of port | |
| external_address | external address to be used by the region | |
| region_x | region x location in grid | |
| region_y | region y location in grid | |
| estate_name | estate name that the new region belongs to. Specify estate owner if the estate does not exist yet |
Optional paramenters
These parameters are optional and do not need to be set
| parameter | Description | Values |
|---|---|---|
| region_id | region uuid to be used for new region | |
| estate_owner_uuid | estate owner uuid (optionaly use estate_owner_first and estate_owner_last) | |
| estate_owner_first | estate owners first name | |
| estate_owner_last | estate owners last name | |
| persist | saves new region configs to file e.g. region.ini | true, false |
| region_file | when using persist you can specify the file to save region configs to (requires persist to be used) | |
| public | enable/disable public access to new region | true, false |
| enable_voice | enable/disable voice to new region | true, false |
| heightmap_file | load a heightmap file once the new region has been created |
Notes
|
Example
PHP
<?php // Including the RemoteAdmin PHP class. include('RemoteAdmin.php'); // Instantiate the class with parameters identical to the Python example above $myRemoteAdmin = new RemoteAdmin('127.0.0.1', 9000, 'secret'); // Invoke admin_create_user (multiple parameters) $parameters = array('region_name' => 'My Plaza', 'listen_ip' => '0.0.0.0', 'listen_port' => '9001', 'region_x' => '1000', 'region_y' => '1000', 'estate_name' => 'My Estate'); $myRemoteAdmin->SendCommand('admin_create_region', $parameters); ?>
