ai-chat
Chat com canais (local, OOC, emprego), sugestões de comandos e /me. Substitui o recurso de chat do FiveM.
O ai-chat é a caixa de chat. Os jogadores escrevem em canais que você define no painel (todos, os jogadores por perto, um emprego), rodam comandos com sugestões só dos comandos que podem usar, e mostram ações sobre a cabeça com /me.
O que faz no jogo
- Canais. Cada canal tem um nome, uma cor e um alcance: todos no servidor, ou só os jogadores a alguns metros. Um canal pode ser limitado a empregos e gangues. Os jogadores veem só os canais que podem usar.
- Trocar. Tab passa pelos canais (e pelo modo Command, abaixo). O chat abre no primeiro canal.
- Comandos. Uma linha que começa com
/roda um comando em qualquer canal. As sugestões listam só os comandos que o jogador tem permissão para usar, com os argumentos deles. - Comandos sem / (opcional): a entrada abre em um modo Command em que o comando é digitado sem a barra.
- Histórico. Up e Down percorrem as linhas que você enviou, enquanto a entrada está vazia.
- Cores. Os códigos de cor do GTA
^0a^9funcionam. HTML vindo de scripts nunca é desenhado. - Esmaecer. O chat some aos poucos alguns segundos depois da última mensagem enquanto está fechado.
- Nomes de autor são nomes de personagens.
- As mensagens não são guardadas. Elas vão para o canal de log
messagespelo AI Core.
Instalação
A receita do txAdmin do AI Core o instala. À mão: coloque a pasta em resources/[ai]/ e adicione ensure ai-chat ao server.cfg depois de ensure ai-core. Ele precisa do ai-core. Ele não tem tabela no banco de dados.
Remova o próprio recurso chat do FiveM e mantenha set resources_useSystemChat false no seu cfg: o ai-chat fornece chat.
Configurações do painel
Abra o painel de administração (F10) e escolha Chat.
Aba Channels
Onde os jogadores escrevem. Cada canal é um registro; aperte New channel para adicionar um.
| Configuração | O que muda | Valores | Padrão para um canal novo |
|---|---|---|---|
| Name | A tag do canal mostrada antes do autor. | 1 a 24 caracteres | |
| Colour | Cor da tag do canal e do autor, como #RRGGBB. | uma cor hex | #36ff9f |
| Range | Só jogadores a essa distância de quem escreve a leem. 0 significa todos no servidor. | 0 a 1000 m | 0 |
| Jobs | Só membros desses empregos podem usar. Deixe empregos e gangues vazios para todos. | nomes de empregos | vazio |
| Gangs | Membros dessas gangues também podem usar. | nomes de gangues | vazio |
| Only on duty | Membros do emprego precisam estar em serviço naquele emprego. | ligado / desligado | desligado |
| Order | O menor vem primeiro; o primeiro canal é onde o chat abre. | 0 a 100 | 10 |
Canais que vêm com o script:
| Canal | Alcance | Quem | Ordem |
|---|---|---|---|
| Local | 20 m | todos | 0 |
| OOC | todos no servidor | todos | 1 |
| Police | todos no servidor | o emprego police | 2 |
Aba Settings
Messages: regras para toda mensagem.
| Configuração | O que muda | Valores | Padrão |
|---|---|---|---|
| Longest message | Mensagens mais longas são cortadas. | 16 a 1000 caracteres | 256 |
| Stays on screen | Segundos que as mensagens ficam visíveis depois de uma nova enquanto o chat está fechado. | 2 a 60 s | 8 |
| Messages kept | Quantas mensagens cada jogador guarda para rolar para trás. | 20 a 500 | 100 |
| Join and leave messages | Avisa a todos quando um jogador entra ou sai. | ligado / desligado | desligado |
| Commands without / | A entrada abre no modo Command: os jogadores digitam um comando sem a barra. Tab passa por Command e pelos canais; uma linha que começa com / ainda roda como comando em qualquer canal. | ligado / desligado | ligado |
Comandos
| Comando | Argumentos | Quem | O que faz |
|---|---|---|---|
/ooc | <message> | todos | Uma linha fora do personagem (OOC | <nome no FiveM>) para você e os jogadores a até 20 m. |
/me | <message> | todos | Mostra uma ação sobre a sua cabeça ("acende um cigarro") por 7 segundos, para você e os jogadores a até 20 m. Até 120 caracteres. |
Teclas
| Tecla padrão | O que faz | Nome nas configurações do GTA |
|---|---|---|
| T | Abre a entrada do chat | Open the chat |
Com o chat aberto: Tab troca o canal, Up / Down percorrem as linhas enviadas ou as sugestões, Enter envia (ou pega a sugestão escolhida), Escape fecha.
Funciona com outros scripts
- Substitui o recurso
chatdo FiveM (provide 'chat'). Todo script que enviachat:addMessage,chatMessage, adiciona sugestões ou chamaexports.chat:addMessagefunciona sem alterações. - Comandos feitos com a lib do AI Core (
addCommand) enviam sua própria ajuda e argumentos como sugestões.
Limites conhecidos
chat:addTemplateé ignorado e templates HTML não são desenhados: a mensagem mostra o texto puro.- Scripts que escutam o evento interno
_chat:messageEntereddo FiveM não veem nada. Use o evento de servidorchatMessageno lugar. - O
setSeObjectdos hooks de mensagem e o filtro por ACE dos modos de script não são respondidos.