Skip to content

Fury044/Fury-offsetfinder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Shell Offset Finder 🛠️

A professional, high-fidelity developer utility for FiveM designed to capture precise interior offsets within world-spawned shells. This tool streamlines the configuration process for complex housing resources like RTX, VMS, QB-Core, and ESX.

✨ Features

  • Premium Glassmorphism UI: A stunning, modern interface with real-time coordinate synchronization.
  • Multi-Point Configuration Wizards:
    • RTX Pro Wizard: Support for Exit, Management, Wardrobe, Storage, Cook, Sink (Water/Player), Shower (Water/Player), and dynamic Cleaning Points.
    • VMS Pro Wizard: Specialized interaction sets (Focus/Water/Player) for door and interactive objects.
    • QB Pro Wizard: Dual-mode support for Apartment (json.decode strings) and Housing exports.
    • ESX Property Wizard: Sequential capture for Wardrobe, Storage, and Entrance.
  • Automated Workspace: Automatically deletes previous shells upon new spawn and teleports you into the workspace instantly.
  • Positioning Mode: Release NUI focus to navigate freely between capture points while keeping wizards active.
  • Visual Debugging: Green origin markers and Cyan trace lines (toggable) for pixel-perfect alignment.

🚀 Getting Started

Installation

  1. Clone or download this repository into your resources folder.
  2. Ensure the resource in your server.cfg:
    ensure shell-offsetfinder

📖 How to Use

  1. Spawn a Shell: Use /oshell [model_name] to spawn a shell and teleport inside.
  2. Position Yourself: Walk to the exact location you want to capture (e.g., the wardrobe or door).
  3. Capture / Export:
    • Press Enter to open the Export Menu if you just want a quick offset.
    • Select a Wizard (RTX, VMS, QB, ESX) for a multi-point automated setup.
  4. Finish: Once all points are captured, enter a label and click Generate. The code block will be copied to your clipboard instantly.
  5. Cleanup: Press H (/odel) at any time to delete the shell and return to your original position.

Basic Commands

Command Description Keybind
/oshell [model] [rotation] Spawn a shell and teleport inside. -
/odel Delete the active shell and return to world. H
/oui Toggle the live coordinate overlay cards. G
copyplayeroffset Capture point or open export menu. ENTER

🏗️ Supported Formats

The tool generates ready-to-paste code blocks for the following systems:

  • BCS Housing
  • PS Housing (Standard & Labeled)
  • Loaf Housing
  • Origen Housing
  • VMS Housing (Interaction sets)
  • RTX Housing (Multi-location)
  • QB-Core (Apartments & Housing)

🛠️ Performance

  • Zero Idle Impact: The script utilizes optimized sleep intervals and only activates synchronization loops when a shell is spawned.
  • Frame-Safe Rendering: Utilizes native drawing methods for markers and lines.

🤝 Contributions

Contributions are what make the community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

Distributed under the MIT License. See LICENSE for more information.


Developed with ❤️ by Fury & Antigravity

About

A professional, high-fidelity developer utility for FiveM designed to capture precise interior offsets within world-spawned shells. This tool streamlines the configuration process for complex housing resources like RTX, VMS, QB-Core, and ESX.

Topics

Resources

License

Stars

Watchers

Forks

Contributors