explaingit

janpio/twitchmc

Analysis updated 2026-07-06 · repo last pushed 2023-09-09

Audience · generalComplexity · 4/5DormantSetup · moderate

TLDR

TwitchMC connects a Minecraft server to a Twitch channel so only current subscribers can join. Streamers link their account once, and access is managed automatically as subscriptions change.

Mindmap

mindmap
  root((repo))
    What it does
      Sub-only Minecraft servers
      Auto manages access
      Links accounts with code
    How it works
      Minecraft plugin
      Web API service
      Control panel website
    Tech stack
      T3 Stack
      Firebase formerly
      Java plugin
    Use cases
      Streamer community perk
      No manual whitelist
      Self-host or hosted
    Audience
      Twitch streamers
      Community managers
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Offer a Minecraft server as a subscriber-only perk for your Twitch channel.

USE CASE 2

Let subscribers automatically join a Minecraft server without manually managing a whitelist.

USE CASE 3

Self-host the system to keep full control over your community's server access.

USE CASE 4

Use the hosted version for a quick setup without managing infrastructure.

What is it built with?

T3 StackMinecraft PluginTypeScript

How does it compare?

janpio/twitchmc0xhassaan/nn-from-scratch0xzgbot/hermes-comfyui-skills
Stars00
LanguagePython
Last pushed2023-09-09
MaintenanceDormant
Setup difficultymoderatemoderateeasy
Complexity4/54/51/5
Audiencegeneraldeveloperdesigner

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires running a Minecraft server alongside the web service and control panel, or using the hosted version at TwitchMC.io.

No license information was provided in the explanation, so default copyright restrictions may apply.

In plain English

TwitchMC lets Twitch streamers set up a Minecraft server that only their subscribers can join. Instead of manually managing a whitelist or handing out access one by one, the streamer connects their Twitch account once, and from then on anyone who is subscribed to their channel can log in and play. The system has two main pieces. The first is a plugin that runs on the Minecraft server itself. When a player tries to connect, the plugin pings a web service to ask whether that person is allowed in. The second piece is that web service plus a control panel where players link their Minecraft identity to their Twitch account. The linking process works through a short code shown in-game, the player enters it on the control panel website after logging in with Twitch, and from that point the system knows who they are and whether they are subscribed to the streamer. This is built for Twitch streamers who want to offer a Minecraft server as a perk for their subscribers, without the hassle of manually adding or removing people as subscriptions come and go. A mid-sized streamer with a few hundred active subs, for example, could spin up a server, install the plugin, and let their community start playing without needing to manage access lists themselves. The project is open source and can be self-hosted, though there is also a hosted version at TwitchMC.io for those who want a simpler setup. The team originally used Firebase for the database and backend logic but moved away from it after running into hard-to-diagnose permission errors and timeout issues that would cause the control panel to hang for some users. They rebuilt the API and control panel using a modern web stack called the T3 Stack, which gave them more direct control over the database and hosting while keeping costs lower. The Minecraft plugin itself is kept deliberately simple, almost all the logic lives in the web service, so the plugin stays compatible with future Minecraft server versions without requiring constant updates.

Copy-paste prompts

Prompt 1
I want to set up TwitchMC for my Twitch channel. Walk me through how to install the plugin on my Minecraft server and connect it to the control panel.
Prompt 2
How do I link my Minecraft account to my Twitch account using the in-game code on the TwitchMC control panel?
Prompt 3
I am self-hosting TwitchMC instead of using the hosted version. What infrastructure do I need to run the web service and database?
Prompt 4
Explain how the TwitchMC plugin checks if a player is a subscriber when they try to join the Minecraft server.
Prompt 5
Help me troubleshoot why a subscribed Twitch viewer cannot join my TwitchMC Minecraft server after linking their account.

Frequently asked questions

What is twitchmc?

TwitchMC connects a Minecraft server to a Twitch channel so only current subscribers can join. Streamers link their account once, and access is managed automatically as subscriptions change.

Is twitchmc actively maintained?

Dormant — no commits in 2+ years (last push 2023-09-09).

What license does twitchmc use?

No license information was provided in the explanation, so default copyright restrictions may apply.

How hard is twitchmc to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is twitchmc for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.