mirror of
https://github.com/minetest/minetest_docs.git
synced 2024-10-05 17:33:08 +02:00
document server side modchannels
This commit is contained in:
parent
3b76db7168
commit
1a3930f9df
49
doc/modchannels.adoc
Normal file
49
doc/modchannels.adoc
Normal file
@ -0,0 +1,49 @@
|
||||
= Modchannels
|
||||
|
||||
allows ssm(server side mods) comunication to csm(client side mods) and vice versa.
|
||||
|
||||
== minetest.x api
|
||||
|
||||
=== minetest.mod_channel_join(channel_name)
|
||||
|
||||
* `channel_name`: string, modchannel name
|
||||
* returns ref for use with <<methods>>
|
||||
* creates channel if not existing and joins the server on that channel
|
||||
* listen for messages on this channel with `minetest.register_on_modchannel_message`
|
||||
|
||||
=== minetest.register_on_modchannel_message(function(channel_name, sender, message))
|
||||
|
||||
* `channel_name`: string, modchannel name (already joined)
|
||||
* `sender`: string, empty if from a ssm, player name if from a client
|
||||
* `message`: string, message
|
||||
|
||||
== methods
|
||||
|
||||
=== leave()
|
||||
|
||||
* server leaves the channel, no more messages from this channel on `minetest.register_on_modchannel_message`
|
||||
* set the ref to nil afterwords to free resources
|
||||
|
||||
=== is_writeable()
|
||||
|
||||
* returns boolean, true if the channel is writeable
|
||||
|
||||
=== send_all(message)
|
||||
|
||||
* `message`: string, limited to 65535 characters
|
||||
* sends to all ssm and csm on the channel
|
||||
* message will drop if channel is not writable or invalid
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user