Difference between revisions of "Error Codes"

From SphereWiki
Jump to: navigation, search
m (Added languagemenue)
(→‎Exit Codes)
 
(5 intermediate revisions by 2 users not shown)
Line 18: Line 18:
 
| -8 || Failed to load world save(s)
 
| -8 || Failed to load world save(s)
 
|-
 
|-
−
| -3 || Failed to load server settings (script, ini, mul files)
+
| -3 || Failed to load server settings (script, ini, mul files) ''or'' <br />did not write AGREE=1 in the sphere.ini
 
|-
 
|-
 
| -1 || Shutdown via commandline (/?, /T and /Q switches)
 
| -1 || Shutdown via commandline (/?, /T and /Q switches)
Line 32: Line 32:
 
|  6 || SIGABRT signal, process aborted ''(Linux Only)''
 
|  6 || SIGABRT signal, process aborted ''(Linux Only)''
 
|}
 
|}
−
 
  
 
==Garbage Collection==
 
==Garbage Collection==
Line 47: Line 46:
  
 
{| border="1" cellpadding="3"
 
{| border="1" cellpadding="3"
−
| '''Code''' || '''Description'''
+
| '''Code''' || '''Message''' || '''Description''' ||
 
|-
 
|-
−
| 1102 || Disconnected character not acting as such.
+
| 1102 || Disconnected charr not acting as such || A character has been marked disconnected from the world, but it is not listed in the sector's disconnected character's list. || *
 
|-
 
|-
−
| 1103 || NPC with STATF_Ridden does not have the correct action set.
+
| 1103 || Ridden NPC not acting as such || An NPC has the [[FLAGS|statf_ridden]] flag set, but does not have its [[ACTION]] property set to 111. ||
 
|-
 
|-
−
| 1104 || Ridden NPC without a mount item.
+
| 1104 || Ridden NPC without a mount item || An NPC has the [[FLAGS|statf_ridden]] flag set, but its [[ACTARG1]] property isn't set to the [[UID]] of an item whose [[TYPE]] property is set to [[TYPE|t_figurine]] or [[TYPE|t_eq_horse]]. ||
 
|-
 
|-
−
| 1105 || Ridden NPC with a mount item that is not linked to them.
+
| 1105 || Ridden NPC with a mislinked mount item || An NPC has the [[FLAGS|statf_ridden]] flag set, but its [[ACTARG1]] property isn't set to the [[UID]] of an item whose [[MORE2]] property matches the NPC's [[UID]]. ||
 
|-
 
|-
−
| 1106 || Disconneced NPC neither dead or ridden.
+
| 1106 || Disconnected NPC neither dead nor ridden || An NPC has been disconnected from the world, but does not have either one of the [[FLAGS|statf_ridden]] or [[FLAGS|statf_dead]] flags set. ||
 
|-
 
|-
−
| 1107 || Ingame character that is neither a player or an NPC.
+
| 1107 || In game char that is neither a player nor an NPC || A character is not a player or an NPC. || *
 
|-
 
|-
−
| 1108 || Character not on a valid position.
+
| 1108 || Char not on a valid position || A character's [[P|position]] is outside of the map boundaries. ||
 
|-
 
|-
−
| 1203 || NPC with STATF_Ridden does not have the correct action set.
+
| 1203 || Ridden NPC not acting as such || Same as 1103. ||
 
|-
 
|-
−
| 1204 || Ridden NPC without a mount item.
+
| 1204 || Ridden NPC without a mount item || Same as 1104. ||
 
|-
 
|-
−
| 1205 || Ingame character that is neither a player or an NPC.
+
| 1205 || In game char that is neither a player nor an NPC || Same as 1107. ||
 
|-
 
|-
−
| 2102 || Item without an ITEMDEF.
+
| 2102 || Item without ITEMDEF || An item does not have an [[ITEMDEF]] section. || *
 
|-
 
|-
−
| 2103 || Item ITEMDEF with an ID of 0.
+
| 2103 || Item ITEMDEF with ID = 0 || An item's [[ITEMDEF]] has an [[ID]] of zero. || *
 
|-
 
|-
−
| 2104 || Disconnected item.
+
| 2104 || Disconnected item || An item has been marked as disconnected from the world. || *
 
|-
 
|-
−
| 2105 || Item not on a valid position.
+
| 2105 || Item not on a valid position || An item is not in a container and its [[P|position]] is outside of the map boundaries. ||
 
|-
 
|-
−
| 2106 || Item flagged as being in a container but it isn't.
+
| 2106 || Item flagged as being in a container but it isn't || An item is flagged as not being top level, but it does not have a container. ||
 
|-
 
|-
−
| 2202 || Item flagged as equipped but it isn't.
+
| 2202 || Item flagged as equipped but it isn't || An item is flagged as being equipped, but its parent is not a character. ||
 
|-
 
|-
−
| 2205 || Item's LINK property is set to itself or a UID that doesn't exist.
+
| 2205 || Mislinked item || An item's [[LINK]] property matches its [[UID]], or has been set to a [[UID]] that doesn't exist. ||
 
|-
 
|-
−
| 2206 || GM Robe or Deathshroud not on a character.
+
| 2206 || Gm Robe / Deathshroud not on a char || A GM robe or death shroud ([[ID]] of 0204E or 0204F) is not equipped to a character. ||
 
|-
 
|-
−
| 2207 || Deathshroud not on a dead character.
+
| 2207 || Deathshroud not on a dead char || A death shroud ([[ID]] of 0204F) is equipped to a character without the [[FLAGS|statf_dead]] flag set. ||
 
|-
 
|-
−
| 2208 || GM Robe on a character without privileges.
+
| 2208 || Gm Robe on a char without privilege || A GM robe ([[ID]] of 0204E) is equipped to a character whose [[PLEVEL]] is less than 2. ||
 
|-
 
|-
−
| 2220 || Trade window memory not equipped in the correct layer, or not equipped to a player.
+
| 2220 || Trade window memory not equipped in the correct layer || A [[TYPE|t_eq_trade window]] item type is not equipped, has its [[LAYER]] property set to something other than [[LAYER|layer_none]], or is equipped to an NPC. ||
 
|-
 
|-
−
| 2221 || Client linger memory not equipped in the correct layer, or not equipped to a player.
+
| 2221 || Client linger memory not equipped in the correct layer || A [[TYPE|t_eq_client_linger]] item type is not equipped, has its [[LAYER]] property set to something other than [[LAYER|layer_flag_clientlinger]], or is equipped to an NPC. ||
 
|-
 
|-
−
| 2222 || Memory not equipped or is not a real memory.
+
| 2222 || Memory not equipped / not in the memory layer / without color || A memory item ([[ID]] of 02007) is not equipped, or a non-memory item has had its [[TYPE]] set to [[TYPE|t_eq_memory_obj]] after creation. ||
 
|-
 
|-
−
| 2226 || Mount memory not equipped in the correct layer.
+
| 2226 || Mount memory not equipped in the correct layer || A [[TYPE|t_eq_horse]] item type is not equipped, or has its [[LAYER]] property set to something other than [[LAYER|layer_horse]]. ||
 
|-
 
|-
−
| 2227 || Hair or beard item is not equipped, not in a corpse, and not in a vendor box.
+
| 2227 || Hair/Beard item not equipped / not in a corpse / not in a vendor box || A [[TYPE|t_hair]] or [[TYPE|t_beard]] item type that isn't equipped, is either not in a container or its container has an [[ID]] other than 02006 or 02AF8. ||
 
|-
 
|-
−
| 2228 || Hair or beard item is equipped, but not in the correct layer.
+
| 2228 || Hair/Beard item not equipped / not in a corpse / not in a vendor box || A [[TYPE|t_hair]] or [[TYPE|t_beard]] item is equipped, but has its [[LAYER]] property set to something other than [[LAYER|layer_hair]] or [[LAYER|layer_beard]]. ||
 
|-
 
|-
−
| 2229 || Game piece not in a container.
+
| 2229 || Game piece not in a game board || A [[TYPE|t_game_piece]] item has been found outside of a container. ||
 
|-
 
|-
−
| 2230 || Item equipped in layer_none but it isn't a trade window.
+
| 2230 || Item equipped in the trade window layer but it isn't a trade window || An equipped item has been found with its [[LAYER]] property set to [[LAYER|layer_none]], but its [[TYPE|type]] is not [[TYPE|t_eq_trade_window]]. ||
 
|-
 
|-
−
| 2231 || Item equipped in layer_special but it isn't a memory or script type.
+
| 2231 || Item equipped in the memory layer but it isn't a memory || An equipped item has been found with its [[LAYER]] property set to [[LAYER|layer_special]], but its [[TYPE|type]] is not [[TYPE|t_eq_memory_obj]] or [[TYPE|t_eq_script]]. ||
 
|-
 
|-
−
| 2233 || Item equipped in layer_horse but it isn't a mount memory.
+
| 2233 || Item equipped in the mount memory layer but it isn't a mount memory || An equipped item has been found with its [[LAYER]] property set to [[LAYER|layer_horse]], but its [[TYPE|type]] is not [[TYPE|t_eq_horse]]. ||
 
|-
 
|-
−
| 2234 || Item equipped in the client linger layer but it isn't a client linger memory.
+
| 2234 || Item equipped in the client linger layer but it isn't a client linger memory || An equipped item has been found with its [[LAYER]] property set to [[LAYER|layer_flag_clientlinger]], but its [[TYPE|type]] is not [[TYPE|t_eq_client_linger]]. ||
 
|-
 
|-
−
| 2235 || Item equipped in the murder memory layer but it isn't a murder memory.
+
| 2235 || Item equipped in the murder memory layer but it isn't a murder memory || An equipped item has been found with its [[LAYER]] property set to [[LAYER|layer_flag_murders]], but the character is an NPC or the player has its [[KILLS]] property set to 0. ||
 
|-
 
|-
−
| 2236 || Item flagged as decay but without timer set.
+
| 2236 || Item flagged as decay but without timer set || A top-level item has the [[ATTR|attr_decay]] flag set, but its [[TIMER]] property has not been set. ||
 
|-
 
|-
−
| 3101 || Object is totally lost, no parent exists.
+
| 3101 || Object is totaly lost, no parent exists || An object has no parent. || *
 
|-
 
|-
−
| 3102 || Object was deleted or UID is incorrect.
+
| 3102 || Object was deleted or UID is incorrect || An object does not have a valid [[UID]]. || *
 
|-
 
|-
−
| 3201 || More than one object with the same UID.
+
| 3201 || Object not correctly loaded by server (UID conflict) || More than one object has the same [[UID]] value. || *
 
|-
 
|-
−
| 4222 || Memory item is not equipped, not in the memory layer, or without colour
+
| 4222 || Memory not equipped / not in the memory layer / without color || A memory item is not flagged as equipped, has its [[LAYER]] property set to something other than [[LAYER|layer_special]], or has its [[COLOR]] property set to 0. ||
 
|-
 
|-
−
| 4223 || Memory not on a character.
+
| 4223 || Memory not on a char || A memory item is flagged as equipped, but it's [[CONT|parent]] is not a character. ||
 
|-
 
|-
−
| 4224 || Guild/town memory does not link to the character's town/guild.
+
| 4224 || Stone/Guild memory mislinked || A memory item's [[COLOR]] property has one of the [[COLOR|memory_guild]] or [[COLOR|memory_town]] flags set, but the [[LINK]] property is not set to the [[UID]] of a guild or town stone. ||
 
|-
 
|-
−
| 4225 || Guild/town memory linked to a stone, but the character is not a member.
+
| 4225 || Stone/Guild memory linked to the wrong stone || A memory item's [[COLOR]] property has one of the [[COLOR|memory_guild]] or [[COLOR|memory_town]] flags set, but the character the memory is equipped to is not a member of the guild or town. ||
 
|-
 
|-
−
| 7101 || Object's UID does not match up with server's UID table.
+
| 7101 || Object's UID does not match up with server's UID table. || An object does not have the expected [[UID]] value. || *
 
|-
 
|-
−
| 7102 || Object does not exist.
+
| 7102 || Object does not exist. || An object does not exist. || *
 
|-
 
|-
−
| FFFF || Bad memory allocation (unknown error occured).
+
| FFFF || Bad memory allocation || An exception was thrown whilst checking the object's validity. || *
 
|}
 
|}
 +
 +
 +
'''Note''': ''Garbage collection codes marked with * generally indicate a serious error within an object's internal state and should not normally be seen. If you are experiencing and are able to reliably reproduce any such errors then please report the details to the [http://tracker.sphere.torfo.org/bugs/main_page.php bug tracker].''

Latest revision as of 18:04, 1 July 2023

Help
Available languages
Missing languages


Exit Codes

When Sphere closes, an 'exit code' will normally be shown in the console to describe why it is being shut down. In general, an exit code less than 0 is considered to be an error code, and values above 0 are normal shutdown codes. In most cases, a more descriptive error will be shown in the console and/or log file to help better diagnose the reason behind error codes.


The following table lists all of the current codes and their meanings.


Code Description
-10 Unexpected error occurred
-9 Failed to bind server port
-8 Failed to load world save(s)
-3 Failed to load server settings (script, ini, mul files) or
did not write AGREE=1 in the sphere.ini
-1 Shutdown via commandline (/?, /T and /Q switches)
1 X in console or
SIGHUP signal, terminal closed (Linux Only)
2 SHUTDOWN command
4 Service shutdown (Windows Only)
5 Console window closed (Windows Only)
6 SIGABRT signal, process aborted (Linux Only)

Garbage Collection

The purpose of garbage collection is to validate all of the server objects and free up unused UIDs. Garbage collection is initiated:

  • After the world save is loaded at startup.
  • Before a world save begins, if the FORCEGARBAGECOLLECT setting is enabled in Sphere.ini.
  • After the IMPORT or RESTORE functions have been used on the server object.
  • When the 'G' command is entered via the Sphere console
  • When the GARBAGE function is used on the server object.


When garbage collection encounters a problem with an object it may attempt to automatically correct the error, otherwise the object will be removed. When an object is removed by garbage collection there will normally be an error shown in the console describing the item that was removed along with the reason. The following table lists all of the garbage collection codes along with their description:


Code Message Description
1102 Disconnected charr not acting as such A character has been marked disconnected from the world, but it is not listed in the sector's disconnected character's list. *
1103 Ridden NPC not acting as such An NPC has the statf_ridden flag set, but does not have its ACTION property set to 111.
1104 Ridden NPC without a mount item An NPC has the statf_ridden flag set, but its ACTARG1 property isn't set to the UID of an item whose TYPE property is set to t_figurine or t_eq_horse.
1105 Ridden NPC with a mislinked mount item An NPC has the statf_ridden flag set, but its ACTARG1 property isn't set to the UID of an item whose MORE2 property matches the NPC's UID.
1106 Disconnected NPC neither dead nor ridden An NPC has been disconnected from the world, but does not have either one of the statf_ridden or statf_dead flags set.
1107 In game char that is neither a player nor an NPC A character is not a player or an NPC. *
1108 Char not on a valid position A character's position is outside of the map boundaries.
1203 Ridden NPC not acting as such Same as 1103.
1204 Ridden NPC without a mount item Same as 1104.
1205 In game char that is neither a player nor an NPC Same as 1107.
2102 Item without ITEMDEF An item does not have an ITEMDEF section. *
2103 Item ITEMDEF with ID = 0 An item's ITEMDEF has an ID of zero. *
2104 Disconnected item An item has been marked as disconnected from the world. *
2105 Item not on a valid position An item is not in a container and its position is outside of the map boundaries.
2106 Item flagged as being in a container but it isn't An item is flagged as not being top level, but it does not have a container.
2202 Item flagged as equipped but it isn't An item is flagged as being equipped, but its parent is not a character.
2205 Mislinked item An item's LINK property matches its UID, or has been set to a UID that doesn't exist.
2206 Gm Robe / Deathshroud not on a char A GM robe or death shroud (ID of 0204E or 0204F) is not equipped to a character.
2207 Deathshroud not on a dead char A death shroud (ID of 0204F) is equipped to a character without the statf_dead flag set.
2208 Gm Robe on a char without privilege A GM robe (ID of 0204E) is equipped to a character whose PLEVEL is less than 2.
2220 Trade window memory not equipped in the correct layer A t_eq_trade window item type is not equipped, has its LAYER property set to something other than layer_none, or is equipped to an NPC.
2221 Client linger memory not equipped in the correct layer A t_eq_client_linger item type is not equipped, has its LAYER property set to something other than layer_flag_clientlinger, or is equipped to an NPC.
2222 Memory not equipped / not in the memory layer / without color A memory item (ID of 02007) is not equipped, or a non-memory item has had its TYPE set to t_eq_memory_obj after creation.
2226 Mount memory not equipped in the correct layer A t_eq_horse item type is not equipped, or has its LAYER property set to something other than layer_horse.
2227 Hair/Beard item not equipped / not in a corpse / not in a vendor box A t_hair or t_beard item type that isn't equipped, is either not in a container or its container has an ID other than 02006 or 02AF8.
2228 Hair/Beard item not equipped / not in a corpse / not in a vendor box A t_hair or t_beard item is equipped, but has its LAYER property set to something other than layer_hair or layer_beard.
2229 Game piece not in a game board A t_game_piece item has been found outside of a container.
2230 Item equipped in the trade window layer but it isn't a trade window An equipped item has been found with its LAYER property set to layer_none, but its type is not t_eq_trade_window.
2231 Item equipped in the memory layer but it isn't a memory An equipped item has been found with its LAYER property set to layer_special, but its type is not t_eq_memory_obj or t_eq_script.
2233 Item equipped in the mount memory layer but it isn't a mount memory An equipped item has been found with its LAYER property set to layer_horse, but its type is not t_eq_horse.
2234 Item equipped in the client linger layer but it isn't a client linger memory An equipped item has been found with its LAYER property set to layer_flag_clientlinger, but its type is not t_eq_client_linger.
2235 Item equipped in the murder memory layer but it isn't a murder memory An equipped item has been found with its LAYER property set to layer_flag_murders, but the character is an NPC or the player has its KILLS property set to 0.
2236 Item flagged as decay but without timer set A top-level item has the attr_decay flag set, but its TIMER property has not been set.
3101 Object is totaly lost, no parent exists An object has no parent. *
3102 Object was deleted or UID is incorrect An object does not have a valid UID. *
3201 Object not correctly loaded by server (UID conflict) More than one object has the same UID value. *
4222 Memory not equipped / not in the memory layer / without color A memory item is not flagged as equipped, has its LAYER property set to something other than layer_special, or has its COLOR property set to 0.
4223 Memory not on a char A memory item is flagged as equipped, but it's parent is not a character.
4224 Stone/Guild memory mislinked A memory item's COLOR property has one of the memory_guild or memory_town flags set, but the LINK property is not set to the UID of a guild or town stone.
4225 Stone/Guild memory linked to the wrong stone A memory item's COLOR property has one of the memory_guild or memory_town flags set, but the character the memory is equipped to is not a member of the guild or town.
7101 Object's UID does not match up with server's UID table. An object does not have the expected UID value. *
7102 Object does not exist. An object does not exist. *
FFFF Bad memory allocation An exception was thrown whilst checking the object's validity. *


Note: Garbage collection codes marked with * generally indicate a serious error within an object's internal state and should not normally be seen. If you are experiencing and are able to reliably reproduce any such errors then please report the details to the bug tracker.

Retrieved from "https://wiki.spherecommunity.net/index.php?title=Error_Codes&oldid=8095"