Features Guide

Moon Advanced Stashes is a fully persistent, physical stash system built for immersive and secure FiveM roleplay servers. This guide explains every major system and how it works.

---

🌍 1. Physical Stash Placement

Overview

Players can place physical stash objects directly into the world using stash items.

How It Works

• A stash item is used from inventory.

• A live preview object appears.

• Players can rotate and position the stash.

• Once placed, the stash becomes a persistent world object.

Key Features

• Smooth placement preview

• Scroll-based rotation

• Cancel option

• Optional zone restrictions

• Server-side validation on placement

---

💾 2. Full Persistence System

Overview

Stashes are permanently stored in the database.

What This Means

• Stashes survive server restarts

• Items inside are never wiped

• Access permissions remain saved

• No duplication or ghost entities

Technical Behavior

• Each stash is saved with:

  • Unique stash ID

  • Owner identifier

  • Coordinates

  • Heading

  • Slot count

  • Weight limit

  • Access list

---

🔐 3. Ownership System

Overview

Every stash is permanently bound to a single owner.

Rules

• Only the owner can manage access.

• Only the owner (or trusted members) can open the stash.

• Other players cannot steal or interact with it.

• Pickup is restricted to authorized players.

---

👥 4. Access Management System

Overview

Owners can grant or revoke stash access to other players.

Permissions

• Open access

• Pickup access (optional if enabled)

Features

• Access managed directly from the stash

• Stored in the database

• Persistent across restarts

• Members see stash blips (if enabled)

---

🎒 5. Inventory Integration

Supported Inventories

• QB Inventory

• ox_inventory

Features

• Custom slot amount per stash

• Custom weight limit per stash

• Opens like a normal stash inventory

• Metadata-safe logic

• Inventory abstraction via bridge system

---

🚫 6. Empty Pickup Protection

Overview

Players cannot pick up a stash if it contains items.

Behavior

• The system checks stash contents.

• If items exist, pickup is blocked.

• Once empty, the stash can be picked up.

• Picking up returns the original stash item (with metadata).

This prevents:

• Item hiding exploits

• Instant contraband teleportation

• Duplication

---

🚔 7. Police Raid System

Overview

Stashes can be raided through a controlled warrant system.

Requirements

• Valid raid warrant item

• Warrant must match stash ID

• Owner must be online

• Minigame must be completed successfully

DOJ / Judge Command

/generateraidwarrant [stashId]

Security Features

• Metadata-bound warrant system

• Warrant consumed on use

• Owner & members notified during raid

• Fully server-validated

---

📍 8. Zone-Based Placement System (Optional)

Overview

Administrators can restrict stash placement to specific PolyZones.

Features

• Configurable zone list

• Placement allowed only inside zones

• Client-side validation

• Optional zone blips

Use Cases

• Gang territories

• Warehouse districts

• Drug operation zones

• Storage yards

---

🗺 9. Map Blips System

Zone Blips

• Displays designated placement areas

• Configurable sprite, color, scale

Personal Stash Blips

• Owners see their stash locations

• Members with access see shared stash locations

• Not visible to unauthorized players

---

📊 10. Maximum Stash Limit

Overview

Administrators can set a maximum number of stashes per player.

Behavior

• Limit enforced server-side

• Relocating a stash does not count as a new one

• Prevents map clutter and abuse

• Fully configurable in config.lua

---

⚡ 11. Streaming & Performance System

Overview

Stashes are optimized for large servers.

Features

• Stashes only spawn when players are nearby

• Automatic despawn when out of range

• Reduced entity load

• Scales well with many active stashes

---

🔧 12. Framework Support

Supported Frameworks

• QBCore

• QBOX

• ESX

Implementation

• Framework abstraction layer

• Identifier normalization

• Inventory wrapper support

---

🎯 13. Target System Support

• qb-target

• ox_target

Context menus and interaction are fully supported.

---

🛡 14. Security & Anti-Exploit Design

Moon Advanced Stashes is built with server-side authority.

Security highlights:

• No client-trusted placement logic

• Metadata-bound stash IDs

• Server-validated pickup logic

• Inventory abstraction

• No duplicate stash creation

• Safe database persistence

• Proper entity cleanup

Designed to be production-ready and stable under heavy RP environments.

---

🧩 15. Configuration Overview

Configurable options include:

• Maximum stashes per player

• Zone system toggle

• Blip settings

• Raid warrant item

• Debug mode

• Inventory selection

• Framework selection

• Weight & slot defaults

All configurable via config.lua.

---

📌 Summary

Moon Advanced Stashes provides:

• Immersive physical storage

• Persistent world integration

• Secure access control

• Law enforcement interaction

• Performance optimization

• Cross-framework compatibility

It is designed for serious RP servers that require stability, security, and realism.