OnPlayerModInfo

From Multi Theft Auto: Wiki
Revision as of 18:37, 28 October 2014 by Ccw (talk | contribs)
Jump to navigation Jump to search

This event is triggered when a player has modified certain files.

[[{{{image}}}|link=|]] Note: Any resource using this event should call resendPlayerModInfo for each player in onResourceStart

Parameters

string filename, table itemlist
  • filename: An string with the filename of the modified file
  • itemlist: A table with the details of each modification within the file.
    • Possible keys for each sub-table are:
    • id: GTA model or texture id
    • name: GTA name
ADDED/UPDATED IN VERSION 1.4 r6902 :
    • sizeX,sizeY,sizeZ: The modified model size (If the item is a DFF)
    • originalSizeX,originalSizeY,originalSizeZ: The unmodified model size (If the item is a DFF)
    • length: Length in bytes of the item
    • md5: md5of the item bytes
    • sha256: sha256 of the item bytes
    • paddedLength: Length in bytes of the item padded to 2048 byte boundary
    • paddedMd5: md5 of the item bytes padded to 2048 byte boundary
    • paddedSha256: sha256 of the item bytes padded to 2048 byte boundary

Source

The source of this event is the player

Example

This example prints all information into the chatbox 


function handleOnPlayerModInfo ( filename, modList )
    -- Print player name and file name
    outputChatBox( getPlayerName(source) .. " " .. filename )

    -- Print details on each modification
    for idx,mod in ipairs(modList) do
        local line = tostring(idx) .. ")"
        for k,v in pairs(mod) do
            line = line .. " " .. tostring(k) .. "=" .. tostring(v)
        end
        outputChatBox( line )
    end
end
	
addEventHandler ( "onPlayerModInfo", getRootElement(), handleOnPlayerModInfo )


This example checks modified files against a list and prints a warning in the chatbox 


checkModels = { "m4.dff", "ak47.dff" }

function handleOnPlayerModInfo ( filename, modList )
    for _,mod in ipairs(modList) do			-- Check each modified item
        for _,checkName in ipairs(checkModels) do
            if mod.name == checkName then		-- See if modified item is in our check list
                outputChatBox ( "Not allowed to used modified weapons. Please restore " .. filename )
            end
        end
    end
end
	
addEventHandler ( "onPlayerModInfo", getRootElement(), handleOnPlayerModInfo )

See Also

Player events


Event functions


Retrieved from "https://wiki.multitheftauto.com/wiki/OnPlayerModInfo?oldid=42738"