Shell Spawner & IPL Management Suite

A premium, high-performance FiveM resource designed for the persistent spawning and management of interior shells as world-wide IPLs.

✨ Features

• Persistent Spawning: Shells are registered as mission-entities and saved to a local JSON database, surviving server restarts.
• Premium NUI Dashboard: A glassmorphism-styled management interface for tracking, teleporting, editing, and deleting shells.
• Dynamic Placement System:
  • Advanced Freecam: Fly through the world to find the perfect spot.
  • Axis-Locked Movement: WASD movement is locked to the XY plane for stability.
  • Rotation Snapping: Toggle between free rotation and 90° increments (G key).
  • Precision Speed Control: Adjust movement speed dynamically via Scroll Wheel.
  • Independent Zoom: Zoom the camera without shifting the shell's position (V key).
• Manual Editing: Directly refine X, Y, Z, and Rotation coordinates from the UI.
• Admin Permissions: Robust support for Ace Permissions and Identifier-based security.

🎮 Controls (Placement Mode)

Key	Action
W, A, S, D	Move Shell (Horizontal XY)
L-SHIFT / L-CTRL	Move Shell (Vertical Z)
Q / E	Rotate Shell (Normal or Snapped)
G	Toggle 90° Rotation Snapping
V	Cycle Camera Zoom Distance
Scroll Wheel	Increase/Decrease Movement Speed
ENTER	Confirm and Save Shell
BACKSPACE	Cancel Selection

🛠️ Installation

1. Copy the Fury-shellspawner folder to your resources directory.
2. Add ensure Fury-shellspawner to your server.cfg.
3. (Optional) Add Ace Permissions:

   add_ace group.admin command.shellmanager allow

⚙️ Configuration

Modify config.lua to:

• Enable/Disable Ace Permissions.
• Add manual Admin Identifiers.
• Change the primary management command name.
• Toggle action logging.

📄 License

MIT License - See the LICENSE file for details.