World server - Revision history

Sleepy E: Include settings list instead of doubling it

2018-07-24T13:24:02Z

Include settings list instead of doubling it

@@ Line 55: / Line 55: @@
 == Per-world settings ==
 The world server keeps individual settings for each world in the '''Setting''' table of the database. For each row, one column defines the ID of the world, the key and the value respectively.
@@ Line 62: / Line 61: @@
 === Values ===
 :''All values are optional''
-{| class="wikitable sortable"
+{{:List_of_world_settings}}
 [[Category:Servers]]

Legion: /* Per-world settings */ Added a direct link to the page "List of world settings"

2017-06-01T19:04:16Z

Per-world settings: Added a direct link to the page "List of world settings"

← Older revision		Revision as of 19:04, 1 June 2017
Line 55:		Line 55:

	== Per-world settings ==		== Per-world settings ==
			:<div class="boilerplate" id="stub">''See also: [[List of world settings]].''</div>
	The world server keeps individual settings for each world in the '''Setting''' table of the database. For each row, one column defines the ID of the world, the key and the value respectively.		The world server keeps individual settings for each world in the '''Setting''' table of the database. For each row, one column defines the ID of the world, the key and the value respectively.

Roy Curtis: recat

2013-08-21T16:08:43Z

recat

← Older revision		Revision as of 16:08, 21 August 2013
Line 165:		Line 165:
	\|}		\|}

	[[Category: ~~Virtual Paradise~~]]		[[Category:Servers]]

Legion: recat Category: Virtual Paradise

2013-03-07T23:06:16Z

recat Category: Virtual Paradise

← Older revision		Revision as of 23:06, 7 March 2013
Line 165:		Line 165:
	\|}		\|}

	[[Category: ~~World administration~~]]		[[Category: Virtual Paradise]]

Legion: +cat Category: World administration

2013-03-07T22:54:44Z

+cat Category: World administration

← Older revision		Revision as of 22:54, 7 March 2013
Line 164:		Line 164:
	\| Three float values between 0.0 - 1.0 for X, Y and Z positions respectively		\| Three float values between 0.0 - 1.0 for X, Y and Z positions respectively
	\|}		\|}

			[[Category: World administration]]

Roy Curtis: syntax fix

2013-01-18T17:29:40Z

syntax fix

← Older revision		Revision as of 17:29, 18 January 2013
Line 32:		Line 32:
	! rowspan = 5 \| database		! rowspan = 5 \| database
	\| backend		\| backend
	\| 'Optional' Database driver to use internally		\| ''Optional'' Database driver to use internally
	\|		\|
	* obdc		* obdc
	\|-		\|-
	\| connection_string		\| connection_string
	\| 'Optional' Standard string used to describe database driver or provider to use, along with relevant information such as database name and login information		\| ''Optional'' Standard string used to describe database driver or provider to use, along with relevant information such as database name and login information
	\| See http://www.connectionstrings.com/ for examples		\| See http://www.connectionstrings.com/ for examples
	\|-		\|-
	\| database_type		\| database_type
	\| 'Optional' Type of database to use		\| ''Optional'' Type of database to use
	\|		\|
	* sqlite		* sqlite
	\|-		\|-
	\| connections		\| connections
	\| ''Optional' Amount of persistent connections to keep to the database. Ideally, never set higher than amount of threads.		\| ''Optional'' Amount of persistent connections to keep to the database. Ideally, never set higher than amount of threads.
	\| 1 - 255		\| 1 - 255
	\|-		\|-
	\| threads		\| threads
	\| 'Optional' Amount of threads dedicated to I/O on the database connections. Ideally, set to at least the number of CPU cores (physical and virtual) available on the system.		\| ''Optional'' Amount of threads dedicated to I/O on the database connections. Ideally, set to at least the number of CPU cores (physical and virtual) available on the system.
	\| 1 - 255		\| 1 - 255
	\|}		\|}

Roy Curtis: world settings

2013-01-18T17:28:39Z

world settings

New page

The '''world server''' is the software that hosts a virtual world, connected to a Virtual Paradise [[universe server]].

== worldserver.info ==
The world server reads important connection and database settings from '''worldserver.info''', which is parsed as a [http://www.boost.org/doc/libs/1_41_0/doc/html/boost_propertytree/parsers.html#boost_propertytree.parsers.info_parser Boost property tree]. The file can be edited in any text editor such as Notepad++.

=== Values ===
{| class="wikitable sortable"
! style="width: 75px" | Key
! style="width: 75px" | Subkey
! style="width: 250px" class="unsortable" | Description
! style="width: 150px" class="unsortable" | Valid values
|-
! rowspan = 3 | server
| port
| Port for clients to connect to, to access all worlds on this server.
| Any number between 1 - 65535 (values below 1024 may conflict with other services such as HTTP servers)
|-
| host
| ''Only for client version 0.3.22 and newer'' Host name for clients connecting via the universe to resolve and connect to, to access all worlds on this server.
|
* localhost (local universe)
* example.no-ip.org (free dynamic hostname service)
* auth.myowndomain.org
|-
| ip
| ''Optional; see 'host''' The IP address clients connecting via the universe should connect to, to access all worlds on this server. Should not be used if router does not allow NAT loopback.
|
* 127.0.0.1 (local universe)
* IP address on http://www.whatismyip.com/
|-

! rowspan = 5 | database
| backend
| 'Optional' Database driver to use internally
|
* obdc
|-
| connection_string
| 'Optional' Standard string used to describe database driver or provider to use, along with relevant information such as database name and login information
| See http://www.connectionstrings.com/ for examples
|-
| database_type
| 'Optional' Type of database to use
|
* sqlite
|-
| connections
| ''Optional' Amount of persistent connections to keep to the database. Ideally, never set higher than amount of threads.
| 1 - 255
|-
| threads
| 'Optional' Amount of threads dedicated to I/O on the database connections. Ideally, set to at least the number of CPU cores (physical and virtual) available on the system.
| 1 - 255
|}

== Per-world settings ==
The world server keeps individual settings for each world in the '''Setting''' table of the database. For each row, one column defines the ID of the world, the key and the value respectively.

The values are never used by the server; they are sent to the client. Each value is a string with a maximum of 255 characters, however the client requires some values to conform to a particular format to be valid.

=== Values ===
:''All values are optional''
{| class="wikitable sortable"
! style="width: 100px" | Key
! style="width: 250px" class="unsortable" | Description
! style="width: 150px" class="unsortable" | Valid values
|-
| allow_passthrough
| Whether passing through objects by holding SHIFT is enabled
| 0 for false, 1 for true (default)
|-
| avatar
| Object to use as users' 3D avatar (3D representation)
| Relative object name on the specified path with extension, e.g.:
* p1cube0100.rwx
* ../avatars/cy.rwx
* dog.md2
|-
| farplane
| Far clipping plane distance; how far from the camera the ground and avatars are rendered
| Any float value
|-
| nearplane
| Near clipping plane distance; how close to the camera the ground and avatars are rendered
| Any float value (0 may cause glitching)
|-
| fov
| Field of view; how wide an angle the scene is visible to the camera
| Any integer value
|-
| ground
| Field of view; how wide an angle the scene is visible to the camera
| Any integer value
|-
| fov
| Field of view; how wide an angle the scene is visible to the camera
| Any integer value
|-
| ground
| Object to render as the "ground" or as static scenery, irrespective of user's visibility
| Relative object name on the specified path with extension, e.g. ground.rwx
|-
| groundrepeats
| If the ground object repeats infinitely, to cover the world with the object
| 0 for false, 1 for true
|-
| objectpath
| Resolvable HTTP address to a server that provides the world's assets via the HTTP protocol, such as an [http://wiki.activeworlds.com/index.php?title=Object_path object path]
| Any valid HTTP address, e.g.
* http://localhost/
* http://objects.activeworlds.com/aw/ (alphaworld path)
* http://myop.no-ip.org:8282
|-
| skybox
| Prefix name of a set of textures used for the skybox
| Relative JPG texture name on the specified path with extension, e.g. sky_hd, which will load:
* sky_hd_fr.jpg
* sky_hd_bk.jpg
* sky_hd_lf.jpg
* sky_hd_rt.jpg
* sky_hd_dn.jpg
* sky_hd_up.jpg
|-
| skybox_swaplr
| Swaps the skybox's left and right textures
| 0 for false, 1 for true
|-
| terrain
| If the terrain system should be used
| 0 for false (default), 1 for true
|-
| terrainoffset
| Y (up-down) distance to offset the terrain globally by
| Any float value
|-
| terrainscale
| Scale factor of the terrain grid, with 10m*10m at scale factor 1. Values below 0.5 may cause performance issues for clients
| Any float value
|-
| welcome
| Welcome message to provide to clients entering
| Any string value
|-
| worldlight_diffuse
| 3D vector defining the diffuse light color of the world
| Three float values between 0.0 - 1.0 for red, green and blue channels respectively, delimited by space. e.g.:
* 1.0 0.0 0.0 for full red
* 1.0 1.0 1.0 for full white
|-
| worldlight_ambient
| 3D vector defining the ambient light color of the world
| Three float values between 0.0 - 1.0 for red, green and blue channels respectively, delimited by space. e.g.:
* 1.0 0.0 0.0 for full red
* 1.0 1.0 1.0 for full white
|-
| worldlight_specular
| 3D vector defining the specular light color of the world
| Three float values between 0.0 - 1.0 for red, green and blue channels respectively, delimited by space. e.g.:
* 1.0 0.0 0.0 for full red
* 1.0 1.0 1.0 for full white
|-
| worldlight_position
| 3D vector defining the position of the world's sunlight
| Three float values between 0.0 - 1.0 for X, Y and Z positions respectively
|}