matrix_chat/README.md
Jon Neverland b54f0df57b Remove need for secure.enable_security (#7)
With changes in lua-matrix mod now works with only secure.trusted_mods
2017-08-08 12:33:33 +02:00

1.7 KiB

Matrix mod for Minetest

This mod creates a bridge between a Matrix channel and the in-game chat. The code is shamelessly based on the irc mod and examples from lua-matrix.

Installing

cd <Mods directory> && git clone --recursive git@github.com:diggers-mt/minetest-matrix.git

OS X

brew install lua@5.1
luarocks-5.1 install lua-cjson
brew install openssl
luarocks-5.1 install cqueues CRYPTO_DIR=/usr/local/opt/openssl/ OPENSSL_DIR=/usr/local/opt/openssl #https://github.com/wahern/cqueues/wiki/Installation-on-OSX#via-brew
luarocks-5.1 install luaossl CRYPTO_DIR=/usr/local/opt/openssl/ OPENSSL_DIR=/usr/local/opt/openssl
luarocks-5.1 install luasocket
luarocks-5.1 install luasec OPENSSL_DIR=/usr/local/opt/openssl
export MATRIX_API_HTTP_CLIENT=luasocket

Ubuntu

Tested on 16.04.

apt-get install lua5.1 luarocks lua-sec
luarocks install lua-cjson
luarocks install luasocket
luarocks install luasec
export MATRIX_API_HTTP_CLIENT=luasocket

You might need to prepend sudo to first and second commands.

For the moment you need to add matrix to secure.trusted_mods for lua-matrix to work. This will hopefully change.

secure.trusted_mods = matrix

Settings

  • matrix.user: Matrix username, for example @minetestbot:matrix.org

  • matrix.password: Password for Matrix user

  • matrix.server: Server to connect to, include http(s), https://matrix.org

  • matrix.port: Server port, default 8448

  • matrix.room_id: Room to join, room_id in matrix. Always starts with !

License

See LICENSE.txt for details.