> For the complete documentation index, see [llms.txt](https://docs.otland.net/ots-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.otland.net/ots-guide/tfs-documentation/luascript-interface/chatchannel.md).
# ChatChannel
There are many types of events for the ChatChannel interface, here is a list.
* [**canJoin**](#canjoin-player)**(player)**
* [**onJoin**](#onjoin-player)**(player)**
* [**onLeave**](#onleave-player)**(player)**
* [**onSpeak**](#onspeak-player-type-message)**(player, type, message)**
- [x] You create a ChatChannel script in data/chatchannels/scripts folder, but
- [x] You must register ChatChannel in data/chatchannels/chatchannels.xml, here is an example
```xml
```
* **Alternatively you can use revscript method to register via lua, by saving a .lua file in data/scripts folder.**
**Please keep in mind you can name your script whatever you want as long as it ends in .lua, and its full name is in the xml, with script="*****scriptname.lua*****"**
## canJoin(player)
> * **player** -- 1st arg/parameter /***userdata***/ = The **player** who is trying to join the channel
**canJoin is called whenever any player attempts to open the registered channel.**
**You can register your event in movement.xml like so:**
```xml
```
**You can then call the event in a script like so:**
**Example:** *godchat.lua*
```lua
function canJoin(player)
return player:getAccountType() > ACCOUNT_TYPE_GAMEMASTER -- if account type is higher access than a gamemaster returns true to allow joining, otherwise returns false and doesn't allow access
end
```
**Always remember to return true if you wish to allow player to join the channel, false if not!**
## onJoin(player)
> * **player** -- 1st arg/parameter /***userdata***/ = The **player** whom has just joined the channel
**onJoin is called whenever any player joins the registered chatchannel**
**You can register your event in creaturescripts.xml like so:**
```xml
```
**You can then call the event in a script like so:**
**Example:** *godchat.lua*
```lua
function onJoin(player)
player:sendChannelMessage("System:", "Welcome to GodChat!", MESSAGE_STATUS_CONSOLE_RED, 8)
end
```
**onJoin will execute its logic everytime a player joins the channel, returns don't matter for this event!**
## onLeave(player)
> * **player** -- 1st arg/parameter /***userdata***/ = The **player** who has left the registered chatchannel
**onLeave is called whenever a player leaves the registered chatchannel**
**You can register your event in creaturescripts.xml like so:**
```xml
```
**You can then call the event in a script like so:**
**Example:** *godchat.lua*
```lua
function onLeave(player)
player:sendTextMessage(MESSAGE_STATUS_CONSOLE_RED, "You have left GodChat")
end
```
**onLeave will execute its logic everytime a player leaves the channel, returns don't matter for this event!**
## onSpeak(player, type, message)
> * **player** -- 1st arg/parameter /***userdata***/ = The **player** that is removing the item
> * **type** -- 2nd arg/parameter /***integer***/ = a constant value representing the TALK\_TYPE
> * **message** -- 3rd arg/parameter /***string***/ = the text that player has sent
**onSpeak runs everytime a player in the chatchannel sends a message.**
**You can register your event in creaturescripts.xml like so:**
```xml
```
**You can then call the event in a script like so:**
**Example:** *godchat.lua*
```lua
function onSpeak(player, type, message)
if player:getAccountType() == 10 then
if message == "hidehealth" then
player:setHiddenHealth(true)
end
if message == "showhealth" then
player:setHiddenHealth(false)
end
else
player:sendTextMessage(MESSAGE_INFO_DESCR, "You do not have appropriate account type to execute this channel command!")
end
end
```
**onSpeak executes everytime a player speaks in registered channel, returns don't matter here**
**Here is a complete example including all the events in one file**
**Example in xml:**
```xml
```
**Example:** *godchat.lua*
```lua
function canJoin(player)
return player:getAccountType() > ACCOUNT_TYPE_GAMEMASTER -- if account type is higher access than a gamemaster returns true to allow joining, otherwise returns false and doesn't allow access
end
function onJoin(player)
player:sendChannelMessage("System:", "Welcome to GodChat!", MESSAGE_STATUS_CONSOLE_RED, 8)
end
function onLeave(player)
player:sendTextMessage(MESSAGE_STATUS_CONSOLE_RED, "You have left GodChat")
end
function onSpeak(player, type, message)
if player:getAccountType() == 10 then
if message == "hidehealth" then
player:setHiddenHealth(true)
end
if message == "showhealth" then
player:setHiddenHealth(false)
end
else
player:sendTextMessage(MESSAGE_INFO_DESCR, "You do not have appropriate account type to execute this channel command!")
end
end
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.otland.net/ots-guide/tfs-documentation/luascript-interface/chatchannel.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.