Aircraft Company Garage

So you're running a CNAT simulation flight server and looking to add some depth to your player experience? You're in the right place. I've developed the Aircraft Company Garage plugin, now available as an open-source resource on GitHub, to bring a new level of realism and immersion to your game. Think of it as a specialized vehicle garage system, tailored specifically for your in-game aviation companies.

What Does Aircraft Company Garage Do? Company Hangars, Company Vehicles

This plugin essentially assigns company-specific hangars to players based on their affiliation. It's designed to feel familiar to players already accustomed to existing vehicle garage systems, but with a crucial difference: players can only access a limited selection of aircraft specific to their company within their assigned hangar. This adds a layer of strategic depth and reinforces the company structure within your server.

Key Features: Company-Specific Access, Easy Entry, Clear Instructions

Here’s a breakdown of what the Aircraft Company Garage plugin offers:

• Company-Specific Hangars: Players are automatically assigned hangars based on their company affiliation, creating a sense of belonging and territoriality.
• Limited Vehicle Selection: Only company-approved aircraft are accessible within the assigned hangar, promoting strategic choices and encouraging cooperation within companies.
• In-Game Menu Access: Simply press F6 to access the main menu and manage your garage.
• Simple Storage: Use F7/F3 (configurable) to easily store your aircraft within the designated hangar area.
• In-World Prompts: Upon entering a hangar area, clear prompts guide players on how to store their aircraft, ensuring a user-friendly experience.

Dependencies: Essential for Flight

To ensure smooth operation, the Aircraft Company Garage plugin relies on the following dependencies:

• es_extended: The backbone of many FiveM servers, providing essential framework functions.
• mysql-async: (Future Migration to omxySQL Planned) Handles asynchronous database queries.
• menuv: Provides the in-game menu system for easy garage access and management.
• polyzone: Used for defining the quadrilateral hangar areas, allowing for precise and customizable hangar locations.

Make sure you have these dependencies installed and configured correctly before installing the Aircraft Company Garage plugin.

Installation & Setup: Get Your Server Off the Ground

Here's a quick rundown of the installation process:

1. Download the Plugin: Grab the latest version from the GitHub repository. (Link to GitHub Repository Here)
2. Install Dependencies: Ensure you have es_extended, mysql-async, menuv, and polyzone installed and configured.
3. Database Setup: The initial setup requires manually populating the "aircraft_company_garage" table in your database. Make sure to populate the `aircraft_company` table as well, defining your hangar locations using four coordinates to define the quadrilateral area.
4. Configuration: Customize the plugin to your server's specific needs, such as keybindings, vehicle availability per company, and hangar locations.
5. Start the Resource: Add `ensure AircraftCompanyGarage` to your server.cfg file.

Detailed instructions and schema information can be found within the plugin's README file on GitHub.

Future Roadmap: Enhancements on the Horizon

I'm committed to improving the Aircraft Company Garage plugin and adding new features. Here are a few enhancements I'm considering for the future:

• Vehicle Damage Storage: Implementing the existing, but currently unused, database column to store vehicle damage information, adding a layer of realism and consequence to vehicle use.
• Migration to omxySQL: Potentially migrating from mysql-async to omxySQL for improved performance and compatibility.

Open Source & Ready for Collaboration: Your Feedback is Welcome!

This is my first foray into FiveM Lua development, and I've prioritized code clarity and readability. The code is extensively commented, making it a suitable learning tool for newcomers to FiveM scripting.

I welcome suggestions and feedback from the community! Feel free to submit pull requests, report bugs, or suggest new features on the GitHub repository. I'll do my best to incorporate your suggestions and make this plugin even better. Let's build something awesome together!

Download the Aircraft Company Garage plugin today and take your CNAT simulation flight server to new heights