ModelEquip allows users to easily weld and unweld models to the characters, which is useful when adding weapons, tools, armor, and other items to the player.
To start, go ahead and grab the module and place it in ReplicatedStorage.
After inserting the module, make sure to update the settings to fit your liking. They can be found in the module’s attributes. Documentation for each setting can be found below in the “Documentation” section of this post.
Next, require the module from your script using
After requiring the module, make sure you initialize it using
ModelEquip:Init(). Initializing the module checks for updates (if DetectUpdates is enabled) and watches for player deaths (if PersistDeath is enabled).
That’s it for setting up the module! Now, we need to create our first model.
Inside the module, you will find an example folder. This folder shows the structure your models should follow.
The parts folder contains R15 and R6 body parts for positioning your model on the character. Make sure the parts are named the same as they would be in the character, and that the ObjectValues are set to the proper part.
The model is the model which will be welded to the player. Your model must have a PrimaryPart. You can weld it yourself, or enable settings[“AutomaticallyWeld”], which will weld the model automatically.
Now, parent the folder to the module, and you are set!
Once all of these steps have been completed, you are ready to start using the module! See the documentation section below for functions and example usage.
If true, models will be automatically welded before being added to the character.
If true, characters will respawn with models until they are removed.
If true, the module will check & notify you if an update available.
Init prepares the module for use by checking for updates and watching for player deaths, depending on your settings.
ModelEquip:Add(humanoid:Humanoid, model:string, overridePersistant:boolean)
Adds the specified model to the character.
Removes the specified model from a character.
Below is a script that adds the example model supplied with the module to a player’s right leg when they join. PersistDeath is enabled, so the model will remain on the player even after they die.
local Players = game:GetService("Players") local ModelEquip = require(script.ModelEquip) ModelEquip:Init() local function PlayerAdded(player) local CharacterAdded CharacterAdded = player.CharacterAdded:Connect(function(character) repeat task.wait() until character:FindFirstChildOfClass("Humanoid") ModelEquip:Add(character:FindFirstChildOfClass("Humanoid"),"Example") CharacterAdded:Disconnect() end) end for i, v in Players:GetPlayers() do PlayerAdded(v) end Players.PlayerAdded:Connect(PlayerAdded)
In the end, I hope that others will find this module useful. I would love to add more features, please let me know if there is anything that you would like to see added. If you have any suggestions or changes, I would love to hear those as well. Thank you for reading.
Do you think this is a useful module?