Oprindeligt skrevet af n-gon:

Setup

Below is example code on how to detect RagMod installation and use its hooks

local RagmodEnabled for k, v in pairs(engine.GetAddons()) do if v.wsid == "2817879135" and v.mounted == true then -- Ragmod Reworked exists! Add the module RagmodEnabled = true require("ragmod") break end end -- Stop if ragmod wasn't found if not RagmodEnabled then return end -- Add a command to ragdoll concommand.Add("ragmod_test",function(ply,cmd,args,argStr) local ragdoll = ragmod:TryToRagdoll(ply) -- This tries to ragdoll a player if IsValid(ragdoll) then print("Successfully ragdolled!") end end) -- Detect ragdolls get possessed hook.Add("RM_RagdollReady","my_hook", function(ragdoll, owner, possessor) print("Ragdoll is now ready to use! ", ragdoll, owner, possessor) ragdoll:GetPossessor() -- This now returns a valid possessor on server and client ragdoll:GetOwningPlayer() -- This now returns a valid possessor on server and client end)local RagmodEnabled for k, v in pairs(engine.GetAddons()) do if v.wsid == "2817879135" and v.mounted == true then -- Ragmod Reworked exists! Add the module RagmodEnabled = true require("ragmod") break end end -- Stop if ragmod wasn't found if not RagmodEnabled then return end -- Add a command to ragdoll concommand.Add("ragmod_test", function(ply, cmd, args, argStr) local ragdoll = ragmod:TryToRagdoll(ply) -- This tries to ragdoll a player if IsValid(ragdoll) then print("Successfully ragdolled!") end end) -- Detect ragdolls get possessed hook.Add("RM_RagdollReady", "my_hook", function(ragdoll, owner, possessor) print("Ragdoll is now ready to use! ", ragdoll, owner, possessor) ragdoll:GetPossessor() -- This now returns a valid possessor on server and client ragdoll:GetOwningPlayer() -- This now returns a valid possessor on server and client end) -- Other hooks: -- Detect ragdolls spawning hook.Add("RM_RagdollSpawned", "my_hook1", function(ragdoll) print("Ragdoll created ", ragdoll, ragdoll:GetClass()) end) -- Detect ragdoll get assigned an owner hook.Add("RM_OwnerInitialized", "my_hook2", function(ragdoll, owner) print("Ragdoll owner confirmed ", ragdoll, owner) ragdoll:GetOwningPlayer() -- This now returns a valid owner end) -- Detect ragdolls get possessed hook.Add("RM_RagdollPossessed", "my_hook3", function(ragdoll, possessor) print("Ragdoll possessed ", ragdoll, possessor) ragdoll:GetPossessor() -- This now returns a valid possessor if SERVER then ragdoll:GetOwningPlayer() -- This now returns a valid possessor on the server end end) -- Other hooks: -- Detect ragdolls spawning hook.Add("RM_RagdollSpawned", "my_hook1", function(ragdoll) print("Ragdoll created ", ragdoll, ragdoll:GetClass()) end) -- Detect ragdoll get assigned an owner hook.Add("RM_OwnerInitialized", "my_hook2", function(ragdoll, owner) print("Ragdoll owner confirmed ", ragdoll, owner) ragdoll:GetOwningPlayer() -- This now returns a valid owner end) -- Detect ragdolls get possessed hook.Add("RM_RagdollPossessed", "my_hook3", function(ragdoll, possessor) print("Ragdoll possessed ", ragdoll, possessor) ragdoll:GetPossessor() -- This now returns a valid possessor if SERVER then ragdoll:GetOwningPlayer() -- This now returns a valid possessor on the server end end)

Ragdolls

RagMod ragdolls are prop_ragdoll based fake scripted entities[wiki.facepunch.com]
They can be identified with ragmod:IsRagmodRagdoll(ent)

The ragdolls have several methods you can use to get information about the ragdoll

NOTE: Do not use GM:NetworkEntityCreated or GM:OnEntityCreated hooks to detect RagMod ragdolls, especially on the client! The ragdoll won't have its properties setup yet.
Use the RagMod hooks, like RM_RagdollReady

Ragdoll methods

These exist on the RagMod ragdoll Entities
Note on clientside: These methods might not yet be valid if the hooks haven't been called. Please use the RM_RagdollReady hook to know when the ragdoll has initialized.
Alternatively, the ragdolls have their ragdoll.Ragmod_Initialized property set to true when these methods have been added to their tables.

Player Ragdoll:GetPossessor() Description: Gets the player who is playing as this ragdoll. Usually the same as the owner. Returns: 1. Player The owner or NULL

Player Ragdoll:GetOwningPlayer() Description: Gets the player this ragdoll was created from. Returns: 1. Player The owner or NULL

General methods

RagMod module functions are all in the "ragmod" table

Ragdoll ragmod:TryToRagdoll(Player ply) Description: Tries to ragdoll a player Arguments: 1. Player ply The player to ragdoll Returns: 1. Ragdoll The created ragdoll entity or NULL

boolean ragmod:IsRagmodRagdoll(Entity ragdoll) Description: Checks if the given entity is a RagMod ragdoll Arguments: 1. Entity ragdoll The ragdoll to check Returns: true if the ragdoll is from RagMod. Can return false on clients right after spawn

boolean ragmod:IsRagdoll(Player ply) Description: Checks if the player is a ragdoll Arguments: 1. Player ply The player who we are checking Returns: true if the player is a ragdoll, false otherwise

Ragdoll ragmod:GetRagmodRagdoll(Player ply) Description: Returns the ragdoll this player is controlling Arguments: 1. Player ply The player who we are checking Returns: 1. Ragdoll The ragdoll entity or NULL if not a ragdoll

number ragmod:GetPossessTime(Player ply) Description: Use to find out when a player possessed a ragdoll Arguments: 1. Player ply The player who we are checking Returns: 1. float Time in seconds when the player ragdolled (since game start)

number ragmod:GetTimeSincePossess(Player ply) Description: Use to find out how long a player has possessed a ragdoll Arguments: 1. Player ply The player who we are checking Returns: 1. float Time in seconds since when the player ragdolled

Hooks

This is probably the hook you want to use:

(SHARED) RM_RagdollReady( Ragdoll ragdoll, Player owner, Player possessor) Description: Called when the ragdoll has both it's owner and possessor. This means the ragdoll has fully initialized. If you are looking for a simple hook to detect when a new ragdoll is ready, this is probably it. Arguments: 1. Ragdoll ragdoll The ragdoll entity 2. Player owner The ragdoll origin player 3. Player possessor The player controlling the ragdoll

(SERVER) RM_RagdollTakeDamage( Ragdoll ragdoll, CTakeDamageInfo dmginfo, table extraDmginfo) Description: Called when a ragdoll takes damage. Note that damage might be scaled to 0 Arguments: 1. Ragdoll ragdoll The ragdoll entity 2. CTakeDamageInfo dmginfo Damage the ragdoll took 3. table extraDmginfo Extra info Use extra info like this: extraDmginfo:GetHitGroup() to get hit hitgroup extraDmginfo:GetHitBone() to get hit bone id

The hooks below are called before RM_RagdollReady.
The ragdoll is not fully initialized yet at these hooks, so only use if you know what you are doing

(SERVER) RM_RagdollCreated( Ragdoll ragdoll) Description: Called when a ragdoll is created, but not yet spawned or assigned an owner. Arguments: 1. Ragdoll ragdoll The ragdoll entity

(SHARED) RM_RagdollSpawned( Ragdoll ragdoll) Description: Called when a ragdoll has spawned. On server the ragdoll should have been assigned an owner at this point. On the client neither the owner nor the possessor (usually the same player) is not valid yet. (See: RM_RagdollPossessed and RM_OwnerInitialized) The ragdoll has had its physics initialized here. Arguments: 1. Ragdoll ragdoll The ragdoll entity

(SHARED) RM_RagdollPossessed( Ragdoll ragdoll, Player possessor) Description: Called when a player starts possessing a ragdoll Arguments: 1. Ragdoll ragdoll The ragdoll entity 1. Player possessor The player now controlling the ragdoll or NULL

(SHARED) RM_OwnerInitialized( Ragdoll ragdoll, Player owner) Description: Called when a ragdoll has been assigned an owner On server the ragdoll hasn't spawned yet On clients the ragdoll could have spawned already Arguments: 1. Ragdoll ragdoll The ragdoll entity 2. Player owner The ragdoll owner