{"id":20674808,"url":"https://github.com/btarg/twitchvsminecraft2","last_synced_at":"2025-07-16T14:34:08.168Z","repository":{"id":147799480,"uuid":"233666735","full_name":"btarg/TwitchVsMinecraft2","owner":"btarg","description":"A Minecraft Forge mod that lets viewers on Twitch or members of a Discord server interact with your game.","archived":false,"fork":false,"pushed_at":"2022-03-23T23:18:02.000Z","size":1778,"stargazers_count":3,"open_issues_count":1,"forks_count":3,"subscribers_count":1,"default_branch":"1.18","last_synced_at":"2025-06-22T11:06:56.971Z","etag":null,"topics":["discord","forge","forge-mod","minecraft","minecraft-forge","minecraft-mod","mod","streaming","twitch"],"latest_commit_sha":null,"homepage":"https://btarg.github.io/TwitchVsMinecraft2/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/btarg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"ko_fi":"btarg"}},"created_at":"2020-01-13T18:39:15.000Z","updated_at":"2024-01-08T16:38:26.000Z","dependencies_parsed_at":"2023-05-27T14:00:41.165Z","dependency_job_id":null,"html_url":"https://github.com/btarg/TwitchVsMinecraft2","commit_stats":null,"previous_names":["btarg/twitchvsminecraft2"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/btarg/TwitchVsMinecraft2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/btarg%2FTwitchVsMinecraft2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/btarg%2FTwitchVsMinecraft2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/btarg%2FTwitchVsMinecraft2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/btarg%2FTwitchVsMinecraft2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/btarg","download_url":"https://codeload.github.com/btarg/TwitchVsMinecraft2/tar.gz/refs/heads/1.18","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/btarg%2FTwitchVsMinecraft2/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261282322,"owners_count":23134939,"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":["discord","forge","forge-mod","minecraft","minecraft-forge","minecraft-mod","mod","streaming","twitch"],"created_at":"2024-11-16T21:07:35.305Z","updated_at":"2025-06-22T11:07:10.935Z","avatar_url":"https://github.com/btarg.png","language":"Java","funding_links":["https://ko-fi.com/btarg"],"categories":[],"sub_categories":[],"readme":"# Twitch Vs Minecraft Reloaded (Forge 1.18.2)\n\n[![Build status](https://github.com/iCrazyBlaze/TwitchVsMinecraft2/actions/workflows/build.yml/badge.svg)](https://github.com/iCrazyBlaze/TwitchVsMinecraft2/actions)\n[![CurseForge](http://cf.way2muchnoise.eu/full_318840_downloads.svg)](https://www.curseforge.com/minecraft/mc-mods/twitch-vs-minecraft)\n\nA Minecraft mod for Forge inspired by [Kaze Emanuar](https://www.youtube.com/channel/UCuvSqzfO_LV_QzHdmEj84SQ)\nand [CrowdControl](https://crowdcontrol.live) that lets Twitch viewers interact with the game to provide a fun challenge\nfor streamers.\n\n[🌐 Project homepage](https://icrazyblaze.github.io/twitchvsminecraft)\n\n[🔨 View the project on CurseForge for more info!](https://www.curseforge.com/minecraft/mc-mods/twitch-vs-minecraft)\n\n[📙 See the documentation if you are making modifications to the code.](https://icrazyblaze.github.io/TwitchVsMinecraft2/)\n\n# Forge version\n\nThe latest version of the mod is designed to work with [Forge](https://files.minecraftforge.net) for Minecraft 1.18.2\n\n\u003e This mod is **NOT** backwards compatible with any older Minecraft Forge versions.\n\u003e Only versions of the mod for the latest versions of Minecraft Forge will be supported going forwards.\n\n# How it works\n\n## **Using Twitch**\n\nThis mod integrates [Twitch4J](https://twitch4j.github.io/), a Java Twitch API wrapper. It uses this library to read a\nTwitch channel's chat.\n\n## **Using Discord**\n\nThis mod integrates [JDA](https://github.com/DV8FromTheWorld/JDA), a Java Discord API wrapper. It uses JDA to connect to\nDiscord as a bot, where it will read messages from the channels it can see, and send them through the same system as the\nTwitch chat.\n\n## **What the mod does**\n\nEvery time a new non-blacklisted chat message is received that starts with the chosen prefix, it is added to a list.\nEvery 30 seconds (this can be changed), a random message from the list is chosen, and if it's a valid command,\ne.g. `\"!creeper\"`, the list of new chat messages will be cleared, the timer will restart and the command will be\nexecuted. A list of commands is available [here](http://bit.ly/2UfBCiL) and on the website.\n\n# Twitch OAuth key\n\nAs stated on CurseForge, you will need a Twitch OAuth key to log in. You can get\nthis [here.](https://twitchapps.com/tmi)\n\nYou should keep this key private and safe. **DO NOT** share this key with others!\n\nFollow the instructions on the TwitchApps page for how to revoke access to the Twitch API if you want to stay extra\nsafe.\n\n\u003e This key is stored in a file located in the Minecraft root directory under `config`.\n\n# Discord Bot Token\n\nYou can also connect a Discord Bot and use your Discord server instead of Twitch chat. Visit\nthe [Discord Developer Dashboard](https://discord.com/developers/applications), and create a bot.\n\n\u003e This key is stored in a file located in the Minecraft root directory under `config`.\n\n# Editing the configuration file\n\nYou will need to edit this file to add your Twitch channel name, change the affected players, or choose what Discord\nchannels are read from, and you will often use it to change timer settings.\n\n\u003e You should edit this file as soon as you start playing. Make sure you have it on hand while trying the mod as you may need to tweak settings during your game.\n\nYour config file will be located in:\n\n```jsonpath\n.minecraft/config/twitchmod-common\n```\n\nand will look like this by default when opened in a text editor:\n\n```toml\n[general]\n\t#Name of Twitch channel\n\ttwitch_channel_name = \"btarg1\"\n\t#Names of Discord channels to read commands from ['separated', 'like', 'this']\n\tdiscord_channels = [\"general\"]\n\t#Should chat messages from Twitch or Discord be show in-game?\n\tshow_chat_messages = true\n\t#Should chosen commands be shown if chat messages are enabled?\n\tshow_commands_in_chat = true\n\t#How many seconds until the next command is chosen\n\t#Range: 3 ~ 60\n\tchoose_command_delay = 10\n\t#How many seconds until a random viewer-written message is shown on screen\n\t#Range: 10 ~ 480\n\tchoose_message_delay = 100\n\t#The players' Minecraft usernames that will be effected\n\tminecraft_username = [\"Dev\", \"Test\"]\n\t#The prefix for commands in Twitch or Discord\n\tcommand_prefix = \"!\"\n\t#Prevent the same command from being executed twice in a row\n\tenable_cooldown = true\n\t#Allow Frenzy Mode\n\tenable_frenzy = true\n\t#Require a certain amount of bits for any command\n\trequire_bits = false\n\t#How many bits are needed to activate commands if they are required\n\t#Range: \u003e 1\n\tminimum_bits = 10\n\t#How many votes are needed to activate special commands (e.g. Frenzy Mode)\n\t#Range: \u003e 2\n\tvotes_needed = 3\n\t#How many messages should be included when chat writes a book\n\t#Range: 5 ~ 99\n\tbook_length = 10\n```\n\n# Testing\n\nTo test commands without connecting to Twitch or Discord, use `/ttv test [true/false] \u003cstring\u003e`.\n\nWhen connected to Twitch, the Broadcaster's commands are always sent through, bypassing the blacklist and command timer\nentirely.\n\nTo review settings and view connection status, type `/ttv status`.\n\n# Building from source\n\n\u003e *Before you try building, make sure you [have JDK installed](https://adoptopenjdk.net/) and have properly set up your Java development environment.*\n\nTo build the project using a terminal, type\n\n```\n./gradlew build\n```\n\nOr find it in the Gradle tab in IDEA. Use the `genIntellijRuns` task to set up the mod properly for IDEA.\n\nThe final `.jar` mod file will be located in the **build/libs** folder.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbtarg%2Ftwitchvsminecraft2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbtarg%2Ftwitchvsminecraft2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbtarg%2Ftwitchvsminecraft2/lists"}