OnPlayerModInfo

From Multi Theft Auto: Wiki
Revision as of 14:57, 14 August 2015 by Qaisjp (talk | contribs) (rvert)
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: md5 of 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,item in ipairs(modList) do
        outputChatBox( idx .. ") id:" .. item.id .. " name:" .. item.name )
        if item.sizeX then
            outputChatBox( "size:" .. item.sizeX .. "," .. item.sizeY .. "," .. item.sizeZ )
            outputChatBox( "originalSize:" .. item.originalSizeX .. "," .. item.originalSizeY .. "," .. item.originalSizeZ )
        end
        if item.length then
            outputChatBox( "length:" .. item.length .. " md5:" .. item.md5 )
        end
    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 _,item in ipairs(modList) do			-- Check each modified item
        for _,checkName in ipairs(checkModels) do
            if item.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