Decisão de servidor não deveria virar briga no Discord
Toda mudança relevante — ajuste de economia, nova regra, wipe, horário de evento
— acaba discutida num canal do Discord onde participam as vinte pessoas mais
barulhentas. O resto da cidade não opina, e depois reclama.
O TBS Polls leva a pergunta para dentro do jogo, onde está todo mundo.
Enquetes definidas no config
Cada enquete tem título, descrição, lista de opções (cada uma com sua própria
descrição) e uma data de encerramento no formato `DD/MM/AAAA`. Não precisa de
painel administrativo nem de banco de dados para criar — é uma entrada no
arquivo de configuração e um restart.
Enquete sem data de encerramento fica aberta indefinidamente.
Voto único, validado no servidor
Cada jogador vota uma vez por enquete, e a checagem acontece no servidor, contra
o ID estável dele — não contra a sessão. Sair e entrar de novo não libera outro
voto.
Resultados no momento certo
Enquanto a enquete está aberta, o jogador vê o formulário de voto. Depois da data
de encerramento, a mesma tela passa a mostrar o resultado: votos por opção,
porcentagem e total. A transição é automática, sem intervenção do staff.
Isso importa mais do que parece — resultado parcial visível durante a votação
enviesa o voto de quem ainda não votou.
### Cache em memória
Os votos ficam cacheados na memória e persistidos em MySQL. A leitura do
resultado não bate no banco a cada abertura de menu. Há um comando de admin para
recarregar o cache caso você edite algo direto no banco.
### Comandos de administração
| Comando | Função |
|—|—|
| `/enquete` | Abre o menu de enquetes (qualquer jogador) |
| `/pollResults` | Imprime o placar consolidado no console do servidor |
| `/reloadPollCache` | Limpa e recarrega o cache de votos do banco |
Os nomes dos três comandos são configuráveis, para evitar colisão com o que você
já tem instalado.
Sem interface própria
O sistema não traz front-end. Usa o menu de contexto do `ox_lib`, que a maioria
dos servidores modernos já roda. Isso significa três coisas: instala mais leve,
combina visualmente com o resto do seu servidor sem ajuste nenhum, e não há NUI
para dar conflito ou consumir recurso.
API para integração
Cinco exports e um evento, todos documentados, para plugar as enquetes no resto
do seu servidor:
“`lua
exports[‘tbs_polls’]:GetPolls()
exports[‘tbs_polls’]:GetPollResults(titulo)
exports[‘tbs_polls’]:HasUserVoted(userId, titulo)
exports[‘tbs_polls’]:GetVoteCache()
exports[‘tbs_polls’]:OpenPollsMenu() — cliente
AddEventHandler(‘tbs_polls:voted’, function(source, userId, poll, option) end)
“`
Dá para premiar quem votou, exibir o resultado no seu site ou disparar um
anúncio automático no encerramento.
Um arquivo, quatro frameworks
| `Config.Framework` | Compatibilidade |
|—|—|
| `qbcore` | QBCore e Qbox (`qb-core` ou `qbx_core`) |
| `vrp` | vRP clássico |
| `vrpex` | vRPEX |
| `custom` | Template aberto — seis funções para preencher |
O adapter `custom` é o mais simples do nosso catálogo: seis métodos
(`GetUserId`, `GetSourceById`, `GetIdentity`, `HasPermission`, `Notify`,
`IsAdmin`) e o que faltar cai num adapter padrão.
Três idiomas
Português, inglês e espanhol.
Requisitos
– `ox_lib` e `oxmysql`
– MySQL — a tabela é criada automaticamente no primeiro start
– QBCore, Qbox, vRP, vRPEX ou base própria via template `custom`
⚠️ IMPORTANTE — LEIA ANTES DE COMPRAR
🔧 Instalação assistida (opcional)
Se preferir que a nossa equipe faça a instalação na sua base, prestamos
esse serviço por uma taxa de R$ 100,00 (aprox. USD 20). O serviço inclui
a instalação completa e os ajustes necessários para o funcionamento
correto no seu servidor.
Inclui: instalação do resource, configuração do framework, ajuste da
permissão de administrador e teste de funcionamento.
Não inclui: criação das suas enquetes, integração com scripts de
terceiros ou desenvolvimento de novas funcionalidades — orçados à parte.
Observação: este é um dos nossos scripts mais simples de instalar. Na
maioria das bases, a instalação leva poucos minutos seguindo a
documentação — o serviço assistido é opcional e raramente necessário
aqui.
🛠️ Suporte a mau funcionamento
Também prestamos suporte para ajustes e correções caso o script não
funcione corretamente na sua base.
⚙️ Configuração aberta
As enquetes, os nomes dos comandos, a permissão de admin e os textos
ficam em arquivos abertos e editáveis.
🖥️ Sem interface própria
O sistema usa o menu de contexto do ox_lib, então ele já combina com o
visual do seu servidor — sem NUI para configurar, sem conflito de
interface e sem peso extra.
💬 Suporte
Todo o atendimento é feito pelo nosso Discord:
https://discord.gg/8SZ3KVYxr5
