Clans

For Co-operative mode, see Co-op Mode.
Clans are a multiplayer feature of the game. They consist of a group of players who can - among other things - chat, donate resources, and play together in special co-op matches.

## General information

Clans have a name and a logo that distinguishes them. They can be leveled up with collective effort of all members.

Each member of a clan has a role (also known as rank). These roles correspond to those of the ants in a colony, making clans conceptually a bigger ant colony:

* Queen: It's the leader and main manager of the clan. The creator of a clan is formerly the Queen, but the clan leadership can be passed to another member, which becomes the Queen.
* Major: Members with special permissions for management of the clan.
* Worker: Average member with no special permissions.
* Larva: New members join as larvae.

Clans have a storage which members can donate resources to. With them, temporary bonuses can be activated for all members. Members can also chat and play co-ops together.

Clans are located in the "Social Menu", at the top left area of the screen, below the weather icon. This window is divided in 5 tabs:

* Clan
* Chat
* Bonus
* Search
* Co-op

Clan tabChat tabBonus tabSearch tabCo-op tab
## Clan info

### Name and logo

The clan name is selected when the clan is created and can never be changed after creation. Clan names must be unique, therefore two clans can't have the same name. A clan can be searched in the "Search" tab by its name and joined.

The clan logo is a picture that represents the clan. It's created and edited by the Queen using default designs and two colors. The available designs are 11, as seen in the following picture:

Both the name and the logo can be found in the "Clan" tab at the top left corner, but also appear in the "Search" tab for players to identify the clans in the list, and potentially join them.

The name of the clan also appears below members' names in Battles (including the Ranking) and above their names in public Co-op lobbies, above the ant.

**Note:** there is a bug where, if a clan member logs out of the game and they are kicked from a clan, this player will keep showing the clan's name when attacked as long as they remain offline, until they log back in to realize they were kicked.

### Clan level

All clans start as level 1, and can be leveled up by filling the activity bar located in the "Bonus" tab. Clan level affects a lot of things, which are explained throughout this article. The maximum level of any clan is 12.

### Clan trophies

The clan trophies are the sum of all members' trophies **multiplied by the clan level**.

### Member count

Each clan can have a certain number of players in it. The member capacity of a clan is determined by its level.

### Requirements

Each clan has certain requirements to join (using the "Search" menu). They are configured by the Queen and consist of:

* The player's Queen's Chamber level, represented by a crown .
* The player's trophies, or rank, represented by a trophy .

Players don't need to meet the requirements if they are invited to the clan.

### Open/Request mode

For recruitment through the "Search" menu, clans can have one of two options for joining the clan, configured as well by the Queen:

* This icon means that players that meet the requirements will join the clan immediately if there's a spot.
* This icon means that players that meet the requirements will send a request to join, which can be approved or declined.

It's important to mention that when a player sends a request and this one is accepted when said player is offline, they won't actually join until they log in. In the meantime, another player's request can be accepted too and if they are online they will join instead, causing the first player to miss their opportunity to join. Many players might not join the clan this way because they might be offline when requests are reviewed.

### Clan description

In the right side of the "Clan" tab there's an announcement board which can be used as the clan description. By default, when a clan is created, this messages only says "**Welcome to [Clan name]!**", but it can be edited to include the co-op schedule and donation requirements, or any kind of message leaders want to give. The clan description can have 6 lines of text, with a limit of 150 characters in total (including the special character for a new line).

## Members

Clan members are found in a list in the "Clan" tab. It's unknown what is the sorting based on.

### Member color

Members can have their own color. All players have the same light-blue color when joining the clan, but it can be changed by Majors or the Queen. The member's color appears in the "Chat" tab, as the member's messages will have their name with their corresponding color. When a member asks for resources, the request card is also the member's color. The member's color also appears in Clan co-op lobbies, in the player's name and card in the players list.

### Member role

As said earlier, there are four roles for members of a clan: Queen, Major, Worker and Larva; with different permissions each one:

* Ask for resources.
* Donate to the clan storage.
* Donate to other members.
* Have friendly-battles with other members.
  Worker
  Major
* Manage requests to join.
* Invite new members.
* Edit clan description.
* Kick Larvae and Workers.
* Change the colors of Larvae, Workers and themselves.
  Queen
* Post recruitment message.
* Edit clan logo, requirements and request mode.
* Activate bonuses.
* Hosting Clan co-operatives.
* Promote/Demote members.
* Pass clan leadership.
* Kick Majors.
* Change the colors of Majors and themselves.
* Dissolve the clan.

### Member stats

The following stats are found in the member list:

* Total donation: The sum of all resources donated to the clan **and** to other members.
* Total clan points: The sum of individual clan points the member contributed to the clan. Clan points from Clan co-ops are not included.
* Trophies: The member's trophies.
* Queen Chamber level: The member's Queen Chamber level.

Members that haven't logged in for longer than 30 days will have their trophies reset to 1000 only for the clan list (they won't actually lose their rank/trophies). This will affect the clan's trophies as well, and therefore their position in the ranking. This penalty is reverted when the clan member logs in again.

### Friendly battle

Every member has a button to have a "friendly battle". This works just like testing one's defense in the Defense tab ("Battle" menu): one can simulate an attack to another member of the clan, without any consequences to the soldiers, resources or trophies of either players.

Members of a same clan can't be matched together in a real battle.

### Member status

All members have a status indicator at the right end of their position on the list:

* Currently active members have a green circle as status.
* Members inactive for up to an hour ago don't have anything in their status.
* Members inactive for longer than 1 hour have a value (hours, days) in their status, indicating how long have they been inactive.

A member is inactive if they:

* Closed their game.
* Are in a co-op lobby.
* Lost connection for over 5 minutes.
* Minimized the game for over 5 minutes.
* Are AFK (no keys pressed) for over 5 minutes.

## Level up Bar

Clans can level up by filling an activity bar with **clan points**. The required points to fill the activity bar depends on the clan's level. The higher the clan level, the more clan point are required to advance to the next level:

There are two ways to get clan points:

#### Individual activity

Members can get clan points by doing the following activities:

 Watching ads for Battle Tokens.

Note: Players in level 12 clans can no longer earn clan points since the clan is at max level.

### Clan Co-ops

Main article: Co-op Mode
By winning at a Clan co-operative, besides the individual rewards each player receives, the clan receives a certain amount of clan points that also scale with the level of the clan. Clans at level 12 receive 15000 resources each of fungus , leaves , and seeds  (45000 total resources) instead of clan points.

Clans can win **twice** at Clan co-ops per day: once at Termite Nest, and once at Crab Beach. Clan co-op can only be opened and started by the Queen. All online members of the clan will be notified when the lobby is open through a blue message that appears on the screen, accompanied of a vibration. This notification will repeat every several seconds while the lobby is active and not started.

New clan members can't join Clan co-ops in their first day in the clan. It's only after the next reset (0:00 UTC) that they can join Clan co-ops.

## Donating

Members can donate resources (Fungus, Leaves, and Seeds) to the clan storage and to the other members.

### To clan storage

Members can donate to the clan storage in the "Bonus" tab. Members can donate any amount of resources they want, only limited by the chamber capacity and by how many resources they have.

However, there is a limit for how many times members can donate every day. This daily limit depends on the clan's level: if the clan's level is **between 1 and 5**, members can donate **once** per day; if the clan's level is **between 6 and 11**, members can donate **twice** per day; if the clan's level equals **12**, members can donate **thrice** per day.

### Asking for resources

All clan members can ask for a resource (either fungus, leaves or seeds) **once a day** in the "Chat" tab. This doesn't change with the clan's level.

The request will appear in the right side of the "Chat" tab. Other members can donate any amount of resources they wish, only limited by the request capacity and by the resources they have. The request capacity equals 20% of the corresponding resource chamber's capacity, up to a max of 1999 for level 12 storage chambers.

If the corresponding chamber doesn't have enough capacity to receive all the resources from the request, the request capacity will adapt to only receive the necessary resources to max said resource's chamber capacity, and the request capacity will not increase even though the number of resources in the chamber lowers. Resources can't be requested with a full chamber.

Once a resource is requested, it can't be cancelled. Additionally, members can only have one request at a time in the Donations section, and making another (after the reset time) with one still active will replace the first one, even if it's for another resource.

There is a cool-down of 20 seconds for a member to donate again in the same resource request, but donating to other members can be done unlimited times per day.

## Bonuses

The resources donated to the clan storage can be used to purchase the activation of temporary clan bonuses. The bonuses are:

* Workers' speed.
* Player's speed.
* Soldiers' speed.
* Soldiers' resilience.
* Fusion success chance.

Bonuses can only be activated by the Queen, and last for 7 days. When activated, each bonus takes effect immediately and applies for every clan member. Active bonuses show in a blue color, and also display a timer for its expiration time. Multiple bonuses can be active simultaneously.

The value and the cost of each bonus depends on the clan level:

 +2%
 +3%
 +5%

## Chat

It's possible to chat with other clan members in the "Chat" tab. The clan chat contains messages from members but also system messages.

**Member messages** are written in white text, and include the member's name and their color in the name. They also have a limit of 120 characters.

Member messages have timestamps at the beginning of the line that indicate how long ago (in hours and minutes) they were sent. These timestamps won't be updated unless the player goes through a loading screen, and messages sent after the player has loaded the game won't include any timestamps until the player loads the game once more.

**System messages** are written in light brown color. They are automatic messages that announce a certain action, such as a member's log in, donations, members joining or getting kicked, etc. These messages don't have any timestamps. All the system messages known are:

* **[Member] joined the clan!**
* **Clan member [Member] logged in.**
* **Clan member [Member] logged out.**
* **Clan bonus activated!**
* **[Member] donated [Donation total] resources.**
* **[Member] was kicked from the clan.**
* **[Member] is now the clan's queen!**
* **Clan is now level [Level number]!**

**Note:** The logged in/out messages are temporary and will disappear if the game goes through any loading screen.

Clan chat (as well as Co-op lobbies' chat) has an automatic censorship feature, that replaces offensive words with "**\*\*\***" in any position, including when these are contained in larger groups of characters.

The chat is reset every day at 00:00 UTC. Players can't see messages sent before the reset if they have gone through any loading screen after the game's reset time at 0:00 UTC. The chat also has a limit of 235 lines of text for the maximum message history.

The clan chat menu is also available for all players inside co-op lobbies.

## Other functions

### Post recruitment

In the "Clan" tab there is a button with a blue megaphone. This button is used to post Recruitment messages in-game. They are posted in the "Chat" tab of players that meet the requirements of the clan but that aren't in any clan. The message includes: the clan name, its level and the requirements to join. It can only be posted by the Queen once after every loading screen.

### Edit clan

Next to the "Post recruitment" button there's another one that opens a new menu. This menu can only be accessed by the Queen, and it allows to edit the clan's logo and the requirements, as well as activating the requests to join the clan (explained earlier in the article). Like also said earlier, the clan name can't be changed.

### Requests

Below the clan's description, there is a button to check the requests to join the clan.

If Requests are active for the clan, players that attempt to join through the "Search" tab will send a request to join. Requests include the player's name, their Queen's Chamber level and rank/trophies. They can be reviewed by the Queen or Majors, which can accept or decline them. Clans can have a maximum of 15 requests at a time.

If Requests are disabled, the button will have no function.

### Invite member

Next to the Requests management button there's the Invite button. The Queen and Majors can invite new members to the clan by entering their name, checking if the name is valid (confirms the player) and finally sending the invitation. Players invited to join the clan don't have to meet any requirements.

### Leave clan

Next to the Invite button there is the "Leave clan" button. Any player can leave the clan by pressing it and confirming their decision. After leaving, players need to restart their game if they wish to join any clan.

For the Queen, this button is used to dissolve the clan, but this can only be done if there are no other members in the clan. After a clan is dissolved, its name can be used again for other player's clan.

### Edit member

There's a button for each member in the clan with a gear icon. This button can be used by the Queen and Majors to edit members' role and colors, as well as kicking that member.

This menu has different permissions according to the role:

* The Queen can open it for **everyone** in the clan, including themselves. The Queen can:
	+ Edit the member's color.
	+ Promote or demote the member to a different role (Larva, Worker, Major).
	+ Pass the Queen role to the member.
	+ Kick the member.
* Majors can open it for everyone, including themselves, **except the Queen and other Majors**. Majors can:
	+ Edit the member's color.
	+ Kick the member.

For the Queen to pass the Queen role to another member, they need to confirm their decision by typing "yes" in a confirmation window. After this, the original Queen is demoted to Major.
Members can't kick themselves through this menu.

## Creating a clan

Players can create their own clans or join another's. Starting a clan may be slow, and managing a serious clan requires much effort. It's usually better to join an already existing clan.

### Requirements and cost

A clan can be created in the "Clan" tab of the Social menu. For creating a clan, the player must have their Queen's Chamber at level 5 or higher. Additionally, creating a clan has a cost of 50 gems  and 250 honeydew .

### Creating the clan

By pressing "Create", a new menu will open. There, the player can enter the clan's name and create the logo.

Choosing a name here is very important because it can never be changed after the clan is created. After a name is entered, the player must press the "Check" button to confirm if the name entered is available. If another clan already uses that name, the player must enter a different name.

The player can select the design that appears in the center of the clan logo, as well as two colors: one for the background of the logo and another for the design and the outline. Unlike the clan name, the logo can be changed anytime after the clan creation in the "Edit clan" menu. The requirements for joining and the request option can only be configured after the can creation, in the "Edit clan" menu as well.

### Searching a clan

In the "Search" tab there's a ranking of clans based on the clan trophies (clan trophies are the addition of all members' trophies multiplied by the clan level). The ranking list contains the top 120 clans.

One can look at the clans in the list, or search a different clan that may not appear in the list by using the Search tool at the top of the window. This will look for the clan name entered and display what was found.

In the "Chat" tab there won't be any conversations but recruitment messages of all clans that the player meets the requirements for. These messages include the clan name which can be searched, the clan level and the requirements. If the player sees a clan that caught their attention, they can search it.

If players meet the requirements for a clan, either searched or in the top list, they can join by using the button at the right for each clan. This button can have two icons depending if Requests are active or not for the selected clan:

* This icon means the requests are disabled and the player will join immediately to the clan.
* This icon means that the requests are active, and the player will send a request to join.

If the request are disabled it's easier to join than by sending a request, because it can be accepted when the player is offline and someone else can join before the player logs in.

### Invitation

Players can be invited by a clan's Major or Queen. Invited players don't need to meet the requirements, unlike players that join through the "Search" tab. Players can have multiple invitations and can decline those from clans they don't want to join.

***For more info about joining a clan, see Joining a Clan FAQ.***

## Trivia

* ArielGames has two clans in the game. The first one is "MyClan", the Queen is "ArielIOS" and there aren't other members. The second one is "MyClan2", the Queen is "Ariel" and has a second unknown member.
	+ Both clans can be found in the "Search" tab, but can't be joined because the requirements are set as " 12 - 99999".
	+ In the official announcement of clans, a picture of a clan called "Myclan" was included. However it's not the same clan as the current "MyClan" because the capitalization of the name is different.
* Players can't reset their progress in the game and delete their accounts if they are in a clan. They must leave first.
* There's a very rare bug that allows players to attack a clan mate in a real battle.
* “Turminators” was the first clan ever in Pocket Ants.
* The clans: Colony, Norvop, Antphobia, TheRockIsALie and HonorLatino were all created on the first day clans were released (07-Jan-2021) and are still active today!
* Clans are supercolonies according to Ariel. Supercolonies are natural large aggregations of ant colonies that are non-aggressive to each other, and occur in some ant species.
* Clan level 12 resource costs were adjusted down from 750000 resources each to 600000 resources on 26-May-2023 and resources replaced the Clan Points co-op reward on 13-July-2023.

## References

1. ↑ 1.0 1.1 https://discord.com/channels/738416192255164446/738416851503284295/797156311363354649
2. ↑ https://discord.com/channels/738416192255164446/738416851503284295/816667127917576202
3. ↑ 3.0 3.1 https://discord.com/channels/738416192255164446/738416851503284295/798632329291366441
4. ↑ https://discord.com/channels/738416192255164446/738416851503284295/796507853346701362
5. ↑ https://discord.com/channels/738416192255164446/738416851503284295/796770934891085855
6. ↑ https://discord.com/channels/738416192255164446/771309272025137152/813081029841256448