OnPlayerModInfo: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(16 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Server event}}
{{Server event}}
This event is triggered when a player has modified certain files
This event is triggered when a player has modified certain files.
 
{{Note|Any resource using this event should call [[resendPlayerModInfo]] for each player in [[onResourceStart]].}}
==Parameters==
==Parameters==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
Line 8: Line 8:
</syntaxhighlight>  
</syntaxhighlight>  


*'''filename''': An string with the filename of the modified file
*'''filename''': a [[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.
**'''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==
==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]].


==Example==  
==Example==  
This example prints all information into the chatbox
This example prints all modification information into the chatbox.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addEventHandler ( "onPlayerModInfo", root,
    function ( filename, itemList )
        -- Print player name and file name
        outputChatBox( tostring(getPlayerName(source)) .. " " .. tostring(filename) )


        -- Print details on each modification
function handleOnPlayerModInfo ( filename, modList )
        for idx,item in ipairs(itemList) do
    -- Print player name and file name
            local line = tostring(idx) .. ")"
    outputChatBox( getPlayerName(source) .. " " .. filename )
             for k,v in pairs(item) do
 
                line = line .. " " .. tostring(k) .. "=" .. .. tostring(v)
    -- 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 )
 
-- Ensure no one gets missed when the resource is (re)started
addEventHandler( "onResourceStart", resourceRoot,
    function()
        for _,plr in ipairs( getElementsByType("player") ) do
            resendPlayerModInfo( plr )
        end
    end
)</syntaxhighlight>
 
 
This example checks modified files against a list and prints a warning in the chatbox.
<syntaxhighlight lang="lua">
 
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
            outputChatBox( line )
         end
         end
    end
end
addEventHandler ( "onPlayerModInfo", getRootElement(), handleOnPlayerModInfo )


-- Ensure no one gets missed when the resource is (re)started
addEventHandler( "onResourceStart", resourceRoot,
    function()
        for _,plr in ipairs( getElementsByType("player") ) do
            resendPlayerModInfo( plr )
        end
     end
     end
)
)
addEventHandler ( "onPlayerModInfo", getRootElement(),onPlayerModInfo )
</syntaxhighlight>
</syntaxhighlight>


{{See also/Server event|Player events}}
{{See also/Server event|Player events}}

Latest revision as of 03:01, 27 September 2018

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: a 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.
    • 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 modification 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 )

-- Ensure no one gets missed when the resource is (re)started
addEventHandler( "onResourceStart", resourceRoot,
    function()
        for _,plr in ipairs( getElementsByType("player") ) do
            resendPlayerModInfo( plr )
        end
    end
)


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 )

-- Ensure no one gets missed when the resource is (re)started
addEventHandler( "onResourceStart", resourceRoot,
    function()
        for _,plr in ipairs( getElementsByType("player") ) do
            resendPlayerModInfo( plr )
        end
    end
)

See Also

Player events


Event functions