🛩️ Ancomox Airdrop — Das Versorgungsabwurf-Event für deinen Server

Anfliegendes Transportflugzeug · markierte Abwurfzone · Fallschirm-Abwurf · geteilter Loot-Container · Spieler-Fackeln ·  Automatic Airdrops

Bereit, deinen Spielern ein Ereignis zu geben statt einer Kiste, die aus dem Nichts erscheint? Vergiss Airdrop-Scripts, bei denen „Abwurf" bedeutet, dass irgendwo ein Prop gespawnt wird und im Chat eine Zeile steht. Bei Ancomox Airdrop fliegt ein echtes Transportflugzeug den Abwurfpunkt an — und jeder Spieler auf dem Server sieht es live über seine Karte ziehen.

Von der Ankündigung bis zum Aufschlag vergeht rund eine Minute. Genug Zeit, um ins Auto zu springen, sich einen Weg zu überlegen und unterwegs festzustellen, dass drei andere dieselbe Idee hatten. Danach steht dort kein Instant-Loot, sondern ein geteilter Container, um den man sich streiten kann.

🛩️ Das Event — was wirklich passiert

Kein Prop, das erscheint. Ein Ablauf mit Anlauf, Höhepunkt und Nachspiel.

• 28 Sekunden Anflug: Das Transportflugzeug startet 2,2 km vom Abwurfpunkt entfernt und fliegt die komplette Strecke. Modell, Flughöhe, Geschwindigkeit und An-/Abflugstrecke stehen offen in der Config.
• 36 Sekunden am Fallschirm: Die Kiste löst sich aus 320 Metern, pendelt im Sinkflug, dreht sich um die eigene Achse und zieht eine farbige Rauchfahne — die Farbe hängt am Drop-Typ.
• Aufschlag mit Wirkung: Staubwolke, Sound, der Fallschirm klinkt aus. Danach liegt die Kiste da, wo sie hingehört — auf dem Boden, nicht darüber und nicht darin.
• Alle sehen dasselbe: Der Server berechnet einen kompletten Flugplan, jeder Client rechnet daraus dieselbe Position. Kein Spieler sieht das Flugzeug woanders als sein Nachbar.
• Automatisch oder auf Kommando: Alle 45 bis 90 Minuten von selbst, ab einer einstellbaren Spielerzahl, maximal zwei gleichzeitig. Oder per Befehl, wann immer du willst.

🗺️ Karte & HUD

Ein Event, das niemand mitbekommt, ist kein Event.

• Zone wird vorab markiert: Ein roter Radius von 200 Metern erscheint mit der Ankündigung — bewusst um bis zu 70 Meter versetzt, damit gesucht werden muss. Beim Aufsetzen wird er durch den exakten Kisten-Blip ersetzt.
• Das Flugzeug als Karten-Event: Ein bewegter Blip zieht über die Karte, für jeden Spieler sichtbar, egal wie weit entfernt. Physisch gerendert wird das Flugzeug erst in Sichtweite — der Blip ist immer da.
• HUD mit den Zahlen, die zählen: Typ, Zone, Countdown bis zur Landung, Entfernung und die Restzeit bis zum Verschwinden. Mehrere Drops gleichzeitig, nach Entfernung sortiert.
• Auffindbar ohne Rätselraten: Wer zu spät kommt, sieht am HUD sofort, ob sich der Weg noch lohnt.

📦 Die Kiste — ein geteilter Container, kein Instant-Loot

Der Unterschied zwischen „erster nimmt alles" und einer Szene, um die gekämpft wird.

• Erst aufbrechen: Ein Fortschrittsbalken, dessen Dauer am Drop-Typ hängt — drei Sekunden beim Sanitäts-Drop, zwölf beim exotischen. Optional mit benötigtem Werkzeug, das wahlweise verbraucht wird.
• Mehrere gleichzeitig: Die Kiste öffnet ein echtes Inventar mit 10 bis 18 Slots. Spieler teilen sich den Inhalt, nehmen mit, was sie tragen können, und kommen für den Rest zurück.
• Verschwindet, wenn sie leer ist: Sechs Sekunden nach dem letzten Gegenstand ist sie weg. Geprüft wird der echte Inhalt des Stashs, nicht eine mitgezählte Liste.
• Oder nach 25 Minuten: Wer sie nicht findet, verliert sie. Drei Minuten vorher gibt es eine Warnung — nur für Spieler in der Nähe, nicht für den halben Server.
• Zugriff regelbar: Optional auf bestimmte Jobs beschränkt, gesperrt im Fahrzeug, gesperrt im Downed-Zustand.

🎲 Loot-Engine

Gewichte statt Prozente. Du musst nichts auf 100 aufaddieren, damit es funktioniert.

• Vier Drop-Typen enthalten: Standard, Selten, Exotisch und Sanität — mit eigenen Flugzeugmodellen, Rauchfarben, Blip-Farben, Container-Größen und Aufbruchzeiten.
• Garantiert und gezogen: Was immer drin sein soll, steht unter guaranteed. Der Rest wird gewichtet aus dem Pool gezogen, so oft wie du rolls setzt.
• Einmalig ziehbare Einträge: Ein unique-Flag verhindert, dass dieselbe Waffe dreimal in einer Kiste landet.
• Geld statt Item: Ein Eintrag mit account wird direkt gutgeschrieben — Bargeld, Bank oder Schwarzgeld. Bei QBCore, das kein Schwarzgeld kennt, greift automatisch markiertes Geld.
• Waffen nur einmal schreiben: Du schreibst weapon_pistol. Läuft ox_inventory, wird daraus automatisch WEAPON_PISTOL. Munitionsnamen bleiben unangetastet.
• Stapelt von selbst: Zieht der Pool dasselbe Item zweimal, entsteht ein Stapel statt zwei halbleerer Slots.
• Sagt dir Bescheid, wenn etwas fehlt: Existiert ein Item in deinem Inventar nicht, warnt die Konsole beim ersten Drop im Klartext — statt dass Spieler eine leere Kiste finden und du rätst.

🗺️ Abwurfzonen

• Fünf Zonen aktiv, zwei vorbereitet: Sandy Shores, Grand Senora, Mount Chiliad, Zancudo-Umland und das Alamo-Sea-Ufer sind an. Chumash und Cayo Perico liegen fertig dabei und werden mit einem true aktiviert.
• Zwei Modi je Zone: Zufälliger Punkt im Radius mit automatischer Boden-Erkennung — oder handverlesene Koordinaten, die als vermessen gelten und keine Prüfung mehr brauchen. Für Gebirge und Küsten ist der zweite Modus der richtige.
• Wasser wird umgangen: Landet der gewählte Punkt im Wasser, sucht das Script bis zu viermal einen neuen.
• Sperrbereiche: Polizeiwache, Flughafen und Krankenhaus sind ab Werk ausgeschlossen. Weitere trägst du als Koordinate mit Radius ein.
• Zeitfenster pro Zone: Eine Zone kann auf bestimmte Ingame-Stunden begrenzt werden — Nachtzone, Feierabendzone, wie du willst.

🔥 Spieler-Fackeln

Ein Airdrop, den Spieler selbst auslösen — ohne dass daraus ein Automat wird.

• Zwei Fackel-Items: Eine für den Standard-Drop, eine für den seltenen. Jede ruft ihren eigenen Typ.
• Cooldowns, die halten: 30 Minuten pro Spieler, 5 Minuten global. Mit Datenbank überleben sie einen Serverneustart.
• 25 Sekunden Vorlauf: Die Fackel brennt sichtbar, dann kommt das Flugzeug. Genug Zeit, dass andere den Rauch sehen.
• Gesperrte Bereiche: Wo nicht gezündet werden darf, passiert nichts — der Spieler bekommt eine Meldung statt eines fehlgeschlagenen Drops.
• Item zurück, wenn nichts kommt: Scheitert der Abwurf, bekommt der Spieler die Fackel wieder und der Cooldown wird zurückgesetzt.
• Die Position kommt vom Server: Ausgelesen aus dem echten Ped, nicht aus dem, was der Client meldet.

🚔 Polizei & Dispatch

• Meldung beim Start: Unbekanntes Flugobjekt, Abwurf gemeldet — an die konfigurierten Jobs, auf die ungefähre Zone.
• Meldung beim Plündern: Wenn jemand die Kiste öffnet, mit einstellbarer Wahrscheinlichkeit. Ab Werk 65 %, damit es nicht jedes Mal kommt.
• Angebunden an dein System: ps-dispatch, cd_dispatch und qs-dispatch werden erkannt. Hast du keines, verschickt das Script eine eigene Meldung mit zeitlich begrenztem Blip.

🔒 Sicherheit & Anti-Exploit

Kein Betrag, keine Position und kein Zugriff kommt jemals vom Client.

• Der Client sendet während der Szene gar nichts: Anflug, Abwurf und Landung laufen über Server-Timer. Es gibt schlicht kein Event, das man missbrauchen könnte.
• Distanz wird serverseitig neu geprüft: Bei jedem Öffnen und jeder Entnahme, gegen die echte Ped-Position. Waagerecht streng, senkrecht mit Toleranz — Looten aus dem Stockwerk darüber geht nicht, ein leichter Höhenversatz sperrt aber auch niemanden aus.
• Einmalige Unlock-Tickets: Der Server vergibt vor dem Fortschrittsbalken ein Ticket mit Zeitstempel und zieht es beim Öffnen ein. Wer den Balken überspringt, kommt nicht durch.
• Rate-Limits pro Spieler und pro Event-Typ: 30 Aufrufe je zehn Sekunden, getrennt nach Aktion. Event-Spam läuft ins Leere, echte Klicks funktionieren.
• Mengen werden validiert: Gegen NaN, gegen Unendlich und gegen den tatsächlichen Restbestand. Ein Eintrag lässt sich nicht doppelt entnehmen.
• Boden-Höhe per Konsens: Bis zu drei Clients werden unabhängig befragt, der Median gewinnt. Ein einzelner manipulierter Client kann die Kiste nicht an eine unerreichbare Höhe legen.
• Verstöße werden protokolliert: Mit Name, Identifier und Grund in der Konsole, optional an Discord. Ab vier Verstößen wird gekickt — abschaltbar.
• Discord-Webhooks: Fünf Kategorien einzeln schaltbar — Start, Loot, Ende, Admin-Aktionen und Sicherheitsverstöße.

⚙️ Kompatibilität & Entwicklerfreundlichkeit

• Frameworks: es_extended, qb-core und qbx_core werden automatisch erkannt — oder gar keines, im Standalone-Betrieb.
• Erkennung läuft nach: Startet eine Abhängigkeit nach diesem Resource, wird sie trotzdem gefunden. Kein „Framework: standalone", weil die Ladereihenfolge in der server.cfg unglücklich war.
• Inventar: ox_inventory, qb-inventory, qs-inventory und das Framework-eigene Inventar. Ist keines davon da, übernimmt ein eingebautes Loot-Fenster — mit derselben Server-Prüfung wie alle anderen.
• Third-Eye: ox_target und qb-target. Ohne beides schaltet das Script auf 3D-Text mit Tastendruck um.
• Oberfläche: Benachrichtigungen, Fortschrittsbalken und TextUI laufen über ox_lib, ESX oder QBCore — je nachdem, was läuft. Ist nichts davon da, greift die eingebaute Variante.
• Keine harten Abhängigkeiten: Auf einen nackten Server legen und starten. Jede Integration ist ein Bonus, keine Voraussetzung.
• Mehrsprachig: Deutsch, Englisch, Französisch und Spanisch. Fehlt ein Schlüssel in deiner Sprache, greift automatisch Englisch statt eines leeren Feldes.
• Server-Exports: StartAirdrop, EndAirdrop und GetActiveAirdrops — für eigene Events, Belohnungen oder ein Adminmenü.
• Admin-Befehle: /airdrop [typ] [hier], /airdropcancel <id|all> und /airdroplist. Rechte über ACE, das in jedem Framework funktioniert, oder über Framework-Gruppen.
• Statistiken, wenn du willst: Mit oxmysql landet jeder Drop und jede Entnahme in der Datenbank. Ohne läuft alles weiter, nur ohne Auswertung.

📋 Systemanforderungen

Die kurze Fassung: du brauchst nichts. Das Script läuft auf einem leeren FiveM-Server. Alles Weitere macht es schöner, ist aber keine Bedingung.

Zwingend erforderlich

Das war es. Kein Framework, keine Datenbank, keine Library ist Pflicht.

Optional

Nach dem Kauf in fünf Minuten erledigt

1. Ordner in resources legen, ensure ancomox_airdrop in die server.cfg.
2. Konsole ansehen: das Script meldet beim Start, welches Framework, Inventar und Target es erkannt hat.
3. config/loot.lua öffnen und die Item-Namen gegen deine echten Items tauschen.
4. config/zones.lua durchgehen. Für Gebirge und Küsten eigene Koordinaten setzen und preferPoints = true verwenden — das ist der zuverlässigste Modus.
5. Adminrecht setzen: add_ace group.admin ancomox.airdrop allow.
6. Optional: Fackel-Items eintragen, Discord-Webhooks hinterlegen.
7. Testen mit /airdrop standard und zusehen, wie der Blip über die Karte zieht.

🛡️ Escrow & Anpassbarkeit

Dieses Skript wird über das offizielle Cfx.re Asset Escrow System ausgeliefert. Die Kernlogik ist verschlüsselt. Alles, was du zum Anpassen brauchst, bleibt vollständig offen und bearbeitbar:

• config/config.lua — Erkennung, Intervalle, Flugzeug, Kiste, Blips, Interaktion, Sicherheit, Webhooks, HUD
• config/zones.lua — Abwurfzonen, Sperrbereiche, Regeln für die Punktwahl
• config/loot.lua — Drop-Typen und Loot-Tabellen
• locales/ — alle vier Sprachdateien, jeder einzelne Text
• items/ — die fertigen Item-Einträge für ox_inventory und QBCore
• sql/, README, INSTALL und CHANGELOG

Damit Escrow funktioniert, muss dein FiveM-Server-Key in deinem Keymaster mit dem Tebex-Kauf verknüpft sein. Das passiert beim Kauf automatisch über deine Cfx.re-Anmeldung.

❓ Häufige Fragen

Brauche ich ox_lib, ox_target oder eine Datenbank?
Nein. Für jede Integration gibt es einen eingebauten Fallback. Sind sie installiert, werden sie automatisch genutzt.

Läuft es ohne Framework?
Ja. Im Standalone-Betrieb übernimmt das eingebaute Loot-Fenster die Kiste, und die Adminrechte kommen über ACE-Berechtigungen.

Sehen wirklich alle Spieler dasselbe Flugzeug?
Ja. Der Server schickt einen Flugplan, jeder Client rechnet daraus dieselbe Position. Der Karten-Blip ist für alle sichtbar, das Flugzeug selbst wird in Sichtweite gerendert.

Was passiert, wenn niemand in der Nähe der Abwurfzone ist?
Flugzeug und Kiste fliegen und landen trotzdem exakt nach Plan — die Zeitsteuerung läuft auf dem Server. Wer später ankommt, findet die Kiste genau dort, wo sie liegt.

Können Spieler durch eine Wand oder vom Dach looten?
Nein. Jede Aktion prüft die echte serverseitige Position erneut, waagerecht wie senkrecht.

Kann ich Loot, Zonen und Zeiten ändern?
Alles. Drei Config-Dateien, durchgehend kommentiert, außerhalb des Escrow.

Wie viele Zonen sind dabei?
Sieben, davon fünf aktiv. Chumash und Cayo Perico liegen fertig dabei und werden mit einem Schalter aktiviert. Eigene Zonen sind ein Eintrag mit Koordinate, Radius oder festen Punkten.

Kollidiert das mit meinem bestehenden Airdrop-Script?
Nur wenn beide laufen. Nimm das alte aus der server.cfg — Item-Namen und Loot-Tabellen übernimmst du in wenigen Minuten in die Config.