> For the complete documentation index, see [llms.txt](https://soulslike-framework.isik.vip/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://soulslike-framework.isik.vip/workflow/creating-and-editing-items/creating-and-editing-weapons.md). # Creating & Editing Weapons

### Using the Utility Tools to Create & Edit Weapons Weapons are one of the few items that **require a world Actor.** 1. Begin by creating a new Weapon Actor class of type **B\_Item\_Weapon** for your new weapon:

2. Adjust the **Mesh** to your liking. Optionally, you can use the debug visualizers for the placement of your mesh:

2. (Optional) Add your trail effect (toggled through the [Trail Notify](/animation-notifies/feedback/weapon-trail-notify.md))

3. Go into your mesh and add a **Starting & Ending Socket.** You can do this through the **Socket Manager** window. If you do not have it, you can toggle it from *Window -> Socket Manager.* This is necessary for the weapon tracing system (**AC\_CollisionManager) .**

4. Finally back in your new Weapon actor, select **AC\_CollisionManager** component and adjust its Config tab according to your new sockets:

5. Run **Soulslike Item Creator** from the Soulslike Framework editor dropdown or head into **/SoulslikeFramework/\_Utility/Creators** and right-click and Run Utility Widget -> **EUW\_ItemCreator:**

6. Fill in the details as you desire. If you are unsure of any field, feel free to leave it empty. You can always edit your Item properties easily through the **Item Browser** utility tool.

{% hint style="danger" %} **IMPORTANT:** The **Overlay Tag** property determines the default wielded stance for your weapon. This property is *Experimental*, and using **SoulslikeFramework.Equipment.Weapons.Overlay.OneHanded** is recommended. {% endhint %} 7. Add a **Pickup Actor (B\_PickupItem)** to your world, and select your newly created Item asset on the **Config** tab.

8. You can now loot your item and find it in your **Inventory & Equipment** widgets!

If you are not happy with how your character holds your new weapon, you can always edit its positioning in the item's **world actor** until you get a look you're happy with: {% embed url="" %} ### Creating/Editing Weapon Movesets 1. Run the **Soulslike Weapon Animset Creator** from the Soulslike Framework editor dropdown or head into /SoulslikeFramework/*Utility/Creators and Run Utility Widget ->* **EUW\_WeaponAnimsetCreator:**

2. Fill in the necessary montages as you desire. For more information, [check out the Setup Custom Montages page.](/getting-started/quickstart/setup-custom-montages.md)

3. Finally, click **Create Moveset** to create the new weapon moveset asset. 4. Run **Soulslike Item Browser** from the Soulslike Framework editor dropdown or head into /SoulslikeFramework/*Utility/Browsers and* Run Utility Widget *->* **EUW\_ItemBrowser:**

5. Select your new item and assign the new moveset:

5. If you've setup your montages correctly, your attacks should now be playing the correlated montage:

### Creating/Editing Weapon Abilities Weapon abilities can be created either by using the **Soulslike Weapon Ability Creator** or by manually duplicating/creating a Data Asset derived from **PDA\_WeaponAbility.**

Fill in the details as you desire:

**Additional Effect** is an actor that will be spawned when the ability is used. You can add any customized logic this way. This field is **optional**. Ensure that you have setup your **Ability Montage** correctly. You can follow the [Setup Custom Montages](/getting-started/quickstart/setup-custom-montages.md) page for more details on creating montages.

Finally, assign the new ability to your weapon. This can be done through **Soulslike Item Browser** or through the corresponding **PDA\_Item** asset:

That's it! Now you should have your new ability on your weapon:

{% hint style="warning" %} By default, **Weapon Ability Slot** is set to be **Right Hand**. That means that only weapons equipped on the slots that are considered Right Hand slots can have an ability. You can adjust this to your liking through **PC\_SoulslikeFramework -> AC\_EquipmentManager.** {% endhint %}

### Creating/Editing Weapons for AI **AI Weapons** use the same data of an existing weapon asset you have. For example, if we have DA\_Greatsword, we do **not** need another asset for the AI version. All we want to do is instead of using the **B\_Item\_Weapon** class, use **B\_Item\_Weapon\_AI** class as the world actor. After setting up the actor, ensure that you **select the corresponding item asset in the AI weapon class:**