# MatterBukkit<\/p>\n
A Minecraft Bukkit plugin which sends chat messages from\/to MatterBridge.<\/p>\n
\n
\n
\n<\/p>\n
## Setup<\/p>\n
First, install the plugin onto your Bukkit\/Spigot\/Paper server, and start it to generate [`config.yml`](src\/main\/resources\/config.yml). Then, configure it:<\/p>\n
– Set [`url`](src\/main\/resources\/config.yml#L3) to the URL where you’re running MatterBridge, with port 4242 or whatever you’d like to use (if you’re running it on the same server, you can use `http:\/\/localhost:4242`).
\n– Set [`gateway`](src\/main\/resources\/config.yml#L6) to the name of your MatterBridge gateway.
\n– Set a [`token`](src\/main\/resources\/config.yml#L9) to secure the API. This is optional, but heavily recommended.
\n– Configure all other settings to your liking.<\/p>\n
Add an API protocol and gateway to `matterbridge.toml`. Here is an example:<\/p>\n
“`toml
\n[api]
\n[api.minecraft]
\nToken=”pasteTokenHere”
\n# Set BindAddress to “0.0.0.0:port” if your Minecraft server is running on a different server, and you’re not using a reverse proxy
\nBindAddress=”127.0.0.1:4242″
\nBuffer=1000
\nRemoteNickFormat=”[{PROTOCOL}] {NICK}”<\/p>\n
[[gateway.inout]]
\naccount=”api.minecraft”
\nchannel=”api”
\n“`<\/p>\n
Add any other protocols and gateways you would like to use, following MatterBridge’s documentation.<\/p>\n
If necessary, open your desired port in your firewall, then start MatterBridge and restart your Minecraft server.<\/p>\n
## Build<\/p>\n
You can build the project in the following 2 steps:<\/p>\n
* Check out the repository
\n * Build the jar file using maven: *mvn clean package*<\/p>\n
**Note:** JDK 1.8 and Maven is required to build the project!<\/p>\n
### Testing<\/p>\n
You can start a local test server including a MatterBridge instance using Docker and Docker Compose. For that, use the [docker-compose.yml](docker-dev\/docker-compose.yml) from the [docker-dev](docker-dev) folder.<\/p>\n
Copy the target\/MatterBukkit.jar to docker-dev\/data\/plugins and restart the Minecraft container.<\/p>\n
## My other plugins<\/p>\n
You can find them on my website.<\/p>\n","protected":false},"excerpt":{"rendered":"
A Bukkit plugin which sends chat messages from\/to MatterBridge.<\/p>\n","protected":false},"featured_media":98758,"template":"","meta":{"_minecraft_slug":"matterbukkit","_minecraft_project_id":"m78oYWqM","_minecraft_author":"Programie","_minecraft_license":"MIT","_minecraft_downloads":442,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"matterbukkit.zip","_minecraft_size_bytes":3549109,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T10:49:05.942940Z","_minecraft_date_created":"2023-05-25T21:08:13.199608Z","_minecraft_date_modified":"2025-07-06T15:27:57.513122Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/matterbukkit","_minecraft_icon_attachment_id":98758,"_minecraft_imported_at":"2026-06-05T16:08:30+00:00","_minecraft_import_hash":"daf96cc3a10ac3e7d69b33e65117d72f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,867,129],"mod_loader":[130,132,134],"minecraft_version":[379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,73,74,38,78,79,80],"class_list":["post-98757","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-paper","mod_category-social","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7"],"yoast_head":"\n