⏸️ FX-PAUSEMENU

Advanced pause menu system for RedM with animations, rewards system, leaderboard, hotkeys display, and full framework compatibility.

---

📦 INSTALLATION

ensure fx-pausemenu

• Place the script inside resources/fx-pausemenu • Add ensure fx-pausemenu to your server.cfg • Restart your server

---

⚙️ BASIC SETTINGS

Config.Language = "en"

• Defines system language • Used for UI and notifications

---

🎬 PAUSE ANIMATION SYSTEM

Config.PauseMenuAnimation = {
  Random = true,
  Animations = {
    {scenario = "WORLD_HUMAN_WRITE_NOTEBOOK"}
  }
}

• Plays animation when pause menu is opened • Random → selects random animation • Supports scenario and prop-based animations

---

🎯 ACTION REQUIREMENT SYSTEM

Config.ActionRequirements = {
  map = {
    enabled = true,
    item = "map",
    amount = 1
  }
}

• Requires item to use certain actions • Example → map requires "map" item • Can be disabled

---

📊 LEADERBOARD SYSTEM

Config.LeaderboardLimits = {
  weekly = 10,
  total = 50
}

• Limits leaderboard display • weekly → weekly top players • total → all-time players

---

⏱️ SAVE SYSTEM

Config.SaveInterval = 60

• Saves player playtime periodically • Value is in seconds • Prevents data loss

---

🎁 DAILY REWARD SYSTEM

Config.DailyRewards = {
  [1] = {
    label = "Daily Reward #1",
    requiredTime = 60
  }
}

• Rewards based on playtime • requiredTime → minutes required • Includes money and item rewards

---

Config.DailyResetHour = 0

• Resets daily rewards at specific hour • Example → 0 = midnight

---

Config.DailyResetCmdCommand = "resetdaily"

• Command to reset rewards manually

---

🏆 WEEKLY REWARD SYSTEM

Config.EnableWeeklyRewards = true
Config.WeeklyResetDay = "monday"
Config.WeeklyResetHour = 20

• Enables weekly rewards • Rewards top players by playtime • Automatically distributed

---

Config.WeeklyRewards = {
  [1] = {
    label = "First Player #1"
  }
}

• Defines rewards for top players • Supports money and items

---

📈 TOTAL TIME REWARD SYSTEM

Config.TotalTimeRewards = {
  [1] = {
    label = "5 Hours",
    requiredTime = 300
  }
}

• Rewards based on total playtime • Permanent progression rewards • Encourages long-term play

---

🎮 HOTKEY SYSTEM

Config.Hotkeys = {
  ["Z"] = {label = "Ragdoll"},
  ["B"] = {label = "Point Finger"}
}

• Displays keybinds in UI • Helps new players • Fully customizable

---

🎯 HUD CONTROL

Config.HideHud = function()
Config.ShowHud = function()

• Automatically hides HUD when menu opens • Works with fx-hud • Optional system

---

🔔 NOTIFY SYSTEM

Notify({
  text = "Reward claimed",
  type = "success"
})

• Framework-based notification system • Supports VORP / RSG / REDEMRP

---

🌐 LOCALE SYSTEM

Config.Locale = {
  ["en"] = {
    ["rewardClaimed"] = "You received: ${items}"
  }
}

• Multi-language support • Fully customizable messages

---

⚙️ SERVER CONFIG

SV_Config.Webhook = {
  url = "YOUR_WEBHOOK",
  logo = "...",
  banner = "...",
  color = 16775871
}

• Discord logging system • Sends events to webhook • Optional but recommended

---

🔧 VORP SETUP

self.Joblabel = function(value)

• Required for job label sync • Updates job label in UI • Must be replaced in vorp_core

---

⚠️ IMPORTANT NOTES

• Rewards depend on playtime • Daily reset must be configured • Weekly rewards require EnableWeeklyRewards • HUD integration requires fx-hud • Locale must match selected language

---

🚨 COMMON MISTAKES

• Rewards not working → wrong time config • Leaderboard empty → playtime not saved • Animation not playing → invalid scenario • HUD not hiding → fx-hud not running • Webhook not sending → invalid URL

---

🏁 SUMMARY

FX-PAUSEMENU provides:

• Advanced pause menu system • Daily / weekly reward system • Leaderboard system • Animation system • Hotkey UI system • Full framework compatibility

---

© Fixitfy Development