Difference between revisions of "Sectors"

From SphereWiki
Jump to: navigation, search
(Created page with '__FORCETOC__ The world is split into fixed-size sectors (by default, 64x64 tiles). Environmental settings (light, weather, etc) are stored on a per-sector basis. Accessing sector...')
 
 
(2 intermediate revisions by 2 users not shown)
Line 16: Line 16:
 
|-
 
|-
 
| [[ALLITEMS]] ''command'' || R || Executes ''command'' on all items inside the sector.
 
| [[ALLITEMS]] ''command'' || R || Executes ''command'' on all items inside the sector.
 +
|-
 +
| [[CANSLEEP]] || R || Returns 1 if the sector have all condition to sleep. (X ONLY)
 
|-
 
|-
 
| [[CLIENTS]] || R || Gets the number of clients in the sector.
 
| [[CLIENTS]] || R || Gets the number of clients in the sector.
Line 29: Line 31:
 
| [[COMPLEXITY]].LOW || R || Returns 1 if the sector has a low complexity. (10+ characters)
 
| [[COMPLEXITY]].LOW || R || Returns 1 if the sector has a low complexity. (10+ characters)
 
|-
 
|-
| [[DRY]] || R || Sets the weather to dry.
+
| [[DRY]] || W || Sets the weather to dry.
 
|-
 
|-
 
| [[ISDARK]] || R || Returns 1 if the light level in the sector is considered to be dark.
 
| [[ISDARK]] || R || Returns 1 if the light level in the sector is considered to be dark.
 
|-
 
|-
 
| [[ISNIGHTTIME]] || R || Returns 1 if the local time of day is between 9pm and 7am.
 
| [[ISNIGHTTIME]] || R || Returns 1 if the local time of day is between 9pm and 7am.
 +
|-
 +
| [[ISSLEEPING]] || R || Returns 1 if the sector is sleeping. (X ONLY)
 
|-
 
|-
 
| [[ITEMCOUNT]] || R || Returns the number of items in the sector.
 
| [[ITEMCOUNT]] || R || Returns the number of items in the sector.
Line 42: Line 46:
 
|-
 
|-
 
| [[LOCALTOD]] || R || Gets the local time of day, in minutes.
 
| [[LOCALTOD]] || R || Gets the local time of day, in minutes.
 +
|-
 +
| [[NUMBER]] || R || Gets the index number of the sector.
 
|-
 
|-
 
| [[RAIN]] || W || Sets the weather to raining.
 
| [[RAIN]] || W || Sets the weather to raining.

Latest revision as of 02:07, 16 September 2021

The world is split into fixed-size sectors (by default, 64x64 tiles). Environmental settings (light, weather, etc) are stored on a per-sector basis. Accessing sectors in scripts can be accomplished using the SECTOR reference from a character, item or map point object. The following table details the various properties of the sector object in SphereServer:


Properties and Functions

Here is a list of all sector properties and functions. If a function is marked as readable then it can return a value when used as <KEY>. Click on the name for more detailed information such as usage and examples.

Name Read/Write Description
ALLCHARS command R Executes command on all characters inside the sector.
ALLCHARSIDLE command R Executes command on all disconnected characters inside the sector.
ALLCLIENTS command R Executes command on all clients inside the sector.
ALLITEMS command R Executes command on all items inside the sector.
CANSLEEP R Returns 1 if the sector have all condition to sleep. (X ONLY)
CLIENTS R Gets the number of clients in the sector.
COLDCHANCE RW Gets or sets the chance of snow for the sector.
COMPLEXITY R Gets the number of characters in the sector.
COMPLEXITY.HIGH R Returns 1 if the sector has a high complexity. (less than 5 characters)
COMPLEXITY.MEDIUM R Returns 1 if the sector has a medium complexity. (less than 10 characters)
COMPLEXITY.LOW R Returns 1 if the sector has a low complexity. (10+ characters)
DRY W Sets the weather to dry.
ISDARK R Returns 1 if the light level in the sector is considered to be dark.
ISNIGHTTIME R Returns 1 if the local time of day is between 9pm and 7am.
ISSLEEPING R Returns 1 if the sector is sleeping. (X ONLY)
ITEMCOUNT R Returns the number of items in the sector.
LIGHT RW Gets or sets the light level for the sector.
LOCALTIME R Gets the local time of day, as a descriptive string.
LOCALTOD R Gets the local time of day, in minutes.
NUMBER R Gets the index number of the sector.
RAIN W Sets the weather to raining.
RAINCHANCE RW Gets or sets the chance of rain for the sector.
RESPAWN ALL W Resurrects dead NPC characters (not corpses). If ALL is provided then all sectors will be affected.
RESTOCK ALL W Restocks all NPCs in the sector. If ALL is provided then all sectors will be affected.
SEASON RW Gets or sets the current season in the sector.
SNOW W Sets the weather to snowing.
WEATHER RW Gets or sets the current weather in the sector.