🫂 Carry & Animation Browser

Das mulderdev_carry Skript bietet nicht nur ein vollwertiges System zum Tragen von Spielern, sondern beinhaltet auch einen massiven, integrierten Animation Browser, um Hunderte von RDR2 Animationen direkt im Spiel zu testen und zu durchsuchen.

---

✨ Features

1. Tragesystem (Carry System)

Das Tragesystem ermöglicht es, andere Spieler auf zwei verschiedene Arten zu transportieren:

• Carry Mode (Leadout Style): Du nimmst den Spieler am Arm und führst ihn.
• Grab Mode (Grabbed Style): Du wirfst den Spieler über deine Schulter.

Während ein Spieler getragen wird, verliert das Ziel alle Steuerungsmöglichkeiten und ist unverwundbar ("no collision"). Der Träger selbst ist in seiner Bewegungsgeschwindigkeit eingeschränkt.

2. Animation Browser 🎬

Ein massives Werkzeug für Roleplay-Tester und Entwickler! Mit diesem Befehl öffnet sich ein UI-Browser, in dem du über 400 vordefinierte Animations-Dictionaries durchsuchen kannst:

• Wähle eine Kategorie (z.B. script_common@, amb_rest@, amb_camp@).
• Gib einen passenden Animationsnamen ein (idle, walk, action_01).
• Teste die Animation sofort am eigenen Charakter.
• Bietet einen Loop-Modus (Endlosschleife) und einen Stop-Button.

---

📥 Installation

1. Kopiere den Ordner mulderdev_carry in deinen resources Ordner.
2. Trage das Skript in deine server.cfg ein:

   ensure mulderdev_carry

3. Starte den Server neu.

---

🎮 Commands (Befehle)

Alle Standard-Befehle lassen sich in der config.lua anpassen.

Tragen

Befehl	Aktion	Erneute Eingabe
/carry	Carry Mode: Nimmt den nächsten Spieler am Arm	Lässt Spieler los
/grab	Grab Mode: Wirft Spieler über die Schulter	Lässt Spieler los

Animation Browser

Befehl	Aktion
/animbrowser oder /anim	Öffnet das Animations-Menü

---

⚙️ Konfiguration (config.lua)

Das Skript ist komplett anpassbar. Du kannst nicht nur die Befehle und die Reichweite ändern, sondern auch präzise die Koordinaten, Knochen (Bones) und Animationen einstellen, die für das Tragen verwendet werden.

Beispiel Config.Carry (Leadout Style)

Hier kannst du z.B. anpassen, an welchem Knochen der Ziel-Spieler befestigt wird (AttachBone = 24816) und wie hoch (OffsetZ) oder tief (OffsetX/Y) er im Verhältnis zum Träger hängt.

Config.Carry = {
    Command = "carry", -- Chat Befehl
    Distance = 2.0,    -- Interaktionsreichweite

    -- Animation des Trägers
    Carrier = {
        AnimDict = "script_story@mar8@ig@ig5_carry",
        AnimName = "action_01_walk_charles",
        AnimFlag = 25,
    },

    -- Details zum getragenen Spieler
    Target = {
        AnimDict = "script_story@mar8@ig@ig5_carry",
        AnimName = "action_01_walk_uncle",
        AnimFlag = 25,
        AttachBone = 24816, -- Knochen (Bone) wo er angehangen wird
        OffsetX = -0.35,
        OffsetY = -0.05,
        OffsetZ = 0.0,
        RotX = 0.0,
        RotY = 0.0,
        RotZ = 0.0
    }
}

Die Option Config.Grab

Genau identisch aufgebaut wie Config.Carry, nutzt aber mech_carry_ped@dead@carried@human Animationen, um das typische "Über die Schulter werfen" nachzuahmen. Die Offsets (z.B. OffsetZ = 0.70) sorgen dafür, dass der Spieler höher auf deim Rücken liegt.