Adding Verbs to Word Lists
Verb word lists map player input to entity handlers (OnLook, OnTouch, etc.).
Adding a Verb
Run the script from the project root:
./scripts/add_verb.py --action ACTION --verb VERB
Valid actions: Auto-discovered from data/verbs/on_*.txt files. Run ./scripts/add_verb.py --help to see current options.
Example: ./scripts/add_verb.py --action on_attack --verb pummel
Rules
- No duplicates: A verb can only exist in ONE file across all word lists
- Lowercase: All verbs are stored lowercase
- Auto-sorted: Files are automatically kept alphabetically sorted (Python default sort)
- One per line: Each verb on its own line
- Multi-word verbs: Supported (e.g., "log in", "log out")
Files
Word lists are in data/verbs/:
on_look.txt - examine, inspect, look, peer, etc.
on_touch.txt - feel, poke, prod, touch, etc.
on_attack.txt - attack, hit, smash, strike, etc.
on_use.txt - activate, operate, use, etc.
on_take.txt - grab, pick, take, etc.
on_open.txt - open, login, access, boot, etc.
on_close.txt - close, logout, disconnect, etc.
on_drop.txt - drop, etc.
Validation
Run just verbs to check for duplicates across all files.
1---2name: add-verb3description: Add synonyms to verb word lists. Use when adding verbs/synonyms for MUD actions like look, touch, attack, use, take, open, close, or drop.4---56# Adding Verbs to Word Lists78Verb word lists map player input to entity handlers (`OnLook`, `OnTouch`, etc.).910## Adding a Verb1112Run the script from the project root:1314```bash15./scripts/add_verb.py --action ACTION --verb VERB16```1718**Valid actions**: Auto-discovered from `data/verbs/on_*.txt` files. Run `./scripts/add_verb.py --help` to see current options.1920**Example**: `./scripts/add_verb.py --action on_attack --verb pummel`2122## Rules23241. **No duplicates**: A verb can only exist in ONE file across all word lists252. **Lowercase**: All verbs are stored lowercase263. **Auto-sorted**: Files are automatically kept alphabetically sorted (Python default sort)274. **One per line**: Each verb on its own line285. **Multi-word verbs**: Supported (e.g., "log in", "log out")2930## Files3132Word lists are in `data/verbs/`:33- `on_look.txt` - examine, inspect, look, peer, etc.34- `on_touch.txt` - feel, poke, prod, touch, etc.35- `on_attack.txt` - attack, hit, smash, strike, etc.36- `on_use.txt` - activate, operate, use, etc.37- `on_take.txt` - grab, pick, take, etc.38- `on_open.txt` - open, login, access, boot, etc.39- `on_close.txt` - close, logout, disconnect, etc.40- `on_drop.txt` - drop, etc.4142## Validation4344Run `just verbs` to check for duplicates across all files.