Skip to main content

room.save_settings

Generated from spec/protocol.yaml. Do not edit by hand.

Overview

  • ID: 1969
  • Header: ROOM_SETTINGS_SAVE
  • Direction: Client to Server (c2s)
  • Realm: Room
  • Phase: session
  • Since: nitro-1.6.6
  • Summary: Save updated room settings

Payload fields

FieldTypeRequiredDescription
roomIdint32requiredID of the room.
roomNamestringrequiredRoom name.
roomDescriptionstringrequiredRoom description.
lockStateint32requiredDoor mode: 0=open, 1=doorbell, 2=password, 3=invisible.
passwordstringrequiredPassword for password-locked rooms (empty string otherwise).
userCountint32requiredMaximum number of concurrent users allowed.
categoryIdint32requiredNavigator category identifier.
tagsCountint32requiredNumber of tags that follow.
tagsstring[]requiredRoom tag strings (count given by tagsCount).
tradeStateint32requiredTrade mode: 0=disabled, 1=rights holders, 2=everyone.
allowPetsbooleanrequiredWhether visitors may bring pets into the room.
allowPetsEatbooleanrequiredWhether pets may eat room foods.
allowWalkthroughbooleanrequiredWhether avatars can walk through each other.
hideWallsbooleanrequiredWhether room walls are hidden.
wallThicknessint32requiredWall thickness level: -2 to 1.
floorThicknessint32requiredFloor thickness level: -2 to 1.
muteStateint32requiredWho can mute: 0=owner, 1=rights holders, 2=all.
kickStateint32requiredWho can kick: 0=owner, 1=rights holders, 2=all.
banStateint32requiredWho can ban: 0=owner, 1=rights holders, 2=all.
chatBubbleModeint32requiredChat bubble visual mode identifier.
chatBubbleWeightint32requiredChat bubble weight (text width) setting.
chatBubbleSpeedint32requiredChat bubble display speed.
chatDistanceint32requiredMaximum visible chat distance in tiles.
chatFloodProtectionint32requiredFlood protection level: 0=loose, 1=normal, 2=strict.

Behavior

Sender

Sent when the room owner submits the settings form. Contains all configurable room parameters.

Receiver

The server validates and persists the settings, then sends room.settings_saved (s2c 948) on success or room.settings_save_error (s2c 1555) on failure. Confirmed in GLADIATOR.

Notes

  • No additional notes