Error Codes

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.