# FootDistrict

You have 7 modes available:

* empty for running fcfs accounts
* `RAFFLE` for entering a raffle (you need verified accounts)
* `CHECKER` for checking raffle successes
* `ACCOUNT`: allows you to generate new accounts
* `ADDRESS`: sets a new address for an existing account
* `RESET ADDRESS`: change delivery informations for an existing account
* `VERIFY` : checks verification status and something more

### Tasks setup

Here is a table that explains the meaning of every field and, if applicable, a default value.

| COLUMN NAME    | VALUE                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| SITE           | FOOTDISTRICT as a value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| MODE           | One as reported above                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| PID            | Raffle URL or product sku if running CHECKER mode                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| SIZES          | A specific size or a range like `44, 46-48`                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| QUANTITY       | Ignore this column, leave it empty                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| DELAY          | In milliseconds (e.g. 3000 for 3 seconds delay)                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| EMAIL          | Account email                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| PASSWORD       | Account password                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| FIRST NAME     | Recipient name                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| LAST NAME      | Recipient surname                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ADDRESS LINE 1 | Recipient first address line                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ADDRESS LINE 2 | Recipient second address line (optional)                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| HOUSE NUMBER   | Recipient house no.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| CITY           | Recipient city                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ZIPCODE        | Recipient zip code                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| STATE          | Recipient state that has to be picked from the [this list](https://pepperscripts.com/sites/footdistrict)                                                                                                                                                                                                                                                                                                                                                                                                   |
| COUNTRY        | A 2-letters country ISO Code (e.g. `GB` for UK)                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| PHONE          | With country prefix like +44123456789                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| PAYMENT        | `CC`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| CARD HOLDER    | Your card holder                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| CARD NUMBER    | Card number                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| EXP MONTH      | Two digits (e.g `02` or `12`)                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| EXP YEAR       | Four digits (e.g. `2026)`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| CVV            | Credit card CVV                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| WEBHOOK        | If empty the one set up in `settings.json` will be used                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ENTRY WEBHOOK  | If present and filled it will send a webhook for all entries that have been made successfully                                                                                                                                                                                                                                                                                                                                                                                                              |
| START TIME     | <p>Empty if you want to immediately start your task.<br><br>A specific time in the format <code>hh:mm:ss</code> like <code>08:50:00</code> to automatically start this task at the given time.</p><p></p><p>Don't worry if you recognize you put a wrong time in there. You can still manually force start it.<br><br>If you didn't put a specific time, don't forget to put <code>MANUAL</code> as a value if you want to avoid every task to immediately start as soon as your task file is started.</p> |
| PROXY          | <p>You can put a specific proxy or a proxy list.</p><p>In case you using a proxy list, it has to be the exact filename, don't forget the extension name like <code>.txt</code> (e.g. <code>footdistrict.resi.txt).</code><br></p><p>If empty <code>footdistrict.txt</code> will be used.<br>You can also run without proxy by writing <code>localhost</code></p>                                                                                                                                           |

{% hint style="warning" %}
Be sure to use an unbanned proxy that **matches** the region where your account has been verified or you won't be able to enter any raffle .

Prefer **good** residentials, not packet.

When they don't like your proxy they don't get you to read available sizes and to enter the raffle.

If that happens, wipe your session, change proxy and start the task again.
{% endhint %}

### Example taskfile

Here is an example task file:

{% file src="/files/7HuO2QvJyukuea9n1chw" %}

You can edit this file by using [Rons editor](https://www.ronsplace.ca/products/ronseditor).

### Generate tasks

Now, you filled your CSV (e.g. called **footdistrict.csv**) and you are ready for entering a raffle.&#x20;

Everything is well configured.&#x20;

You can of course still manually edit your CSV and change PID, SIZES and START TIME (if needed) but there is something more.

You can quickly edit all this infos directly via CLI by using our task generator (option 2 inside the FootDistrict submenu).

Once started it will ask you which is the source task file to edit (you will choose **footdistrict.csv** as per the example).

Right after it will show you all upcoming raffles with the related closing date.

Once chosen it it will ask you the first "start time" and - if you specify an initial "start time" - the last "start time", pepper will generate all "start times" for other tasks according with the value you specified for start and end "start time" and the numbers of tasks you have.

You can also specify the sizes or the size range you want to run for.

Once finished a new file named **footdistrict-pid.csv** will be generated. The `pid` will be the one you decided to run for. Also the mode for the file will be automatically set as RAFFLE.

{% hint style="info" %}
Why "START TIME" is needed for a Raffle module? It is a good question but this will ensure you to not have all your entries made all in a short time frame. What we suggest is to spread your entries across hours or days even better.
{% endhint %}

### Account creation

If you want to let pepper create an account for your, you can setup your csv with the values you explained in general [tasks setup](#tasks-setup) section.

Keep in mind that you still need to manually verify your account by yourself.

### Account verification

You know that in order to enter super hyped drops you need to verify your account.

Using this mode in conjiuction to the SMS service [you configured into settings.json](/getting-started/cli/settings.md) you can let Pepper to verify the accounts for you.

In order to do this you need to specify the sms provider you want to use and the service you looking to use for receive your sms.

An example of `footdistrict` node into settings.json can be the following one:

```
"footdistrict": {
    "scrapeInvoiceWhenCheckingOrders": false,
    "smsProvider": "smspool",
    "smsService": "any other",
    "smsMaxPrice": 1.5
}
```

`smsMaxPrice` is optional, if not specified it will take the first price available.

When you use it with HeroSMS, `smsMaxPrice`  property is used for picking the **exact** price, so be sure you double check the available prices on HeroSMS website before setting this value.

#### Specific SMS Provider services

For:

* HeroSMS: you can use `footdistrict` if your region is available (check their site) or `any other`
* SMSPool: just use `any other` since they don't have specific footdistrict service
* 5SIM: just use `footdistrict`

### Change your delivery address

FootDistrict allows you to change your delivery address only once every 3 months.

Run `RESET ADDRESS` only if you already have an address and you want to change this informations.

If address details can't be changed, the task will print the error.

### Scraping order invoices

When running `CHECKER` mode and into your settings.json, under the node `sites.footdistrict` if the option `scrapeInvoiceWhenCheckingOrders`  is set to true the cli will download the order invoice automatically.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pepperscripts.com/supported-sites-cli/footdistrict.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
