# TB Platoon Assigner
Achieve maximum platoon efficiency with this tool. After you enter in your guild's unique platoon requirements, the guild's entire roster will be read and sorted according to your chosen assignment algorithm, guaranteeing that the most efficient donations can be made to fill the requirements.
For EchoStation bot users, assignments can be sent directly to guild members in their own private message.
A short list of features can be found below:
* Assignments can be posted publicly in Discord, or sent directly to the player (requires [EchoStation bot](https://docs.echobase.app/echostation)).
* Opt-in to @mentions so that guild members can be tagged with their assignments.
* Grouping Rules allow guild officers to define conditional preferences for assignments, such as "if someone is assigned {this}, then don't make them give up {that}." Several logic options are available.
* EchoStation's [#player](https://docs.echobase.app/echostation/player-commands/donation-preference#player "mention") command allows guild members to prioritize their own collections, in case they need to save certain toons for combat, for example.
* So much more!
## Navigation
### Platoon Assigner Home
This is a visual reminder of which tool you are currently using. It is also a link that will take you back to the landing page for the Platoon Assigner.
### Battle Picker
This dropdown will allow you to choose between all possible Territory Battles.
### Phase picker
This dropdown will allow you to choose between all possible phases of the chosen battle.
{% hint style="info" %}
Displayed beside each option in the dropdown is the star or relic level requirement for that phase.
{% endhint %}
### Keyboard Shortcuts
This is a flyout menu that can act as a reminder of how you can rapidly fill out your assignments using only your keyboard.
{% content-ref url="tb-platoon-assigner/usage-guide/manual-entry/using-a-keyboard" %}
[using-a-keyboard](https://docs.echobase.app/tb-platoon-assigner/usage-guide/manual-entry/using-a-keyboard)
{% endcontent-ref %}
{% hint style="info" %}
This menu option is not available on smaller screens, due to the likelihood that small mobile devices are not equipped with a keyboard. However, the shortcuts themselves will always work.
{% endhint %}
### Help
Click this link to return to this documentation.
### Submit
This button will prompt you to confirm all of your settings before creating assignments.
{% hint style="warning" %}
This button will be **disabled** until 100% of the platoons on the screen are either filled in or ignored. You can use the progress bar inside each mission header to find missing requirements.
{% endhint %}
## Quick Setup
New to the TB Platoon Assigner? These are the important things you need to know, and how to learn more about each.
### Choose your phase
Choose the battle and phase that you would like to run assignments for. This will influence what is shown in the platoon assigner. You should see the complete layout of your chosen phase, including mission labels.
{% content-ref url="tb-platoon-assigner/usage-guide/choosing-a-phase" %}
[choosing-a-phase](https://docs.echobase.app/tb-platoon-assigner/usage-guide/choosing-a-phase)
{% endcontent-ref %}
### Submit the requirements
If all platoon requirements are filled, the green **Submit** button should become accessible. After clicking it, you will be prompted to confirm your settings before the assignments are created and sent to Discord.
{% content-ref url="settings" %}
[settings](https://docs.echobase.app/settings)
{% endcontent-ref %}
### Select your Discord destination
If you are using the [EchoStation bot](https://docs.echobase.app/echostation), this step is very easy. Simply select a channel in the provided dropdown.
{% content-ref url="settings/discord-channel" %}
[discord-channel](https://docs.echobase.app/settings/discord-channel)
{% endcontent-ref %}
Otherwise, you'll be prompted to enter a Webhook URL. This is the way to submit assignments to Discord without using a bot.
{% content-ref url="settings/webhook-url" %}
[webhook-url](https://docs.echobase.app/settings/webhook-url)
{% endcontent-ref %}
### Submit for assignments
Once a Discord Channel or a Webhook URL is chosen, you can now confirm your settings by clicking the green **Submit** button at the bottom of the settings window.
{% hint style="info" %}
If you don't wish assignments to be posted to Discord, you may click the "Preview" button to view the assignments in the webapp only.
{% endhint %}
After assignments have been posted in Discord, you should receive a success message indicating that it is finished.
**Congratulations!**
You can now go see your platoon assignments!
## Advanced Features
Omit some guild members from receiving assignments
**Use the** [**Ignore List**](https://docs.echobase.app/navigation#logged-in-guild-ignore-list)**!**
Erase or change platoon requirements
[clearing-requirements](https://docs.echobase.app/tb-platoon-assigner/usage-guide/clearing-requirements "mention")
Skip certain platoons
[ignoring-platoons](https://docs.echobase.app/tb-platoon-assigner/usage-guide/ignoring-platoons "mention")
Specify some custom assignments before submitting
[pre-assignments](https://docs.echobase.app/tb-platoon-assigner/usage-guide/pre-assignments "mention")
Give your guild members the ability to influence the assignment algorithm by specifying which toons to keep or give
[donation-preference](https://docs.echobase.app/echostation/player-commands/donation-preference "mention")
Set up guild members to receive @mentions with their assignments
[include-mentions](https://docs.echobase.app/settings/include-mentions "mention")
Set up guild members to receive a personal Direct Message with their assignments in it
[send-dms-to-each-member](https://docs.echobase.app/settings/send-dms-to-each-member "mention")