Compare commits
	
		
			2 Commits
		
	
	
		
			1.0.0
			...
			376e3ec616
		
	
	| Author | SHA1 | Date | |
|---|---|---|---|
| 376e3ec616 | |||
| 1b4a7b76df | 
							
								
								
									
										167
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										167
									
								
								README.md
									
									
									
									
									
								
							@@ -1,40 +1,139 @@
 | 
				
			|||||||
# Yapper
 | 
					# Yapper
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## World of Warcraft addon that *yaps* a given message in a given channel every now and then
 | 
					## Overview
 | 
				
			||||||
 | 
					Yapper is a World of Warcraft addon that allows you to automatically send messages to various in-game chat channels at specified intervals. Whether you want to spam a joke in guild chat, set an AFK message, or communicate across different channels, Yapper makes it easy.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Download [here!](https://git.site.quack-lab.dev/dave/wow-Yapper/media/branch/master/Yapper.zip)
 | 
					## Features
 | 
				
			||||||
 | 
					- Configurable message interval
 | 
				
			||||||
 | 
					- Support for multiple chat channels
 | 
				
			||||||
 | 
					- Persistent settings across game sessions
 | 
				
			||||||
 | 
					- Simple slash command interface
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Interfacing with the addon is done entirely through two commands:
 | 
					## Installation
 | 
				
			||||||
 | 
					1. Download the latest version from the [Yapper release page](https://git.site.quack-lab.dev/dave/wow-Yapper/media/branch/master/Yapper.zip)
 | 
				
			||||||
 | 
					2. Extract the ZIP file
 | 
				
			||||||
 | 
					3. Place the `Yapper` folder in your World of Warcraft `_retail_/Interface/AddOns/` directory
 | 
				
			||||||
 | 
					4. Ensure the addon is enabled in the character selection screen
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## `/yap`
 | 
					## Usage Commands
 | 
				
			||||||
- Main command that controls most of the parameters
 | 
					 | 
				
			||||||
- Simply running `/yap` will cause the yapper to begin... yapping
 | 
					 | 
				
			||||||
- `/yap <number>` sets the yap interval 
 | 
					 | 
				
			||||||
  - `/yap 30` would send a message every 30 seconds
 | 
					 | 
				
			||||||
- `/yap <string>` sets the yap message
 | 
					 | 
				
			||||||
  - `/yap I'm a big strong boy!` would set the message to "I'm a big strong boy!"
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
## `/yapc`
 | 
					### `/yap`
 | 
				
			||||||
- Controls the channel in which yapping takes place
 | 
					The primary command for controlling Yapper's core functionality:
 | 
				
			||||||
  - The available channels are:
 | 
					
 | 
				
			||||||
    - `CHANNEL` - Message to a server or custom chat channel (sent with /1, /2, etc in the default UI); requires channel number for channel argument
 | 
					- Start yapping: `/yap`
 | 
				
			||||||
	- `DND` - Enables Away-From-Keyboard status for the player, with text as the custom message seen by others attempting to whisper the player
 | 
					- Set yap interval: `/yap <number>`
 | 
				
			||||||
	- `EMOTE` - Custom text emotes visible to nearby players (sent with /e in the default UI)
 | 
					  - Example: `/yap 30` sends a message every 30 seconds
 | 
				
			||||||
	- `GUILD` - Messages to guild members (sent with /g in the default UI)
 | 
					- Set yap message: `/yap <string>`
 | 
				
			||||||
	- `INSTANCE_CHAT` - Messages to a LFG/LFR instance group (sent with /i in the default UI)
 | 
					  - Example: `/yap I'm a big strong boy!`
 | 
				
			||||||
	- `OFFICER` - Messages to guild officers (sent with /o in the default UI)
 | 
					
 | 
				
			||||||
	- `PARTY` - Messages to party members (sent with /p in the default UI)
 | 
					### `/yapc`
 | 
				
			||||||
	- `RAID` - Messages to raid members (sent with /ra in the default UI)
 | 
					Controls the chat channel for your messages:
 | 
				
			||||||
	- `RAID_WARNING` - Warning to raid members (sent with /rw in the default UI)
 | 
					
 | 
				
			||||||
	- `SAY` - Speech to nearby players (sent with /s in the default UI)
 | 
					#### Supported Channels
 | 
				
			||||||
	- `WHISPER` - Message to a specific character (sent with /w in the default UI); requires name of the character for channel argument
 | 
					- `SAY`: Speak to nearby players
 | 
				
			||||||
	- `YELL` - Yell to not-so-nearby players (sent with /y in the default UI)
 | 
					- `YELL`: Yell to not-so-nearby players
 | 
				
			||||||
- Some channels also require special data such as "CHANNEL" and "WHISPER"
 | 
					- `GUILD`: Message guild members
 | 
				
			||||||
  - For `WHISPER` that is the target being whispered
 | 
					- `PARTY`: Message party members
 | 
				
			||||||
  - For `CHANNEL` that is the channel name
 | 
					- `RAID`: Message raid members
 | 
				
			||||||
- Example:
 | 
					- `RAID_WARNING`: Send a raid warning
 | 
				
			||||||
  - `/yapc SAY` will make yapper use the say channel (/s)
 | 
					- `INSTANCE_CHAT`: Message LFG/LFR group
 | 
				
			||||||
  - `/yapc YELL` will use yell channel (/y)
 | 
					- `OFFICER`: Message guild officers
 | 
				
			||||||
  - `/yapc WHISPER` will error out - we are missing a recipient!
 | 
					- `EMOTE`: Send a custom text emote
 | 
				
			||||||
  - `/yapc WHISPER Pinkleta` will whisper Pinkleta
 | 
					- `DND`: Set Away-From-Keyboard status
 | 
				
			||||||
  - `/yapc CHANNEL world_ru` will yap to world channel
 | 
					- `WHISPER`: Message a specific character
 | 
				
			||||||
 | 
					- `CHANNEL`: Message a custom chat channel
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					#### Channel-Specific Examples
 | 
				
			||||||
 | 
					- `/yapc SAY` - Use say channel
 | 
				
			||||||
 | 
					- `/yapc YELL` - Use yell channel
 | 
				
			||||||
 | 
					- `/yapc WHISPER Pinkleta` - Whisper a specific player
 | 
				
			||||||
 | 
					- `/yapc CHANNEL world_ru` - Message a custom channel
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					## Example Scenarios
 | 
				
			||||||
 | 
					1. Periodic Guild Joke: 
 | 
				
			||||||
 | 
					   ```
 | 
				
			||||||
 | 
					   /yap Hey guys, knock knock!
 | 
				
			||||||
 | 
					   /yapc GUILD
 | 
				
			||||||
 | 
					   /yap 300  # Tells a joke every 5 minutes
 | 
				
			||||||
 | 
					   ```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### `/yapl`
 | 
				
			||||||
 | 
					Changes language of the "debug" messages of the addon.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Example:
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					/yapl ru
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					/yapl en
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					# Yapper; Ruski
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					## Обзор
 | 
				
			||||||
 | 
					Yapper - это аддон для World of Warcraft, позволяющий автоматически отправлять сообщения в различные внутриигровые каналы чата через заданные интервалы. Будь то спам шутками в гильдейском чате, установка AFK-сообщения или общение в разных каналах, Yapper делает это простым.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					## Возможности
 | 
				
			||||||
 | 
					- Настраиваемый интервал сообщений
 | 
				
			||||||
 | 
					- Поддержка множества каналов чата
 | 
				
			||||||
 | 
					- Сохранение настроек между игровыми сессиями
 | 
				
			||||||
 | 
					- Простой интерфейс слэш-команд
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					## Установка
 | 
				
			||||||
 | 
					1. Скачайте последнюю версию со [страницы релизов Yapper](https://git.site.quack-lab.dev/dave/wow-Yapper/media/branch/master/Yapper.zip)
 | 
				
			||||||
 | 
					2. Распакуйте ZIP-файл
 | 
				
			||||||
 | 
					3. Поместите папку `Yapper` в директорию World of Warcraft `_retail_/Interface/AddOns/`
 | 
				
			||||||
 | 
					4. Убедитесь, что аддон включен на экране выбора персонажа
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					## Команды использования
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### `/yap`
 | 
				
			||||||
 | 
					Основная команда для управления функциональностью Yapper:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					- Начать отправку: `/yap`
 | 
				
			||||||
 | 
					- Установить интервал: `/yap <число>`
 | 
				
			||||||
 | 
					  - Пример: `/yap 30` отправляет сообщение каждые 30 секунд
 | 
				
			||||||
 | 
					- Установить сообщение: `/yap <текст>`
 | 
				
			||||||
 | 
					  - Пример: `/yap Я большой и сильный!`
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### `/yapc`
 | 
				
			||||||
 | 
					Управляет каналом чата для сообщений:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					#### Поддерживаемые каналы
 | 
				
			||||||
 | 
					- `SAY`: Говорить с ближайшими игроками
 | 
				
			||||||
 | 
					- `YELL`: Кричать не очень близким игрокам
 | 
				
			||||||
 | 
					- `GUILD`: Сообщения членам гильдии
 | 
				
			||||||
 | 
					- `PARTY`: Сообщения членам группы
 | 
				
			||||||
 | 
					- `RAID`: Сообщения членам рейда
 | 
				
			||||||
 | 
					- `RAID_WARNING`: Отправить предупреждение рейду
 | 
				
			||||||
 | 
					- `INSTANCE_CHAT`: Сообщения группе LFG/LFR
 | 
				
			||||||
 | 
					- `OFFICER`: Сообщения офицерам гильдии
 | 
				
			||||||
 | 
					- `EMOTE`: Отправить пользовательскую эмоцию
 | 
				
			||||||
 | 
					- `DND`: Установить статус "Не беспокоить"
 | 
				
			||||||
 | 
					- `WHISPER`: Сообщение конкретному персонажу
 | 
				
			||||||
 | 
					- `CHANNEL`: Сообщение в пользовательский канал чата
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					#### Примеры для каналов
 | 
				
			||||||
 | 
					- `/yapc SAY` - Использовать канал "сказать"
 | 
				
			||||||
 | 
					- `/yapc YELL` - Использовать канал "крик"
 | 
				
			||||||
 | 
					- `/yapc WHISPER Pinkleta` - Шепнуть конкретному игроку
 | 
				
			||||||
 | 
					- `/yapc CHANNEL world_ru` - Сообщение в пользовательский канал
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					## Примеры сценариев
 | 
				
			||||||
 | 
					1. Периодическая шутка в гильдии:
 | 
				
			||||||
 | 
					   ```
 | 
				
			||||||
 | 
					   /yap Эй, ребята, тук-тук!
 | 
				
			||||||
 | 
					   /yapc GUILD
 | 
				
			||||||
 | 
					   /yap 300  # Рассказывает шутку каждые 5 минут
 | 
				
			||||||
 | 
					   ```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					### `/yapl`
 | 
				
			||||||
 | 
					Изменяет язык "отладочных" сообщений аддона.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Примеры:
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					/yapl ru
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					/yapl en
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
		Reference in New Issue
	
	Block a user