- Sobre o Projeto
- Diferenças em relação ao dpEmotes
- Arquitetura do Sistema
- Funcionalidades
- Interface NUI
- Fluxo de Comunicação NUI ↔ Lua
- FrontierPreview
- Sistema de Favoritos
- Categorias de Emotes
- Comandos & Keybinds
- Instalação
- Configuração (config.lua)
- Estrutura de Arquivos
- Compatibilidade com Frameworks
- Créditos & Animações Customizadas
DOIZZP EMOTES V1 é um sistema completo de animações e emotes para servidores FiveM baseado no amplamente utilizado dpEmotes, com uma diferença fundamental: a interface do usuário foi completamente reescrita do zero utilizando tecnologias web modernas (HTML5, CSS3 e JavaScript ES2020+), eliminando a dependência do NativeUI.
O resultado é um painel premium com visual dark-glass, neon vermelho e estética gamer, com suporte a virtual scroll para listas de centenas de animações sem perda de performance, preview em tempo real do personagem e persistência de favoritos via ResourceKvp.
| Aspecto | dpEmotes (original) | DOIZZP EMOTES V1 |
|---|---|---|
| Interface | NativeUI (menu nativo GTA) | HTML/CSS/JS — NUI personalizado |
| Visual | Padrão do jogo | Dark Glass · Red Neon · Gamer premium |
| Performance na lista | Renderiza todos os itens | Virtual Scroll (apenas itens visíveis) |
| Preview de emote | ❌ | ✅ FrontierPreview (câmera dedicada) |
| Busca | Limitada | Busca em tempo real com debounce (120ms) |
| Favoritos | KVP básico | Lista persistida via ResourceKvp + keybind |
| Arquivo EmoteMenu.lua | Presente | ❌ Substituído por client/NUI.lua |
| Arquivo NativeUI.lua | Obrigatório | ❌ Removido completamente |
| Fonte de dados | Interna ao menu | Serializada como JSON via SendNUIMessage |
┌─────────────────────────────────────────────────────────────┐
│ DOIZZP EMOTES V1 │
│ │
│ ┌──────────────┐ SendNUIMessage ┌──────────────────┐ │
│ │ NUI.lua │ ──────────────────► │ html/script.js │ │
│ │ (client) │ │ (NUI / browser) │ │
│ │ │ ◄────────────────── │ │ │
│ │ │ fetch() callbacks │ html/style.css │ │
│ └──────┬───────┘ └──────────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────┐ TriggerServerEvent ┌────────────────┐ │
│ │ Emote.lua │ ──────────────────► │ Server.lua │ │
│ │ Syncing.lua │ ◄────────────────── ─ │ (sincronismo) │ │
│ │ Walk.lua │ └────────────────┘ │
│ └──────┬───────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ AnimationList.lua + AnimationListCustom.lua │ │
│ │ (RP.Emotes, RP.Dances, RP.PropEmotes, RP.Walks, │ │
│ │ RP.Expressions, RP.Shared, RP.AnimalEmotes, ...) │ │
│ └─────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
| Arquivo | Responsabilidade |
|---|---|
fxmanifest.lua |
Manifesto do recurso, scripts, ui_page e data_files |
config.lua |
Todas as configurações do servidor |
client/NUI.lua |
Bridge principal — substitui EmoteMenu.lua + NativeUI.lua |
client/Emote.lua |
Lógica de execução das animações |
client/FrontierPreview.lua |
Sistema de preview com câmera dedicada |
client/Syncing.lua |
Sincronismo de emotes entre jogadores |
client/AnimationList.lua |
Tabela completa de animações nativas (28 000+ linhas) |
client/AnimationListCustom.lua |
Animações customizadas adicionais |
client/Walk.lua |
Estilos de caminhada persistentes |
client/Expressions.lua |
Expressões faciais persistentes |
client/Keybinds.lua |
Keybinds numéricos opcionais (SQL) |
html/index.html |
Estrutura da interface NUI |
html/style.css |
Tema Dark Glass · Red Neon |
html/script.js |
Lógica da UI, virtual scroll e comunicação com Lua |
server/Server.lua |
Eventos de sincronismo e keybinds SQL |
- Menu NUI premium aberto com
F5(configurável), sem NativeUI - 8 categorias de animações: Emotes, Danças, Props, Walks, Expressões, Shared, Animals e Favoritos
- Busca em tempo real com debounce de 120ms — busca por nome ou comando
- Virtual Scroll — renderiza apenas os cards visíveis para suportar centenas de emotes sem lag de UI
- FrontierPreview — câmera dedicada que pré-visualiza a animação no personagem antes de executar
- Sistema de Favoritos — marque emotes favoritos, persistidos localmente via
ResourceKvp; um favorito pode ser associado ao keybind rápido (CAPS LOCKpor padrão) - Shared Emotes — envie convite para jogadores próximos (< 3 m) com
Ypara aceitar /Npara recusar - Estilos de caminhada persistentes — aplica automaticamente ao reconectar (polling a cada 60s)
- Expressões faciais persistentes — salvas no client, reaplicadas no login
- Emotes em veículos — por padrão apenas upper body quando dentro de um veículo
- Cancelamento automático — cancela emote ao morrer, nadar (se
AllowInWater = false) ou ao pressionarF6 - Desarme opcional — configura
DisarmPlayer = truepara remover a arma ao emoting - Suporte QBCore — integração nativa opcional
- 1 100+ animações customizadas streamadas localmente (
.ycd) - Props customizados de múltiplos criadores (
.ydr/.ytyp) - Binoculars e News Camera como comandos (
/binoculars,/newscam) - Ragdoll, Crouch e Crawl toggles configuráveis
- Finger Pointing configurável
- Suporte a SQL Keybinding (6 slots numéricos opcionais)
- Notificações via GTA nativo ou chat (configurável)
- Suporte a Lua 5.4,
fxmanifest cerulean, OneSync obrigatório
A interface é construída inteiramente em HTML5/CSS3/JS sem qualquer framework ou biblioteca externa.
/* Paleta principal */
--bg-panel: rgba(10, 10, 14, 0.97) /* painel escuro com vidro */
--red: #e8001c /* accent primário */
--red-bright: #ff1a35 /* hover / glow */
--text-white: #f4f4f8
/* Tipografia */
--font-title: 'Rajdhani' (700) /* títulos e brand */
--font-body: 'DM Sans' (400/500) /* labels e listas */
/* Dimensões do painel */
--panel-w: 440px
--header-h: 62px
--search-h: 60px
--footer-h: 66px
--cat-w: 68px /* largura da coluna de categorias */
--card-h: 70px /* altura de cada card de emote */┌─────────────────────────────────────────────┐
│ HEADER — Brand · Contador · Botão fechar │
├─────────────────────────────────────────────┤
│ SEARCH BAR — Input com clear + resultado │
├──────────┬──────────────────────────────────┤
│ │ CONTENT HEADER │
│ CATEGORY│ ─────────────────────────────── │
│ NAV │ EMOTE LIST (Virtual Scroll) │
│ (ícones)│ │
│ 🎭 │ ┌─────────────────────────────┐ │
│ 💃 │ │ Card: ícone · nome · cmd │ │
│ 🧸 │ │ ⭐ fav · ▶ preview │ │
│ 👟 │ └─────────────────────────────┘ │
│ 😄 │ ... (só itens visíveis) │
│ 🤝 │ │
│ 🐾 │ │
│ ⭐ │ │
├──────────┴──────────────────────────────────┤
│ FOOTER — Emote selecionado · Btn Cancelar │
└─────────────────────────────────────────────┘
O script implementa virtual scrolling próprio (sem biblioteca) que mantém no DOM apenas os cards dentro da viewport mais um buffer de VIRTUAL_BUFFER = 8 itens acima e abaixo. Isso garante que mesmo com 800+ emotes numa categoria a performance de renderização seja constante.
CARD_HEIGHT = 74px (--card-h + gap, deve coincidir com CSS)
VIRTUAL_BUFFER = 8 (itens extras além da viewport)
MAX_VISIBLE = 800 (cap suave por categoria; use busca para mais)
SEARCH_DEBOUNCE = 120ms (delay da busca em tempo real)
PREVIEW_DEBOUNCE = 120ms (delay do preview ao hover)
ANIM_STAGGER_MAX = 14 (máx de cards com animação de entrada staggered)
-- NUI.lua: OpenEmoteMenu()
SendNUIMessage({
action = "openMenu",
resourceName = "DOIZZP_EMOTES_V1",
favorites = { "cheer", "wave" },
favoriteEmote = "cheer",
categories = {
emotes = { { name, label, type, cmd }, ... },
dances = { ... },
props = { { name, label, type, cmd, variant }, ... },
walks = { ... },
expressions = { ... },
shared = { ... },
animals = { ... },
}
})| Callback NUI | Payload enviado | Ação em Lua |
|---|---|---|
playEmote |
{ name, type, variant } |
Executa EmoteMenuStart(), WalkMenuStart() ou shared |
previewEmote |
{ name, type, variant } |
FrontierPreviewPlay() na câmera dedicada |
cancelEmote |
{} |
EmoteCancel() + DestroyAllProps() |
addFavorite |
{ name } |
AddFavorite() + salva no KVP |
removeFavorite |
{ name } |
RemoveFavorite() + salva no KVP |
setKeyFav |
{ name } |
Define FavoriteEmote global para o keybind |
closeMenu |
{} |
SetNuiFocus(false, false) |
// Exemplo em script.js — executar emote
async function playEmote(emote) {
await fetch(`https://${State.resourceName}/playEmote`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ name: emote.name, type: emote.type, variant: emote.variant ?? 0 })
});
}O FrontierPreview é um sistema de preview em tempo real que cria um ped clone do jogador em posição de câmera lateral para demonstrar a animação antes de executá-la no personagem principal.
-- Configuração (config.lua)
FrontierPreview = {
Enabled = true,
Interval = 250, -- ms entre frames de preview
CameraDistance = 4.8, -- distância da câmera ao ped
CameraRight = 0.85, -- offset lateral da câmera
CameraHeight = -0.45, -- offset vertical da câmera
}Funcionamento:
- Ao abrir o menu →
FrontierPreviewStart()cria o ped clone e posiciona câmera - Ao hover em um card (debounce 120ms) →
previewEmotecallback →FrontierPreviewPlay(type, name, variant) - O preview resolve a animação nas tabelas
RP.*conforme o tipo (emotes,dances,whitecustom, etc.) - Props customizados são criados e attachados ao ped de preview
- Ao fechar o menu →
FrontierPreviewStop()destrói o ped, props e câmera
Os favoritos são armazenados localmente no client via ResourceKvp (persistência nativa do FiveM, sem banco de dados).
-- Chave KVP usada
local FAV_KVP_KEY = "nui_favorites_list"
-- Estrutura salva (JSON)
-- ["cheer", "wave", "sit"]- Adicionar favorito — botão ⭐ no card ou
addFavoritecallback - Remover favorito — segundo toque no ⭐ ou
removeFavoritecallback - Emote favorito do keybind — botão de pin no card →
setKeyFav→ salva emFavoriteEmoteglobal - Carregamento —
LoadFavorites()é chamado uma vez noAddEventHandler('onClientResourceStart', ...) - A aba Favoritos (⭐) no menu exibe apenas os emotes marcados como favorito, com busca funcional
| Categoria | Ícone | Tabela Lua | Comando | Descrição |
|---|---|---|---|---|
| Emotes | 🎭 | RP.Emotes + RP.White* |
/e <nome> |
Emotes base + packs customizados |
| Dances | 💃 | RP.Dances |
/e <nome> |
Danças sincronizáveis |
| Props | 🧸 | RP.PropEmotes |
/e <nome> |
Emotes com objetos 3D attachados |
| Walks | 👟 | RP.Walks |
/walk <nome> |
Estilos de caminhada persistentes |
| Mood | 😄 | RP.Expressions |
/expr <nome> |
Expressões faciais persistentes |
| Shared | 🤝 | RP.Shared |
/p <nome> |
Emotes para dois jogadores |
| Animals | 🐾 | RP.AnimalEmotes |
/e <nome> |
Animações de animais |
| Favoritos | ⭐ | (KVP local) | — | Emotes marcados pelo jogador |
| Comando | Descrição |
|---|---|
/e <nome> |
Executa um emote pelo nome |
/e c |
Cancela o emote atual |
/walk <nome> |
Aplica um estilo de caminhada |
/walk reset |
Restaura a caminhada padrão |
/expr <nome> |
Aplica uma expressão facial |
/p <nome> |
Inicia emote compartilhado com jogador próximo |
/nearby |
Lista jogadores próximos (alias de /p) |
/binoculars |
Ativa binóculos (se habilitado no config) |
/newscam |
Ativa câmera de notícias (se habilitado no config) |
| Tecla | Ação | Configurável via |
|---|---|---|
F5 |
Abrir / Fechar o menu NUI | Config.MenuKeybind |
F6 |
Cancelar emote atual | Config.CancelEmoteKey |
CAPS LOCK |
Executar emote favorito do keybind | Config.FavKeybind |
X |
Cancelar emote (alternativo) | Config.EnableXtoCancel |
Y |
Aceitar convite de emote compartilhado | Hardcoded (input 246) |
N |
Recusar convite de emote compartilhado | Hardcoded (input 182) |
U |
Ragdoll toggle (se habilitado) | Config.RagdollKeybind |
B |
Finger pointing (se habilitado) | Config.PointingKeybind |
RCTRL |
Crawl toggle (se habilitado) | Config.CrawlKeybind |
- Servidor FiveM com build 5848 ou superior
- OneSync habilitado (obrigatório — declarado no manifesto)
- Lua 5.4 habilitado no servidor
1. Faça o download e copie para o servidor
# Copie a pasta para o diretório de recursos
cp -r DOIZZP_EMOTES_V1/ server-data/resources/[local]/2. Adicione ao server.cfg
ensure DOIZZP_EMOTES_V13. (Opcional) Configure o config.lua
Edite config.lua de acordo com as necessidades do seu servidor (ver seção abaixo).
4. (Opcional) SQL Keybinding
Se desejar keybinds SQL (Config.SqlKeybinding = true), importe o schema necessário e habilite a opção no config. O script criará entradas automaticamente no primeiro login do jogador.
5. Reinicie o servidor ou use refresh + start DOIZZP_EMOTES_V1
Todas as opções estão no arquivo config.lua na raiz do recurso.
Config = {
-- ── Idioma ─────────────────────────────────────────────────
MenuLanguage = 'pt', -- 'pt', 'en', 'es', etc.
-- ── Debug ──────────────────────────────────────────────────
DebugDisplay = false, -- prints extras no console
-- ── Cancelamento ───────────────────────────────────────────
EnableXtoCancel = true, -- X cancela emote
CancelEmoteKey = 'f6', -- tecla de cancelar
-- ── Comportamento ──────────────────────────────────────────
DisarmPlayer = false, -- desarmar ao emoting
AllowedInCars = true, -- emotes em veículos (upper body)
CancelPreviousEmote = false, -- cancela emote anterior ao iniciar novo
AllowInWater = true, -- permite emotes na água
-- ── Menu ───────────────────────────────────────────────────
MenuKeybindEnabled = true,
MenuKeybind = 'f5',
MenuTitle = "FRONTIER",
MenuPosition = "right", -- "left" ou "right"
MenuImage = "URL_DO_BANNER", -- 512x128px recomendado
CustomMenuEnabled = true,
-- ── Favorito (keybind) ─────────────────────────────────────
FavKeybindEnabled = true,
FavKeybind = 'capital', -- CAPS LOCK
-- ── FrontierPreview ────────────────────────────────────────
FrontierPreview = {
Enabled = true,
Interval = 250,
CameraDistance = 4.8,
CameraRight = 0.85,
CameraHeight = -0.45,
},
-- ── Funcionalidades opcionais ──────────────────────────────
RagdollEnabled = false,
RagdollKeybind = 'u',
RagdollAsToggle = true,
ExpressionsEnabled = true,
PersistentExpression = true,
WalkingStylesEnabled = true,
PersistentWalk = true,
PersistencePollPeriod = 60000, -- ms
SharedEmotesEnabled = true,
AdultEmotesDisabled = false,
AnimalEmotesEnabled = true,
Search = true,
HandsupEnabled = false,
PointingEnabled = false,
CrouchEnabled = false,
CrawlEnabled = true,
CrawlKeybind = 'rcontrol',
BinocularsEnabled = true,
NewscamEnabled = true,
-- ── Framework ──────────────────────────────────────────────
Framework = false, -- false ou "qb-core"
SqlKeybinding = false,
-- ── Notificações ───────────────────────────────────────────
NotificationsAsChatMessage = false, -- true = mensagem no chat
-- ── Updates ────────────────────────────────────────────────
CheckForUpdates = false,
}DOIZZP_EMOTES_V1/
│
├── fxmanifest.lua # Manifesto do recurso
├── config.lua # Configurações centrais
├── animals.lua # Tabela de emotes de animais
├── printer.lua # Utilitário de impressão
│
├── html/ # Interface NUI (sem NativeUI)
│ ├── index.html # Estrutura da UI
│ ├── style.css # Tema Dark Glass · Red Neon (27KB)
│ └── script.js # Lógica, virtual scroll, callbacks (31KB)
│
├── client/
│ ├── NUI.lua # ★ Bridge NUI — substitui EmoteMenu + NativeUI
│ ├── Emote.lua # Execução de animações
│ ├── FrontierPreview.lua # Preview com câmera dedicada
│ ├── AnimationList.lua # Lista completa de animações (28 452 linhas)
│ ├── AnimationListCustom.lua # Animações customizadas extras
│ ├── Syncing.lua # Sincronismo multiplayer
│ ├── Walk.lua # Estilos de caminhada
│ ├── Expressions.lua # Expressões faciais
│ ├── Keybinds.lua # Keybinds SQL opcionais
│ ├── Binoculars.lua # Comando /binoculars
│ ├── NewsCam.lua # Comando /newscam
│ ├── Crouch.lua # Sistema de agachar
│ ├── Pointing.lua # Apontar o dedo
│ ├── Ragdoll.lua # Toggle ragdoll
│ ├── NoIdleCam.lua # Desativa câmera idle
│ ├── Utils.lua # Funções utilitárias compartilhadas
│ └── frameworks/
│ └── qb-core.lua # Integração QBCore (client)
│
├── server/
│ ├── Server.lua # Eventos de sincronismo
│ └── frameworks/
│ └── qb-core.lua # Integração QBCore (server)
│
└── stream/
├── divined@drpack@new.ycd # Animação customizada
├── [Custom Emotes]/ # Packs de criadores (24 creators)
│ ├── Amnilka/
│ ├── BoringNeptune/
│ ├── BzZziEmotes/
│ ├── ChocoholicAnimations/
│ ├── CMGMods/
│ ├── CrunchyCat Poses/
│ ├── DarkAnimations/
│ ├── DestinyCustoms/
│ ├── Dollie_Mods/
│ ├── EnchantedBrwny/
│ ├── GenesisMods/
│ ├── LittleSpoon/
│ ├── Mads/
│ ├── MissSnowieEmotes/
│ ├── MollyEmotes/
│ ├── Prue/
│ ├── Pupppy/
│ ├── QueenSistersAnimations/
│ ├── SapphireMods/
│ ├── Struggleville/
│ ├── ultrahacx/
│ ├── WhiskerValeMods/
│ ├── Whitecustom/
│ └── WolfSquareEmotes/
└── [Props]/ # Props 3D customizados (.ydr / .ytyp)
├── Brummiee/
├── BzzziProps/
├── CandyApple/
├── KayKayMods/
├── KnjghPizzaSlices/
├── NattyLollipops/
├── PataMods/
├── TayMcKenzieNZ/
└── UltraRingCase/
Config.Framework = falseO recurso funciona de forma independente, sem necessidade de framework.
Config.Framework = "qb-core"Os arquivos client/frameworks/qb-core.lua e server/frameworks/qb-core.lua são carregados automaticamente e fornecem integração com permissões, jobs e eventos do QBCore.
O recurso inclui +1 100 arquivos .ycd de animações customizadas streamadas localmente, provenientes de 24 criadores da comunidade FiveM, todos incluídos com permissão expressa dos autores originais.
Inclui props 3D de 9 criadores diferentes, streamados via DLC_ITYP_REQUEST, cobrindo itens como milkshakes, corações, skates, instrumentos musicais, joias, comidas temáticas, lanternas, bandeiras e muito mais.
Este recurso é baseado no dpEmotes, com todas as suas funcionalidades originais preservadas e a interface completamente substituída.
| Criador | Tipo de conteúdo |
|---|---|
| Amnilka | Poses fotográficas, casais |
| BoringNeptune | Danças (MJ Thriller, Wave) |
| BzZziEmotes | Give Love |
| ChocoholicAnimations | Singles, couples, skate |
| CMGMods | Couple poses, skate |
| CrunchyCat Poses | Poses táticas e policiais |
| DarkAnimations | Piano, saxofone, pool, estudo |
| DestinyCustoms | Smoking weapon |
| Dollie_Mods | Follow me |
| EnchantedBrwny | Casamentos |
| GenesisMods | Beijos (múltiplas variações) |
| LittleSpoon | Selfies, amizade, sexy |
| Mads | Poses policiais |
| MissSnowieEmotes | Variados |
| MollyEmotes | Variados |
| Prue | Variados |
| Pupppy | Variados |
| QueenSistersAnimations | Variados |
| SapphireMods | Variados |
| Struggleville | Variados |
| ultrahacx | Variados |
| WhiskerValeMods | Variados |
| Whitecustom | Props, comidas, eventos |
| WolfSquareEmotes | Variados |
Nota: Nenhuma animação paga foi incluída neste recurso. Todas as animações customizadas foram adicionadas com permissão expressa de seus respectivos criadores.
Este recurso é de uso privado e distribuído sob licença customizada do autor DoizzP (github: poolshev). A reutilização, redistribuição ou venda do código-fonte ou dos assets é proibida sem autorização explícita.
As animações customizadas pertencem a seus respectivos criadores e estão sujeitas às licenças individuais de cada um.
Desenvolvido por DoizzP · GitHub
Interface NUI desenvolvida do zero — sem NativeUI, sem frameworks externos.