Songs are the collectible items in The Dojo. Users can obtain them using the command !discover, which adds them to their collection known as a Chapter. Chapters have 13 slots to store Songs, but users can get more slots by expanding their Vault using the command !expand. Users can also rearrange Songs in their Chapter and Vault using the commands !swap slot1 slot2 and !movetofront slots. Users can also remove Songs from their Chapter or Vault by destroying them using the command !scrap slot. Doing so will refund Pieces, and the number of Pieces obtained increases with the Level of the Song that was Scrapped. Users can also trade Songs and Pieces with each other using the command !trade selling buying user.

This section excludes information about Levels, Stats, Stars, and Elements as they are combat-related. Please refer to the Combat - Basic Mechanics section for the relevant information.

Users can Discover Songs, which adds them to the user's collection, using the command !discover number where number is the number of Songs a user wants to Discover. Each Song obtained using Discover costs 40% of the Base Price in credits.

Users can also use Pieces (refer to subsection below) to Hunt and Stalk Songs. Users can obtain Songs from a specified album using the command !hunt number album where number is the number of Songs a user wants to Hunt and album is the name of the album a user wants to Hunt. Each Song obtained using Hunt costs 20 Pieces. Similarly, users can obtain a specified Song using the command !stalk song where song is the name of the Song a user wants to Stalk. Users can only obtain 1 Song for each use of Stalk. Each Song obtained using Stalk costs 350 Pieces.

When users obtain Songs, they are first stored in their Chapter, which has 13 slots that can each store 1 Song. Chapters are also used in Combat (refer to its dedicated sections below). When a user's Chapter is full, they are no longer able to obtain new Songs. Users can view their Chapter using the command !chapter. Users can view a specific Song in their Chapter using the command !song slot where slot is the slot number of the Song the user wants to see.

Users also have a Vault, which provides extra slots to store Songs. By default, users have 0 slots in their Vault, but can gain new slots using the command !expand. Each use of !expand increases the number of slots in a user's Vault by 1. The first use of !expand costs 250 credits and each subsequent usage costs 250 credits more than the previous one, up to a maximum of 5000 credits. The maximum size of a user's Vault is 52 slots, so users can store a total of 65 Songs in their Chapter and Vault combined. Users can view their Vault by using the commands !chapter and !vault. Each page displayed by these commands shows 13 Songs each, and users can navigate to other pages using the buttons below the embed.

Users can rearrange their Chapter and Vault by using some commands. Users can swap the position of two Songs using the command !swap slot1 slot2, where slot1 and slot2 refer to the slots of the Songs that the user wants to swap. Users can also move Songs to the front of their Chapter while pushing all other Songs backwards using the command !movetofront slots, where slots refers to the slot numbers of the Songs the user wants to move. If only one Song is moved, only that slot number is specified e.g. !movetofront 7 to move the Song in slot 8. If multiple Songs are moved, their slot numbers must be joined using &, e.g. !movetofront 1&4&7&13,

Users can remove Songs from their Chapter or Vault using the command !scrap slot, where slot is the slot number of the Song the user wants to remove. This gives users Pieces in return. Scrapping a Level 1 Song returns 1 Piece, and each subsequent Level doubles the number of Pieces returned. For example, Scrapping a Level 5 Song returns 16 Pieces.

Pieces are subject to taxes, similar to credits. Like the Wealth Tax and Inactivity Decay for credits, it is applied every 25 bowls. The tax is 1% of a user's total Pieces, rounded down. This means users with less than 100 Pieces are not subject to this tax.

Songs and Pieces can be traded between users at a small fee of Pieces. Users can use the command !trade selling buying user where selling is the slot numbers of the Songs and Pieces to be traded away by the command user, buying is the slot numbers of the Songs and Pieces to be obtained by the command user, and user is the target user to be traded with. To trade Pieces, the number of Pieces followed by a p is used, e.g. 50p to trade 50 Pieces. Similarly to !movetofront, trading multiple Songs, or Songs and Pieces, uses an & to join them. For example, if user A wanted to give away their Songs 2, 4, 7, and 100 Pieces for user B's Songs 5, 9, 18, and 22, user A would send !trade 2&4&7&100p 5&9&18&22 @user B. When a trade is initiated, the target user has 30 seconds to reply with 'Y' to confirm the trade. If there is no response, or if the target user replies with 'N', the trade is cancelled and no Songs are lost.

When trading, both users involved in the trade must pay a fee based on the Valuation of the Songs and number of Pieces involved. A Song's Valuation is the number of Pieces it would return when Scrapped, multiplied by 2 if it has an Element and multiplied by 5 for every Star it has, if any. For example, a Level 2 Song with an Element and two Stars has a Valuation of 100 Pieces. The fee for trading is 10% of the total number of Pieces and Valuation of every Song involved in the trade. For example, a trade with Songs worth 100, 250, 300, 390, and 700 Pieces, plus 100 Pieces, has a total Valuation of 1840 Pieces, and both users must pay 184 Pieces each to trade.

Songs can be used to Fight other users or Battle pre-made Albums. Every Song has one Mainstat and two Substats chosen from a pool of seven. Users can Train these Songs to increase their Level and their Stats. Songs also have Elements, which make them deal more or less Damage based on the opposing Chapter's Element, and Stars, which increase their maximum Level. While Fighting other users is free, Battling Albums costs Pieces that increase with the Album Level. Users can get rewards from Battling such as User Score and Ephemera.

There are 7 Stats that Songs can have in The Dojo, namely Tenacity, Altruism, Strength, Whimsy, Intelligence, Fortitude, and Tempo. The first letter of these names spell out T. A. Swift, which stands for Taylor Alison Swift.

All Songs have one Mainstat and two Substats selected from the 7 possible Stats. A Song can only have 1 of each Stat at maximum. All Songs with the same name will have the same Mainstat, for example, all Tim McGraws will have Tenacity as their Mainstat. However, both Substats for all Songs are randomly selected from the remaining 6 options.

[LIST THE SONGS AND THEIR STATS HERE IDFK HOW TO DO IT]

When fighting in The Dojo, the Stats of individual Songs are not important. Instead, Chapters are used. Chapters start with 100 Tenacity and 100 Tempo, then the Stats of all Songs in that Chapter are added to it. Chapters take Turns to deal Damage, and at the end of every Turn they heal a certain amount. The uses of the 7 Stats in these fights are as follows:

1. Tenacity, represented by a ❤️ / :heart:, is a Chapter's health. It is reduced by incoming Damage and increased by Healing. When a Chapter's Tenacity reaches 0, they are defeated and lose the fight.
2. Altruism, represented by a 🤝 / :handshake:, is a Chapter's healing. Every Turn, a Chapter heals itself a random amount between 0% and 100% of its Altruism.
3. Strength, represented by a 💪 / :muscle:, is a Chapter's damage. When a Chapter attacks, its Strength determines the initial Damage it deals.
4. Whimsy, represented by a ✨ / :sparkles:, is a Chapter's critical damage percent. When a Chapter attacks, it has a chance to land a Critical Hit. If it does so, the Damage it deals is increased by its Whimsy in percent (i.e. 10 Whimsy is +10% Damage).
5. Intelligence, represented by a 🧠 / :brain:, is a Chapter's critical chance percent. When a Chapter attacks, its Intelligence is the percentage chance that it lands a Critical Hit (i.e. 10 Intelligence is a 10% Critical Chance).
6. Fortitude, represented by a ⛰️ / :mountain:, is a Chapter's defense. When a Chapter takes Damage, the Damage is reduced by its Fortitude.
7. Tempo, represented by a ⏱️ / :stopwatch:, is a Chapter's speed. In a fight, the Chapter with a higher Tempo attacks first. Additionally, the ratio between the Chapters' Tempos is the ratio between the number of attacks they do. For example, a Chapter with 200 Tempo will attack twice as often as a Chapter with 100 Tempo.

When first obtained, Songs all start at Level 1. Users can increase this Level by Training them using the command !train slot where slot is the slot number of the Song the user wants to Train, increasing the Song's Level by 1. Training a Level 1 Song costs 1 Piece, and every subsequent Level doubles the cost. For example, Training a Level 8 Song to reach Level 9 costs 256 Pieces.

By default, the maximum Level for a Song is Level 10. However, they have a chance to generate with Stars (refer to the Elements subsection below). Each Star increases the maximum Level for a Song by 1.

When Songs are first Discovered, their Mainstat will be a fixed amount depending on what it is, but their Substats can be a random amount in a given range. Similarly, training a Song increases its Mainstat by a set amount and one of its substats by a random amount in a given range. This is summarised in the following table:

Songs can also have an Element, of which there are 8. Elements are split into 3 groups of Basic Element, Advanced Element, and Moon Element, and each has a different chance of being the Element of a Song, summarised in this table: *In this Wiki, the emoji ❌ / :x: is sometimes used to represent Elementless for visual consistency.

When Chapters fight each other, they cycle through the Elements of the Songs in themselves and take on that Element. When two different Elements match up, i.e. the attacking Chapter has one Element and the other Chapter has another, the Damage dealt is either increased or decreased by a multiplier. Within each group of Elements, a closed loop of strengths and weaknesses are formed:

1. Water is strong against Fire, Fire is strong against Grass, Grass is strong against Water, and vice versa. Basic Elements deal 150% Damage to and receive 67% Damage from the Element they are strong against.
2. Lightning is strong against Wind, Wind is strong against Stone, Stone is strong against Lightning, and vice versa. Advanced Elements deal 200% Damage to and recieve 50% Damage from the Element they are strong against.
3. New Moon and Full Moon do not form a similar loop. Instead, they both deal 300% Damage and recieve 300% Damage from each other.

Certain groups of Elements are strong and weak against other groups too:

1. Elementless deal 90%/80%/70% Damage to and receive 110%/120%/130% from Basic/Advanced/Moon Elements respectively.
2. Basic Elements deal 110%/90%/80% Damage to and receive 90%/110%/120% Damage from Elementless/Advanced/Moon Elements respectively.
3. Advanced Elements deal 120%/110%/90% Damage to and receive 80%/90%/110% Damage from Elementless/Basic/Moon Elements respecitvely.
4. Moon Elements deal 130%/120%/110% Damage to and receive 70%/80%/90% Damage from Elementless/Basic/Advanced Elements respectively.

All matchups are summarised in the following table, with the number representing the Damage dealt by the Element in the top row against the Element in the first column:
Songs can also have Stars. When a Song is obtained, there is a 10% chance to add one Star to it, and this chance is repeated 6 times for a maximum of 6 Stars on one Song. For example, there is a 0.01% chance for a Song to generate with at least 4 Stars, or 1 in 10 000. Each Star of a Song increases its maximum Level by 1.

Fights are a round of combat between users. They are done automatically; users only need to prepare their Chapter then send the command !fight user where user is the target user they want to Fight. The details of the Fight are done internally, and when it is over, a summary message of the Fight is sent.

There is no cost to Fighting with other users, but there are also no rewards given.

Users can also choose to Battle pre-made Chapters generated by BowlBot instead of users. The combat mechanics are identical to that of Fight, however there are additional mechanics involving difficulty, cost, and rewards.

Every Bot Cycle, a set number of Albums are randomly selected from Taylor Swift's 12 studio albums. The number of Albums is based on the days of the week. On Monday, there is 1 Album available, and it increases by 1 per day up to a maximum of 7 on Sundays. These can be checked using the commands !battlelog, !progress, !battle with no parameter, and !blitz with no parameter. To Battle them, users can use the command !battle album where album is the name of the Album they want to Battle. Albums contain between 9 and 13 Songs. Albums have a Level, and all Songs in them have that same Level. For example, a Level 4 Album could have 11 Songs at Level 4.

When users Battle, they start by Battling Albums at Level 1. If they win that Battle, they can proceed to the next Level. There is no limit to the Level of an Album and its songs besides how far a user's Chapter can go. Battling an Album costs Pieces equal to its Level. For example, Battling a Level 17 Album costs 17 PIeces. Users can quickly Battle an Album until they lose a Battle or run out of Pieces using the command !blitz. The cost of using Blitz is the same as Battling each Level individually.

There are some rewards for Battling Albums. Every Battle won adds 1 to a user's Cleared Floors, which contribute to their User Score. Winning a Battle also has a 2% chance to immediately award the user an Ephemera if they can hold it. At Levels 7, 13, 22, and 89, this 2% chance is replaced; users are instead awarded a Pending Victory Ephemera. When users vote in a TaylorBowl, there is a 33% chance for one Pending Victory Ephemera to become a regular Ephemera. Otherwise, it is destroyed. If an Ephemera were to Spontaneously Generate for that user during that Bowl, the Pending Victory Ephemera will wait until the next Bowl to attempt to convert. Users can get at maximum 15 Pending Victory Ephemera in one Bot Cycle. Users can check their Pending Victory Ephemera using the command /wallet, where it is represented with a question mark beside an Ephemera.

Users can check the highest Level of each Album they are able to Battle using the command !battlelog, or check the users who have the five highest victories against each available Album using the command !progress.

?

All Songs in a Chapter also give it additional Stats or special bonuses based on their Element.

1. Elementless Songs, when the Chapter is Elementless, grant a 40% chance to perform a Counter. The Counter deals Damage equal to 60% of the Chapter's Strength, increasing by 20% for every Elementless Song, and is unable to land Critical Hits.
2. Water Songs multiply a Chapter's Intelligence by 1.04 each.
3. Fire Songs multiply a Chapter's Strength by 1.03 each.
4. Grass Songs increase the minimum healing amount from a Chapter's Altruism by 5% each.
5. Lightning Songs multiply a Chapter's Whimsy by 1.075 each.
6. Wind Songs grant a Chapter one Critical Cancel each, which are consumed when the Chapter takes a Critical Hit to make it a regular hit.
7. Stone Songs grant a Chapter one Second Chance which revives a Chapter to 8% of its initial Tenacity when it is defeated. This percentage increases by 8% for every Stone Song.
8. New Moon Songs multiply a Chapter's Tempo by 1.025 each.
9. Full Moon Songs grant a Chapter a 2% chance to dodge incoming Damage, increasing by 2% for every Full Moon Song.

For Counters and Second Chances, they do not count as a Turn.

Damage dealt in The Dojo is given by the formula: where \(m_{1}\) is the Elemental Multiplier (refer to the table in Combat - Basic Mechanics / Elements) and \(m_{2}\) is the Critical Damage Multiplier, given by:

Chapters take Turns to perform actions, and every Turn involves the following order of actions:

1. Change Element
2. Attack
3. Heal

The first Chapter to have a Turn is the Chapter with the higher Tempo. If both Chapters have the same Tempo, the user who sent the command goes first. During their Turn, a Chapter first changes its Element according to the order of its Songs. On its first Turn, its Element is that of its first Song; on its second Turn, its Element is that of its second Song, etc. Chapters continue to have the Element they last changed to until the start of their next Turn. When a Chapter has cycled through all its Songs, it loops back to its first Song's Element. After attacking, the Chapter heals a random amount between 0% and 100% of its Altruism. The amount healed cannot let a Chapter's Tenacity exceed its original value.

It is possible to identify the order in which Chapters will have their Turns based on their Tempo. Note that this may not be how it works in the code for BowlBot, but it is an accurate model based on the testing performed so far.

Both Chapters are assigned an arbitrary number, which will be referred to as "Tempo Score", starting at 0 when the Fight or Battle begins. When it is time for a Chapter to have a Turn, attempt to add the reciprocal of their Tempos to their Tempo Score. Whichever Chapter has a lower Tempo Score will have a Turn, and that number added to their Tempo Score. The other Chapter has no changes made to their Tempo Score. This repeats for every Turn.

For example, consider Chapter A with 100 Tempo and Chapter B with 250 Tempo, where Chapter A is the Chapter that intiated the Fight. The reciprocals of their Tempos are 0.01 and 0.004 respectively. For the first Turn in the Fight, Chapter B will have a lower resultant Tempo Score, so they perform a Turn and their Tempo Score is increased to 0.004. For the second Turn, Chapter B will still have a lower resultant Tempo Score, so they perform a Turn and their Tempo Score is increased to 0.008. For the third Turn, Chapter B would have a resultant Tempo Score of 0.012 and Chapter A would have one of 0.01, so Chapter A has their Turn. A summary of the order of Turns in this Fight, assuming no Chapter is defeated, is as such: *Since the resultant Tempo Scores would be tied, Chapter A takes priority as it initiated the Fight.

As can be seen, the ratio of number of Turns that Chapter A does to the number of Turns that Chapter B does is also the ratio between their Tempos, \(2:5\).

The embed sent when Fighting or Battling contains lines of emojis that explain what happened during the combat. Understanding what each emoji means can help users change their Chapters to be better in combat. Each row is one Turn, and contains one string of emojis. All the notation used and their meanings are summarised in the following table:

1.1   Damage dealt: where \(m_{1}\) is the Elemental Multiplier and \(m_{2}\) is the Critical Damage Multiplier.

1.2   Table of Elemental Multiplier, \(m_{1}\):
1.3   Critical Damage Multiplier, \(m_{2}\):

Term	Definition
Collection	A user's Chapter and Vault combined; the location of their stored Songs.
Counter	A weaker attack by a Chapter when taking Damage that does not count as a Turn.
Pending Victory Ephemera	A currency that has a 33% chance of converting into Ephemera, once per Bowl voted in.
Scrap	To destroy a Song in return for Pieces.
Second Chance	An effect that allows a Chapter to regain Tenacity upon being defeated.
Tempo Score	A mathematical model for the order in which two Chapters have Turns.