Configuration

Welcome to MBT Malisling Configuration Guide!

MBT.Debug = false

If set to true, this variable enables debugging information to be displayed. Debugging information can help developers track issues and understand how the system is functioning. For non-developers, it's generally safe to leave this as false unless you're troubleshooting with assistance from a developer.

---

MBT.DropWeaponOnDeath = true

When set to true, this variable allows players to drop their weapons upon death. Set it to false to prevent dropping weapons on death.

---

MBT.EnableSling = true

Setting this variable to true enables the feature of holstered weapons on the character's body (slinging). If set to false, weapons won't be holstered on the character. This can enhance realism and visual appeal.

---

MBT.EnableFlashlight = true

Set this variable to true to enable flashlights on weapons. Set it to false to disable flashlights.

---

MBT.Relog = false

If you're using a feature called esx_multicharacter and relog is enabled, set this to true. If you're not using these features, keep it as false.

---

MBT.Jamming = {
    ["Enabled"] = true,
    ["Cooldown"] = 5,
    ["Animation"] = { ["Dict"] = "anim@weapons@first_person@aim_rng@generic@pistol@singleshot@str", ["Anim"] = "reload_aim" },
    ["Chance"] = {
        [50] = 10,
        [40] = 15,
        [30] = 20,
        [20] = 25,
        [10] = 30
    }
}

This section contains settings related to weapon jamming behavior:

• Enabled: Set to true to enable weapon jamming functionality.

• Cooldown: Specifies the time (in seconds) before a jammed weapon can be fired again.

• Animation: Dictates the animation played when the character reloads a jammed weapon.

• Chance: Defines the probability of jamming based on remaining ammo, where keys represent ammo percentages and values represent jamming chances.

---

MBT.Throw = {
    ["Enabled"] = true,
    ["Animation"] = { ["Dict"] = "melee@unarmed@streamed_variations", ["Anim"] = "plyr_takedown_front_slap" },
    ["Groups"] = {
        [`GROUP_MELEE`] = { ["Allowed"] = true, ["Multipliers"] = { ["X"] = 40.0, ["Y"] = 40.0, ["Z"] = 15.0 } },
        [`GROUP_PISTOL`] = { ["Allowed"] = true, ["Multipliers"] = { ["X"] = 20.0, ["Y"] = 20.0, ["Z"] = 15.0 } },
        [`GROUP_RIFLE`] = { ["Allowed"] = true, ["Multipliers"] = { ["X"] = 10.0, ["Y"] = 10.0, ["Z"] = 5.0 } },
        [`GROUP_MG`] = { ["Allowed"] = false, ["Multipliers"] = { ["X"] = 20.0, ["Y"] = 20.0, ["Z"] = 10.0 } },
        [`GROUP_SMG`] = { ["Allowed"] = true, ["Multipliers"] = { ["X"] = 20.0, ["Y"] = 20.0, ["Z"] = 10.0 } },
        [`GROUP_SHOTGUN`] = { ["Allowed"] = true, ["Multipliers"] = { ["X"] = 20.0, ["Y"] = 20.0, ["Z"] = 10.0 } },
        [`GROUP_STUNGUN`] = { ["Allowed"] = true, ["Multipliers"] = { ["X"] = 20.0, ["Y"] = 20.0, ["Z"] = 10.0 } },
        [`GROUP_SNIPER`] = { ["Allowed"] = false, ["Multipliers"] = { ["X"] = 20.0, ["Y"] = 20.0, ["Z"] = 10.0 } },
        [`GROUP_HEAVY`] = { ["Allowed"] = false, ["Multipliers"] = { ["X"] = 20.0, ["Y"] = 20.0, ["Z"] = 10.0 } },
    },
    ["Key"] = "K",
    ["Command"] = "throwWeapon"
}

This section contains settings for throwing weapons:

• Enabled: Set to true to enable throwing weapons.

• Animation: Specifies the animation to play when the character throws a weapon.

• Groups: Defines allowed weapon groups for throwing and their respective multipliers for throw physics.

• Key: Defines the input key for throwing.

• Command: Specifies the command triggered when the player throws a weapon.

---

MBT.Bones = { ["Back"] = 24816, ["LHand"] = 36029 }

Maps bone identifiers to specific bones on the character's body. These identifiers are used to position props (weapons) on the character.

---

MBT.HolsterControls = {
    ["Confirm"] = { ["Label"] = "Confirm Holster", ["Input"] = "MOUSE_BUTTON", ["Key"] = "MOUSE_RIGHT" },
    ["Cancel"] = { ["Label"] = "Cancel Holster", ["Input"] = "keyboard", ["Key"] = "BACK" }
}

Defines controls for confirming and canceling holster actions:

• Confirm: Settings for confirming holstering, including a label, input type, and key.

• Cancel: Settings for canceling holstering, including a label, input type, and key

---

MBT.Notification = function (data)
    lib.notify(data)
end

This function is used to display notifications. You might need the corresponding lib or library to use this function properly.

---

MBT.Labels = {
    ["has_jammed"] = {
        ["title"] = "Jammed!",
        ["description"] = "Your weapon has jammed! Check its state! ",
        ["type"] = "error",
        ["icon"] = "fa-solid fa-triangle-exclamation",
    },
    ["has_unjammed"] = {
        ["title"] = "Unjammed!",
        ["description"] = "You have unjammed your weapon! ",
        ["type"] = "success",
        ["icon"] = "fa-solid fa-person-rifle",
    },
    ["no_allowed_throw"] = {
        ["title"] = "Ops!",
        ["description"] = "You are not able to throw this weapon! ",
        ["type"] = "error",
        ["icon"] = "fa-solid fa-hand-fist",
    },
    ["Holster_Help"] = "[RMOUSE] - Unholster [BACKSPACE] - Cancel",

}

Contains definitions for various labels used in notifications:

• title: The title of the notification.

• description: A description accompanying the notification.

• type: The type of notification (error, success, etc.).

• icon: An icon associated with the notification.

---

MBT.PropInfo = {
    -- ... (various prop information for different scenarios)
}

Contains information about positioning and animations of props (weapons) on the character's body. This section is organized into different scenarios or groups, each with various settings like bone, position, rotation, and holster animations.

---

MBT.CustomPropPosition = {
    -- ... (customized prop positions for specific scenarios)
}

Allows you to define custom prop positions for specific scenarios or groups. Each scenario can have its own set of positions and animations.

---