{"id":22017876,"url":"https://github.com/blnstudio/bln_belt_attachments","last_synced_at":"2025-07-15T12:03:10.191Z","repository":{"id":263999994,"uuid":"892047119","full_name":"blnStudio/bln_belt_attachments","owner":"blnStudio","description":"Realistically display your weapons and items on your character's belt when equipped from inventory but not in use! Works with lanterns, lassos, machetes, and more.","archived":false,"fork":false,"pushed_at":"2025-01-11T19:00:50.000Z","size":11160,"stargazers_count":2,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-11T20:17:48.822Z","etag":null,"topics":["fivem","redm"],"latest_commit_sha":null,"homepage":"https://github.com/blnStudio/bln_belt_attachments","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blnStudio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-21T12:20:15.000Z","updated_at":"2025-01-11T19:00:54.000Z","dependencies_parsed_at":null,"dependency_job_id":"b8833b85-05ce-405f-baf1-4ba856abe6d6","html_url":"https://github.com/blnStudio/bln_belt_attachments","commit_stats":null,"previous_names":["blnstudio/bln_belt_attachments"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blnStudio%2Fbln_belt_attachments","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blnStudio%2Fbln_belt_attachments/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blnStudio%2Fbln_belt_attachments/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blnStudio%2Fbln_belt_attachments/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blnStudio","download_url":"https://codeload.github.com/blnStudio/bln_belt_attachments/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236045312,"owners_count":19086077,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fivem","redm"],"created_at":"2024-11-30T05:08:29.758Z","updated_at":"2025-07-15T12:03:10.184Z","avatar_url":"https://github.com/blnStudio.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RedM Belt Attachments\n\n\u003cimg src=\"./.github/assets/banner.png\" alt=\"bln Belt Attachments script - redm\" width=\"100%\" /\u003e\n\u003cdiv style=\"display: flex; justify-content: space-between;\"\u003e\n    \u003cimg src=\"./.github/assets/demo-1.png\" alt=\"Image 1\" width=\"45%\" /\u003e\n    \u003cimg src=\"./.github/assets/demo-2.png\" alt=\"Image 2\" width=\"45%\" /\u003e\n\u003c/div\u003e\n\nRealistically display your weapons and items on your character's belt when equipped from inventory but not in use! Works with lanterns, lassos, machetes, and more.\n\n[![](https://img.shields.io/badge/YouTube-FF0000?style=flat\u0026logo=youtube\u0026logoColor=white)](https://youtu.be/6ZGfaL8W5Ng)\n[![Discord](https://img.shields.io/badge/Discord-1111?style=flat\u0026logo=discord\u0026logoColor=white\u0026color=7289da)](https://discord.bln-studio.com/)\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/blnStudio/bln_belt_attachments)\n![License](https://img.shields.io/github/license/blnStudio/bln_belt_attachments)\n\n## Features\n- Automatically shows/hides items on your belt\n- Synchronized across all players - everyone sees each other's belt items\n- Smooth transitions when equipping/unequipping\n- Works with both male \u0026 female characters\n- Supports multiple item types:\n  - Regular and Davy lanterns\n  - Regular and reinforced lassos\n  - Machetes\n  - Metal detector\n  - Quiver\n  - And more can be easily added!\n\nThere are 7 attachements already configured for you.\n\n## Installation\n1. Download the `bln_belt_attachments` script\n2. Place it in your server's `resources` folder\n3. Add `ensure bln_belt_attachments` to your `server.cfg`\n\n## 🛠️ Usage\nThe script works automatically once installed. When you have supported items in your inventory:\n- Items appear on your belt when equipped but not in active use\n- Automatically hide/show items when using them\n- All players can see each other's belt attachments\n\n### Supported Items\n- `WEAPON_MELEE_LANTERN` - Regular lantern\n- `WEAPON_MELEE_DAVY_LANTERN` - Davy lantern\n- `WEAPON_KIT_METAL_DETECTOR` - Metal detector\n- `WEAPON_LASSO` - Regular lasso\n- `WEAPON_LASSO_REINFORCED` - Reinforced lasso\n- `WEAPON_MELEE_MACHETE` - Machete\n- `WEAPON_BOW` - Quiver\n\nyou can support/add more items as you need!\n\n## How to Add New Categories and Attachments\n\n### Adding a New Category\n\nTo add a new category of items (e.g., if you want to add a new type of weapon or tool), follow these steps:\n\n1. Open `config.lua`\n2. Add a new category to the `Config.categories` table\n3. Add your items to the new category\n\nExample of adding a new \"knives\" category:\n\n```lua\nConfig.categories = {\n    -- Existing categories here...\n    \n    knives = {  -- New category\n        {\n            hashName = 'WEAPON_MELEE_KNIFE',  -- Weapon hash name\n            model = `w_melee_knife02`,        -- Model hash\n            bone = {\n                male = 'SKEL_R_Thigh',        -- Attachment bone for male\n                female = 'skel_r_thigh',      -- Attachment bone for female\n            },\n            offset = {\n                male = {\n                    x = 0.0,\n                    y = 0.0,\n                    z = -0.11,\n                    pitch = -83.0,\n                    roll = 0.0,\n                    yaw = 80.0,\n                },\n                female = false,  -- Use male settings for female\n            },\n        }\n    }\n}\n```\n\n### Adding New Items to Existing Categories\n\nTo add a new item to an existing category (e.g., adding a new type of lantern):\n\n1. Identify the category you want to add to\n2. Add a new item table to that category's array\n3. Configure the item's properties\n\nExample of adding a new lantern to the existing \"lanterns\" category:\n\n```lua\nConfig.categories = {\n    lanterns = {\n        -- Existing lanterns...\n        \n        {   -- New lantern\n            hashName = 'WEAPON_MELEE_LANTERN_HALLOWEEN',\n            model = `s_interact_lantern_halloween`,\n            bone = {\n                male = 'PH_Lantern',\n                female = 'PH_Lantern',\n            },\n            offset = {\n                male = {\n                    x = -0.05,\n                    y = 0.0,\n                    z = 0.0,\n                    pitch = 0.0,\n                    roll = 0.0,\n                    yaw = 0.0,\n                },\n                female = false,\n            },\n        }\n    }\n}\n```\n\n### Configuration Properties Explained\n\nWhen adding new items, you'll need to configure these properties:\n\n- `hashName`: Can be either:\n  - A string: Single weapon/item hash name (e.g., `'WEAPON_MELEE_LANTERN'`)\n  - An array: Multiple weapon hashes (e.g., `{'weapon_bow', 'weapon_bow_improved'}`)\n- `alwaysAttached`: Optional boolean\n  - If `true`: Item stays attached when equipped, even while in use\n  - If `false` or not set: Item only shows when equipped but not in active use\n- `model`: The model hash for the attached item\n- `bone`: Specifies attachment points\n  - `male`: The bone name for male characters\n  - `female`: The bone name for female characters (or `false` to use male settings)\n- `offset`: Position and rotation settings\n  - `male`: Offset values for male characters\n    - `x`, `y`, `z`: Position offset from the attachment bone\n    - `pitch`, `roll`, `yaw`: Rotation angles in degrees\n  - `female`: Offset values for female characters (or `false` to use male settings)\n\n### Bone Names\n\nHere are some useful bone names for attachments:\n[Bone Names](https://github.com/femga/rdr3_discoveries/tree/master/boneNames)\n\n### Tips for Testing New Attachments\n\n1. Start with offset values at 0.0 and adjust gradually\n2. Test with both male and female characters\n3. Check different animations to ensure the attachment looks good in motion\n4. Use small increments (0.01-0.05) when adjusting position values\n5. For rotation, use increments of 5-10 degrees initially\n\n### Troubleshooting\n\nIf your attachment isn't appearing:\n1. Verify the `hashName` matches exactly\n2. Ensure the model exists and is loaded\n3. Check if the bone name is correct\n4. Try adjusting the offset values\n5. Verify the item is properly registered in your inventory system\n\n## Support 💬\nNeed help? Join our Discord server:\n[Join Discord](https://discord.com/invite/MEZRYQVpnt)\n\n## Credits 🙏\nCreated by [BLN Studio](https://bln.tebex.io)\nFeel free to contribute to this project! \n\n## ⚠️ Note\nThis script is purely cosmetic and does not affect gameplay mechanics. It's designed to enhance immersion by displaying your items realistically when not in use.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblnstudio%2Fbln_belt_attachments","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblnstudio%2Fbln_belt_attachments","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblnstudio%2Fbln_belt_attachments/lists"}