mirror of
https://github.com/matrix-org/mjolnir.git
synced 2024-10-01 01:36:06 -04:00
109 lines
4.4 KiB
YAML
109 lines
4.4 KiB
YAML
# Where the homeserver is located (client-server URL). This should point at
|
|
# pantalaimon if you're using that.
|
|
homeserverUrl: "https://matrix.org"
|
|
|
|
# The access token for the bot to use. Do not populate if using Pantalaimon.
|
|
accessToken: "YOUR_TOKEN_HERE"
|
|
|
|
# Pantalaimon options (https://github.com/matrix-org/pantalaimon)
|
|
pantalaimon:
|
|
# If true, accessToken above is ignored and the username/password below will be
|
|
# used instead. The access token of the bot will be stored in the dataPath.
|
|
use: false
|
|
|
|
# The username to login with.
|
|
username: mjolnir
|
|
|
|
# The password to login with. Can be removed after the bot has logged in once and
|
|
# stored the access token.
|
|
password: your_password
|
|
|
|
# The directory the bot should store various bits of information in
|
|
dataPath: "/data/storage"
|
|
|
|
# If true (the default), only users in the `managementRoom` can invite the bot
|
|
# to new rooms.
|
|
autojoinOnlyIfManager: true
|
|
|
|
# If `autojoinOnlyIfManager` is false, only the members in this group can invite
|
|
# the bot to new rooms.
|
|
acceptInvitesFromGroup: '+example:example.org'
|
|
|
|
# If the bot is invited to a room and it won't accept the invite (due to the
|
|
# conditions above), report it to the management room. Defaults to disabled (no
|
|
# reporting).
|
|
recordIgnoredInvites: false
|
|
|
|
# The room ID where people can use the bot. The bot has no access controls, so
|
|
# anyone in this room can use the bot - secure your room!
|
|
# This should be a room alias or room ID - not a matrix.to URL.
|
|
# Note: Mjolnir is fairly verbose - expect a lot of messages from it.
|
|
managementRoom: "#moderators:example.org"
|
|
|
|
# Set to false to make the management room a bit quieter.
|
|
verboseLogging: true
|
|
|
|
# The log level for the logs themselves. One of DEBUG, INFO, WARN, and ERROR.
|
|
# This should be at INFO or DEBUG in order to get support for Mjolnir problems.
|
|
logLevel: "INFO"
|
|
|
|
# Set to false to disable synchronizing the ban lists on startup. If true, this
|
|
# is the same as running !mjolnir sync immediately after startup.
|
|
syncOnStartup: true
|
|
|
|
# Set to false to prevent Mjolnir from checking its permissions on startup. This
|
|
# is recommended to be left as "true" to catch room permission problems (state
|
|
# resets, etc) before Mjolnir is needed.
|
|
verifyPermissionsOnStartup: true
|
|
|
|
# If true, Mjolnir won't actually ban users or apply server ACLs, but will
|
|
# think it has. This is useful to see what it does in a scenario where the
|
|
# bot might not be trusted fully, yet. Default false (do bans/ACLs).
|
|
noop: false
|
|
|
|
# Set to true to use /joined_members instead of /state to figure out who is
|
|
# in the room. Using /state is preferred because it means that users are
|
|
# banned when they are invited instead of just when they join, though if your
|
|
# server struggles with /state requests then set this to true.
|
|
fasterMembershipChecks: false
|
|
|
|
# A case-insensitive list of ban reasons to automatically redact a user's
|
|
# messages for. Typically this is useful to avoid having to type two commands
|
|
# to the bot. Use asterisks to represent globs (ie: "spam*testing" would match
|
|
# "spam for testing" as well as "spamtesting").
|
|
automaticallyRedactForReasons:
|
|
- "spam"
|
|
- "advertising"
|
|
|
|
# A list of rooms to protect (matrix.to URLs)
|
|
protectedRooms:
|
|
- "https://matrix.to/#/#yourroom:example.org"
|
|
|
|
# Set this option to true to protect every room the bot is joined to. Note that
|
|
# this effectively makes the protectedRooms and associated commands useless because
|
|
# the bot by nature must be joined to the room to protect it.
|
|
#
|
|
# Note: the management room is *excluded* from this condition. Add it to the
|
|
# protected rooms to protect it.
|
|
#
|
|
# Note: ban list rooms the bot is watching but didn't create will not be protected.
|
|
# Manually add these rooms to the protected rooms list if you want them protected.
|
|
protectAllJoinedRooms: false
|
|
|
|
# Misc options for command handling and commands
|
|
commands:
|
|
# If true, Mjolnir will respond to commands like !help and !ban instead of
|
|
# requiring a prefix. This is useful if Mjolnir is the only bot running in
|
|
# your management room.
|
|
#
|
|
# Note that Mjolnir can be pinged by display name instead of having to use
|
|
# the !mjolnir prefix. For example, "my_moderator_bot: ban @spammer:example.org"
|
|
# will ban a user.
|
|
allowNoPrefix: false
|
|
|
|
# In addition to the bot's display name, !mjolnir, and optionally no prefix
|
|
# above, the bot will respond to these names. The items here can be used either
|
|
# as display names or prefixed with exclamation points.
|
|
additionalPrefixes:
|
|
- "mjolnir_bot"
|