# Info {% hint style="danger" %} The `Info:` module is required for all weapons {% endhint %} ```yaml Info: Weapon_Item: Weapon_Info_Display: # scroll down for more information Dual_Wield: # scroll down for more information Weapon_Converter_Check: Type: Name: Lore: Enchants: Custom_Model_Data: Weapon_Get_Mechanics: Weapon_Equip_Mechanics: Weapon_Equip_Delay: Weapon_Holster_Mechanics: Cancel: Block_Interactions: Item_Interactions: Break_Blocks: Drop_Item: Swap_Hands: Arm_Swing_Animation: ``` #### Weapon\_Item The item to use as the weapon. Uses the [Item Serializer](https://app.gitbook.com/s/IIUkVnlH40vVBzLhWWQ8/item-serializer "mention"). This is also where you define lore, attributes, etc. #### Weapon\_Info\_Display How to show ammo and other information in the action bar. Uses placeholders and colors. Check out the default weapons for examples.
Display Example ```yaml Weapon_Info_Display: Action_Bar: Message: "AK-47 «»" ```
```yaml Weapon_Info_Display: Action_Bar: Message: Dual_Wield: Main_Hand: Off_Hand: Boss_Bar: Title: Bar_Color: Bar_Style: Dual_Wield: Main_Hand: Off_Hand: Show_Ammo_In: Boss_Bar_Progress: Exp_Level: Exp_Progress: ``` #### Dual\_Wield Dual-wielding with weapons is always disabled by default. If you want to be able to shoot with both hands at the same time, you'll have to add dual wielding for both weapons while allowing them to dual wield with each other. Only the other hand may reload the weapon at a time and only other weapon may apply zooming. Both weapons can still shoot simultaneously.
50_GS Dual Wield Example ```yaml Dual_Wield: Whitelist: true Weapons: - "50_GS" ```
```yaml Dual_Wield: Whitelist: Weapons: - - Mechanics_On_Deny: ``` * `Whitelist` * Whether to use `Weapons` as a whitelist or blacklist. * A whitelist means that only X options are allowed to be used. * A blacklist means that X options are NOT allowed to be used. * `true` -> Only weapons listed in `Weapons` can be used. * `Weapons` * List of valid weapons. You should enter the weapon titles of the guns. * This list's behavior changes based on the value of `Whitelist` * `Mechanics_On_Deny` * These mechanics will be run when dual wielding is denied. * Helpful in sending denial messages and denial sounds. * Use the [Mechanics](https://app.gitbook.com/o/MgHAZkcfIhs3YcmBjk2r/s/hz7yMxlL81NxAT44nraH/ "mention") wiki. #### Weapon\_Converter\_Check For a regular item to become a "weapon," WeaponMechanics checks if the item should become a weapon. This is the list of checks the plugin goes through to determine if it should convert an item into a weapon. This is especially useful if you want players to get weapons through "vanilla means," like trading. * `Type` * Check if the material of the item is the same. * Material Examples: `stone`, `stick`, `emerald`. * `Name` * Check if the name of the item is the same. * Note: If your weapon name has a color (e.g., `"AK-47"`), then the item must have that color. * Note: These 2 options are **NOT** equal `"M4A1" ≠ "M4A1"`. * `Lore` * Check if the lore of the item is the same. * Enable this if you want *COMPLETE CONTROL* over who gets weapons since regular players cannot give lore to items. * `Enchants` * Check if the enchantments of the item are the same. * Note: Check both the enchantments *AND* the levels. * `Custom_Model_Data` * Check if the custom model data is the same. * This is *faster* then `Lore` and `Name`, and gives good plugin compatibility! #### Weapon\_Get\_Mechanics Mechanics triggered when getting the weapon through command (`/wm give`) * `@Source{}` -> The entity being given the weapon. #### Weapon\_Equip\_Mechanics Mechanics triggered when equipping the weapon in hand. * `@Source{}` -> The entity holding the weapon #### Weapon\_Equip\_Delay The time, in ticks, after equipping the weapon before it can be shot. This prevents players from switching weapons too quickly to get an unfair advantage. Sidearms should have a lower equip delay then primaries. #### Weapon\_Holster\_Mechanics Mechanics triggered when holstering the weapon (taking it out of your hand). * `@Source{}` -> The entity holding the weapon #### Cancel Cancels certain events while holding the weapon. * `Block_Interactions` * Cancels opening doors, chests, etc. * This causes the item to bob up and down; *you should not use this*. * `Item_Interactions` * Cancels tilling dirt, shearing logs, etc. * This causes the item to bob up and down; *you should not use this*. * `Break_Blocks` * Cancels breaking blocks. * `Drop_Item` * Cancels dropping the gun while holding it. * `Swap_Hands` * Cancels swapping hands between main hand and off hand (Pressing `F`). * `Arm_Swing_Animation` * Cancels arm swing animation for other players (Like the punch animation). {% hint style="warning" %} Due to visual item bobbing glitches, I recommend using the following configuration for all of your guns: ```yaml Cancel: Drop_Item: true Swap_Hands: true Arm_Swing_Animation: true ``` {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://cjcrafter.gitbook.io/weaponmechanics/weapon-modules/info.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.