View source for Chat commands

The commands for the [[The chat room|ScotMesh chat]]. Send them in the RRC room or as a message to the LXMF group (<code>625ad393ca4df62a1382f9d936322a0a</code>). The reply goes only to you: over RRC it arrives as a notice, and over LXMF as a message from the group.

<code>/help</code> lists the commands where you are, and <code>/help nick</code> explains one.

== Everyone ==

{| class="wikitable"
! Command !! What it does
|-
| <code>/help [command]</code> || Lists the commands, or explains one.
|-
| <code>/whoami</code> || Shows your name, identity and settings, and where you are connected.
|-
| <code>/nick Name</code> || Takes a name. Your old one is freed.
|-
| <code>/leave</code> || Frees your name and leaves the LXMF group.
|-
| <code>/who</code> || Shows who is here, on RRC and in the LXMF group.
|-
| <code>/history 20</code> || Shows earlier messages, up to 100, at most one request every 15 seconds.
|-
| <code>/topic</code> || Shows the room topic.
|}

== LXMF group ==

{| class="wikitable"
! Command !! What it does
|-
| <code>/join [Name]</code> || Joins the group, optionally with a name. With no name it uses the display name your app announces. You get the last 10 messages to start with.
|-
| <code>/lxmf on</code> || Gets every message. This is the default.
|-
| <code>/lxmf off</code> || Stops group messages. You keep your name and your place in the group.
|-
| <code>/lxmf auto</code> || Pauses group messages while you are in the room over RRC, and starts them again when you leave.
|-
| <code>/lxmf mine on</code> or <code>off</code> || Chooses whether you also get your own messages sent from RRC or the page.
|-
| <code>/pause</code>, <code>/resume</code> || The same as <code>/lxmf off</code> and <code>/lxmf on</code>.
|-
| <code>/me waves</code> || Sends an action: <code>* Name waves</code>.
|}

The <code>/lxmf</code> settings also work from the RRC room. On the chat page they are under '''Your name &amp; settings'''.

== RRC rooms ==

Your RRC client sends joining and leaving itself. These are the hub's own room commands; <code>&lt;room&gt;</code> is the room name, such as <code>scotmesh</code>.

{| class="wikitable"
! Command !! What it does
|-
| <code>/join newroom</code> || Joins a room, or creates it if nobody is in it. You become its founder.
|-
| <code>/list</code> || Lists registered rooms and their topics.
|-
| <code>/who [room]</code> || Shows who is in a room.
|-
| <code>/topic &lt;room&gt; [text]</code> || Shows the topic, or sets it (only operators can if the room is <code>+t</code>).
|-
| <code>/register &lt;room&gt;</code> || The founder keeps the room even when it is empty. It also sets <code>+n</code> and <code>+t</code>.
|-
| <code>/unregister &lt;room&gt;</code> || The founder undoes <code>/register</code>.
|}

== Room operators ==

The founder of a room and anyone they make an operator.

{| class="wikitable"
! Command !! What it does
|-
| <code>/op &lt;room&gt; Name</code>, <code>/deop</code> || Makes someone an operator, or removes it.
|-
| <code>/voice &lt;room&gt; Name</code>, <code>/devoice</code> || Lets someone speak in a moderated (<code>+m</code>) room, or removes it.
|-
| <code>/kick &lt;room&gt; Name</code> || Removes someone from the room. They can come back.
|-
| <code>/ban &lt;room&gt; add Name</code> || Bans someone from the room. <code>del</code> lifts it and <code>list</code> shows the bans.
|-
| <code>/invite &lt;room&gt; add Name</code> || Invites someone to an invite-only or keyed room for 15 minutes.
|-
| <code>/mode &lt;room&gt; +m</code> || Sets a room mode. See below.
|}

Over LXMF the room is always <code>scotmesh</code>, so leave it out: <code>/kick Name</code>, <code>/ban add Name</code>.

{| class="wikitable"
! Mode !! Meaning
|-
| <code>+i</code> || Invite only.
|-
| <code>+k key</code> || A key is needed to join; <code>-k</code> removes it.
|-
| <code>+m</code> || Moderated: only operators and voiced people can speak.
|-
| <code>+n</code> || No messages from people not in the room.
|-
| <code>+p</code> || Private: left out of <code>/list</code>, and <code>/who</code> is refused.
|-
| <code>+t</code> || Only operators can change the topic.
|}

== Hub operators ==

{| class="wikitable"
! Command !! What it does
|-
| <code>/kline add Name [reason]</code> || Bans an identity from the whole hub and disconnects it everywhere. <code>del</code> lifts it and <code>list</code> shows the bans.
|-
| <code>/release Name</code> || Frees a name someone holds. They are told.
|-
| <code>/stats</code> || Shows the hub's counters.
|}

== Naming someone ==

Where a command takes a name, you can give:
* their name (lookalikes match, so <code>rab</code> finds <code>Rab</code>);
* their guest name, such as <code>guest-2af3</code>;
* six or more characters of their identity hash;
* the whole 32-character hash.

If several people match, the hub lists them and asks for a longer hash.

== NomadNet ==

NomadNet's RRC screen handles slash commands itself. <code>/help</code> there shows NomadNet's own list, and <code>/nick</code> sets the name NomadNet sends. It passes only these to the hub:

<code>/who /names /topic /mode /kick /ban /invite /op /deop /voice /devoice /register /unregister /kline /stats</code>

For anything else (<code>/whoami</code>, <code>/lxmf</code>, <code>/history</code>, <code>/leave</code> to free your name), message the LXMF group, or use '''Your name &amp; settings''' on the chat page. In NomadNet, <code>/leave</code> on the RRC screen leaves the room; it doesn't free your name.

MeshChatX passes every command to the hub.

[[Category:The ScotMesh Backbone]]