Sprummlbot - A lightweight multifunctional TS3 bot

Scrump

Member
Joined
Oct 3, 2015
Messages
34
Points
43
Location
Germany
I configured everything, the bot is not showing me up anything i just can send a server message, this function is working but where can i seee and setup the rest?
You have to set up the bot via config file :). The Web Interface Setup will come soon :)
 

strux1

Member
Joined
Mar 19, 2016
Messages
30
Points
43
Age
31
Ahh okay so the Webinterface is without functions right now?
Thanks a lot for the fast answer. When it will be released with working interface?
 

Scrump

Member
Joined
Oct 3, 2015
Messages
34
Points
43
Location
Germany
Ahh okay so the Webinterface is without functions right now?
Thanks a lot for the fast answer. When it will be released with working interface?
So the web interface only has client and ban actions and a public message function. More will be added
 

BrandoGamer

Member
Joined
Apr 9, 2016
Messages
3
Points
35
Age
48
Error Log from 16_6_2016__20_05_25.
Custom message: Connection Error!
com.github.theholywaffle.teamspeak3.api.exception.TS3ConnectionFailedException: An error occurred while connecting to the TeamSpeak3 server
at com.github.theholywaffle.teamspeak3.QueryIO.<init>(QueryIO.java:71)
at com.github.theholywaffle.teamspeak3.TS3Query.connect(TS3Query.java:99)
at net.scrumplex.sprummlbot.qgZSyjGOVNPGbBZt5NUv.GoicqOVehRY68RCP7lXb(Unknown Source)
at net.scrumplex.sprummlbot.Main.main(Unknown Source)
Caused by: java.net.ConnectException: Connessione rifiutata
at java.net.PlainSocketImpl.socketConnect(Native Method)
at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:339)
at java.net.AbstractPlainSocketImpl.connectToAddress(AbstractPlainSocketImpl.java:200)
at java.net.AbstractPlainSocketImpl.connect(AbstractPlainSocketImpl.java:182)
at java.net.SocksSocketImpl.connect(SocksSocketImpl.java:392)
at java.net.Socket.connect(Socket.java:579)
at java.net.Socket.connect(Socket.java:528)
at java.net.Socket.<init>(Socket.java:425)
at java.net.Socket.<init>(Socket.java:208)
at com.github.theholywaffle.teamspeak3.QueryIO.<init>(QueryIO.java:57)
... 3 more
Please contact support!
I'm use debian 8.5.2 with java 7..... Help Please!
 
Last edited by a moderator:

Scrump

Member
Joined
Oct 3, 2015
Messages
34
Points
43
Location
Germany
[/spoiler]
Error Log from 16_6_2016__20_05_25.
Custom message: Connection Error!
com.github.theholywaffle.teamspeak3.api.exception.TS3ConnectionFailedException: An error occurred while connecting to the TeamSpeak3 server
at com.github.theholywaffle.teamspeak3.QueryIO.<init>(QueryIO.java:71)
at com.github.theholywaffle.teamspeak3.TS3Query.connect(TS3Query.java:99)
at net.scrumplex.sprummlbot.qgZSyjGOVNPGbBZt5NUv.GoicqOVehRY68RCP7lXb(Unknown Source)
at net.scrumplex.sprummlbot.Main.main(Unknown Source)
Caused by: java.net.ConnectException: Connessione rifiutata
at java.net.PlainSocketImpl.socketConnect(Native Method)
at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:339)
at java.net.AbstractPlainSocketImpl.connectToAddress(AbstractPlainSocketImpl.java:200)
at java.net.AbstractPlainSocketImpl.connect(AbstractPlainSocketImpl.java:182)
at java.net.SocksSocketImpl.connect(SocksSocketImpl.java:392)
at java.net.Socket.connect(Socket.java:579)
at java.net.Socket.connect(Socket.java:528)
at java.net.Socket.<init>(Socket.java:425)
at java.net.Socket.<init>(Socket.java:208)
at com.github.theholywaffle.teamspeak3.QueryIO.<init>(QueryIO.java:57)
... 3 more
Please contact support!
[/spoiler]
I'm use debian 8.5.2 with java 7..... Help Please!
You need to configure the bot in the config.ini file. You need to add your server's ip address to the ip field in Connection
 

BrandoGamer

Member
Joined
Apr 9, 2016
Messages
3
Points
35
Age
48
User got warned: Lack of bb tag usage on long post
This is my config:
#Your Sprummlbot need this to connect to your server.
[Connection]
#IP of the teamspeak3 server (NO SRV Records)
ip = localhost
#Port of Query Login (Leave this normal if you dont know it)
port = 10011
#Change this to true if you want to set the flood settings to: FLOOD_COMMANDS: 60 FLOOD_TIME: 15 BAN_TIME: 600
optimize-flood-settings = false

#Here you need to define the server query login, otherwise Sprummlbot won't be able to do his job.
[Login]
#Put the username of ysour server's serveradminquery account
username = serveradmin
#Put the password of your server's serveradminquery account
password = YvgqunVB
#Put the serverid of your server here (On self hosted servers it is 1
server-id = 1

#Here you can define the Port for the web interface.
[Webinterface]
#Port for the Webinterface. 0=disabled
port = 9911
#Set the name of the group, for the Web Interface
group = Admins

#Here you define the name and the notification permission group for your bot.
[Appearance]
#Nickname for the Bot
nickname = WorldOfTekkit
#The group for the people who will get sprummlbot messages.
notify-group = Admins

#Here you need to set up the AFK-Mover feature of your new bot
[AFK Mover]
#Defines if it is enabled
enabled = true
#Defines the channel ID of the AFK Channel, where AFKs will be moved to
channelid = 20
#Set the name of the group, for the AFK Whitelist
whitelist-group = VIPs
#Enable this if you want this as a condition
condition-away = true
#Enable this if you want this as a condition
condition-mic-muted = false
#Enable this if you want this as a condition
condition-mic-disabled = false
#Enable this if you want this as a condition
condition-speaker-muted = true
#Enable this if you want this as a condition
condition-speaker-disabled = false
#This defines when a client will be moved (-1 means all conditions have to be met)
condition-min = 1
#Defines how long someone can be afk, if he is muted. (in seconds 600=10min)
maxafktime = 3
#This defines channels where afks will be moved from but not back.
afk-move-back-blacklist = 4,5,6
#Put the channel ids of the channels where being afk is allowed. e.g. music channels or support queue. To expand the list add in a new line afk-allowed-channel-id=%CHANNELID%
afk-allowed-channel-id = 3,15,18,28,29,30,31,33,34,35,36,37,38,39,40,41,42,43

#If you have a support section in your TeamSpeak, then you can define it here and the Sprummlbot will assist you-
[Support Notifier]
#Defines if it is enabled
enabled = true
#Defines the channel IDs of support channels. You can define multiple ones here!
channelid = 54,55
#Set this to true if you want to poke instead of private messages.
poke = false
#Set the name of the group, for the Supporters
group = Supporto

#With this feature you can prevent users from recording.
[Anti Recording]
#Defines if it is enabled
enabled = true
#Set the name of the group, for the VPN Whitelist
whitelist-group = VIPs

#This feature can be used to announce messages frequently.
[Broadcasts]
#This is the broadcast feature. You can add messages to the broadcasts.ini
enabled = false
#This sets the interval when messages will be sent to users. (in seconds! 300=5min)
interval = 300
#Set the name of the group, to ignore broadcasts.
ignore-group = VIPs

#This feature uses a whitelist for server groups, so unauthorized people can not acquire important groups.
[Server Group Protector]
#Enables the Server Group Protector. This protects users from joining Server Groups. It will be defined in groupprotect.ini
enabled = true

#With this feature you can keep an eye on your server. This will write everything in a log file.
[Server Logger]
#This defines if the Sprummlbot should log all server events into a text file.
enabled = true

#This feature kicks clients which are faking their ip with VPNs. This feature is not perfect so do not expect 100% detection.
[VPN Checker]
#This is the VPN Checker feature. This will kick everyone who uses vpn.
enabled = true
#This sets the interval, when vpns should be checked. (in seconds! 60=1min)
interval = 15
#If the checker found an vpn, it's ip will be saved in an seperated config file. This could be network efficient.
save-ips = true
#Set the name of the group, for the VPN Whitelist
whitelist-group = VIPs

#With this feature you can add channels to your server which are displaying useful infirmation to your users.
[Channel Stats]
#Enable or disable this feature here
enabled = true

#This feature can be used to have a server banner which updates every minute. It contains a clock, the date and the online users.
[Dynamic Banner]
#Only enable if you know what this does.
enabled = true
#This is the path to the original banner. Should be in the same directory as the Sprummlbot.jar and should be readable.
file = banner.png
#This defines the font size in pixels for the texts.
font-size = 18
#Define here the Font name OR Font path of the font you want to use
font = Dialog
#This is the RGB color. The first number is red, the second green and the last blue. Do not use #000000. Use 000000
color = 000
#This is the x position of the time text
position-of-time-x = 10
#This is the y position of the time text
position-of-time-y = 0
#Use a Java-Time Format here. Some of them are described in the Oracle Docs https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html
time-format = HH\:mm
#This is the x position of the date text
position-of-date-x = 10
#This is the y position of the date text
position-of-date-y = 20
#Use a Java-Time Format here. Some of them are described in the Oracle Docs https://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html
date-format = dd.MM.yyyy
#This is the x position of the online users text
position-of-users-x = 10
#This is the y position of the online users text
position-of-users-y = 40
#%users% and %max% are variables. You need them!
users-text = %users%/%max% online

#With this feature you can inform your users about social media and contact things.
[Messages]
#Put this to false if you do not want welcome messages when connecting.
welcome-msg-activated = false
#Skype ID for !skype command
skype-id = ASSENTE
#Website for !web command
website = IN ARRIVO
#Youtube channel link for !yt command
youtube = IN ARRIVO

#Here you can define disabled commands and some permission groups for administrative commands.
[Commands]
#Set the allowed group for the command !toggle. NOTE: THIS COMMAND CAN DISABLE THE MODULES!
toggle-command-group = Admins
#Set the allowed group for the command !sendmsg.
sendmsg-command-group = ServerAdmin
#This list can disable the following commands: !login, !mute, !skype, !support, !web, !yt. These commands will also be disabled automatically if their features are disabled (e.g. !mute will be disabled if Broadcasts are disabled)
disabled = !COMMAND1
disabled = !COMMAND2

#Here are some advanced options.
[Misc]
#Language definition. Available languages: you can add more languages at the messages.ini defual languages: de_DE, en_US, pt_BR and it
language = it
#Defines if the bot should check for updates (Bot will only send a message to console if an update is available.
update-notification = true
#Defines the interval when Sprummlbot will check for AFK, Support or Recorders. Define in milliseconds (1second = 1000milliseconds). If you have problems with the Network Performance put this higher
check-tick = 1500
#This is needed for the Dynamic Banner and the Mobile Connect feature. Set this to auto if your webinterface port is opened. Otherwise set it to auto (this will get the public ip of the bot). (Domains and DynDNS allowed)
ip = auto
#Set this to true if your bot's ip is whitelisted! If not keep it on false
can-flood = true
#Developers only. xD
debug = 0
My ts3 server is hosted in localhost (same vps) and... Yes I'm italian...
 
Last edited by a moderator:

r3flex

Member
Joined
Jun 21, 2016
Messages
33
Points
38
Age
29
How do I create the run.sh file? and how do I access the web interface?
 

BeHolder

Member
Joined
May 23, 2016
Messages
8
Points
36
Age
22
Why this bot logging to my server from Portugal? (i have server in Netherland) and web panel / scripts not work. (i see webpanel but panel don't see clients, bans etc *i have permissions*)
 

Ricky89

Member
Joined
Jul 9, 2016
Messages
23
Points
38
Age
30
Location
Italy
Hello Server Admins:),
the Sprummlbot is a lightweight TS3 Server Query Bot and it is written in Java.

Features
  • AFK Mover - Moves AFK clients to an AFK channel.
  • Support Channel Notifier - The support notifier of the Sprummlbot notifies clients, defined in config, when someone joins a specific channel.
  • Record Blocker - Kicks clients, which are trying to record.
  • VPN Blocker - Kicks clients using VPN services.
  • Web Interface - Completely free and included web interface with login system.
  • Dynamic Server Banner - Auto refreshing server banner with time, date and online clients. (Custom fonts, and other settings)
  • Plugin API - Plugin API, which is as easy as the Bukkit API.
  • Many commands - Many administrative and information commands, which can be disabled.
The bot will reconnect if it loses connection to the server.

System requirements
Java (7+) compatible machine (almost all operating systems) and minimum 256mb ram.
Recommended (for Web Interface and VPN Check use): 1gb RAM (+1gb SWAP), 2 vCores.
The bot's ip should be whitelisted in query_ip_whitelist.txt.

Download
Click here
Virus Total

Installation
Click here to see installation for Debian/Ubuntu or Windows

Forum (Support, Ideas, Other)
sprum.ml Forum


TS3 Forums Post
The webinterface of this bot is awesome! Only a question, how the VPN blocker work? And can this feature generate CPU overload, so I need to install a CPU Throttler?
 

giulio89

Member
Joined
Jul 6, 2016
Messages
2
Points
33
Age
37
Hello Server Admins:),
the Sprummlbot is a lightweight TS3 Server Query Bot and it is written in Java.

Features
  • AFK Mover - Moves AFK clients to an AFK channel.
  • Support Channel Notifier - The support notifier of the Sprummlbot notifies clients, defined in config, when someone joins a specific channel.
  • Record Blocker - Kicks clients, which are trying to record.
  • VPN Blocker - Kicks clients using VPN services.
  • Web Interface - Completely free and included web interface with login system.
  • Dynamic Server Banner - Auto refreshing server banner with time, date and online clients. (Custom fonts, and other settings)
  • Plugin API - Plugin API, which is as easy as the Bukkit API.
  • Many commands - Many administrative and information commands, which can be disabled.
The bot will reconnect if it loses connection to the server.

System requirements
Java (7+) compatible machine (almost all operating systems) and minimum 256mb ram.
Recommended (for Web Interface and VPN Check use): 1gb RAM (+1gb SWAP), 2 vCores.
The bot's ip should be whitelisted in query_ip_whitelist.txt.

Download
Click here
Virus Total

Installation
Click here to see installation for Debian/Ubuntu or Windows

Forum (Support, Ideas, Other)
sprum.ml Forum


TS3 Forums Post
prejudice I wanted to download this useful program, but the download does not work
 

giulio89

Member
Joined
Jul 6, 2016
Messages
2
Points
33
Age
37
java version "1.8.0_74"
Java(TM) SE Runtime Environment (build 1.8.0_74-b02)
Java HotSpot(TM) 64-Bit Server VM (build 25.74-b02, mixed mode)

this is my java version, and it works :)
prejudice I have tried to install the program, however, is not doing her job I run commando! login you start, however if I try to use a prox no ip is banned
 

Top