OnPlayerModInfo: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 9: Line 9:


*'''filename''': An string with the filename of the modified file
*'''filename''': An string with the filename of the modified file
*'''itemlist''': A table with the details of each modification within the 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
{{New items|3.06892|1.4 r6902|
**'''sizeX,sizeY,sizeZ''': The modified model bounding box (If the item is a DFF)
**'''originalSizeX,originalSizeY,originalSizeZ''': The unmodified model bounding box (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==
==Source==
The [[event system#Event source|source]] of this event is the [[player]]
The [[event system#Event source|source]] of this event is the [[player]]

Revision as of 18:36, 28 October 2014

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 bounding box (If the item is a DFF)
    • originalSizeX,originalSizeY,originalSizeZ: The unmodified model bounding box (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