SDK Reason Codes

From ActiveWiki
Jump to: navigation, search

Current version

Reason codeValueDescription
RC_SUCCESS 0

Success

Return value from an asynchronous call: Request has been sent to the server.
Return value from a blocking call: Operation has completed successfully.
When passed to a callback: Operation has completed successfully.

RC_CITIZENSHIP_EXPIRED 1

Citizenship has expired

Citizenship of the owner has expired.

RC_LAND_LIMIT_EXCEEDED 2

Land limit exceeded

Land limit of the universe would be exceeded if the world is started.

RC_NO_SUCH_CITIZEN 3

No such citizen

No citizenship with a matching citizen number was found.

RC_LICENSE_PASSWORD_CONTAINS_SPACE 5

License password contains space

Password cannot contain a space.

RC_LICENSE_PASSWORD_TOO_LONG 6

License password too long

Password cannot be longer than 8 characters.

RC_LICENSE_PASSWORD_TOO_SHORT 7

License password too short

Password must be at least 2 characters.

RC_LICENSE_RANGE_TOO_LARGE 8

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.

RC_LICENSE_RANGE_TOO_SMALL 9

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.

RC_LICENSE_USERS_TOO_LARGE 10

License users too large

User limit cannot exceed 1024.

RC_LICENSE_USERS_TOO_SMALL 11

License users too small

User limit must be larger than 0.

RC_INVALID_PASSWORD 13

Invalid password

Unable to login due to invalid password.

RC_LICENSE_WORLD_TOO_SHORT 15

License world too short

Name must be at least 2 characters.

RC_LICENSE_WORLD_TOO_LONG 16

License world too long

Name cannot be longer than 8 characters.

RC_INVALID_WORLD 20

Invalid world

Unable to start the world due to invalid name or password.

RC_SERVER_OUTDATED 21

Server outdated

Server build either contains a serious flaw or is outdated and must be upgraded.

RC_WORLD_ALREADY_STARTED 22

World already started

World has already been started at a different location.

RC_NO_SUCH_WORLD 27

No such world

No world with a matching name has been started on the server.

RC_UNAUTHORIZED 32

Unauthorized

Not authorized to perform the operation.

RC_NO_SUCH_LICENSE 34

No such license

No license with a matching world name was found.

RC_TOO_MANY_WORLDS 57

Too many worlds

Limit of started worlds in the universe would be exceeded if the world is started.

RC_MUST_UPGRADE 58

Must upgrade

SDK build either contains a serious flaw or is outdated and must be upgraded.

RC_BOT_LIMIT_EXCEEDED 59

Bot limit exceeded

Bot limit of the owner citizenship would be exceeded if the bot is logged in.

RC_WORLD_EXPIRED 61

World expired

Unable to start world due to its license having expired.

RC_CITIZEN_DOES_NOT_EXPIRE 62

Citizen does not expire

TODO: What is this used for?

RC_LICENSE_STARTS_WITH_NUMBER 64

License starts with number

Name cannot start with a number.

RC_NO_SUCH_EJECTION 66

No such ejection

No ejection with a matching identifier was found.

RC_NO_SUCH_SESSION 67

No such session

No user with a matching session number has entered the world.

RC_WORLD_RUNNING 72

World running

World has already been started.

RC_WORLD_NOT_SET 73

World not set

World to perform the operation on has not been set.

RC_NO_SUCH_CELL 74

No such cell

No more cells left to enumerate.

RC_NO_REGISTRY 75

No registry

Unable to start world due to missing or invalid registry.

RC_CANT_OPEN_REGISTRY 76 Can't open registry
RC_CITIZEN_DISABLED 77

Citizen disabled

Citizenship of the owner has been disabled.

RC_WORLD_DISABLED 78

World disabled

Unable to start world due to it being disabled.

RC_TELEGRAM_BLOCKED 85 Telegram blocked
RC_UNABLE_TO_UPDATE_TERRAIN 88 Unable to update terrain
RC_EMAIL_CONTAINS_INVALID_CHAR 100

Email contains invalid char

Email address contains one or more invalid characters.

RC_EMAIL_ENDS_WITH_BLANK 101

Email ends with blank

Email address cannot end with a blank.

RC_NO_SUCH_OBJECT 101

No such object

Unable to find the object to delete.

RC_EMAIL_MISSING_DOT 102

Email missing dot

Email address must contain at least one '.'.

RC_NOT_DELETE_OWNER 102 Not delete owner
RC_EMAIL_MISSING_AT 103

Email missing at

Email address must contain a '@'.

RC_EMAIL_STARTS_WITH_BLANK 104

Email starts with blank

Email address cannot start with a blank.

RC_EMAIL_TOO_LONG 105

Email too long

Email address cannot be longer than 50 characters.

RC_EMAIL_TOO_SHORT 106

Email too short

Email address must be at least 8 characters or longer.

RC_NAME_ALREADY_USED 107

Name already used

Citizenship with a matching name already exists.

RC_NAME_CONTAINS_NONALPHANUMERIC_CHAR 108

Name contains nonalphanumeric character

Name contains invalid character(s).

RC_NAME_CONTAINS_INVALID_BLANK 109

Name contains invalid blank

Name contains invalid blank(s).

RC_NAME_ENDS_WITH_BLANK 111

Name ends with blank

Name cannot end with a blank.

RC_NAME_TOO_LONG 112

Name too long

Name cannot be longer than 20 characters.

RC_NAME_TOO_SHORT 113

Name too short

Name must be at least 4 characters.

RC_PASSWORD_TOO_LONG 115

Password too long

Password cannot be longer than 16 characters.

RC_PASSWORD_TOO_SHORT 116

Password too short

Password must be at least 8 characters.

RC_UNABLE_TO_DELETE_CITIZEN 124

Unable to delete citizen

Unable to delete citizen due to a database problem.

RC_NUMBER_ALREADY_USED 126

Number already used

Citizenship with a matching citizen number already exists.

RC_NUMBER_OUT_OF_RANGE 127

Number out of range

Citizen number is larger than the auto-incremented field in the database.

RC_PRIVILEGE_PASSWORD_IS_TOO_SHORT 128

Privilege password is too short

Privilege password must be either empty or at least 4 characters.

RC_PRIVILEGE_PASSWORD_IS_TOO_LONG 129

Privilege password is too long

Password cannot be longer than 12 characters.

RC_NOT_CHANGE_OWNER 203

Not change owner

Not permitted to change the owner of an object. It requires eminent domain or caretaker capability.

RC_CANT_FIND_OLD_ELEMENT 204

Can't find old element

Unable to find the object to change.

RC_IMPOSTER 212

Imposter

Unable to enter world due to masquerading as someone else.

RC_ENCROACHES 300

Encroaches

Not allowed to encroach into another's property.

RC_OBJECT_TYPE_INVALID 301 Object type invalid
RC_TOO_MANY_BYTES 303

Too many bytes

Cell limit would be exceeded.

RC_UNREGISTERED_OBJECT 306

Unregistered object

Model name does not exist in the registry.

RC_ELEMENT_ALREADY_EXISTS 308 Element already exists
RC_RESTRICTED_COMMAND 309 Restricted command
RC_OUT_OF_BOUNDS 311 Out of bounds
RC_RESTRICTED_OBJECT 313

Restricted object

Not allowed to build with 'z' objects in this world. [the same error code is used for V4 objects]

RC_RESTRICTED_AREA 314

Restricted area

Not allowed to build within the restricted area of this world.

RC_NOT_YET 401

Not yet

Would exceed the maximum number of operations per second.

RC_TIMEOUT 402

Timeout

Synchronous operation timed out.

RC_UNABLE_TO_CONTACT_UNIVERSE 404

Unable to contact universe

Unable to establish a connection to the universe server.

RC_NO_CONNECTION 439

No connection

Connection to the server is down.

RC_NOT_INITIALIZED 444

Not initialized

SDK API has not been initialized (by calling aw_init).

RC_NO_INSTANCE 445 No instance
RC_INVALID_ATTRIBUTE 448 Invalid attribute
RC_TYPE_MISMATCH 449 Type mismatch
RC_STRING_TOO_LONG 450 String too long
RC_READ_ONLY 451

Read only

Unable to set attribute due to it being read-only.

RC_INVALID_INSTANCE 453 Invalid instance
RC_VERSION_MISMATCH 454

Version mismatch

Aw.h and Aw.dll (or libaw_sdk.so for Linux) are from different builds of the SDK.

RC_QUERY_IN_PROGRESS 464

Query in progress

A property query is already in progress.

RC_EJECTED 466

Ejected

Disconnected from world due to ejection.

RC_NOT_WELCOME 467

Not welcome

Citizenship of the owner does not have bot rights in the world.

RC_CONNECTION_LOST 471 Connection lost
RC_NOT_AVAILABLE 474 Not available
RC_CANT_RESOLVE_UNIVERSE_HOST 500 Can't resolve universe host
RC_INVALID_ARGUMENT 505 Invalid argument
RC_UNABLE_TO_UPDATE_CAV 514 Unable to update custom avatar
RC_UNABLE_TO_DELETE_CAV 515 Unable to delete custom avatar
RC_NO_SUCH_CAV 516 No such custom avatar
RC_WORLD_INSTANCE_ALREADY_EXISTS 521 World instance already exists
RC_WORLD_INSTANCE_INVALID 522 World instance invalid
RC_PLUGIN_NOT_AVAILABLE 523 Plugin not available
RC_DATABASE_ERROR 600 Database error
RC_Z_BUF_ERROR 4995

Buffer error (zlib)

Not enough room in the output buffer.

RC_Z_MEM_ERROR 4996

Memory error (zlib)

Memory could not be allocated for processing.

RC_Z_DATA_ERROR 4997

Data error (zlib)

Input data was corrupted.

Only for version 3.6 and older

Reason codeValueDescription
RC_MESSAGE_LENGTH_BAD 4 Message length bad
RC_LICENSE_CONTAINS_INVALID_CHAR 12 License contains invalid character
RC_SERVER_OUT_OF_MEMORY 17 Server out of memory
RC_NOT_LOGGED_IN 31

Not logged in

Must be logged in to perform the operation.

RC_WORLD_ALREADY_EXISTS 33

World already exists

Name already exists.

RC_NO_SUCH_ACTING_CITIZEN 42 No such acting citizen
RC_ACTING_PASSWORD_INVALID 43 Acting password invalid
RC_EJECTION_EXPIRED 69

Ejection expired

Attempting to add an ejection that has already expired.

RC_ACTING_CITIZEN_EXPIRED 70 Acting citizen expired
RC_ALREADY_STARTED 71 Already started
RC_ACTING_CITIZEN_DISABLED 80 Acting citizen disabled
RC_TELEGRAM_TOO_LONG 86 Telegram too long
RC_NAME_DOESNT_EXIST 110 Name doesn't exist
RC_NAME_UNUSED 114 Name unused
RC_PASSWORD_WRONG 117

Password wrong

TODO: Where is this used?

RC_UNABLE_TO_DELETE_NAME 119 Unable to delete name
RC_UNABLE_TO_GET_CITIZEN 120 Unable to get citizen
RC_UNABLE_TO_INSERT_CITIZEN 121 Unable to insert citizen
RC_UNABLE_TO_INSERT_NAME 122 Unable to insert name
RC_UNABLE_TO_PUT_CITIZEN_COUNT 123 Unable to put citizen count
RC_UNABLE_TO_CHANGE_ATTRIBUTE 210 Unable to change attribute
RC_INVALID_REQUEST 213 Invalid request
RC_CANT_BUILD_HERE 216 Can't build here
RC_UNABLE_TO_STORE 305 Unable to store
RC_NO_BUILD_RIGHTS 310 No build rights
RC_OUT_OF_MEMORY 400 Out of memory
RC_NULL_POINTER 403 Null pointer
RC_UNABLE_TO_CONTACT_WORLD 405 Unable to contact world
RC_INVALID_WORLD_NAME 406 Invalid world name
RC_SEND_FAILED 415 Send failed
RC_RECEIVE_FAILED 416

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.

RC_STREAM_EMPTY 421 Stream empty
RC_STREAM_MESSAGE_TOO_LONG 422 Stream message too long
RC_WORLD_NAME_TOO_LONG 423 World name too long
RC_MESSAGE_TOO_LONG 426 Message too long
RC_UNABLE_TO_CREATE_SOCKET 428 Unable to create socket
RC_UNABLE_TO_CONNECT 429 Unable to connect
RC_UNABLE_TO_SET_NONBLOCKING 430 Unable to set nonblocking
RC_CANT_OPEN_STREAM 434 Can't open stream
RC_CANT_WRITE_STREAM 435 Can't write stream
RC_CANT_CLOSE_STREAM 436 Can't close stream
RC_UNABLE_TO_INITIALIZE_NETWORK 442 Unable to initialize network
RC_INCORRECT_MESSAGE_LENGTH 443 Incorrect message length
RC_OUT_BUFFER_FULL 446 Out buffer full
RC_INVALID_CALLBACK 447 Invalid callback
RC_IN_BUFFER_FULL 461 In buffer full
RC_PROTOCOL_ERROR 463 Protocol error
RC_NO_STREAM 473 No stream
RC_OLD_UNIVERSE 487

Old universe

Universe is too outdated to be compatible.

RC_OLD_WORLD 488

Old world

World is too outdated to be compatible.

RC_WORLD_NOT_RUNNING 489

World not running

Unable to stop a world that is not running.

Not used by the SDK

Reason codeValueDescription
RC_UNABLE_TO_MAIL_BACK_NUMBER 14 Unable to mail back number
RC_IDENTITY_ALREADY_IN_USE 39 Identity already in use
RC_UNABLE_TO_REPORT_LOCATION 40 Unable to report location
RC_INVALID_EMAIL 41 Invalid email
RC_UNIVERSE_FULL 45 Universe full
RC_BILLING_TIMEOUT 46 Billing timeout
RC_BILLING_RECV_FAILED 47 Billing recv failed
RC_BILLING_RESPONSE_INVALID 48 Billing response invalid
RC_BILLING_REJECTED 55 Billing rejected
RC_BILLING_BLOCKED 56 Billing blocked
RC_BETA_REQUIRED 79 Beta required
RC_INVALID_USER_COUNT 81 Invalid user count
RC_PRIVATE_WORLD 91 Private world
RC_NO_TOURISTS 92 No tourists
RC_CANT_CHANGE_OWNER 211 Can't change owner
RC_JOIN_REFUSED 250 Join refused
RC_TOO_MANY_RESETS 427 Too many resets
RC_UNABLE_TO_REGISTER_RESOLVE 452 Unable to register resolve
RC_WORLD_FULL 465 World full
RC_UNABLE_TO_BIND 468 Unable to bind
RC_UNABLE_TO_LISTEN 469 Unable to listen
RC_UNABLE_TO_ACCEPT 470 Unable to accept
RC_EMAIL_CHANGE_NOT_ALLOWED 525 Email change not allowed
RC_NAME_CHANGE_NOT_ALLOWED 526 Name change not allowed
RC_EMAIL_ALREADY_USED 527 Email already used
RC_EMAIL_NOT_ALLOWED 528 Email not allowed
RC_WORLD_REDIRECT 529

World redirect

TODO: Is this ever used in the SDK?