gitwtfhub

wtf is twitchmc?

janpio/twitchmc — explained in plain English

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

Audience · generalComplexity · 4/5DormantSetup · moderate

TL;DR

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

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

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

REASON 4

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

What's in the stack?

T3 StackMinecraft PluginTypeScript

How it stacks up

janpio/twitchmc0verflowme/alarm-clock0xhassaan/nn-from-scratch
Stars0
LanguageCSSPython
Last pushed2023-09-092022-10-03
MaintenanceDormantDormant
Setup difficultymoderateeasymoderate
Complexity4/52/54/5
Audiencegeneralvibe coderdeveloper

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

How do you spin it up?

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.

Wtf does this do

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.

Yoink these 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

wtf 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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.