wasvendel_emote

Installation

Unzip wasvendel_emote.
Drag the wasvendel_emote folder into your server's resources directory.
Import wasvendel_emote.sql into your database.
Add the resource to your server.cfg after your framework core.

cfg

ensure oxmysql
ensure your_core
ensure wasvendel_emote

SQL

Import wasvendel_emote.sql to enable favorites and saved walk or face style persistence.

The resource also attempts to run auto-migration on first start.

Configuration

Edit config.lua to configure commands, categories, animations, and sync radius.

Setting	Description
`Config.Commands`	Command names for the menu, favorites, cancel, props, and play commands.
`Config.BlockUseWhen`	States that block emote usage.
`Config.BlockCancelWhen`	States that block emote cancellation.

Commands

Command	Usage	Description
`/emenu`	`/emenu`	Opens the emote menu.
`/efav`	`/efav`	Opens the favorites menu.
`/ecancel`	`/ecancel`	Cancels the current emote.
`/clearprops`	`/clearprops`	Clears attached props.
`/e`	`/e [animId]`	Plays an emote by ID.

All command names are configurable in config.lua under Config.Commands.

Events

Client Events

Sync

Event	Payload	Description
`wasvendel_emote:syncPlay`	`sourceId, animId`	Syncs that another player started an emote.
`wasvendel_emote:syncStop`	`sourceId`	Syncs that another player stopped an emote.

Paired Emotes

Event	Payload	Description
`wasvendel_emote:playPaired`	`partnerServerId, role, data`	Starts a paired emote as `att` or `vic`.
`wasvendel_emote:targetMessage`	`fromId, fromName, animId`	Sends a paired emote request notification.

Saved Styles

Event	Payload	Description
`wasvendel_emote:applySavedWalk`	`animId`	Applies the saved walk style.
`wasvendel_emote:applySavedFace`	`animId`	Applies the saved face expression.
`wasvendel_emote:sendFavs`	`favs, type`	Sends the favorites list to the UI.

Server Events

Event	Payload	Description
`wasvendel_emote:requestFavs`	`type`	Requests favorites by type.
`wasvendel_emote:toggleFav`	`emoteId`	Toggles an emote as favorite.
`wasvendel_emote:saveWalkStyle`	`animId`	Saves the walk style.
`wasvendel_emote:saveFaceStyle`	`animId`	Saves the face style.
`wasvendel_emote:notifyTarget`	`targetId, animId`	Sends a paired emote request.
`wasvendel_emote:reply`	`requesterId, accepted, animId`	Accepts or declines a paired emote request.
`wasvendel_emote:syncPlay`	`animId`	Broadcasts the emote to nearby players.
`wasvendel_emote:syncStop`	None	Broadcasts the emote stop.

Play an Emote from Another Resource

Trigger the play flow on the client by using the /e command flow, or call the internal sync after your own animation logic.

lua

-- Server: force sync to nearby players after your own animation logic
TriggerClientEvent("wasvendel_emote:syncPlay", -1, src, "anim_id_here")

For walk and face style restore on spawn, the resource handles wasvendel_emote:requestSavedStyles automatically on character load.