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.
Wortkette
Jedes neue Wort muss mit dem letzten Buchstaben des vorherigen beginnen.
Dieses Modul ist aktuell nur für Nutzer mit Early-Access verfügbar.
Dieses Modul speichert Daten in der Datenbank deines Bots.
Dieses Modul erstellt einen Haupt-Slash-Befehl auf deinem Server.
Dieses Modul hat 2 Konfigurationsdateien.
Dieses Modul wird auf über 100 Servern auf SCNX aktiv verwendet.
Dieses Modul ist bei jedem Plan kostenlos dabei. Mehr über Preise erfahren.
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 tossfor 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
- Enable the module in your SCNX dashboard.
- In the configuration, add at least one channel to the "Channels" list.
- 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).
- 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 resetcommand.
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
Dokumentation Verstehen
In dieser Dokumentation bezeichnen wir eine verpflichtende Slash-Befehl-Option mit dem Namen
name und dem Typen Typ als name:<Typ>. Optionen, die nicht Pflichtfelder sind, werden als [name:<Typ>] angegeben. Wenn sich die Aktionen eines Befehls zwischen Pflichtfeldern und Nicht-Pflichtfeldern sehr unterscheiden, listen wir sie eventuell separat.Beispiele
/moderate ban user:<Mitglied>: Dieser Befehl (/moderate ban) hat nur eine verpflichtende Option mit dem Namen "user", die nur ein Mitglied akzeptiert./moderate ban victim:<Mitglied> reason:<Text>: Dieser Befehl (/moderate ban) hat eine Option mit dem Namen "victim" als Pflichtangabe, die nur ein Mitglied akzeptiert, und ein weiteres Pflichtfeld mit dem Namen "reason", das jeglichen Text als Wert akzeptiert./moderate ban victim:<Mitglied> reason:<Text> [proof:<Anhang>]: Dieser Befehl (/moderate ban) hat eine Option mit dem Namen "victim" als Pflichtangabe, die nur ein Mitglied akzeptiert, und ein weiteres Pflichtfeld mit dem Namen "reason", das jeglichen Text als Wert akzeptiert. Zusätzlich gibt es eine optionale Option mit dem Namen "proof", die einen Anhang als Wert akzeptiert.
| Command | Description |
|---|---|
/word-chain status | Shows the last word, the required next letter, the current chain length, and the longest chain so far (ephemeral). |
/word-chain stats | Shows 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.
| Field | Description |
|---|---|
| Channels | Channels in which the Word Chain game runs. |
| Minimum word length | Minimum 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 role | Role required to run /word-chain reset. Leave empty to require the "Manage Messages" permission. |
| Success-Reaction | The 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 user | If enabled, users cannot post two words in a row. |
| Message on wrong input | Sent 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 resets | Only 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 message | Only 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 action | Only visible if strikes are enabled. Wrong messages a user has to send to trigger restriction. |
| Give role on action, instead of removing permission | Only visible if strikes are enabled. If enabled, the strike role is added instead of removing the "Send Messages" permission. |
| Role given when strike threshold reached | Only visible if the option above is enabled. The role given to users when they reach the strike threshold. |
| Message when user gets actioned | Only 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.
| Field | Description |
|---|---|
| Word count | The number of accepted words a user must contribute in a single chain to reach this milestone. |
| Roles | Roles given to the user when they reach this milestone (optional). |
| Message | A 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 statusto 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.
Brauchst du mehr Hilfe?
Findest du nicht, wonach du suchst? Unser Team hilft dir gerne.