Passa al contenuto principale

Word Chain

Word-association game (Szólánc / letzter-Buchstabe-Spiel) where each new word must start with the last letter of the previous word.

Catena di parole
Ogni nuova parola deve iniziare con l'ultima lettera della precedente
This module is currently only available to users with Early-Access.
This module is storing data in your bot's database.
This module creates one top-level Slash-Command on your server.
This module has 2 configuration files.
This module is being actively used on over 100 other servers on SCNX.
This module is included for free in every plan. Learn more about prices.

Features

  • Designate one or more channels as word-chain channels where members build a chain of words.
  • Configurable minimum word length to discourage trivial submissions.
  • Optional "no repeats" rule: a word can only appear once per chain.
  • Optional German ß ↔ ss equivalence: when enabled, a trailing ß is treated as equivalent to ss for last-letter matching.
  • Optional restart-on-wrong-word: any invalid input resets the chain (otherwise the invalid message is removed and the chain continues).
  • Anti-double-post protection: by default, a user cannot post two words in a row.
  • Deletion protection: if a user deletes their last accepted word, the bot reposts it together with the required next-letter so the chain stays clear.
  • Configurable success reaction with optional auto-removal after 5 seconds.
  • Optional channel topic that updates after every accepted word with the last word, the required next letter, and the current chain length.
  • Optional strike system that can restrict access for users who repeatedly post invalid messages.
  • Milestones that reward users with roles or messages after contributing a configurable number of words to a single chain.

Setup

  1. Enable the module in your SCNX dashboard.
  2. In the configuration, add at least one channel to the "Channels" list.
  3. The bot needs the "Send Messages", "Add Reactions", "Manage Messages", and "Manage Channels" permissions in the configured channels (the last one is required for the channel topic feature).
  4. Optionally configure a moderator role - members with this role (or with the "Manage Messages" permission, if no role is set) can run the /word-chain reset command.

Usage

In a configured chain channel, members send single words. Each new word must start with the last letter of the previous accepted word. The bot reacts with the configured success emoji to confirm the word was accepted, and optionally updates the channel topic with the required next letter. Invalid messages (wrong starting letter, too short, repeated, double-post by the same user, ...) are either removed (and the user shown a brief hint) or - if "Restart chain when a user posts an invalid word?" is enabled - cause the chain to reset.

Commands

Understand the documentation
In these docs, name:<Type> is an option of a slash-command with name name and the type Type. Options that not required, are described as [name:<Type>]. If the action of a command is vastly different between required and not-required options, we might list them separately.
Examples
  • /moderate ban user:<Member>: This command (/moderate ban) has an required option with the name "user" that only accepts one member as a value.
  • /moderate ban victim:<Member> reason:<Text>: This command (/moderate ban) has an required option with the name "victim" that only accepts one member as a value and another required option with the name "reason" that accepts any text as an value.
  • /moderate ban victim:<Member> reason:<Text> [proof:<Attachment>]: This command (/moderate ban) has an required option with the name "victim" that only accepts one member as a value, another required option with the name "reason" that accepts any text as an value and a not-required option with the name "proof" which allows one attachment as its value.
CommandDescription
/word-chain statusShows the last word, the required next letter, the current chain length, and the longest chain so far (ephemeral).
/word-chain statsShows a top-15 contributor leaderboard for the active chain plus the longest-chain record (ephemeral).
/word-chain reset [reason:<Text>]Moderator-only. Resets the chain back to an empty state. The optional reason is included in the public reset message.

Configuration

In this configuration file, you can configure the Word Chain game. Open it in your dashboard.

FieldDescription
ChannelsChannels in which the Word Chain game runs.
Minimum word lengthMinimum number of letters a word must have to be accepted.
Allow repeated words?If disabled, a word can only appear once per chain.
Treat ß and ss as equivalent (German only)If enabled, a trailing ß is treated as equivalent to ss for last-letter matching.
Moderator roleRole required to run /word-chain reset. Leave empty to require the "Manage Messages" permission.
Success-ReactionThe emoji the bot reacts with when a valid word is accepted.
Remove reactions after 5 seconds?If enabled, the success reaction is removed after 5 seconds to keep the channel clean.
Only one continuous message per userIf enabled, users cannot post two words in a row.
Message on wrong inputSent when a user provides invalid input (auto-deleted after 8 seconds).
Restart chain when a user posts an invalid word?If enabled, any invalid input resets the chain.
Message when chain resetsOnly visible if the option above is enabled. Sent in the channel when the chain resets due to an invalid word.
Protect against users deleting the last word?If enabled, the bot reposts the last accepted word if its message gets deleted.
Deletion protection messageOnly visible if deletion protection is enabled. Sent when a user deletes the last accepted word.
Restrict users who repeatedly post invalid messages?If enabled, users who reach the configured threshold of wrong messages are restricted (either by removing their "Send Messages" permission or by adding a strike role).
Amount of wrong messages to trigger actionOnly visible if strikes are enabled. Wrong messages a user has to send to trigger restriction.
Give role on action, instead of removing permissionOnly visible if strikes are enabled. If enabled, the strike role is added instead of removing the "Send Messages" permission.
Role given when strike threshold reachedOnly visible if the option above is enabled. The role given to users when they reach the strike threshold.
Message when user gets actionedOnly visible if strikes are enabled. The message sent when a user reaches the configured strike count.
Channel topic template (leave blank to disable)Channel topic set after each accepted word. Available placeholders: %lastword%, %nextletter%, %count%.

Milestones

In this configuration file, you can set up milestones to reward users for contributing words to a single chain. Open it in your dashboard.

FieldDescription
Word countThe number of accepted words a user must contribute in a single chain to reach this milestone.
RolesRoles given to the user when they reach this milestone (optional).
MessageA congratulatory message sent when the user reaches this milestone (auto-deleted after 10 seconds).

Troubleshooting

The bot is not reacting to messages in the chain channel
  • Make sure the channel is added to the "Channels" list in the configuration.
  • Make sure the bot has the "Add Reactions", "Send Messages", and "Manage Messages" permissions in the channel.
Valid-looking words are being rejected
  • Check that the word starts with the correct letter - run /word-chain status to see the required next letter.
  • Make sure the word meets the configured minimum length.
  • If "Allow repeated words?" is disabled, the word may already have been used in this chain.
  • For German chains: enable the "Treat ß and ss as equivalent" option if you want words like "Fluss" to follow "weiß".

Stored data

The following data is being stored about every chain channel:

  • The channel ID
  • The list of words used in the current chain (for the "no repeats" check)
  • The most recent accepted word and the user who posted it
  • A count of accepted words per contributing user
  • The current chain length and the longest-ever chain length
  • Timestamps for when the chain started and when the last word was added

To remove all data stored by this module, purge the module database.

Need more help?
Can't find what you're looking for? Our team is happy to help.