Skip to content

Commit

Permalink
Remove channels variable from config. Start working on README (adapti…
Browse files Browse the repository at this point in the history
…ng pallettown one)
  • Loading branch information
CBRSightings committed Oct 30, 2017
1 parent 09db09c commit 12d03f4
Show file tree
Hide file tree
Showing 4 changed files with 278 additions and 23 deletions.
278 changes: 278 additions & 0 deletions README.MD
Original file line number Diff line number Diff line change
@@ -0,0 +1,278 @@
# novaBot

novaBot is a [Discord](https://discordapp.com) bot that uses data from [RocketMap](https://github.com/RocketMap/RocketMap) to provide a complete, configurable package for Pokemon Go communities.
novaBot's features include:

- Personalised pokemon and raid notifications, delivered by DM.
- Filter settings based on geofence, suburb, or IV.
- Automated posting of pokemon/raids to Discord channels.
- Unique raid coordination system.
- Optional tiered donator/supporter system using Discord roles to reward members of your community.

You can download the latest release [here](https://github.com/novskey/novabot/releases) (Just download the .jar file)

1. [Installation Guides](#install-guides)
1. [Windows Installation](#windows-install)
2. [Linux Installation](#linux-install)
3. [Mac Installation](#mac-install)
2. [Configuration](#configuration)
3. [Usage](#usage)
1. [Basic Examples](#basic-examples)
4. [FAQ](#faq)
5. [Discord Support Server](https://discord.gg/RgWSqyU)
6. [Wiki - WIP](http://pallettown.readthedocs.io/)

### Prerequisites

- [Java JRE 64-bit](https://java.com/en/download/manual.jsp)
- [MySQL/MariaDB](https://mariadb.org/download/)

That's it!
## <a name="install-guides"></a> Installation Guides

### <a name="windows-install"></a>Windows

#### Install prerequisites

##### Java JRE 64-bit

Download and run the offline 64-bit installer from https://java.com/en/download/manual.jsp.
Make sure you select the 64-bit installer or novaBot will not work correctly.

##### MariaDB

https://mariadb.org/download/

#### Running novaBot

There a two ways of running novaBot.

Starting it from cmd.exe (or alternative shell) with:

`java -jar novabot.jar`

Or simply double clicking the .jar file in Windows Explorer.

You can find the .jar file [here](https://github.com/novskey/novabot/releases).

###<a name="linux-install"></a> Linux

Tested on Ubuntu 16.04

#### Install prerequisites

##### Java JRE

Install Java8 through terminal with

```
sudo add-apt-repository ppa:webupd8team/java
sudo apt-get update
sudo apt-get install oracle-java8-installer
```

#### Running novaBot

There a two ways of running novaBot.

Starting it from cmd.exe (or alternative shell) with:

`java -jar novabot.jar`

Or simply double clicking the .jar file in Windows Explorer.

You can find the .jar file [here](https://github.com/novskey/novabot/releases).
### <a name="mac-install"></a> Mac

Detailed instructions not written yet, however, if you install the following dependencies, it should work:

- [Java JRE](https://java.com/en/download/manual.jsp)
#### Running novaBot

There a two ways of running novaBot.

Starting it from cmd.exe (or alternative shell) with:

`java -jar novabot.jar`

Or simply double clicking the .jar file in Windows Explorer.

You can find the .jar file [here](https://github.com/novskey/novabot/releases).

## <a name="configuration"></a> Configuration

### config.ini

[example file](config.example.ini)

### geofences.txt

[example file](geofences.txt)

### suburbs.txt

[example file](suburbs.txt)

### formatting.ini

[example file](formatting.txt)

### gkeys.txt

[example file](gkeys.txt)

### supporterlevels.txt

[example file](supporterlevels.txt)

### raidalerts.txt

[example file](raidalerts.txt)

### raidchats.txt

[example file](raidchats.txt)

### pokechannels.ini

[example file](pokechannels.ini)

## <a name="usage"></a> Usage

For more detailed documentation, please visit the [wiki](http://pallettown.readthedocs.io/).

### <a name="basic-examples"></a> Basic Examples

**Note: When using a proxy list, you may encounter errors if you have a proxy (possibly VPN too) configured for your system.
Please disable the proxy/VPN if you encounter any errors**

#### Create a single account with random details with manual captcha

- Enter any email address that is plusmail compatible into the Email field. (If you aren't sure, check the FAQ [here](#faq-plusmail))
- Click Create Accounts

Username, password, and date of birth will be randomly generated and entered for you.
All you have to do is wait for the captcha to appear, and solve it.

![Create a single account with random details](images/1-random-manual.jpg)

#### Create 5 accounts with random details with manual captcha, and save the usernames/passwords to a text file

- Enter a plusmail compatible email address in the Email field. (See [the FAQ](#faq-plusmail) if you're unsure)
- Enter the number 5 into the Number of accounts field.
- Click the Output File field, which will open up a file browser (It may take a while on some systems)
- Select your output file
- Click Create Accounts

![Create 5 accounts with random details with manual captcha, and save the usernames/passwords to a text file](images/5-random-manual-save.jpg)

#### Create 10 accounts with random details with 2captcha and a proxy list, and save the details to a file

- Enter a plusmail compatible email address in the Email field. (See [the FAQ](#faq-plusmail) if you're unsure)
- Enter the number 10 into the Number of accounts field.
- Enter your 2Captcha key into the 2Captcha Key field.
- Click the Output File field, which will open up a file browser (It may take a while on some systems)
- Select your output file
- Click the Proxy File field, which will open a file browser (It may take a while on some systems)
- Select your proxy file. It should be formatted as 1 proxy per line, eg:
```
https://13.41.123.231:23123
http://14.51.233.135:23321
11.52.231.136:23321
https://username:[email protected]:21313
```
- Click Create Accounts
![Create 10 accounts with random details with 2captcha and a proxy list, and save the details to a file](images/10-random-2captcha-proxies-save.jpg)
#### Create 5 numbered accounts (eg: user1,user2,user3) with a specific username and password, with manual captcha, and save the details to a file
- Enter a plusmail compatible email address in the Email field. (See [the FAQ](#faq-plusmail) if you're unsure)
- Enter the username you want to use into the Username field.
- Enter the password you want to use into the Password field. (It must contain a capital letter, number, and symbol)
- Enter the number 5 into the Number of accounts field.
- Enter the number 1 into the Start number field. Start number is where the accounts will be numbered from, eg:
```
Start number 1, 5 accounts:
user1,user2,user3,user4,user5
Start number 10, 5 accounts:
user10,user11,user12,user13,user14
```
For more info on proxies see the FAQ [here](#faq-proxy-types)
- Click the Output File field, which will open up a file browser (It may take a while on some systems)
- Select your output file
- Click Create Accounts
![Create 5 numbered accounts (eg: user1,user2,user3) with a specific username and password, with manual captcha, and save the details to a file](images/5-specified-manual-save.jpg)
#### Create 10 accounts with random details, using 2Captcha, automatic Gmail verification, save to file, and use proxy list
- Enter a plusmail compatible email address in the Email field. (See [the FAQ](#faq-plusmail) if you're unsure)
- Enter the number 10 into the Number of accounts field.
- Enter your 2Captcha key into the 2Captcha Key field.
- Check the Auto Verify Accounts box.
- Enter your email account for auto verify. (eg: [email protected], or [email protected] if you've set up forwarding to gmail)
- Enter your email account password.
- Click the Output File field, which will open up a file browser (It may take a while on some systems)
- Select your output file
- Click the Proxy File field, which will open a file browser (It may take a while on some systems)
- Select your proxy file. It should be formatted as 1 proxy per line, eg:
```
https://13.41.123.231:23123
http://14.51.233.135:23321
11.52.231.136:23321
https://username:[email protected]:21313
```
For more info on proxies see the FAQ [here](#faq-proxy-types)
- Click Create Accounts
![Create 10 accounts with random details, using 2Captcha, automatic verification, save to file, and use proxy list](images/10-random-2captcha-gmailav-proxies-save.jpg)
## <a name="faq"></a> FAQ
For more help, please ask on the [discord](https://discord.gg/RgWSqyU).
#### <a name="faq-proxy-types"></a> What proxy types are supported?
PalletTown currently supports the following proxy protocols:
- HTTP/HTTPS
- SOCKS4/SOCKS5
#### <a name="faq-proxy-sources"></a> Where can I find proxies to use with PalletTown?
PalletTown works best with private proxies. Public proxies often have unstable connections, and can even be banned by Niantic.
For best results, google "private proxies".
#### <a name="faq-plusmail"></a> What is a "plusmail compatible email address"?
A plusmail compatible email address is an email where emails sent to [email protected] get redirected to [email protected].
This is a very useful feature as it allows the creation of many PTC accounts with a single email address.
Hotmail, Outlook, and Gmail support this feature, however Niantic is able to detect it being used in gmail addresses so it won't work for Pallet Town.
You can test if your email service supports plusmail like so:
For address [email protected], send an email to [email protected], you should receive it in your email [email protected].
If it doesn't arrive in your email, your email service does not support the plusmail trick, and you'll need a different email to use Pallet Town.
#### <a name="hotmail-forwarding"></a> How do I automatically forward emails from Hotmail to Gmail?
***NOTE: Hotmail to Gmail forwarding is no longer required! Simply use your hotmail address in the auto verification box***
##### If you've already received at least 1 activation email in your hotmail
1. Log into your hotmail account.
2. Click on an activation email from niantic
3. At the top of the window, click the three dots on the far right
![Three dot button](images/hotmail-threedots.png)
4. Click the "Create rule..." option
![Create rule option](images/hotmail-createrule.png)
5. Remove the middle condition so that only received from, and matches subject remain
![Forwarding conditions](images/hotmail-conditions.png)
6. Click the drop down under do all of the following, then "Forward, redirect or send", and then "Forward the message to..."
![Forward the message to](images/hotmail-forwardto.png)
7. Enter your gmail address in the box that appears, and click ok, then ok again to create the rule.
Done!
##### If you haven't received at least 1 activation email in your hotmail
TBA
1 change: 0 additions & 1 deletion config.ini
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
[config]
token = MjkzMzI4Mjc0MDk0ODE3Mjgw.DDDm3w.AcvLVtE9W6GfmLzwmVH5gKoj_gU
blacklist = [13, 16, 19, 21, 23, 29, 32, 41, 48, 60, 98, 115, 118, 120, 183, 161, 165, 167, 177, 194, 198]
channels = false
useRmDb = false
standardRaidTable = false
googleSuburbField = city
Expand Down
7 changes: 0 additions & 7 deletions src/core/Config.java
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,6 @@ public class Config {

private HashMap<String,Boolean> showMap = new HashMap<>();

private boolean useChannels;
private boolean useRmDb;

private boolean raidsEnabled;
Expand Down Expand Up @@ -119,8 +118,6 @@ public Config(Ini configIni, File gkeys, Ini formattingIni){

geofences = Boolean.parseBoolean(config.get("geofences"));

useChannels = Boolean.parseBoolean(config.get("channels"));

useRmDb = Boolean.parseBoolean(config.get("useRmDb"));

standardRaidTable = Boolean.parseBoolean(config.get("standardRaidTable"));
Expand Down Expand Up @@ -597,10 +594,6 @@ public String getAdminRole() {
return adminRole;
}

public boolean useChannels() {
return useChannels;
}

public boolean useRmDb() {
return useRmDb;
}
Expand Down
15 changes: 0 additions & 15 deletions src/core/MessageListener.java
Original file line number Diff line number Diff line change
Expand Up @@ -85,11 +85,6 @@ public static void main(final String[] args) {
loadConfig();
loadSuburbs();


if(config.useChannels()){
FeedChannels.loadChannels();
}

if(config.useGeofences()){
Geofencing.loadGeofences();
}
Expand All @@ -111,11 +106,6 @@ public static void main(final String[] args) {
.setToken(config.getToken())
.buildBlocking();


if(config.useChannels()){
FeedChannels.updateDiscordChannels(jda);
}

jda.addEventListener(new MessageListener());

for (Guild guild1 : jda.getGuilds()) {
Expand Down Expand Up @@ -1241,14 +1231,9 @@ else if (msg.equals("!help")) {
: "") +
"!reset\n" +
"!settings\n" +
(config.useChannels() ? "!channellist or !channels\n" : "") +
(config.useGeofences() ? "!regionlist or !regions\n" : "") +
"!help```").queue();
return;
}
else if (config.useChannels() &&(msg.equals("!channellist") || msg.equals("!channels"))) {
channel.sendMessageFormat("%s, accepted channels are: ```%s```",author,FeedChannels.getListMessage()).queue();
return;
}else if (config.useGeofences() &&(msg.equals("!regionlist") || msg.equals("!regions"))) {
channel.sendMessageFormat("%s, accepted regions are: ```%s```",author,Geofencing.getListMessage()).queue();
return;
Expand Down

0 comments on commit 12d03f4

Please sign in to comment.