ai-chat
Чат с каналами (локальный, OOC, рабочий), подсказками команд и /me. Заменяет ресурс chat из FiveM.
ai-chat является окном чата. Игроки пишут в каналы, которые вы задаёте в панели (все, игроки поблизости, одна работа), запускают команды с подсказками только для тех команд, которые им разрешены, и показывают действия над головой через /me.
Что он делает в игре
- Каналы. У каждого канала есть название, цвет и дальность: все на сервере или только игроки в пределах нескольких метров. Канал можно ограничить работами и бандами. Игроки видят только те каналы, которыми могут пользоваться.
- Переключение. Tab перебирает каналы (и режим Command, см. ниже). Чат открывается в первом канале.
- Команды. Строка, начинающаяся с
/, запускает команду в любом канале. Подсказки показывают только команды, которые игроку разрешено использовать, с их аргументами. - Команды без / (необязательно): поле ввода открывается в режиме Command, где команда вводится без косой черты.
- История. Вверх и Вниз перебирают отправленные строки, пока поле ввода пустое.
- Цвета. Работают цветовые коды GTA от
^0до^9. HTML от скриптов никогда не отрисовывается. - Затухание. Закрытый чат исчезает через несколько секунд после последнего сообщения.
- Имена авторов являются именами персонажей.
- Сообщения не хранятся. Они идут в канал логов
messagesчерез AI Core.
Установка
Его устанавливает рецепт AI Core для txAdmin. Вручную: положите папку в resources/[ai]/ и добавьте ensure ai-chat в server.cfg после ensure ai-core. Ему нужен ai-core. Таблицы в базе данных у него нет.
Удалите собственный ресурс chat из FiveM и оставьте в cfg set resources_useSystemChat false: ai-chat предоставляет chat.
Настройки панели
Откройте админ-панель (F10) и выберите Chat.
Вкладка Channels
Где пишут игроки. Каждый канал является одной записью; нажмите New channel, чтобы добавить.
| Настройка | Что меняет | Значения | По умолчанию для нового канала |
|---|---|---|---|
| Name | Тег канала, который показывается перед автором. | от 1 до 24 символов | |
| Colour | Цвет тега канала и автора в формате #RRGGBB. | цвет в hex | #36ff9f |
| Range | Читают только игроки на таком расстоянии от пишущего. 0 означает всех на сервере. | от 0 до 1000 м | 0 |
| Jobs | Пользоваться могут только участники этих работ. Оставьте работы и банды пустыми, чтобы было доступно всем. | названия работ | пусто |
| Gangs | Участники этих банд тоже могут пользоваться. | названия банд | пусто |
| Only on duty | Участники работы должны быть на дежурстве в этой работе. | вкл. / выкл. | выкл. |
| Order | Меньшее идёт первым; первый канал тот, в котором открывается чат. | от 0 до 100 | 10 |
Каналы, которые поставляются со скриптом:
| Канал | Дальность | Кто | Порядок |
|---|---|---|---|
| Local | 20 м | все | 0 |
| OOC | все на сервере | все | 1 |
| Police | все на сервере | работа police | 2 |
Вкладка Settings
Messages (сообщения): правила для каждого сообщения.
| Настройка | Что меняет | Значения | По умолчанию |
|---|---|---|---|
| Longest message | Более длинные сообщения обрезаются. | от 16 до 1000 символов | 256 |
| Stays on screen | Сколько секунд сообщения остаются видимыми после нового, пока чат закрыт. | от 2 до 60 с | 8 |
| Messages kept | Сколько сообщений каждый игрок хранит для прокрутки назад. | от 20 до 500 | 100 |
| Join and leave messages | Сообщает всем, когда игрок заходит или выходит. | вкл. / выкл. | выкл. |
| Commands without / | Поле ввода открывается в режиме Command: игроки вводят команду без косой черты. Tab перебирает Command и каналы; строка, начинающаяся с /, всё так же запускается как команда в любом канале. | вкл. / выкл. | вкл. |
Команды
| Команда | Аргументы | Кто | Что делает |
|---|---|---|---|
/ooc | <message> | все | Строка вне роли (OOC | <FiveM name>) вам и игрокам в пределах 20 м. |
/me | <message> | все | Показывает действие над вашей головой ("lights a cigarette") в течение 7 секунд вам и игрокам в пределах 20 м. До 120 символов. |
Привязки клавиш
| Клавиша по умолчанию | Что делает | Название в настройках GTA |
|---|---|---|
| T | Открывает поле ввода чата | Open the chat |
В открытом чате: Tab переключает канал, Вверх / Вниз перебирают отправленные строки или подсказки, Enter отправляет (или берёт выбранную подсказку), Escape закрывает.
Работа с другими скриптами
- Заменяет ресурс
chatиз FiveM (provide 'chat'). Каждый скрипт, который отправляетchat:addMessage,chatMessage, добавляет подсказки или вызываетexports.chat:addMessage, работает без изменений. - Команды, созданные через lib AI Core (
addCommand), отправляют свою справку и аргументы как подсказки.
Известные ограничения
chat:addTemplateигнорируется, и HTML-шаблоны не отрисовываются: сообщение показывает свой простой текст.- Скрипты, которые слушают внутреннее событие FiveM
_chat:messageEntered, ничего не видят. Используйте вместо него серверное событиеchatMessage. setSeObjectхуков сообщений и ACE-фильтрация режимов скриптов не поддерживаются.