NYKS Bird Post - Immersive Bird Post System for RSG & VORP

NYKS Bird Post - Immersive Bird Post System for RSG & VORP

$40.00

Add to Basket

✉️ NYKS Bird Post - Immersive Bird Post System RSG & VORP

Preview video: NS-Bird Post Advanced Post SCRIPT 

Offer your players a unique and immersive way to communicate. nyks_birdpost is a feature-rich, NUI-based mail and delivery script designed exclusively for the VORP framework. It replaces generic text messaging with a full in-game experience, including physical bird models, animated letter reading, and a robust usage system for all mail materials.

🌟 Core Features

  • Immersive NUI Interface: Features a clean, aesthetic, and fully functional NUI that handles Mailbox registration, sending letters, and purchasing messenger birds.

  • Realistic Mail Economy: Mail materials (birds, pens, paper) are treated as consumable items with limited uses. The default usage limit is 5 uses per item.

  • Dynamic Delivery System:

    • Bird Variety: Supports 10 unique bird models (e.g., Eagle, Owl, Pigeon, Hawk) for different speeds and prices.

    • Time-Based Delivery (ETA): Each bird model has a unique ETA (Estimated Time of Arrival), causing a delay between sending and receiving (e.g., Messenger Owl: 5s, Messenger Eagle: 10s).

    • Physical Bird Animation: On send and receive, the chosen bird model physically spawns and flies away or arrives near the player, fully immersing the player in the experience.

  • Mailbox Management:

    • Players must register a mailbox ID for a configurable fee.

    • Lazy Loading: Mailbox inventories are only registered/loaded when a player accesses them, ensuring optimal server performance.

    • Includes a toggle to force all mail delivery to the Mailbox Inventory, even if the recipient is online (Config.AlwaysSendToMailbox).

  • Advanced Discord Webhook Logging: When enabled (Config.EnableWebhook = true), it tracks every mail operation.

    • Logs the Sender, Receiver (Discord Tag & Name), Bird Type, and Message content.

    • Detailed Delivery Statuses: Reports statuses like Delivery Success, Distance Exceeded, Insufficient Funds, Missing Materials, and more.

  • Distance and Range Checks: A configurable maximum delivery distance (Config.MaxDeliveryDistance = 1000 units) is checked if the recipient is online, simulating the bird's range.

  • Immersive Reading Animation: Players can set their preferred animation for reading the received "Mail" item from their inventory (4 options via the /ARead command).

  • Multiple Locations: Features configurable locations for both Mailboxes and Bird Shops, complete with Blips and NPC spawns/despawns (using proximity).

  • Native Prompt System: Uses the native RedM prompt system (e.g., "Hold E to Open") for an authentic and performance-friendly in-game experience.

🛠️ Technical Requirements (Dependencies)

The following resources are required for this script to function correctly:

  • oxmysql

🚀 Installation Steps

  1. Place the script files (nyks_birdpost) into your resources/ directory.

  2. Add ensure nyks_birdpost to your server.cfg file, after its dependencies.

  3. Import the nyks_birdpost_items.sql file into your database. This adds the Mail, Letter Pen, Letter Paper, and 10 Bird Items to your items table.

  4. Open config.lua and change Config.WebhookURL to your own Discord webhook URL (Optional, but recommended).

  5. Open config.lua and adjust fees and distances to your server's economy.

  6. Start your server. Players can now use a Bird Shop to buy a bird, use the bird item to open the mail menu, and register their mailbox.