YouTube Chat For Minecraft - GitHub

Skip to content Dismiss alert {{ message }} youtube / youtube-chat-for-minecraft Public

• Notifications You must be signed in to change notification settings
• Fork 19
• Star 66

• Code
• Pull requests 1
• Actions
• Projects
• Security
• Insights

Additional navigation options

 masterBranchesTagsGo to fileCodeOpen more actions menu

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit   History 15 Commits15 Commits
gradle/wrapper		gradle/wrapper
src/main		src/main
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
configuration.png		configuration.png
dependencies.txt		dependencies.txt
download_json.png		download_json.png
gradlew		gradlew
gradlew.bat		gradlew.bat
settings.gradle		settings.gradle
setup.gradle		setup.gradle
View all files

Repository files navigation

• README
• Contributing
• Apache-2.0 license

YouTube Chat for Minecraft

A plugin for Minecraft Forge that provides an API for YouTube live chat services. This is not an official Google product.

Features

• Broadcasts live chat messages to multiple clients from a single network connection
• Provides author details (channelId, displayName, isChatModerator, isChatOwner isChatSponser, profileImageUrl) and SuperChat details
• In-game configuration

Workspace setup

Clone this repository, and open a terminal to the root directory. Navigate to http://files.minecraftforge.net and pick the latest or recommened MDK version. Update the mdkVersion definition in setup.gradle, then run the installMdk task:

./gradlew -b setup.gradle

Next, setup the decompiled workspace and save the build dependencies:

./gradlew setupDecompWorkspace ./gradlew saveDependencies

Build the jar:

./gradlew build

A single .jar file will be output to build/libs, e.g. ytchat-1.0.0.jar.

Intellij Idea Setup

If you have Intellij Idea installed and plan to use it for development, perform these steps to setup the project directory.

1. Run the following gradle task:

./gradlew idea

2. Open the project folder with Intellij, and import the Gradle project when prompted.
3. Make sure you have the 1.8 JDK configured (File->Project Structure->SDKs).
4. Select Run->Edit Configurations:

• There should be two configurations - Minecraft Client and Minecraft Server.
• Edit the Minecraft Client configuration.
• Go to the Use classpath of a module field
• Select the module ending with _main.
• Ensure a valid JRE is selected.

5. Run the Minecraft Client configuration. Minecraft should open. You may Debug as well.

Installation

Copy the YouTube Chat jar to one these folders depending on your OS:

• Linux: ~/.minecraft/mods
• OSX: ~/Library/Application\ Support/minecraft/mods/
• Windows: %APPDATA%/Minecraft/mods

Obtaining Credentials

1. Create a project in the Google API Console

2. Click Create credentials. Select OAuth client ID from the dropdown, followed by Other for the Application type.

3. Open the API Library and ensure that your application is registered to use the YouTube Data API.

4. Download the client ID JSON by clicking the following icon for your project:

5. Run the YouTube Chat jar from a terminal to obtain authorization credentials, pasting the downloaded json when prompted:

java -jar ytchat-1.0.3.jar login

If you want to clear your credentials or sign in as a different user, run logout:

java -jar ytchat-1.0.3.jar logout

Credentials are saved to ~/.oauth-credentials.

Configuration

1. With YouTube Chat installed, open Minecraft with the forge profile.
2. At the Minecraft main menu, select Mods.
3. Select YouTube Chat, and click Config. There are 2 settings:

• Client Secret: (Required) The client secret json downloaded from the Google API Console
• videoId: (Optional) A videoId associated with the live broadcast to connect to. If blank, will attempt to connect to the signed in user's live broadcast (a Google sign-in dialog will appear when starting YouTube Chat).

Runtime Usage

YouTube Chat supports the following commands in Minecraft:

/ytchat [start|stop|logout|echoStart|echoStop]

• start: Starts the YouTube Chat service, connecting to the live chat of the signed in user.
• stop: Stops the YouTube Chat service.
• logout: Stops the YouTube Chat service and clears saved credentials.
• echoStart: Starts echoing chat messages into Minecraft chat, for troubleshooting.
• echoStop: Stops echoing chat messages into Minecraft chat.

/ytcmock <mock author id/name> <mock input>

Provides mock input for testing without a YouTube live chat connection.

API

To use YouTube Chat, copy the jar into the libs folder of your Forge directory. Regenerate the project with gradle, or manually add a dependency to the jar in the project settings.

Add ytchat to the dependencies field in mcmod.info, e.g.:

"dependencies": ["ytchat"]

Get an instance of the YouTubeChatService interface:

YouTubeChatService service = YouTubeChat.getService();

Discussion and Support

Join the discussion group at https://groups.google.com/forum/#!forum/youtube-chat-for-minecraft

About

A plugin for Minecraft Forge that provides an API for YouTube live chat services

Topics

minecraft youtube youtube-api minecraft-forge youtube-api-v3

Resources

Readme

License

Apache-2.0 license

Contributing

Contributing

Uh oh!

There was an error while loading. Please reload this page.

Activity Custom properties

Stars

66 stars

Watchers

8 watching

Forks

19 forks Report repository

Releases 5

YouTube Chat for Minecraft 1.12 Latest Jul 28, 2017 + 4 releases

Packages

Uh oh!

There was an error while loading. Please reload this page.

Uh oh!

There was an error while loading. Please reload this page.

Contributors

Uh oh!

There was an error while loading. Please reload this page.

Languages

• Java 100.0%

You can’t perform that action at this time.