You're welcome to try and revive it, but to be honest you're better off starting from scratch.
No maintenance is planned for this bridge.
Minecraft bridge for [Matrix].
Matrix room: #minecraft-bridge:matrix.org
Note: This is a personal pet-project and won't see a whole lot of activity. Contributions are welcome, however :)
Before you begin: A Synapse server is required. The instructions here assume that Synapse server is a default setup.
Clone this repository and install the dependencies
git clone https://github.com/turt2live/matrix-appservice-minecraft
cd matrix-appservice-minecraft
npm install
Copy config/sample.yaml
to config/config.yaml
and fill in the appropriate fields
Generate the registration file
node app.js -r -u "http://localhost:9000" -c config/config.yaml
Note: The default URL to run the appservice at is http://localhost:9000
. If you have other appservices, or other requirements, pick an appropriate hostname and port.
Copy/symlink the registration file to your Synapse directory
cd ~/.synapse
ln -s ../matrix-appservice-minecraft/appservice-registration-minecraft.yaml appservice-registration-minecraft.yaml
Add the registration file to your homeserver.yaml
...
app_service_config_files: ["appservice-registration-minecraft.yaml"]
...
Restart synapse (synctl restart
, for example)
Using the port specified during install (9000
by default), use node app.js -p 9000 -c config/config.yaml
from the repository directory.
The bridge should start working shortly afterwards.
Open a 1:1 conversation with @_minecraft:t2bot.io
and send the message !bridge <room id> <server name[:port]>
.
For example, !bridge !kBDEQKODhuvfjxDMAl:t2l.io my-minecraft-server.com:12345
.
The room must be public (so the bridge can join and start bridging users)
To join a server such as myserver.com
, join the room #_minecraft_myserver.com:domain.com
.
If the server has a custom port (not 25565), join #_minecraft_myserver.com_12345:domain.com
where 12345 is the port number.
This is based off matrix-appservice-bridge and uses mineflayer to connect a fake player to the Minecraft server. The fake player is not capable of actually playing the game, and ends up sitting at the spawn point (it does revive itself if someone kills it, however).
Eventually a plugin for server owners will be written/supplied to avoid having an idle player sitting on the server. The plugin will be attempted first before defaulting to trying to connect with the player account. The plugin will also therefore support modded servers (such as FTB) - the player doesn't have any mods installed.
matrix-appservice-twitter was used as a reference implementation of a Synapse appservice - thanks Half-Shot!