Error Codes
Contents
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) |
| -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 | Description |
| 1102 | Disconnected character not acting as such. |
| 1103 | NPC with STATF_Ridden does not have the correct action set. |
| 1104 | Ridden NPC without a mount item. |
| 1105 | Ridden NPC with a mount item that is not linked to them. |
| 1106 | Disconneced NPC neither dead or ridden. |
| 1107 | Ingame character that is neither a player or an NPC. |
| 1108 | Character not on a valid position. |
| 1203 | NPC with STATF_Ridden does not have the correct action set. |
| 1204 | Ridden NPC without a mount item. |
| 1205 | Ingame character that is neither a player or an NPC. |
| 2102 | Item without an ITEMDEF. |
| 2103 | Item ITEMDEF with an ID of 0. |
| 2104 | Disconnected item. |
| 2105 | Item not on a valid position. |
| 2106 | Item flagged as being in a container but it isn't. |
| 2202 | Item flagged as equipped but it isn't. |
| 2205 | Item's LINK property is set to itself or a UID that doesn't exist. |
| 2206 | GM Robe or Deathshroud not on a character. |
| 2207 | Deathshroud not on a dead character. |
| 2208 | GM Robe on a character without privileges. |
| 2220 | Trade window memory not equipped in the correct layer, or not equipped to a player. |
| 2221 | Client linger memory not equipped in the correct layer, or not equipped to a player. |
| 2222 | Memory not equipped or is not a real memory. |
| 2226 | Mount memory not equipped in the correct layer. |
| 2227 | Hair or beard item is not equipped, not in a corpse, and not in a vendor box. |
| 2228 | Hair or beard item is equipped, but not in the correct layer. |
| 2229 | Game piece not in a container. |
| 2230 | Item equipped in layer_none but it isn't a trade window. |
| 2231 | Item equipped in layer_special but it isn't a memory or script type. |
| 2233 | Item equipped in layer_horse but it isn't a mount memory. |
| 2234 | Item equipped in the client linger layer but it isn't a client linger memory. |
| 2235 | Item equipped in the murder memory layer but it isn't a murder memory. |
| 2236 | Item flagged as decay but without timer set. |
| 3101 | Object is totally lost, no parent exists. |
| 3102 | Object was deleted or UID is incorrect. |
| 3201 | More than one object with the same UID. |
| 4222 | Memory item is not equipped, not in the memory layer, or without colour |
| 4223 | Memory not on a character. |
| 4224 | Guild/town memory does not link to the character's town/guild. |
| 4225 | Guild/town memory linked to a stone, but the character is not a member. |
| 7101 | Object's UID does not match up with server's UID table. |
| 7102 | Object does not exist. |
| FFFF | Bad memory allocation (unknown error occured). |
