Ytspawn Plugin Documentation
Overview
Ytspawn is a Minecraft plugin that integrates YouTube live chat with in-game events, allowing viewers to spawn entities and trigger special events in the Minecraft world through chat commands.

JOIN THIS DISCORD SERVER AND GET YOUR PASSWORD
https://discord.gg/exeontop

Features

1. YouTube Live Chat Integration
2. Entity Spawning
3. Special Events
4. Custom Named Entities
5. OP Chicken Feature
6. Speed Horse Spawning
7. Configurable Settings

Configuration
Edit the config.yml file to set up the plugin:

apiKey: "YOUR_YOUTUBE_API_KEY"
videoId: "YOUTUBE_LIVE_VIDEO_ID"
channelId: "YOUTUBE_CHANNEL_ID"
pollingInterval: 200
spawnInterval: 100

• apiKey: Your YouTube Data API key
• videoId: ID of the live stream video
• channelId: Your YouTube channel ID
• pollingInterval: Time between chat message polls (in ticks)
• spawnInterval: Minimum time between entity spawns (in ticks)

Usage
Chat Commands
Viewers can type these commands in the YouTube live chat:

• 1. "zombie" - Spawns a zombie
  2. "cow" - Spawns a cow
  3. "sheep" - Spawns a sheep
  4. "wolf" - Spawns a wolf
  5. "cat" - Spawns a cat
  6. "creeper" - Spawns a creeper
  7. "irongolem" - Spawns an iron golem
  8. "skeleton" - Spawns a skeleton
  9. "pig" - Spawns a pig
  10. "chicken" - Spawns a chicken
  11. "parrot" - Spawns a parrot
  12. "pillager" - Spawns a pillager
  13. "ravager" - Spawns a ravager
  14. "villager" - Spawns a villager
  15. "piglin" - Spawns a piglin
  16. "zoglin" - Spawns a zoglin
  17. "slime" - Spawns a slime
  18. "magmacube" - Spawns a magma cube
  19. "choco" - Spawns a baby panda named "Choco"
  20. "opchicken" - Spawns a special rotating chicken that drops valuable loot
  21. "speed" - Spawns a pre-tamed horse with a saddle
  22. "silverfish" - Spawns a silverfish
  23. "endermite" - Spawns an endermite
  24. "axolotl" - Spawns an axolotl

Special Events

• New Sponsor: Spawns a Warden named "New Member"
• Super Chat: Spawns an Ender Dragon named "Super Chat Dragon"

Technical Details
Dependencies

• Bukkit/Spigot API
• YouTube Data API v3
  (no need to add to your server)

How to get your api key

1. 
   
   
   • Go to the Google Developers Console (https://console.developers.google.com/).
   • Create a new project or select an existing one.
   • Click on "Enable APIs and Services" at the top of the page.
   • Search for "YouTube Data API v3" and select it.
   • Click the "Enable" button to activate the API for your project.
   • Once enabled, go to the "Credentials" section in the left sidebar.
   • Click on "Create Credentials" and select "API Key" from the dropdown menu.(also create for auth )
   • Your new API key will be generated. Copy this key.
   • Open the config.yml file in your ytspawn plugin folder.
   • Replace the existing apiKey value with your new API key:

Key Methods

• onEnable(): Initializes the plugin and YouTube API connection
• pollChatMessages(): Fetches and processes live chat messages
• rotateChickenAndDropLoot(): Handles the OP Chicken feature
• dropOpLoot(): Generates random valuable loot

Error Handling
The plugin implements exponential backoff for API request failures to prevent excessive API calls and potential rate limiting.

Performance Considerations

• Asynchronous chat polling to prevent server lag
• Configurable intervals for polling and spawning to manage server load

Limitations

• Requires an active YouTube live stream
• Dependent on YouTube API quotas and rate limits

This documentation provides an overview of the ytspawn plugin's features, configuration, usage, and technical details. It serves as a comprehensive guide for users and developers working with the plugin.