{"id":17111035,"url":"https://github.com/yariplus/minecraft-nodebb-integration","last_synced_at":"2025-06-18T15:36:48.335Z","repository":{"id":27882850,"uuid":"31374155","full_name":"yariplus/minecraft-nodebb-integration","owner":"yariplus","description":"A plugin for Minecraft servers for integration with a NodeBB forum.","archived":false,"fork":false,"pushed_at":"2018-08-07T02:43:45.000Z","size":349,"stargazers_count":10,"open_issues_count":16,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-13T03:57:39.448Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yariplus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-02-26T15:40:19.000Z","updated_at":"2025-02-06T00:36:43.000Z","dependencies_parsed_at":"2022-09-04T08:50:16.490Z","dependency_job_id":null,"html_url":"https://github.com/yariplus/minecraft-nodebb-integration","commit_stats":null,"previous_names":[],"tags_count":28,"template":false,"template_full_name":null,"purl":"pkg:github/yariplus/minecraft-nodebb-integration","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yariplus%2Fminecraft-nodebb-integration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yariplus%2Fminecraft-nodebb-integration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yariplus%2Fminecraft-nodebb-integration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yariplus%2Fminecraft-nodebb-integration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yariplus","download_url":"https://codeload.github.com/yariplus/minecraft-nodebb-integration/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yariplus%2Fminecraft-nodebb-integration/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260580782,"owners_count":23031472,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-14T16:48:27.804Z","updated_at":"2025-06-18T15:36:43.321Z","avatar_url":"https://github.com/yariplus.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NodeBB Integration\r\nThis Bukkit plugin is a companion app for [Minecraft Integration](https://community.nodebb.org/topic/3559/nodebb-plugin-minecraft-integration-minecraft-integration), a [NodeBB](https://nodebb.org/) forum plugin. It establishes a WebSocket connection to the forum which allows communication between the forum and your Minecraft server. This allows information on your Minecraft server and players to be displayed on your forum via widgets, user profiles, posts, shoutboxes, etc.. Your forum can also send events back to the server such as posts, messages, awards, groups. The plugin is a WebSocket client only and exposes it's API only to the Minecraft Integration plugin. The WebSocket client is run asynchronously to prevent network lag from interfering with normal server processes. If your forum uses a secure connection, this plugin's connection will be secure as well.\r\n\r\n## Requirements\r\n\r\nRequires Java 8 or higher.\r\n\r\n### What is NodeBB?\r\n\r\nForm the [NodeBB](https://nodebb.org/) Docs:\r\n\r\n![NodeBB logo](https://i.imgur.com/3yj1n6N.png)\r\n\r\n**NodeBB** is a next-generation discussion platform that utilizes web sockets for instant interactions and real-time notifications. NodeBB forums have many modern features out of the box such as social network integration and streaming discussions.\r\n\r\n## What does the NodeBB Integration plugin do?\r\n\r\nNodeBB Integration sends socket events to your forum when a Bukkit event occurs. The forum listens for these events and displays relevant information to forum users.\r\n\r\n- Display server info such as online time, plugins, mods, and online players, updated in real-time.\r\n- Show rankings such as most money, playtime, or McMMO skills on your forum, also updated in real-time.\r\n- Synchronize server chat and forum shoutboxes.\r\n- Synchronize server ranks with forum group membership.\r\n- Apply ranks to Minecraft players based on Forum usage. (Posts, reputation, etc..)\r\n\r\n## Plugin Configuration\r\n\r\nAfter placing the NodeBB Integration jar into your plugins folder and restarting your Minecraft server, a config.yml will be created in the folder `plugins/NodeBB_Integration` with the following options:\r\n\r\nOption | Usage\r\n---------------|-------------\r\n**FORUMURL** | The web address of the forum the plugin is connecting to. e.g., https://community.example.com/. Can use color codes with '\u0026'.\r\n**FORUMNAME** | The name of your forum, displayed on messages sent by this plugin. Can use color codes with '\u0026'.\r\n**APIKEY** | The API Key for your forum from the server settings section of Minecraft Integration.\r\n**SOCKETNAMESPACE** | Advanced use only. Default is `plugins`\r\n**PLUGINID** | Advanced use only. Default is `MinecraftIntegration`\r\n\r\nThe FORUMURL and APIKEY are required. You can save them to the config.yml or using the commands below. After editing the configuration, use the command `/nodebb reload` to reconnect to the forum. *No server restart is required.*\r\n\r\n## Commands\r\n\r\n### For OPs\r\n\r\nThese commands are available to all OPs and any players that have the permission **nodebb.admin**\r\n\r\n**/nodebb**\r\nDisplays all plugin commands.\r\n\r\n![\"Picture of commands using /nodebb\"](http://puu.sh/lYDZZ/14c755d95a.png)\r\n\r\n**/nodebb reload**\r\nReloads the config.yml from disk and reconnects to the forum.\r\n\r\n**/nodebb key [key]**\r\nGets or sets the forum API Key and reloads.\r\n\r\n**/nodebb url [url]**\r\nGets or sets the forum URL and reloads.\r\n\r\n**/nodebb name [name]**\r\nGets or sets the forum name and reloads.\r\n\r\n**/nodebb debug [toggle]**\r\nDisplays information useful for fixing errors. Use the toggle option to turn on verbose logging.\r\n\r\n### For Players\r\n\r\nAll players have these commands. No permission is required.\r\n\r\n**/register [KEY]**\r\nConnects the forum account associated with the email entered to the players UUID, allowing additional features on your forum.\r\n\r\n## Setting up your NodeBB forum\r\n\r\nNodeBB Integration is designed for use with the NodeBB plugin [Minecraft Integration](https://community.nodebb.org/topic/3559/nodebb-plugin-minecraft-integration-minecraft-integration).\r\n\r\nMinecraft Integration provides a GUI to manage:\r\n\r\n- Forum accounts linked to a player's UUID.\r\n- Linking a users' avatar to their Minecraft skin.\r\n\r\nas well as adding Widgets to your forum:\r\n\r\n- Server Status (dynamically updated)\r\n- TPS Graph\r\n- Player Rankings (for Playtime, Money, or McMMO stats.)\r\n- Player Graphs (for displaying online players or player rankings over time.)\r\n\r\n### Example Widgets\r\n\r\n#### Server Status\r\n\r\nDynamically updates player count, avatars, online status, and plugins.\r\n\r\n![](http://yariplus.x10.mx/images/widgetServerStatus.png)\r\n\r\n#### Player Graph\r\n\r\nUpdates dynamically.\r\n\r\n![](http://yariplus.x10.mx/images/widgetOnlinePlayersGraph.png)\r\n\r\n#### Player Rankings\r\n\r\nDynamically updates the statistic and player order.\r\n\r\n![](http://yariplus.x10.mx/images/widgetTopPlayersList.png)\r\n\r\n## Advanced Configuration\r\n\r\nAdvanced users can create their own NodeBB plugin to listen for Bukkit events using the socket.io module.\r\n\r\nThe SOCKETNAMESPACE and PLUGINID must be changed to their appropriate values in the config.yml.\r\n\r\n\u003e var socketPlugins = require('./socket.io/plugins');\r\n\u003e\r\n\u003e socketPlugins.MyPlugin = {\r\n\u003e   eventPlayerJoin: function (socket, data, callback) {\r\n\u003e     // The event is parsed into a plain js object.\r\n\u003e     console.log(data.player.name);\r\n\u003e   }\r\n\u003e }\r\n\r\n## Project Information\r\n\r\n**License:**\r\nCC0 or MIT License.\r\n\r\n**Source:**\r\n[https://github.com/yariplus/bukkit-plugin-nodebb-integration](https://github.com/yariplus/bukkit-plugin-nodebb-integration)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyariplus%2Fminecraft-nodebb-integration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyariplus%2Fminecraft-nodebb-integration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyariplus%2Fminecraft-nodebb-integration/lists"}