Room Settings

Room configuration, rights management, bans, mutes, word filter, floor plan editor, and room rollers.

C→S 3129 - RequestRoomSettings

Nitro: ROOM_SETTINGS

Source: RequestRoomSettingsEvent, RoomSettingsComposer

Requests the full settings data for a room, sent when the owner opens the room settings panel.

Body: (empty)

C→S 1969 - RoomSettingsSave

Nitro: ROOM_SETTINGS_SAVE

Source: RoomSettingsSaveEvent, SaveRoomSettingsComposer

Submits updated room settings (name, description, access mode, capacity, chat rules, etc.) to the server.

Body:
  roomId: int
  name: string
  description: string
  readInt: int
  password: string
  usersMax: int
  categoryId: int
  readInt: int
  tag: string
  readInt: int
  readBoolean: boolean
  readBoolean: boolean
  readBoolean: boolean
  readBoolean: boolean
  readInt: int
  readInt: int
  readInt: int
  readInt: int
  readInt: int
  readInt: int
  readInt: int
  readInt: int
  readInt: int

C→S 2300 - RequestRoomHeightmap

Nitro: ROOM_MODEL

Source: RequestRoomHeightmapEvent, GetRoomEntryDataMessageComposer

Requests the room heightmap and entry data when entering a room.

Body: (empty)

C→S 1687 - FloorPlanEditorRequestBlockedTiles

Nitro: GET_OCCUPIED_TILES

Source: FloorPlanEditorRequestBlockedTilesEvent, GetOccupiedTilesMessageComposer

Requests the list of permanently blocked (non-walkable) tiles for the floor plan editor.

Body: (empty)

C→S 3559 - FloorPlanEditorRequestDoorSettings

Nitro: GET_ROOM_ENTRY_TILE

Source: FloorPlanEditorRequestDoorSettingsEvent, GetRoomEntryTileMessageComposer

Requests the current door tile position and direction for the floor plan editor.

Body: (empty)

C→S 875 - FloorPlanEditorSave

Nitro: ROOM_MODEL_SAVE

Source: FloorPlanEditorSaveEvent, UpdateFloorPropertiesMessageComposer

Submits a new floor plan layout (tile map, door position, wall and floor thickness) to the server.

Body:
  map: string
  doorX: int
  doorY: int
  doorRotation: int
  wallSize: int
  floorSize: int

C→S 3385 - RequestRoomRights

Nitro: ROOM_RIGHTS_LIST

Source: RequestRoomRightsEvent, RoomUsersWithRightsComposer

Requests the list of users who have been granted rights in the current room.

Body: (empty)

C→S 2683 - RoomRemoveAllRights

Nitro: ROOM_RIGHTS_REMOVE_ALL

Source: RoomRemoveAllRightsEvent, RemoveAllRightsMessageComposer

Removes room rights from all users at once, sent by the room owner.

Body: (empty)

C→S 3182 - RoomRemoveRights

Nitro: ROOM_RIGHTS_REMOVE_OWN

Source: RoomRemoveRightsEvent, RemoveOwnRoomRightsRoomMessageComposer

Removes the current user's own rights from a room they no longer want to manage.

Body: (empty)

C→S 2267 - RoomRequestBannedUsers

Nitro: ROOM_BAN_LIST

Source: RoomRequestBannedUsersEvent, RoomBannedUsersComposer

Requests the list of users currently banned from a room, sent when the owner opens the ban list.

Body: (empty)

C→S 1477 - RoomUserBan

Nitro: ROOM_BAN_GIVE

Source: RoomUserBanEvent, RoomBanUserComposer

Bans a user from the room for a specified duration, sent by the room owner or a rights holder.

Body:
  userId: int
  roomId: int

C→S 992 - UnbanRoomUser

Nitro: ROOM_BAN_REMOVE

Source: UnbanRoomUserEvent, RoomUnbanUserComposer

Removes a ban for a specific user from the room's ban list.

Body:
  userId: int

C→S 3485 - RoomUserMute

Nitro: ROOM_MUTE_USER

Source: RoomUserMuteEvent, RoomMuteUserComposer

Mutes a user in the room for a specified number of minutes, sent by the room owner or a rights holder.

Body:
  userId: int
  roomId: int

C→S 3637 - RoomMute

Nitro: ROOM_MUTE

Source: RoomMuteEvent, RoomMuteComposer

Toggles the room-wide mute state, silencing all non-moderator chat in the room.

Body: (empty)

C→S 1911 - RequestRoomWordFilter

Nitro: ROOM_FILTER_WORDS

Source: RequestRoomWordFilterEvent, GetCustomRoomFilterMessageComposer

Requests the room's custom word filter list, sent when the owner opens the word filter settings.

Body: (empty)

C→S 3001 - RoomWordFilterModify

Nitro: ROOM_FILTER_WORDS_MODIFY

Source: RoomWordFilterModifyEvent, UpdateRoomFilterMessageComposer

Adds or removes a word from the room's custom word filter.

Body:
  roomId: int
  add: boolean

C→S 143 - VoteForRoom

Nitro: VOTE_FOR_ROOM Note: No Arcturus handler - Nitro only. Source: VoteForRoomMessageComposer

Field	Type	Notes
k	string	Unknown vote/competition identifier

Casts a like/vote for the current room.

C→S 314 - ConvertGlobalRoomId

Nitro: CONVERT_GLOBAL_ROOM_ID Note: No Arcturus handler - Nitro only. Source: ConvertGlobalRoomIdMessageComposer

Field	Type	Notes
flatId	string	Global/legacy room ID string to convert to a local room ID

Requests conversion of a global (cross-server) room ID to a local room ID.

C→S 1265 - RoomSettingsUpdateRoomCategoryAndTrade

Nitro: ROOM_SETTINGS_UPDATE_ROOM_CATEGORY_AND_TRADE Note: No Arcturus handler - Nitro only. Source: UpdateRoomCategoryAndTradeSettingsComposer

Field	Type	Notes
k	int	New room category ID
_arg_2	int	Trade settings value
_arg_3	int	Unknown int

Updates the room's navigator category and trade mode setting.

C→S 2468 - UpdateRoomThumbnail

Nitro: UPDATE_ROOM_THUMBNAIL Note: No Arcturus handler - Nitro only. Source: UpdateRoomThumbnailMessageComposer

Field	Type	Notes
flatId	int	Room ID to update thumbnail for
bgImgId	int	Background image ID
frontImgId	int	Foreground / overlay image ID
objCount	int	Number of object layers

Submits an updated room thumbnail image.

C→S 3305 - SetRoomSessionTags

Nitro: SET_ROOM_SESSION_TAGS Note: No Arcturus handler - Nitro only. Source: SetRoomSessionTagsMessageComposer

Field	Type	Notes
k	string	First session tag string
_arg_2	string	Second session tag string

Sets the current session tags for the room (used for navigator discovery).

C→S 3736 - RoomDirectoryRoomNetworkOpenConnection

Nitro: ROOM_DIRECTORY_ROOM_NETWORK_OPEN_CONNECTION Note: No Arcturus handler - Nitro only. Source: RoomNetworkOpenConnectionMessageComposer

Field	Type	Notes
k	int	Room network / room directory ID
_arg_2	int	Connection parameter / slot index

Opens a network connection for the room directory feature.

Opens a network connection for a room in the room directory. Nitro-only.

S→C 558 - RoomHeightMapUpdate

Nitro: ROOM_HEIGHT_MAP_UPDATE Source: UpdateStackHeightComposer, RoomHeightMapUpdateEvent

Field	Type	Notes
count	byte	Number of tile updates in this batch
[count × x]	byte	Tile X coordinate
[count × y]	byte	Tile Y coordinate
[count × value]	short	Encoded tile height + flags (use RoomHeightMapParser to decode)

Delivers an incremental update to the room heightmap (e.g. after a furniture placement changes walkability).

S→C 3990 - RoomModelBlockedTiles

Nitro: ROOM_MODEL_BLOCKED_TILES Source: FloorPlanEditorBlockedTilesComposer, RoomOccupiedTilesMessageEvent

Delivers blocked (non-walkable) tile positions for the floor plan editor.

Field	Type	Notes
count	int	Number of blocked tile entries
[count × x]	int	Tile X coordinate
[count × y]	int	Tile Y coordinate

Delivers the set of permanently blocked (non-walkable) tiles for the room model.

S→C 1664 - RoomModelDoor

Nitro: ROOM_MODEL_DOOR Source: FloorPlanEditorDoorSettingsComposer, RoomEntryTileMessageEvent

Delivers the entry tile coordinates for the room the client is entering.

Field	Type	Notes
x	int	Entry tile X coordinate
y	int	Entry tile Y coordinate
direction	int	Initial facing direction (0–7, multiplied by 45° = degrees)

Delivers the door tile position and direction for the room model.

S→C 3547 - RoomThickness

Nitro: ROOM_THICKNESS Source: RoomThicknessComposer, RoomVisualizationSettingsEvent

Field	Type	Notes
hideWalls	boolean	Whether walls are hidden
thicknessWall	int	Raw wall thickness value (-2 to 1; decoded as 2^value)
thicknessFloor	int	Raw floor thickness value (-2 to 1; decoded as 2^value)

Delivers the wall and floor thickness settings for the current room.

S→C 3207 - RoomRolling

Nitro: ROOM_ROLLING Source: ObjectsRollingEvent

Furniture rolling/sliding physics. One roller event can carry multiple item rolls plus an optional unit roll.

Field	Type	Notes
fromX	int	Source tile X
fromY	int	Source tile Y
toX	int	Destination tile X
toY	int	Destination tile Y
itemCount	int	Number of rolling items
[itemCount × itemId]	int	Item ID
[itemCount × fromHeight]	string	Source height string
[itemCount × toHeight]	string	Destination height string
rollerId	int	Roller item ID
movementType	int	0=no unit, 1=move, 2=slide
[if movementType>0] unitId	int	Room unit ID
[if movementType>0] unitFromHeight	string	Unit source height
[if movementType>0] unitToHeight	string	Unit destination height

Notifies clients of a rolling/sliding event for a furniture item or user on a roller.

S→C 1498 - RoomSettings

Nitro: ROOM_SETTINGS Source: RoomSettingsComposer, RoomSettingsDataEvent

Full room settings data. See also S→C 1191 (ROOM_SETTINGS_CHAT) for the chat subset.

Field	Type	Notes
roomId	int	Room ID
name	string	Room name
description	string	Room description
doorMode	int	0=open, 1=doorbell, 2=password, 3=invisible
password	string	Room password (empty if not password-locked)
userLimit	int	Max users allowed
categoryId	int	Navigator category ID
tagCount	int	Number of tags
[tagCount × tag]	string	Room tag
isPublic	boolean	Whether the room is publicly listed
allowPets	boolean	Whether pets are allowed
allowPetsEat	boolean	Whether pets can eat
blockRoomWalk	boolean	Whether room entry walking is blocked
hideWalls	boolean	Whether walls are hidden
wallThickness	int	Wall thickness (-2 to 1)
floorThickness	int	Floor thickness (-2 to 1)
whoMutes	int	Who can mute: 0=owner, 1=rights, 2=all
whoKicks	int	Who can kick: 0=owner, 1=rights, 2=all
whoBans	int	Who can ban: 0=owner, 1=rights, 2=all
chatMode	int	0=free flow, 1=line by line
chatBubbleWidth	int	0=wide, 1=normal, 2=thin
chatScrollSpeed	int	0=fast, 1=normal, 2=slow
chatDistance	int	Chat hearing distance
chatFloodProtection	int	0=strict, 1=normal, 2=loose
tradeMode	int	0=no trade, 1=rights, 2=all
moveDiagonally	boolean	Whether diagonal movement is allowed

Delivers the full room settings for the settings editor panel (name, description, access, capacity, trade, etc.).

S→C 948 - RoomSettingsSave

Nitro: ROOM_SETTINGS_SAVE Source: RoomSettingsSavedComposer, RoomSettingsSavedEvent

Field	Type	Notes
roomId	int	ID of the room whose settings were saved

Confirms that room settings were saved successfully.

S→C 1555 - RoomSettingsSaveError

Nitro: ROOM_SETTINGS_SAVE_ERROR Source: RoomEditSettingsErrorComposer, RoomSettingsSaveErrorEvent

Field	Type	Notes
roomId	int	Room ID
errorCode	int	Error code (see RoomSettingsSaveErrorParser constants)
message	string	Additional error message text

Reports that saving room settings failed, with an error code.

S→C 1191 - RoomSettingsChat

Nitro: ROOM_SETTINGS_CHAT Source: RoomChatSettingsComposer, RoomChatSettingsEvent

Field	Type	Notes
mode	int	0=free flow, 1=line by line
weight	int	Bubble width: 0=wide, 1=normal, 2=thin
speed	int	Scroll speed: 0=fast, 1=normal, 2=slow
distance	int	Chat hearing distance in tiles
protection	int	Flood filter: 0=strict, 1=normal, 2=loose

Delivers the room's chat moderation settings (chat mode, flood filter, chat distance).

S→C 3297 - RoomInfoUpdated

Nitro: ROOM_INFO_UPDATED Source: RoomSettingsUpdatedComposer, RoomSettingsUpdatedEvent

Field	Type	Notes
roomId	int	Room ID whose info (name/description) was updated

Notifies clients in the room that the room info (name, description) has been updated.

S→C 1284 - RoomRightsList

Nitro: ROOM_RIGHTS_LIST Source: RoomRightsListComposer, FlatControllersEvent

Field	Type	Notes
roomId	int	Room ID
count	int	Number of rights holders
[count × userId]	int	Account ID
[count × username]	string	Username

Delivers the full list of users who have been granted room rights by the owner.

S→C 2088 - RoomRightsListAdd

Nitro: ROOM_RIGHTS_LIST_ADD Source: RoomAddRightsListComposer, FlatControllerAddedEvent

Field	Type	Notes
roomId	int	Room ID
userId	int	Account ID of the user added
username	string	Username of the user added

Notifies that a user has been added to the room rights list.

S→C 1327 - RoomRightsListRemove

Nitro: ROOM_RIGHTS_LIST_REMOVE Source: RoomRemoveRightsListComposer, FlatControllerRemovedEvent

Field	Type	Notes
roomId	int	Room ID
userId	int	Account ID of the user whose rights were removed

Notifies that a user has been removed from the room rights list.

S→C 2392 - RoomRightsClear

Nitro: ROOM_RIGHTS_CLEAR Source: RoomNoRightsComposer, RoomRightsClearEvent

(no Arcturus composer)

Sent when the user's room rights are cleared (all rights removed).

Notifies the client that all of its room rights have been cleared.

Body: (empty)

S→C 1869 - RoomBanList

Nitro: ROOM_BAN_LIST Source: RoomBannedUsersComposer, BannedUsersFromRoomEvent

Field	Type	Notes
roomId	int	Room ID
count	int	Number of banned users
[count × userId]	int	Banned user account ID
[count × username]	string	Banned username

Delivers the list of users currently banned from the room.

S→C 3429 - RoomBanRemove

Nitro: ROOM_BAN_REMOVE Source: RoomUserUnbannedComposer, UserUnbannedFromRoomEvent

Field	Type	Notes
roomId	int	Room ID
userId	int	Account ID of the un-banned user

Notifies that a user has been unbanned (removed from the room ban list).

S→C 826 - RoomMuted

Nitro: ROOM_MUTE_USER / REMAINING_MUTE

Source: MutedWhisperComposer, RemainingMuteEvent

Field	Type	Notes
isMuted	boolean	Whether the room is currently muted

Notifies the client that the user has been muted in the room (remaining mute time), used for whisper-block feedback.

S→C 2533 - RoomMuted

Nitro: ROOM_MUTED Source: RoomMutedComposer, MuteAllInRoomEvent

Sent when the room muted state changes.

Field	Type	Notes
isMuted	boolean	Whether the room is now muted (true) or unmuted (false)

Notifies clients that the room has been muted (only moderators can chat).

S→C 2937 - RoomGetFilterWords

Nitro: ROOM_GET_FILTER_WORDS Source: RoomFilterWordsComposer, RoomFilterSettingsMessageEvent

Field	Type	Notes
count	int	Number of filtered words
[count × word]	string	Filtered word

Delivers the room's custom word filter list.

S→C 482 - RoomScore

Nitro: ROOM_SCORE Source: RoomScoreComposer, RoomScoreEvent

Field	Type	Notes
totalLikes	int	Total number of likes the room has received
canLike	boolean	Whether the current user can still like the room

Delivers the current room score (like count) and whether the user can still vote.

S→C 1033 - RoomSpectator

Nitro: ROOM_SPECTATOR Source: RoomUnknown3Composer, YouAreSpectatorMessageEvent

(no Arcturus composer)

Sent to notify the client it is now in spectator mode in the current room.

Notifies the client that it is in spectator mode for the current room (view-only, no interaction).

Body: (empty)

S→C 52 - GuestRoomSearchResult

Nitro: GUEST_ROOM_SEARCH_RESULT Note: No Arcturus composer - Nitro only. Source: PrivateRoomsComposer, GuestRoomSearchResultEvent

(no Arcturus composer)

Search results for a navigator room query.

Field	Type	Notes
searchType	int	Type of search performed
searchParam	string	Search parameter string
count	int	Number of room results
[count × room]	RoomData	Room data entry (same structure as in NAVIGATOR_SEARCH_RESULT)
hasAdditional	boolean	Whether an additional official/promoted room follows
[if hasAdditional] ad	OfficialRoomEntry	Promoted room entry

Delivers the result of a legacy guest room lookup (room data for a specific room ID).

S→C 1634 - RoomMessageNotification

Nitro: ROOM_MESSAGE_NOTIFICATION Note: No Arcturus composer - Nitro only. Source: RoomMessagesPostedCountComposer, RoomMessageNotificationMessageEvent

(no Arcturus composer)

Field	Type	Notes
roomId	int	Room ID where the notification originated
roomName	string	Room name
messageCount	int	Number of unread messages in this room

Delivers a room-level notification message (e.g. from a wired action or admin broadcast).

S→C 1759 - RoomAdError

Nitro: ROOM_AD_ERROR Note: No Arcturus composer - Nitro only. Source: RoomAdErrorComposer, RoomAdErrorEvent

(no Arcturus composer)

Field	Type	Notes
errorCode	int	Ad error code
filteredText	string	Filtered/censored text that caused the error

Reports that a room advertisement purchase or submission failed.

S→C 2274 - RoomPromotionMessage

Nitro: ROOM_PROMOTION

Source: RoomPromotionMessage

Field	Type	Notes
(no promotion)	-	promotionId:int(-1), ownerId:int(-1), name:string(""), unknown×4:int(0,0,0,0), name2:string(""), desc:string(""), unknown2×3:int(0,0,0)
(with promotion)	-	promotionId:int(roomId), ownerId:int, ownerName:string, roomId:int, type:int(1), + additional fields

Notes: When the room has no active promotion, Arcturus sends a sequence of −1/0/"" placeholder values. Full promotion data includes title, description, category, and timestamps.

Delivers room promotion/event data for display in the room info panel.

S→C 2897 - RoomEditSettingsError

Nitro: ROOM_SETTINGS_ERROR

Source: RoomEditSettingsError, RoomSettingsErrorEvent

Field	Type	Notes
roomId	int	ID of the room with the settings error
errorCode	int	Error code
info	string	Error description

Reports that saving room settings failed, with a room ID and error description.

S→C 3896 - ShowEnforceRoomCategory

Nitro: SHOW_ENFORCE_ROOM_CATEGORY Note: No Arcturus composer - Nitro only. Source: RoomCategoryUpdateMessageComposer, ShowEnforceRoomCategoryDialogEvent

(no Arcturus composer)

Prompts the user to update their room category to comply with hotel rules.

Prompts the user to update their room category to comply with hotel content rules. Nitro-only.

Body: (empty)