SDK Reason Codes - Revision history

Xan: Created page with "TOC ==Current version==

Reason code Value Description

RC_SUCCESS 0
''Success'' :
..."
2025-04-07T19:24:14Z
Created page with "TOC ==Current version== <table class="sortable" border="border" cellpadding="4" cellspacing="0" width="100%"> <tr><th align="left" width="30%">Reason code</th><th align="left" width="10%">Value</th><th align="left" width="60%">Description</th></tr> <tr> <td id="RC_SUCCESS">RC_SUCCESS</td> <td id="NO_0">0</td> <td><p>''Success'' :<table> <tr><td>Return value from an asynchronous call:</td><td width="20"> </td><td>Request has been sent to the server.</td></tr>..."
New page
TOC

==Current version==

<table class="sortable" border="border" cellpadding="4" cellspacing="0" width="100%">
<tr><th align="left" width="30%">Reason code</th><th align="left" width="10%">Value</th><th align="left" width="60%">Description</th></tr>

<tr>
<td id="RC_SUCCESS">RC_SUCCESS</td>
<td id="NO_0">0</td>
<td><p>''Success''
:<table>
<tr><td>Return value from an asynchronous call:</td><td width="20"> </td><td>Request has been sent to the server.</td></tr>
<tr><td>Return value from a blocking call:</td><td width="20"> </td><td>Operation has completed successfully.</td></tr>
<tr><td>When passed to a callback:</td><td width="20"> </td><td>Operation has completed successfully.</td></tr>
</table>
</p></td>
</tr>

<tr>
<td id="RC_CITIZENSHIP_EXPIRED">RC_CITIZENSHIP_EXPIRED</td>
<td id="NO_1">1</td>
<td><p>''Citizenship has expired''
:Citizenship of the owner has expired.</p></td>
</tr>

<tr>
<td id="RC_LAND_LIMIT_EXCEEDED">RC_LAND_LIMIT_EXCEEDED</td>
<td id="NO_2">2</td>
<td><p>''Land limit exceeded''
:Land limit of the universe would be exceeded if the world is started.</p></td>
</tr>

<tr>
<td id="RC_NO_SUCH_CITIZEN">RC_NO_SUCH_CITIZEN</td>
<td id="NO_3">3</td>
<td><p>''No such citizen''
:No citizenship with a matching citizen number was found.</p></td>
</tr>

<tr>
<td id="RC_LICENSE_PASSWORD_CONTAINS_SPACE">RC_LICENSE_PASSWORD_CONTAINS_SPACE</td>
<td id="NO_5">5</td>
<td><p>''License password contains space''
:Password cannot contain a space.</p></td>
</tr>

<tr>
<td id="RC_LICENSE_PASSWORD_TOO_LONG">RC_LICENSE_PASSWORD_TOO_LONG</td>
<td id="NO_6">6</td>
<td><p>''License password too long''
:Password cannot be longer than 8 characters.</p></td>
</tr>

<tr>
<td id="RC_LICENSE_PASSWORD_TOO_SHORT">RC_LICENSE_PASSWORD_TOO_SHORT</td>
<td id="NO_7">7</td>
<td><p>''License password too short''
:Password must be at least 2 characters.</p></td>
</tr>

<tr>
<td id="RC_LICENSE_RANGE_TOO_LARGE">RC_LICENSE_RANGE_TOO_LARGE</td>
<td id="NO_8">8</td>
<td><p>''License range too large''
:Range must be smaller than 3275 hectometers. That is, at most 32750 coordinates N/S/W/E or 655000 meters across.</p></td>
</tr>

<tr>
<td id="RC_LICENSE_RANGE_TOO_SMALL">RC_LICENSE_RANGE_TOO_SMALL</td>
<td id="NO_9">9</td>
<td><p>''License range too small''
:Range must be larger than 0 hectometers. That is, at least 10 coordinates N/S/W/E or 200 meters across.</p></td>
</tr>

<tr>
<td id="RC_LICENSE_USERS_TOO_LARGE">RC_LICENSE_USERS_TOO_LARGE</td>
<td id="NO_10">10</td>
<td><p>''License users too large''
:User limit cannot exceed 1024.</p></td>
</tr>

<tr>
<td id="RC_LICENSE_USERS_TOO_SMALL">RC_LICENSE_USERS_TOO_SMALL</td>
<td id="NO_11">11</td>
<td><p>''License users too small''
:User limit must be larger than 0.</p></td>
</tr>

<tr>
<td id="RC_INVALID_PASSWORD">RC_INVALID_PASSWORD</td>
<td id="NO_13">13</td>
<td><p>''Invalid password''
:Unable to login due to invalid password.</p></td>
</tr>

<tr>
<td id="RC_LICENSE_WORLD_TOO_SHORT">RC_LICENSE_WORLD_TOO_SHORT</td>
<td id="NO_15">15</td>
<td><p>''License world too short''
:Name must be at least 2 characters.</p></td>
</tr>

<tr>
<td id="RC_LICENSE_WORLD_TOO_LONG">RC_LICENSE_WORLD_TOO_LONG</td>
<td id="NO_16">16</td>
<td><p>''License world too long''
:Name cannot be longer than 8 characters.</p></td>
</tr>

<tr>
<td id="RC_MUST_UPGRADE">RC_MUST_UPGRADE</td>
<td id="NO_18">18</td>
<td><p>''SDK update required''
:The used SDK build is obsolete. Update to recent SDK build number. Similar to RC#58.</p></td>
</tr>

<tr>
<td id="RC_INVALID_WORLD">RC_INVALID_WORLD</td>
<td id="NO_20">20</td>
<td><p>''Invalid world''
:Unable to start the world due to invalid name or password.</p></td>
</tr>

<tr>
<td id="RC_SERVER_OUTDATED">RC_SERVER_OUTDATED</td>
<td id="NO_21">21</td>
<td><p>''Server outdated''
:Server build either contains a serious flaw or is outdated and must be upgraded.</p></td>
</tr>

<tr>
<td id="RC_WORLD_ALREADY_STARTED">RC_WORLD_ALREADY_STARTED</td>
<td id="NO_22">22</td>
<td><p>''World already started''
:World has already been started at a different location.</p></td>
</tr>

<tr>
<td id="RC_NO_SUCH_WORLD">RC_NO_SUCH_WORLD</td>
<td id="NO_27">27</td>
<td><p>''No such world''
:No world with a matching name has been started on the server.</p></td>
</tr>

<tr>
<td id="RC_UNAUTHORIZED">RC_UNAUTHORIZED</td>
<td id="NO_32">32</td>
<td><p>''Unauthorized''
:Not authorized to perform the operation.</p></td>
</tr>

<tr>
<td id="RC_NO_SUCH_LICENSE">RC_NO_SUCH_LICENSE</td>
<td id="NO_34">34</td>
<td><p>''No such license''
:No license with a matching world name was found.</p></td>
</tr>

<tr>
<td id="RC_TOO_MANY_WORLDS">RC_TOO_MANY_WORLDS</td>
<td id="NO_57">57</td>
<td><p>''Too many worlds''
:Limit of started worlds in the universe would be exceeded if the world is started.</p></td>
</tr>

<tr>
<td id="RC_MUST_UPGRADE">RC_MUST_UPGRADE</td>
<td id="NO_58">58</td>
<td><p>''Must upgrade''
:SDK build either contains a serious flaw or is outdated and must be upgraded.</p></td>
</tr>

<tr>
<td id="RC_BOT_LIMIT_EXCEEDED">RC_BOT_LIMIT_EXCEEDED</td>
<td id="NO_59">59</td>
<td><p>''Bot limit exceeded''
:Bot limit of the owner citizenship would be exceeded if the bot is logged in.</p></td>
</tr>

<tr>
<td id="RC_WORLD_EXPIRED">RC_WORLD_EXPIRED</td>
<td id="NO_61">61</td>
<td><p>''World expired''
:Unable to start world due to its license having expired.</p></td>
</tr>

<tr>
<td id="RC_CITIZEN_DOES_NOT_EXPIRE">RC_CITIZEN_DOES_NOT_EXPIRE</td>
<td id="NO_62">62</td>
<td><P>''Citizen does not expire''
:TODO: What is this used for?</P></td>
</tr>

<tr>
<td id="RC_LICENSE_STARTS_WITH_NUMBER">RC_LICENSE_STARTS_WITH_NUMBER</td>
<td id="NO_64">64</td>
<td><p>''License starts with number''
:Name cannot start with a number.</p></td>
</tr>

<tr>
<td id="RC_NO_SUCH_EJECTION">RC_NO_SUCH_EJECTION</td>
<td id="NO_66">66</td>
<td><p>''No such ejection''
:No ejection with a matching identifier was found.</p></td>
</tr>

<tr>
<td id="RC_NO_SUCH_SESSION">RC_NO_SUCH_SESSION</td>
<td id="NO_67">67</td>
<td><p>''No such session''
:No user with a matching session number has entered the world.</p></td>
</tr>

<tr>
<td id="RC_WORLD_RUNNING">RC_WORLD_RUNNING</td>
<td id="NO_72">72</td>
<td><p>''World running''
:World has already been started.</p></td>
</tr>

<tr>
<td id="RC_WORLD_NOT_SET">RC_WORLD_NOT_SET</td>
<td id="NO_73">73</td>
<td><p>''World not set''
:World to perform the operation on has not been set.</p></td>
</tr>

<tr>
<td id="RC_NO_SUCH_CELL">RC_NO_SUCH_CELL</td>
<td id="NO_74">74</td>
<td><p>''No such cell''
:No more cells left to enumerate.</p></td>
</tr>

<tr>
<td id="RC_NO_REGISTRY">RC_NO_REGISTRY</td>
<td id="NO_75">75</td>
<td><p>''No registry''
:Unable to start world due to missing or invalid registry.</p></td>
</tr>

<tr>
<td id="RC_CANT_OPEN_REGISTRY">RC_CANT_OPEN_REGISTRY</td>
<td id="NO_76">76</td>
<td>''Can't open registry''</td>
</tr>

<tr>
<td id="RC_CITIZEN_DISABLED">RC_CITIZEN_DISABLED</td>
<td id="NO_77">77</td>
<td><p>''Citizen disabled''
:Citizenship of the owner has been disabled.</p></td>
</tr>

<tr>
<td id="RC_WORLD_DISABLED">RC_WORLD_DISABLED</td>
<td id="NO_78">78</td>
<td><p>''World disabled''
:Unable to start world due to it being disabled.</p></td>
</tr>

<tr>
<td id="RC_TELEGRAM_BLOCKED">RC_TELEGRAM_BLOCKED</td>
<td id="NO_85">85</td>
<td>''Telegram blocked''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_UPDATE_TERRAIN">RC_UNABLE_TO_UPDATE_TERRAIN</td>
<td id="NO_88">88</td>
<td>''Unable to update terrain''</td>
</tr>

<tr>
<td id="RC_EMAIL_CONTAINS_INVALID_CHAR">RC_EMAIL_CONTAINS_INVALID_CHAR</td>
<td id="NO_100">100</td>
<td><p>''Email contains invalid char''
:Email address contains one or more invalid characters.</p></td>
</tr>

<tr>
<td id="RC_EMAIL_ENDS_WITH_BLANK">RC_EMAIL_ENDS_WITH_BLANK</td>
<td id="NO_101">101</td>
<td><p>''Email ends with blank''
:Email address cannot end with a blank.</p></td>
</tr>

<tr>
<td id="RC_NO_SUCH_OBJECT">RC_NO_SUCH_OBJECT</td>
<td id="NO_101b">101</td>
<td><p>''No such object''
:Unable to find the object to delete.</p></td>
</tr>

<tr>
<td id="RC_EMAIL_MISSING_DOT">RC_EMAIL_MISSING_DOT</td>
<td id="NO_102">102</td>
<td><p>''Email missing dot''
:Email address must contain at least one '.'.</p></td>
</tr>

<tr>
<td id="RC_NOT_DELETE_OWNER">RC_NOT_DELETE_OWNER</td>
<td id="NO_102b">102</td>
<td>''Not delete owner''</td>
</tr>

<tr>
<td id="RC_EMAIL_MISSING_AT">RC_EMAIL_MISSING_AT</td>
<td id="NO_103">103</td>
<td><p>''Email missing at''
:Email address must contain a '@'.</p></td>
</tr>

<tr>
<td id="RC_EMAIL_STARTS_WITH_BLANK">RC_EMAIL_STARTS_WITH_BLANK</td>
<td id="NO_104">104</td>
<td><p>''Email starts with blank''
:Email address cannot start with a blank.</p></td>
</tr>

<tr>
<td id="RC_EMAIL_TOO_LONG">RC_EMAIL_TOO_LONG</td>
<td id="NO_105">105</td>
<td><p>''Email too long''
:Email address cannot be longer than 50 characters.</p></td>
</tr>

<tr>
<td id="RC_EMAIL_TOO_SHORT">RC_EMAIL_TOO_SHORT</td>
<td id="NO_106">106</td>
<td><p>''Email too short''
:Email address must be at least 8 characters or longer.</p></td>
</tr>

<tr>
<td id="RC_NAME_ALREADY_USED">RC_NAME_ALREADY_USED</td>
<td id="NO_107">107</td>
<td><p>''Name already used''
:Citizenship with a matching name already exists.</p></td>
</tr>

<tr>
<td id="RC_NAME_CONTAINS_NONALPHANUMERIC_CHAR">RC_NAME_CONTAINS_NONALPHANUMERIC_CHAR</td>
<td id="NO_108">108</td>
<td><p>''Name contains nonalphanumeric character''
:Name contains invalid character(s).</p></td>
</tr>

<tr>
<td id="RC_NAME_CONTAINS_INVALID_BLANK">RC_NAME_CONTAINS_INVALID_BLANK</td>
<td id="NO_109">109</td>
<td><p>''Name contains invalid blank''
:Name contains invalid blank(s).</p></td>
</tr>

<tr>
<td id="RC_NAME_ENDS_WITH_BLANK">RC_NAME_ENDS_WITH_BLANK</td>
<td id="NO_111">111</td>
<td><p>''Name ends with blank''
:Name cannot end with a blank.</p></td>
</tr>

<tr>
<td id="RC_NAME_TOO_LONG">RC_NAME_TOO_LONG</td>
<td id="NO_112">112</td>
<td><p>''Name too long''
:Name cannot be longer than 20 characters.</p></td>
</tr>

<tr>
<td id="RC_NAME_TOO_SHORT">RC_NAME_TOO_SHORT</td>
<td id="NO_113">113</td>
<td><p>''Name too short''
:Name must be at least 4 characters.</p></td>
</tr>

<tr>
<td id="RC_PASSWORD_TOO_LONG">RC_PASSWORD_TOO_LONG</td>
<td id="NO_115">115</td>
<td><p>''Password too long''
:Password cannot be longer than 16 characters.</p></td>
</tr>

<tr>
<td id="RC_PASSWORD_TOO_SHORT">RC_PASSWORD_TOO_SHORT</td>
<td id="NO_116">116</td>
<td><p>''Password too short''
:Password must be at least 8 characters.</p></td>
</tr>

<tr>
<td id="RC_UNABLE_TO_DELETE_CITIZEN">RC_UNABLE_TO_DELETE_CITIZEN</td>
<td id="NO_124">124</td>
<td><p>''Unable to delete citizen''
:Unable to delete citizen due to a database problem.</p></td>
</tr>

<tr>
<td id="RC_NUMBER_ALREADY_USED">RC_NUMBER_ALREADY_USED</td>
<td id="NO_126">126</td>
<td><p>''Number already used''
:Citizenship with a matching citizen number already exists.</p></td>
</tr>

<tr>
<td id="RC_NUMBER_OUT_OF_RANGE">RC_NUMBER_OUT_OF_RANGE</td>
<td id="NO_127">127</td>
<td><p>''Number out of range''
:Citizen number is larger than the auto-incremented field in the database.</p></td>
</tr>

<tr>
<td id="RC_PRIVILEGE_PASSWORD_IS_TOO_SHORT">RC_PRIVILEGE_PASSWORD_IS_TOO_SHORT</td>
<td id="NO_128">128</td>
<td><p>''Privilege password is too short''
:Privilege password must be either empty or at least 4 characters.</p></td>
</tr>

<tr>
<td id="RC_PRIVILEGE_PASSWORD_IS_TOO_LONG">RC_PRIVILEGE_PASSWORD_IS_TOO_LONG</td>
<td id="NO_129">129</td>
<td><p>''Privilege password is too long''
:Password cannot be longer than 12 characters.</p></td>
</tr>

<tr>
<td id="RC_NOT_CHANGE_OWNER">RC_NOT_CHANGE_OWNER</td>
<td id="NO_203">203</td>
<td><p>''Not change owner''
:Not permitted to change the owner of an object. It requires eminent domain or caretaker capability.</p></td>
</tr>

<tr>
<td id="RC_CANT_FIND_OLD_ELEMENT">RC_CANT_FIND_OLD_ELEMENT</td>
<td id="NO_204">204</td>
<td><p>''Can't find old element''
:Unable to find the object to change.</p></td>
</tr>

<tr>
<td id="RC_IMPOSTER">RC_IMPOSTER</td>
<td id="NO_212">212</td>
<td><p>''Imposter''
:Unable to enter world due to masquerading as someone else.</p></td>
</tr>

<tr>
<td id="RC_ENCROACHES">RC_ENCROACHES</td>
<td id="NO_300">300</td>
<td><p>''Encroaches''
:Not allowed to encroach into another's property.</p></td>
</tr>

<tr>
<td id="RC_OBJECT_TYPE_INVALID">RC_OBJECT_TYPE_INVALID</td>
<td id="NO_301">301</td>
<td>''Object type invalid''</td>
</tr>

<tr>
<td id="RC_TOO_MANY_BYTES">RC_TOO_MANY_BYTES</td>
<td id="NO_303">303</td>
<td><p>''Too many bytes''
:Cell limit would be exceeded.</p></td>
</tr>

<tr>
<td id="RC_UNREGISTERED_OBJECT">RC_UNREGISTERED_OBJECT</td>
<td id="NO_306">306</td>
<td><p>''Unregistered object''
:Model name does not exist in the registry.</p></td>
</tr>

<tr>
<td id="RC_ELEMENT_ALREADY_EXISTS">RC_ELEMENT_ALREADY_EXISTS</td>
<td id="NO_308">308</td>
<td>''Element already exists''</td>
</tr>

<tr>
<td id="RC_RESTRICTED_COMMAND">RC_RESTRICTED_COMMAND</td>
<td id="NO_309">309</td>
<td>''Restricted command''</td>
</tr>

<tr>
<td id="RC_OUT_OF_BOUNDS">RC_OUT_OF_BOUNDS</td>
<td id="NO_311">311</td>
<td>''Out of bounds''</td>
</tr>

<tr>
<td id="RC_RESTRICTED_OBJECT">RC_RESTRICTED_OBJECT</td>
<td id="NO_313">313</td>
<td><p>''Restricted object''
:Not allowed to build with 'z' objects in this world. [the same error code is used for V4 objects]</p></td>
</tr>

<tr>
<td id="RC_RESTRICTED_AREA">RC_RESTRICTED_AREA</td>
<td id="NO_314">314</td>
<td><p>''Restricted area''
:Not allowed to build within the restricted area of this world.</p></td>
</tr>

<tr>
<td id="RC_NOT_YET">RC_NOT_YET</td>
<td id="NO_401">401</td>
<td><p>''Not yet''
:Would exceed the maximum number of operations per second.</p></td>
</tr>

<tr>
<td id="RC_TIMEOUT">RC_TIMEOUT</td>
<td id="NO_402">402</td>
<td><p>''Timeout''
:Synchronous operation timed out.</p></td>
</tr>

<tr>
<td id="RC_UNABLE_TO_CONTACT_UNIVERSE">RC_UNABLE_TO_CONTACT_UNIVERSE</td>
<td id="NO_404">404</td>
<td><p>''Unable to contact universe''
:Unable to establish a connection to the universe server.</p></td>
</tr>

<tr>
<td id="RC_NO_CONNECTION">RC_NO_CONNECTION</td>
<td id="NO_439">439</td>
<td><p>''No connection''
:Connection to the server is down.</p></td>
</tr>

<tr>
<td id="RC_NOT_INITIALIZED">RC_NOT_INITIALIZED</td>
<td id="NO_444">444</td>
<td><p>''Not initialized''
:SDK API has not been initialized (by calling [[aw_init]]).</p></td>
</tr>

<tr>
<td id="RC_NO_INSTANCE">RC_NO_INSTANCE</td>
<td id="NO_445">445</td>
<td>''No instance''</td>
</tr>

<tr>
<td id="RC_INVALID_ATTRIBUTE">RC_INVALID_ATTRIBUTE</td>
<td id="NO_448">448</td>
<td>''Invalid attribute''</td>
</tr>

<tr>
<td id="RC_TYPE_MISMATCH">RC_TYPE_MISMATCH</td>
<td id="NO_449">449</td>
<td>''Type mismatch''</td>
</tr>

<tr>
<td id="RC_STRING_TOO_LONG">RC_STRING_TOO_LONG</td>
<td id="NO_450">450</td>
<td>''String too long''</td>
</tr>

<tr>
<td id="RC_READ_ONLY">RC_READ_ONLY</td>
<td id="NO_451">451</td>
<td><p>''Read only''
:Unable to set attribute due to it being read-only.</p></td>
</tr>

<tr>
<td id="RC_INVALID_INSTANCE">RC_INVALID_INSTANCE</td>
<td id="NO_453">453</td>
<td>''Invalid instance''</td>
</tr>

<tr>
<td id="RC_VERSION_MISMATCH">RC_VERSION_MISMATCH</td>
<td id="NO_454">454</td>
<td><p>''Version mismatch''
:Aw.h and Aw.dll (or libaw_sdk.so for Linux) are from different builds of the SDK.</p></td>
</tr>

<tr>
<td id="RC_QUERY_IN_PROGRESS">RC_QUERY_IN_PROGRESS</td>
<td id="NO_464">464</td>
<td><p>''Query in progress''
:A property query is already in progress.</p></td>
</tr>

<tr>
<td id="RC_EJECTED">RC_EJECTED</td>
<td id="NO_466">466</td>
<td><p>''Ejected''
:Disconnected from world due to ejection.</p></td>
</tr>

<tr>
<td id="RC_NOT_WELCOME">RC_NOT_WELCOME</td>
<td id="NO_467">467</td>
<td><p>''Not welcome''
:Citizenship of the owner does not have bot rights in the world.</p></td>
</tr>

<tr>
<td id="RC_CONNECTION_LOST">RC_CONNECTION_LOST</td>
<td id="NO_471">471</td>
<td>''Connection lost''</td>
</tr>

<tr>
<td id="RC_NOT_AVAILABLE">RC_NOT_AVAILABLE</td>
<td id="NO_474">474</td>
<td>''Not available''</td>
</tr>

<tr>
<td id="RC_CANT_RESOLVE_UNIVERSE_HOST">RC_CANT_RESOLVE_UNIVERSE_HOST</td>
<td id="NO_500">500</td>
<td>''Can't resolve universe host''</td>
</tr>

<tr>
<td id="RC_INVALID_ARGUMENT">RC_INVALID_ARGUMENT</td>
<td id="NO_505">505</td>
<td>''Invalid argument''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_UPDATE_CAV">RC_UNABLE_TO_UPDATE_CAV</td>
<td id="NO_514">514</td>
<td>''Unable to update custom avatar''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_DELETE_CAV">RC_UNABLE_TO_DELETE_CAV</td>
<td id="NO_515">515</td>
<td>''Unable to delete custom avatar''</td>
</tr>

<tr>
<td id="RC_NO_SUCH_CAV">RC_NO_SUCH_CAV</td>
<td id="NO_516">516</td>
<td>''No such custom avatar''</td>
</tr>

<tr>
<td id="RC_WORLD_INSTANCE_ALREADY_EXISTS">RC_WORLD_INSTANCE_ALREADY_EXISTS</td>
<td id="NO_521">521</td>
<td>''World instance already exists''</td>
</tr>

<tr>
<td id="RC_WORLD_INSTANCE_INVALID">RC_WORLD_INSTANCE_INVALID</td>
<td id="NO_522">522</td>
<td>''World instance invalid''</td>
</tr>

<tr>
<td id="RC_PLUGIN_NOT_AVAILABLE">RC_PLUGIN_NOT_AVAILABLE</td>
<td id="NO_523">523</td>
<td>''Plugin not available''</td>
</tr>

<tr>
<td id="RC_DATABASE_ERROR">RC_DATABASE_ERROR</td>
<td id="NO_600">600</td>
<td>''Database error''</td>
</tr>

<tr>
<td id="RC_Z_BUF_ERROR">RC_Z_BUF_ERROR</td>
<td id="NO_4995">4995</td>
<td><p>''Buffer error (zlib)''
:Not enough room in the output buffer.</p></td>
</tr>

<tr>
<td id="RC_Z_MEM_ERROR">RC_Z_MEM_ERROR</td>
<td id="NO_4996">4996</td>
<td><p>''Memory error (zlib)''
:Memory could not be allocated for processing.</p></td>
</tr>

<tr>
<td id="RC_Z_DATA_ERROR">RC_Z_DATA_ERROR</td>
<td id="NO_4997">4997</td>
<td><p>''Data error (zlib)''
:Input data was corrupted.</p></td>
</tr>

</table>

==Addition older reason codes, not used by the free SDK==

<table class="sortable" border="border" cellpadding="4" cellspacing="0" width="100%">
<tr><th align="left" width="30%">Reason code</th><th align="left" width="10%">Value</th><th align="left" width="60%">Description</th></tr>
<tr>
<td id="RC_MESSAGE_LENGTH_BAD">RC_MESSAGE_LENGTH_BAD</td>
<td>4</td>
<td>''Message length bad''</td>
</tr>

<tr>
<td id="RC_LICENSE_CONTAINS_INVALID_CHAR">RC_LICENSE_CONTAINS_INVALID_CHAR</td>
<td>12</td>
<td>''License contains invalid character''</td>
</tr>

<tr>
<td id="RC_SERVER_OUT_OF_MEMORY">RC_SERVER_OUT_OF_MEMORY</td>
<td>17</td>
<td>''Server out of memory''</td>
</tr>

<tr>
<td id="RC_NOT_LOGGED_IN">RC_NOT_LOGGED_IN</td>
<td>31</td>
<td><p>''Not logged in''
:Must be logged in to perform the operation.</p></td>
</tr>

<tr>
<td id="RC_WORLD_ALREADY_EXISTS">RC_WORLD_ALREADY_EXISTS</td>
<td>33</td>
<td><p>''World already exists''
:Name already exists.</p></td>
</tr>

<tr>
<td id="RC_NO_SUCH_ACTING_CITIZEN">RC_NO_SUCH_ACTING_CITIZEN</td>
<td>42</td>
<td>''No such acting citizen''</td>
</tr>

<tr>
<td id="RC_ACTING_PASSWORD_INVALID">RC_ACTING_PASSWORD_INVALID</td>
<td>43</td>
<td>''Acting password invalid''</td>
</tr>

<tr>
<td id="RC_EJECTION_EXPIRED">RC_EJECTION_EXPIRED</td>
<td>69</td>
<td><P>''Ejection expired''
:Attempting to add an ejection that has already expired.</P></td>
</tr>

<tr>
<td id="RC_ACTING_CITIZEN_EXPIRED">RC_ACTING_CITIZEN_EXPIRED</td>
<td>70</td>
<td>''Acting citizen expired''</td>
</tr>

<tr>
<td id="RC_ALREADY_STARTED">RC_ALREADY_STARTED</td>
<td>71</td>
<td>''Already started''</td>
</tr>

<tr>
<td id="RC_ACTING_CITIZEN_DISABLED">RC_ACTING_CITIZEN_DISABLED</td>
<td>80</td>
<td>''Acting citizen disabled''</td>
</tr>

<tr>
<td id="RC_TELEGRAM_TOO_LONG">RC_TELEGRAM_TOO_LONG</td>
<td>86</td>
<td>''Telegram too long''</td>
</tr>

<tr>
<td id="RC_NAME_DOESNT_EXIST">RC_NAME_DOESNT_EXIST</td>
<td>110</td>
<td>''Name doesn't exist''</td>
</tr>

<tr>
<td id="RC_NAME_UNUSED">RC_NAME_UNUSED</td>
<td>114</td>
<td>''Name unused''</td>
</tr>

<tr>
<td id="RC_PASSWORD_WRONG">RC_PASSWORD_WRONG</td>
<td>117</td>
<td><P>''Password wrong''
:TODO: Where is this used?</P></td>
</tr>

<tr>
<td id="RC_UNABLE_TO_DELETE_NAME">RC_UNABLE_TO_DELETE_NAME</td>
<td>119</td>
<td>''Unable to delete name''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_GET_CITIZEN">RC_UNABLE_TO_GET_CITIZEN</td>
<td>120</td>
<td>''Unable to get citizen''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_INSERT_CITIZEN">RC_UNABLE_TO_INSERT_CITIZEN</td>
<td>121</td>
<td>''Unable to insert citizen''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_INSERT_NAME">RC_UNABLE_TO_INSERT_NAME</td>
<td>122</td>
<td>''Unable to insert name''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_PUT_CITIZEN_COUNT">RC_UNABLE_TO_PUT_CITIZEN_COUNT</td>
<td>123</td>
<td>''Unable to put citizen count''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_CHANGE_ATTRIBUTE">RC_UNABLE_TO_CHANGE_ATTRIBUTE</td>
<td>210</td>
<td>''Unable to change attribute''</td>
</tr>

<tr>
<td id="RC_INVALID_REQUEST">RC_INVALID_REQUEST</td>
<td>213</td>
<td>''Invalid request''</td>
</tr>

<tr>
<td id="RC_CANT_BUILD_HERE">RC_CANT_BUILD_HERE</td>
<td>216</td>
<td>''Can't build here''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_STORE">RC_UNABLE_TO_STORE</td>
<td>305</td>
<td>''Unable to store''</td>
</tr>

<tr>
<td id="RC_NO_BUILD_RIGHTS">RC_NO_BUILD_RIGHTS</td>
<td>310</td>
<td>''No build rights''</td>
</tr>

<tr>
<td id="RC_OUT_OF_MEMORY">RC_OUT_OF_MEMORY</td>
<td>400</td>
<td>''Out of memory''</td>
</tr>

<tr>
<td id="RC_NULL_POINTER">RC_NULL_POINTER</td>
<td>403</td>
<td>''Null pointer''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_CONTACT_WORLD">RC_UNABLE_TO_CONTACT_WORLD</td>
<td>405</td>
<td>''Unable to contact world''</td>
</tr>

<tr>
<td id="RC_INVALID_WORLD_NAME">RC_INVALID_WORLD_NAME</td>
<td>406</td>
<td>''Invalid world name''</td>
</tr>

<tr>
<td id="RC_SEND_FAILED">RC_SEND_FAILED</td>
<td>415</td>
<td>''Send failed''</td>
</tr>

<tr>
<td id="RC_RECEIVE_FAILED">RC_RECEIVE_FAILED</td>
<td>416</td>
<td><p>''Receive failed''
:Unable to receive data from network socket.

:This can occur for any number of reasons. But in general, it means some kind of network communication problem has occurred.

:It could be that the peer host has disconnected, peer host failed to respond in time, connection is being blocked by a firewall, or anything else that would interfere with socket communications.</p></td>
</tr>

<tr>
<td id="RC_STREAM_EMPTY">RC_STREAM_EMPTY</td>
<td>421</td>
<td>''Stream empty''</td>
</tr>

<tr>
<td id="RC_STREAM_MESSAGE_TOO_LONG">RC_STREAM_MESSAGE_TOO_LONG</td>
<td>422</td>
<td>''Stream message too long''</td>
</tr>

<tr>
<td id="RC_WORLD_NAME_TOO_LONG">RC_WORLD_NAME_TOO_LONG</td>
<td>423</td>
<td>''World name too long''</td>
</tr>

<tr>
<td id="RC_MESSAGE_TOO_LONG">RC_MESSAGE_TOO_LONG</td>
<td>426</td>
<td>''Message too long''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_CREATE_SOCKET">RC_UNABLE_TO_CREATE_SOCKET</td>
<td>428</td>
<td>''Unable to create socket''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_CONNECT">RC_UNABLE_TO_CONNECT</td>
<td>429</td>
<td>''Unable to connect''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_SET_NONBLOCKING">RC_UNABLE_TO_SET_NONBLOCKING</td>
<td>430</td>
<td>''Unable to set nonblocking''</td>
</tr>

<tr>
<td id="RC_CANT_OPEN_STREAM">RC_CANT_OPEN_STREAM</td>
<td>434</td>
<td>''Can't open stream''</td>
</tr>

<tr>
<td id="RC_CANT_WRITE_STREAM">RC_CANT_WRITE_STREAM</td>
<td>435</td>
<td>''Can't write stream''</td>
</tr>

<tr>
<td id="RC_CANT_CLOSE_STREAM">RC_CANT_CLOSE_STREAM</td>
<td>436</td>
<td>''Can't close stream''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_INITIALIZE_NETWORK">RC_UNABLE_TO_INITIALIZE_NETWORK</td>
<td>442</td>
<td>''Unable to initialize network''</td>
</tr>

<tr>
<td id="RC_INCORRECT_MESSAGE_LENGTH">RC_INCORRECT_MESSAGE_LENGTH</td>
<td>443</td>
<td>''Incorrect message length''</td>
</tr>

<tr>
<td id="RC_OUT_BUFFER_FULL">RC_OUT_BUFFER_FULL</td>
<td>446</td>
<td>''Out buffer full''</td>
</tr>

<tr>
<td id="RC_INVALID_CALLBACK">RC_INVALID_CALLBACK</td>
<td>447</td>
<td>''Invalid callback''</td>
</tr>

<tr>
<td id="RC_IN_BUFFER_FULL">RC_IN_BUFFER_FULL</td>
<td>461</td>
<td>''In buffer full''</td>
</tr>

<tr>
<td id="RC_PROTOCOL_ERROR">RC_PROTOCOL_ERROR</td>
<td>463</td>
<td>''Protocol error''</td>
</tr>

<tr>
<td id="RC_NO_STREAM">RC_NO_STREAM</td>
<td>473</td>
<td>''No stream''</td>
</tr>

<tr>
<td id="RC_OLD_UNIVERSE">RC_OLD_UNIVERSE</td>
<td>487</td>
<td><p>''Old universe''
:Universe is too outdated to be compatible.</p></td>
</tr>

<tr>
<td id="RC_OLD_WORLD">RC_OLD_WORLD</td>
<td>488</td>
<td><p>''Old world''
:World is too outdated to be compatible.</p></td>
</tr>

<tr>
<td id="RC_WORLD_NOT_RUNNING">RC_WORLD_NOT_RUNNING</td>
<td>489</td>
<td><p>''World not running''
:Unable to stop a world that is not running.</p></td>
</tr>
</table>

==Not used by the free SDK==

<table class="sortable" border="border" cellpadding="4" cellspacing="0" width="100%">
<tr><th align="left" width="30%">Reason code</th><th align="left" width="10%">Value</th><th align="left" width="60%">Description</th></tr>
<tr>
<td id="RC_UNABLE_TO_MAIL_BACK_NUMBER">RC_UNABLE_TO_MAIL_BACK_NUMBER</td>
<td>14</td>
<td>''Unable to mail back number''</td>
</tr>

<tr>
<td id="RC_IDENTITY_ALREADY_IN_USE">RC_IDENTITY_ALREADY_IN_USE</td>
<td>39</td>
<td>''Identity already in use''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_REPORT_LOCATION">RC_UNABLE_TO_REPORT_LOCATION</td>
<td>40</td>
<td>''Unable to report location''</td>
</tr>

<tr>
<td id="RC_INVALID_EMAIL">RC_INVALID_EMAIL</td>
<td>41</td>
<td>''Invalid email''</td>
</tr>
<tr>
<td id="RC_UNIVERSE_FULL">RC_UNIVERSE_FULL</td>
<td>45</td>
<td>''Universe full''</td>
</tr>

<tr>
<td id="RC_BILLING_TIMEOUT">RC_BILLING_TIMEOUT</td>
<td>46</td>
<td>''Billing timeout''</td>
</tr>

<tr>
<td id="RC_BILLING_RECV_FAILED">RC_BILLING_RECV_FAILED</td>
<td>47</td>
<td>''Billing recv failed''</td>
</tr>

<tr>
<td id="RC_BILLING_RESPONSE_INVALID">RC_BILLING_RESPONSE_INVALID</td>
<td>48</td>
<td>''Billing response invalid''</td>
</tr>

<tr>
<td id="RC_BILLING_REJECTED">RC_BILLING_REJECTED</td>
<td>55</td>
<td>''Billing rejected''</td>
</tr>

<tr>
<td id="RC_BILLING_BLOCKED">RC_BILLING_BLOCKED</td>
<td>56</td>
<td>''Billing blocked''</td>
</tr>

<tr>
<td id="RC_BETA_REQUIRED">RC_BETA_REQUIRED</td>
<td>79</td>
<td>''Beta required''</td>
</tr>

<tr>
<td id="RC_INVALID_USER_COUNT">RC_INVALID_USER_COUNT</td>
<td>81</td>
<td>''Invalid user count''</td>
</tr>

<tr>
<td id="RC_PRIVATE_WORLD">RC_PRIVATE_WORLD</td>
<td>91</td>
<td>''Private world''</td>
</tr>

<tr>
<td id="RC_NO_TOURISTS">RC_NO_TOURISTS</td>
<td>92</td>
<td>''No tourists''</td>
</tr>

<tr>
<td id="RC_CANT_CHANGE_OWNER">RC_CANT_CHANGE_OWNER</td>
<td>211</td>
<td>''Can't change owner''</td>
</tr>

<tr>
<td id="RC_JOIN_REFUSED">RC_JOIN_REFUSED</td>
<td>250</td>
<td>''Join refused''</td>
</tr>

<tr>
<td id="RC_TOO_MANY_RESETS">RC_TOO_MANY_RESETS</td>
<td>427</td>
<td>''Too many resets''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_REGISTER_RESOLVE">RC_UNABLE_TO_REGISTER_RESOLVE</td>
<td>452</td>
<td>''Unable to register resolve''</td>
</tr>

<tr>
<td id="RC_WORLD_FULL">RC_WORLD_FULL</td>
<td>465</td>
<td>''World full''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_BIND">RC_UNABLE_TO_BIND</td>
<td>468</td>
<td>''Unable to bind''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_LISTEN">RC_UNABLE_TO_LISTEN</td>
<td>469</td>
<td>''Unable to listen''</td>
</tr>

<tr>
<td id="RC_UNABLE_TO_ACCEPT">RC_UNABLE_TO_ACCEPT</td>
<td>470</td>
<td>''Unable to accept''</td>
</tr>

<tr>
<td id="RC_EMAIL_CHANGE_NOT_ALLOWED">RC_EMAIL_CHANGE_NOT_ALLOWED</td>
<td>525</td>
<td>''Email change not allowed''</td>
</tr>

<tr>
<td id="RC_NAME_CHANGE_NOT_ALLOWED">RC_NAME_CHANGE_NOT_ALLOWED</td>
<td>526</td>
<td>''Name change not allowed''</td>
</tr>

<tr>
<td id="RC_EMAIL_ALREADY_USED">RC_EMAIL_ALREADY_USED</td>
<td>527</td>
<td>''Email already used''</td>
</tr>

<tr>
<td id="RC_EMAIL_NOT_ALLOWED">RC_EMAIL_NOT_ALLOWED</td>
<td>528</td>
<td>''Email not allowed''</td>
</tr>

<tr>
<td id="RC_WORLD_REDIRECT">RC_WORLD_REDIRECT</td>
<td>529</td>
<td><P>''World redirect''
:TODO: Is this ever used in the SDK?</P></td>
</tr>
</table>

[[Category:SDK]]

Return value from an asynchronous call: Request has been sent to the server.