Hey, thanks for viewing this page! This plugin was a wish by @seb1211! Because there's actually no other plugin (for free) on the market which is able handle TikTok Donations in Minecraft, I decided to create this one for all of you for free
Please note that this plugin is in BETA phase, means there may be few-many bugs in the plugin. If you find any, feel free to open a ticket on my discord server:https://discord.gg/8QWmU4ebCC
DISCLAIMER: The plugin is using my webserver to transfer datas between TikFinity and my Minecraft Plugin. If you want to use sockets instance of this method (because you think I could abuse your datas) just enable the "Socket.Legacy" mode in the config.yml.
IMPORTANT: This option is only working if your port in the config.yml was unlocked on your WLAN-Router
Whats TikTokLive? TikTok Live allows you to connect your TikFinity account to Minecraft to perform various actions at various events in Minecraft!
How to install: 1. Click on this webpage on Download Now and open your Downloads folder
2. Open your Minecraft-Server-Folder and put the plugin from your Downloads in your plugins folder of your Minecraft-Server
3. Start/Restart your server
4. After your server got started the plugin should get activated. Type
/plugins in your Console to see if the plugin is working (In the List which get printed out you should see a plugin named "TikTokLive").
(
5. Open your TikTokLive folder which can be found in the plugins folder of you Minecraft-Server and open the config.yml. There you can change all settings how you want them)
6. Login/Register at
TikFinity and click on "Actions & Events" at the left bar
7. Type
/tiktoklive generate as a player with OP-Permissions or console. Now a link should be displayed. Click on the link and click on the button "Copy to clipboard"
8. On the opened TikFinity website click on "Create new Action", type in a name (it isn't important which is the name) and scroll down to "Trigger Webhook". Enable this setting with one click on the box and paste in the copied link (from Minecraft) in the left textbox.
9. On the webpage scroll down to "Save" and Click the Button
10. You can now define "Events" and configure them to execute a Minecraft-Gift/Follow/...-Action!'
11. You're ready! All you need to do is changing the gifts/actions in the config.yml to your preferences. If you need help feel free to ask on my discord:
https://discord.gg/8QWmU4ebCC
IMPORTANT INFORMATION: Because of a error of TikFinity/TikTok it could happen that the plugin do not detect the events in action (if you're live on TikTok) but over the Event-Simulator. Because of this I REALLY RECOMMEND to set the ACTION-NAME in TikFinity to your GIFTID (which you configurated in my config.yml)
Coming Soon / TODO: - A GUI for a easier setup
- Edit Code
- Fix Bugs
- Your Wishes (Write me your Ideas:
https://discord.gg/mf9JNrzh)
Commands and Permissions: /tiktoklive reload - Reloads the Configuration-Files and restarts the socket - Permission:
tiktoklive.reload /tiktoklive generate - Generates the basic URL which is needed to connect this plugin to TikFinity - Permission:
tiktoklive.generate /tiktoklive addselected/removeselected <Player> - Add/Remove a player to/from the selected player-list - Permission:
tiktoklive.add.selected / tiktoklive.remove.selected /tiktoklive help - Opens the help-menu - Permission:
tiktoklive.help
Common Questions: COMING SOON
The Configuration-Files:
Code (YAML):
#################################################### # ████████╗████████╗██╗░░░░░██╗██╗░░░██╗███████╗ # # ╚══██╔══╝╚══██╔══╝██║░░░░░██║██║░░░██║██╔════╝ # # ░░░██║░░░░░░██║░░░██║░░░░░██║╚██╗░██╔╝█████╗░░ # # ░░░██║░░░░░░██║░░░██║░░░░░██║░╚████╔╝░██╔══╝░░ # # ░░░██║░░░░░░██║░░░███████╗██║░░╚██╔╝░░███████╗ # # ░░░╚═╝░░░░░░╚═╝░░░╚══════╝╚═╝░░░╚═╝░░░╚══════╝ # #################################################### ############################### # Made by TimeCode @ 2023 # # Plugin-Version: 1.0-BETA # # (05.02.2023) # ############################################################################################################# # If you got an error or found a bug (or if you have wishes), join my discord: https://discord.gg/mf9JNrzh # # And Thank You for downloading my plugin! Please do not report bugs in the review section, because as a # # Downloader you're able to give me your wishes for the plugin and I will add them soon! # #############################################################################################################
#Change this to "false" if you want to disable this plugin Enabled: true
#Change the selected player for TikTokLive Player: #Set this to "true" if all players which are online should be selected AllOnline: false
#Change this to "true" if only the player which first joined the server should be selected FirstWhichJoins: true
#ONLY IF AllOnline AND FirstWhichJoins ARE "false": Set the PlayerName which should be selected (only if he's online) OrName: "TimeCode"
#Here you can change all settings for the Socket (which will connect with TikFinity) Socket: #Uses the old socket system of the plugin (ONLY WORKS ON PUBLIC SERVERS | I DO NOT RECOMMEND TO ENABLE THIS) Legacy: false
#This is the time in ticks between two tikfinity checks (only works if legacy is disabled) RefreshInTicks: 20
#Change this to your PUBLIC IP Address (127.0.0.1 or Localhost WON'T WORK | THIS FUNCTION IS ONLY USABLE IF LEGACY IS ENABLED) IP: 127.0.0.1
#Change the SocketPort (I recommend to keep it at 89) Port: 89
#Change this to your socket password, you will need it to setup the plugin for TikFinity #(If you don't want to use a password set this to "" | NOT RECOMMENDED) Password: "mysecretpassword123" Actions: #Change this to your giftid, giftname (must be configurated in the giftlist.yml), coinamount #You can also add multible giftids, giftnames and coinamounts by adding a "," and a space " " after each giftid, giftname or coinamount #################################################################################################################################################################################################### #NEW IN UPDATE 1.1.1: You can now use the TikFinity Action-Names to listen to TikTok-Events, that means you can now listen to for example Follows #or Subscriptions (for example: If you created a action in TikFinitywith the name "LOL" you're now able to change "6525, 6661" to "LOL" to listen to the specific event configurated in TikFinity) #IMPORTANT: THAT IS ONLY WORKING IF THE NAME ISN'T A GIFT ID OR A GIFT NAME (YOU CAN VIEW ALL GIFT-IDS AND GIFT-NAMES IN THE giftlist.yml) #################################################################################################################################################################################################### 6525, 6661: #Send a Command #Placeholders: %player_name% for the player-name, %player_uuid% for the player-uuid #Get the Coordinates of the player: %player_x%, %player_y%, %player_z%, #For the gifts: %gift_name% to get the gift-name (if it cannot find the name %gift_name% = %gift_id%), #%gift_id% to get the gift-id, %gift_coins% to get the coins which are needed to buy the gift, %gift_amount% get the amount of gifts, #%gifter_name% to get the username of the gifter, %gifter_id% to get the userid of the gifter Command: "" #Change this to "false" if the Command shouldn't get executed in the console (if it's "false" the command will be executed by the player) PerformAsConsole: true
#Send a message to a player #Placeholders: Same as in Command Message: "&aThis is a test" #Send a actionbar to the player #Placeholders: Same like Command & Message Actionbar: "&cThis is a test" #Set a sound which should be played after this event get triggered #All sounds which can be used can be found here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html Sound: BLOCK_NOTE_BLOCK_IMITATE_ENDER_DRAGON
#IMPORTANT INFORMATION: YOU NEED A " BEFORE AND AFTER THE X, Y and Z COORDINATE TeleportPlayer: #Changes the X-Coordinate of the player: #+BLOCKS = +BLOCKXBLOCKSAWAY FROM THE CURRENT LOCATION, -BLOCKS = -BLOCKXBLOCKSAWAY FROM THE CURRENT LOCATION, #BLOCKS = XCOORDINATE X: "+10" #Changes the Y-Coordinate of the player: #+BLOCKS = +BLOCKYBLOCKSAWAY FROM THE CURRENT LOCATION, -BLOCKS = -BLOCKYBLOCKSAWAY FROM THE CURRENT LOCATION, #BLOCKS = XCOORDINATE Y: "+0" #Changes the Z-Coordinate of the player: #+BLOCKS = +BLOCKZBLOCKSAWAY FROM THE CURRENT LOCATION, -BLOCKS = -BLOCKZBLOCKSAWAY FROM THE CURRENT LOCATION, #BLOCKS = XCOORDINATE Z: "+0" #If you want to spawn mobs, use this setting SpawnMob: #The id of the mob 1: #Set the Type of the Mob (REQUIRED) #You can find all of them here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html Type: WITHER
#Set the amount of mobs which should get spawned (NOT REQUIRED) Amount: 1
#Change the settings for the SpawnDistance of the mob (NOT REQUIRED) SpawnDistance: #Change the settings for the random spawn system Random: #Change this to "false" if mob's shouldn't get spawned in a radius... Enabled: true
#... of BELOW blocks MaxRadius: 100
#Changes the X-Coordinate of the mob: #+BLOCKS = +BLOCKXBLOCKSAWAY FROM THE PLAYER, -BLOCKS = -BLOCKXBLOCKSAWAY FROM THE PLAYER, #BLOCKS = XCOORDINATE X: +10
#Changes the Y-Coordinate of the mob: #+BLOCKS = +BLOCKYBLOCKSAWAY FROM THE PLAYER, -BLOCKS = -BLOCKYBLOCKSAWAY FROM THE PLAYER, #BLOCKS = XCOORDINATE Y: +0
#Changes the Z-Coordinate of the mob: #+BLOCKS = +BLOCKZBLOCKSAWAY FROM THE PLAYER, -BLOCKS = -BLOCKZBLOCKSAWAY FROM THE PLAYER, #BLOCKS = XCOORDINATE Z: +0
#The Antispam system | Prevents sending BotMessages AntiSpam: #To disable this set this to "false" Enabled: true
#Set the MaxTikTokEvents TikTokEvents: 6
#Set the MaxSECONDDistance of each event MaxDistanceInSecBetweenEveryEvent: 2
Actions: #Set the delay if the AntiSpam detects spam DelayInSeconds: 5
#"bStats is a free and open source website that helps the developer to collect usage data from his plugin" (Source: bstats.org) #If you don't want to send me automatic statistics, disable this with changing it to "false" bStats: true
#DON'T CHANGE THIS #AFTER CHANGING THIS CONFIG WON'T EXIST ANYMORE config-version: 1.2
Code (YAML):
#################################################### # ████████╗████████╗██╗░░░░░██╗██╗░░░██╗███████╗ # # ╚══██╔══╝╚══██╔══╝██║░░░░░██║██║░░░██║██╔════╝ # # ░░░██║░░░░░░██║░░░██║░░░░░██║╚██╗░██╔╝█████╗░░ # # ░░░██║░░░░░░██║░░░██║░░░░░██║░╚████╔╝░██╔══╝░░ # # ░░░██║░░░░░░██║░░░███████╗██║░░╚██╔╝░░███████╗ # # ░░░╚═╝░░░░░░╚═╝░░░╚══════╝╚═╝░░░╚═╝░░░╚══════╝ # #################################################### ########################################################## # TikTok Giftlist v1.0 # # If you want to add a giftid to this list in general, # # join my discord: https://discord.gg/8QWmU4ebCC # # then I will try to add your giftid to the next update # ########################################################## ######################################################################################################################## # Tutorial "How to add a Gift to the plugin": # # 1. Copy the gift id! You can find all gift ids here: https://streamdps.com/tiktok-widgets/gifts/ # # (The ID is just below the gift emoji) # # 2. Remember the Coins which are needed to buy the gift for the streamer # # 3. Look for the number of coins in the text below. (If there isn't any number who matches with the coins # # of your gift, create one at the bottom of the document in the following format: " NUMBEROFCOINS:") # # IMPORTANT: ONLY the numbers that are TWO CHARACTERS away from the edge of the document are meant! # # 4. Go into a new line BELOW THE CoinNumber and create a text in the following format: " GIFTID: "GIFTNAME"" # # 5. You're finished! You just need to reload the plugin and your gift should be ready # # (6. If you're too stupid to handle this, just join my discord ;)) # ######################################################################################################################## GiftID:
1:
7767: "February" 6093: "Football" 5760: "Weights" 5655: "Rose" 5269: "TikTok" 6788: "Glow Stick" 6784: "Cake Slice" 6246: "Thumbs Up" 6247: "Heart" 7765: "Royal Rose" 6890: "Love You" 7213: "Squirrel" 7375: "Lucky Pig" 7712: "Gold Award" 5:
5650: "Mic" 5487: "Fingerherz" 7501: "Hello Traveler" 7:
7759: "Buy myself flowers" 8:
7762: "Watch" 10:
6125: "Love You" 7341: "Panther" 20:
5658: "Perfume" 55:
7391: "I'm shy" 99:
6432: "Star" 5659: "Paper Crane" 6097: "Little Crown" 6104: "Cap" 6427: "Hat and Mustache" 6525: "Honorable Person" 6661: "Kiss your Heart" 6793: "Ranking Lit" 100:
7121: "Marvelous Confetti" 5513: "Schatztruhe" 5585: "Confetti" 5660: "Hand Hearts" 7163: "Mishka Bear" 150:
7364: "Sceptre" 169:
5729: "Butterfly" 199:
5509: "Sonnenbrille" 5586: "Herzen" 5734: "Goggles" 5880: "Lock and Key" 6436: "Love Focus" 6437: "Garland Headpiece" 6671: "Love You" 6795: "Ranking Lit" 6796: "Ranking Lit" 7458: "Wooly Hat" 7541: "Monsieur" 7545: "Feather Hat" 7546: "Coppola" 7547: "Guards Hat" 6794: "Ranking Lit" 6713: "Cheer For You" 6776: "Birthday Glasses" 299:
6007: "Boxing Gloves" 6265: "Duck" 6267: "Corgi" 6752: "Friend" 6868: "Hedgehog" 7313: "Cuddle Season" 7503: "We Love" 5882: "Rock 'n' Roll" 7532: "Dream Team" 7222: "Full moon" 399:
5899: "Swing" 499:
5731: "Coral" 6415: "Music" 500:
7122: "Gem Gun" 7168: "Money Gun" 7282: "Spaghetti Kiss" 7398: "Prince" 7688: "Don't Do It" 599:
6865: "Cooper Skates Home" 600:
6938: "Mermaid" 7266: "Applause" 699:
5897: "Swan" 7357: "TikTok Trophy" 800:
5664: "Pearl" 899:
5978: "Train" 999:
6233: "Travel with You" 5976: "Hot Air Balloon" 1000:
7123: "Shiny air balloon" 5587: "Gold Mine" 5596: "Sportwagen" 5680: "Disco ball" 5886: "Galaxy" 6200: "Mirror Bloom" 6781: "Watermelon Love" 7181: "Fondue" 1088:
6090: "Fireworks" 1200:
7631: "Take a Drive" 1299:
7186: "Frozen Magic" 1500:
5651: "Garland" 5955: "Champion" 7367: "Diamond Ring" 7467: "Chasing the Dream" 1999:
6033: "Make-up Box" 6834: "Gift Box" 6862: "Cooper Flies Home" 7196: "Let Us Dance" 6327: "Airship" 6789: "Red Carpet" 6797: "Super Cake" 7529: "Mystery Firework" 2000:
6417: "Club" 7182: "Raclette" 2150:
6820: "Whale diving" 2399:
7225: "Snow Plough" 2988:
5765: "Motorcycle" 3000:
6563: "Meteor Shower" 5652: "Ferris Wheel" 3999:
6863: "Cooper Swims Home" 6835: "Gift Box" 4000:
6148: "Flower Overflow" 7466: "Cosy Nights" 4888:
5767: "Private Jet" 6646: "Unicorn Fantasy" 7124: "Signature Jet" 5000:
7237: "Unicorn Fantasy" 7468: "Dancing Adam" 5999:
7626: "Truck" 6864: "Cooper's Home" 6000:
5627: "Romantic Carriage" 6884: "Aqua Car" 6999:
6790: "Celebration Time" 6787: "Birthday Party" 7000:
6089: "Sports Car" 10000:
6149: "Interstellar" 6203: "Sunset Speedway" 10999:
6367: "Falcon" 12000:
6892: "Race Car" 15000:
5954: "Planet" 20000:
6751: "TikTok Shuttle" 6833: "Castle Fantasy" 7125: "Premium Shuttle" 25999:
7400: "Adam's Dream" 26999:
7610: "Dragon Flame" 29999:
6369: "Lion" 7505: "Winter Lion" 34000:
7823: "Leon and Lion" 34999:
6038: "TikTok Universe" 7811: "TikTok Universe" 7312: "TikTok Universe+" 41999:
7603: "Holiday Universe"
#DON'T CHANGE THIS! After changing this the whole GiftList will get resettet version: 1.0