Modules/bIRC/ircGetChannelMode

From Multi Theft Auto: Wiki
Revision as of 17:58, 13 August 2009 by Awwu (talk | contribs) (Created page with '{{ml_birc}} __NOTOC__ This function returns the current channel mode of the specified channel. The specified {{ml_birc|ircbot}} has to be in that channel. ==Syntax== <syntaxhighlight lang="lua">[lua…')
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Package-x-generic.png This function is provided by the external module Basic IRC Module. You must install this module to use this function.

This function returns the current channel mode of the specified channel. The specified ircbot has to be in that channel.

Syntax

string ircGetChannelMode ( ircbot theBot, string channel )

Required Arguments

  • theBot: The ircbot which is in the channel
  • channel: The name of the channel which channel mode you want to get

Returns

Returns the currently set channel mode (letters) or an empty string if there is no modes set in that channel.

Example

This example creates an ircbot called DummyBot makes it connect to a server and join a channel. It also includes an IRC command '!istopiclocked' which can used to check if the topic is locked (only channel ops can change it) on that channel.

function resourceStart ( )
    theBot = ircCreateBot ( "DummyBot" )
    ircConnect ( theBot, "irc.gtanet.com", 6667 )
end
addEventHandler ( "onResourceStart", getResourceRootElement ( getThisResource() ), resourceStart )

function event_ircOnConnect ( theBot )
    setTimer ( ircJoinChannel, 2000, 1, theBot, "#testchannel" )
end

function event_ircOnText ( theBot, channel, sender, message )
    if message:find( "!istopiclocked" ) then
        local channelMode = ircGetChannelMode( theBot, channel )
        if channelMode:find( "t" ) then -- t = TOPIC_LOCK
            ircSendMessage ( theBot, channel, "Yes, the topic is locked." )
        else
            ircSendMessage ( theBot, channel, "Nope, it's not locked... SO CHANGE IT NOW!" )
        end
    end
end

See Also

Bot functions

Creation

Connection

Other

IRC functions

Channel

User

Communication

Other