# Madd Emoji (RedM)

A high-performance, immersive roleplay communication system that displays dynamic 3D icons above player characters. Designed for stability and scalability, this resource enhances player interaction through visual cues and mini-games while maintaining minimal client overhead.

## Features

•   **Optimized Rendering**: Utilizes a lightweight NUI system with distance-based culling and occlusion checks for maximum client performance.

•   **Framework Agnostic Design**: flexible core logic adaptable to any framework (currently integrated with VORP Core for character data).

•   **Multi-Icon Support**: Capable of rendering multiple simultaneous icons per player with automatic offset handling (e.g., dice rolls).

•   **Personalization**: Database-backed override system allowing unique icon sets for specific characters.

•   **Interactive Modules**: Includes built-in support for Dice, Rock-Paper-Scissors, and Tarot cards with associated animations.

•   **Dynamic Visuals**: Supports both static PNG and animated GIF formats with smooth spatial tracking.

•   **Configurable Limits**: robust cooldowns, duration settings, and distance checks to prevent spam and visual clutter.

## Preview

• Youtube Video

## Dependencies

-   `vorp_core` (User/Character management) can be changed in config

-   `oxmysql` (Database persistence)

## Locked Files

• cl_main.lua

• cl_animations.lua

• sv_main.lua

## Installation

1.  **Dependencies**:

    -   `vorp_core`

    -   `oxmysql`

 **Database**:

    Run the `SQL.sql` file to create the `madd_emoji_personal` table.

 **Config**:

    Adjust `config.lua` for sizes, cooldowns, and command names.