Skip to content

Funtimes909/ServerSeekerV2-Discord-Bot

Repository files navigation

GitHub Gradle PostgreSQL JDA Java GitHub Last Commit GitHub Commit Activity Code Size Lines of Code

ServerSeekerV2 Discord Bot

This is the code for a Discord bot to communicate with the ServerSeekerV2 API, if you are looking for the project that scans Minecraft servers and adds them to a database, the code is available here

ServerSeekerV2-Discord-Bot is a Discord bot to fetch results about Minecraft servers from an API, this is useful for statistics.

Commands

Below is a list of every currently implemented command and what it does

/search

Searches for servers and return all that match specified parameters, supports combining advanced filters to precisely pinpoint exact servers.

Example: /search country:NZ version:1.21.4 whitelist:false cracked:true software:paper

/ping

Takes a server address and (optionally) a port as parameters, pings the requested server and displays it's status.

Example: /ping address:192.168.1.1 port:25565

/playerhistory

Displays playerhistory for either a server, or individual player.

Example: /playerhistory player:Funtimes909

Commands with no parameters

/random

Returns a random server.

/info

Displays useful information about thew bot, links to this GitHub repository.

/stats

Shows stats about the discord bot, including unique players found, unique servers found and eventually more.

Authenticated Commands

These are commands exclusive to "trusted users", users the owner of the bot has said can be trusted with potentially dangerous commands.

/track

Receive Discord webhook updates on player activity across scanned servers

Example: /track player:Funtimes909 webhook:

/blacklist

Add/Remove a user from the blacklist, preventing them from using the bot

Example: /blacklist operation:add user:@funtimes909

/takedown

Prevent a server from being scanned in the future, also optionally delete all records of it from the database (default: false)

Example: /takedown address:192.168.1.1 remove-entries:true

Setup

Docker usage is always encouraged since it always provides the same enviroment

Docker

Create a file named ServerSeekerV2-Discord.json following the format in here

NOTE: You should run this in the directory that the scanner is in to that takedown actually works

Run:

docker run --mount type=bind,src=./ServerSeekerV2-Discord.json,dst=/usr/src/app/config.json --mount type=bind,src=./exclude.txt,dst=/usr/src/app/exclude.txt -d nucceteere/serverseekerv2-discord-bot

Manual

About

A discord bot to interface with the ServerSeekerV2 database

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages