The bot has been completely rewritten to allow scalability.
I recommend checking out the wiki for more details on how to use this bot, and what has changed in the rewrite.
Discord bot built using the wonderful JDA library that provides info about doujins from these three sources:
- nhentai
- e-hentai/exhentai
- Wholesome Hentai God List (https://wholesomelist.com)
Focused on features that find wholesome, vanilla doujins (we are a vanilla server after all), and warns about any potentially objectionable tags.
Join our Discord for support and vanilla doujins!
Go ahead and contribute if you'd like. I'll review it and probably merge it. If you need documentation, just join the Discord and ask me what anything does. This rewrite is mostly documented, but any questions are still welcome.
As I've stated, this bot has a focus on wholesomeness. This means that it will warn you about things like netorare, and will also have a suite of wholesomeness-focused commands and utilities. As for the functionality,
H-Bot comes equipped with a lot of commands, plus a bootleg webhook for nhentai. It also conforms with Discord's terms of service by blocking any doujins with the lolicon or shotacon tags (and notably, also the oppai loli tag).
For more functionality details, read the wiki's Commands page.
The webhook is a feature of the bot that provides a webhook functionality with nhentai. Every 15 minutes, it will run a scheduled scan of the latest doujins, and automatically upload the wholesome ones (no bad or warning tags, and at least 3 tags) to the hook channels.
Commands to set it up:
- addhook - Registers the channel as a webhook channel (not shown in help, requires Manage Server permission)
- removehook - Unregisters the channel as a webhook channel (not shown in help, requires Manage Server permission)
- JDA
- Log4j2
- Jsoup
- JSON-Java
- SQLite3 JDBC Driver
- Apache Commons DBCP
- Apache Commons Text
- Apache Commons HttpComponents
If you would like to self-host this bot for your own servers instead of using my invite link, you're going to need a few steps.
First off, you should create the Discord bot. Click on New Application, name the bot whatever you want, attach a bot user, and invite it to your server from the OAuth2 tab (with the following permissions integer: 93248, meaning that in the URL that says https://discordapp.com/api/oauth2/authorize?, you should have the flag &permissions=93248.)
If you get confused by this, there are plenty of image tutorials on the Internet. Creating the Discord bot is a pretty involved process at first, so don't feel too bad.
After this, save the bot token provided to you in the Bot tab somewhere (you'll need it later). Also make sure to keep this a secret - if someone else has access to this, they have access to your bot.
Once you have the bot in your server, you are ready for the next step.
To get started, you should make a folder somewhere, and download whatever version of H-Bot you want from Releases.
Download hbot.jar here:
To run, the bot expects 1 file. (Another one's optional.)
- config.json
- log4j2.xml (if you care about logging, which you really should... at the bare minimum, just place the sample in the same directory as the bot's jar).
All of these files can be found in the samples folder. Go ahead and download them and place them in the same directory as the bot's jar file.
For config.json, make sure that you replace the "botToken": "Your bot token here" with the bot token I told you to save earlier. This is essential to make sure your bot actually starts up. You can also configure the frequency with which the hook runs (in minutes) by changing hooktime. You can leave latestNumber alone. It's stored there only for use by the hook.
Once you're done with all of that, your bot is ready to start.
Since I do use preview features in the source code, you won't be able to just run it using java -jar. This means this also requires JDK 15. If you don't know how to set up JDK 15, I recommend going to AdoptOpenJDK and installing JDK 15 through their easy-to-use binaries.
To run the bot, you need to run the following command:
java --enable-preview -jar hbot.jar
This means if you are using Windows, you can make a Batch file:
@ECHO OFF
java --enable-preview -jar hbot.jar
pause
EXIT
This will work as long as you put it in the same folder as the H-Bot jar. Make sure the bot is running using JDK 15. If it's not, this will not work. To ensure that it is running with JDK 15, instead of using java, you could instead use:
<your_path_to_java_15>\bin\java.exe --enable-preview -jar hbot.jar
For Windows and AdoptOpenJDK users, that path will be:
"C:\Program Files\AdoptOpenJDK\<JDK/JRE 15 folder>\bin\java.exe
Once you have all of this set up, you're pretty much good to go! During startup, the bot will create and setup a few databases.
One last thing.
If you want this telecom (functionality explained in the Functionality section) in your server, you're going to have to perform just a few extra steps.
Make sure you have the Manage Server role (which you should if you invited the bot) if you want to set up a telecom channel.
Create any channel / repurpose any existing channel, then use the command addhook (with default prefix, that would be >addhook).
If you need to delete this hook for any reason, go to that same channel and use the command removehook.
That's all the setup you need to do. Have fun with the bot!
