gist/matrix/m.room.join_rules/README.md

<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->

- [m.room.join_rules](#mroomjoin_rules)
  - [knocking](#knocking)
  - [membership of another room](#membership-of-another-room)
    - [merging knocking and membership of another room](#merging-knocking-and-membership-of-another-room)
  - [Note to self](#note-to-self)
  - [See also](#see-also)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->

# m.room.join_rules

Controls who can join the room. This is best to configure in room settings.

## knocking

Requires room version 7

```json
{
  "join_rule": "knock"
}
```

## membership of another room

Requires room version <del>8</del> 9. Offers only Spaces in room settings

```json
{
  "allow": [
    {
      "room_id": "!whatever:example.net",
      "type": "m.room_membership"
    }
  ],
  "join_rule": "restricted"
}
```

It can be assumed that multiple spaces is simply copying that more,
see below (with exception of `join_rule`)

### merging knocking and membership of another room

Practically the same, but requires room version 10 and new `join_rule` known as
`knock_restricted`

```json
{
  "allow": [
    {
      "room_id": "!ddFNqIRUacwdicInJz:feneas.org",
      "type": "m.room_membership"
    },
    {
      "room_id": "!fGtopoZuCySnTsSdsU:matrix.org",
      "type": "m.room_membership"
    },
    {
      "room_id": "!IVRSynLjDUQRVOHnbE:pikaviestin.fi",
      "type": "m.room_membership"
    },
    {
      "room_id": "!ruWhXaXgrPjaSSecvb:matrix.org",
      "type": "m.room_membership"
    },
    {
      "room_id": "!watercooler-v10:maunium.net",
      "type": "m.room_membership"
    },
    {
      "room_id": "!etDMqntYVqugEClPcE:artemislena.eu",
      "type": "m.room_membership"
    },
    {
      "room_id": "!KMbEUhVQHLwZHmwzKX:matrix.org",
      "type": "m.room_membership"
    },
    {
      "room_id": "!rCWNvpCTZHQkiRYUDE:matrix.org",
      "type": "m.room_membership"
    },
    {
      "room_id": "!AUKUBkWpbVaNhXJhuD:vi.fi",
      "type": "m.room_membership"
    },
    {
      "room_id": "!MHqztrxnQriEOyNLjW:pirateriot.net",
      "type": "m.room_membership"
    },
    {
      "room_id": "!WDaMZSVinTZRLOTajM:hacklab.fi",
      "type": "m.room_membership"
    },
    {
      "room_id": "!IwPxifXSjBLghpVEMh:matrix.org",
      "type": "m.room_membership"
    },
    {
      "room_id": "!iQaStEQNwaqxQfyhZi:sorunome.de",
      "type": "m.room_membership"
    },
    {
      "room_id": "!ESKEvwumMpSRZTnJOI:pikaviestin.fi",
      "type": "m.room_membership"
    },
    {
      "room_id": "!azROMLeGEMPdbdWnbk:matrix.org",
      "type": "m.room_membership"
    }
  ],
  "join_rule": "knock_restricted"
}
```

## Note to self

- `!fGtopoZuCySnTsSdsU:matrix.org` - eu.aminda.space v10
- `!ruWhXaXgrPjaSSecvb:matrix.org` - aminda.eu v10
- `!IVRSynLjDUQRVOHnbE:pikaviestin.fi` - Nova Fervoro v10
- `!watercooler-v10:maunium.net` - WaterDuck v10
- `!etDMqntYVqugEClPcE:artemislena.eu` - Community Moderation Effort v9
- `!KMbEUhVQHLwZHmwzKX:matrix.org` - Matrix Haters v9
- `!rCWNvpCTZHQkiRYUDE:matrix.org` - Matrix.fi v5
- `!AUKUBkWpbVaNhXJhuD:vi.fi` - Olohuone v6
- `!MHqztrxnQriEOyNLjW:pirateriot.net` - GlobalPirates v10
- `!WDaMZSVinTZRLOTajM:hacklab.fi` - Matrix Suomi (Space) v6
- `!IwPxifXSjBLghpVEMh:matrix.org` - FluffyChat (room) v5
- `!iQaStEQNwaqxQfyhZi:sorunome.de` - FluffyChat Space v6
- `!ESKEvwumMpSRZTnJOI:pikaviestin.fi` - Piraattipuolue v10
- `!azROMLeGEMPdbdWnbk:matrix.org` - Piraattipuolueen työrauha v9

## See also

- `m.room.history_visibility`