Basic Race Logic and Implementation

[lcox74]

We want to have a basic/boilerplate MVP of the Race implementations. This includes the following:

• [x] All users have a single snail which is their default.
• [ ] Host Race (default snail)
• [ ] Join Race (default snail)
• [ ] Display and calculate odds
• [ ] Let the race go through all its stages
• [ ] Handle the no-bets flag
• [ ] Handle the dont-fill flag
• [ ] Handle the only-one flag
• [ ] Win Responses

Note: Though the race will have a betting phase, the placing bets will not be supported. It will only be a place holder until after this Issue has been completed.

Note: This also doesn't include rewards or snail experience, as it is the base race mechanics and functionality.

New User

If a user has never played snailrace, then they need to setup their account by using the /snailrace init command. This must generate a User record and a new random snail (which is also set as the default snail).

Host Race

When a user types /snailrace host then it should create a new race with it's own state + Race ID. Setting up the race must handle the no-bets and dont-fill flags. Entry must be open for 10 seconds before closing and going to the BETTING stage.

The host race response message must display the race meta data and the command to join the race. The race must only be the single message that gets edited displaying its state as well as the list of entrants. You can also join the race using the Discord UI View button which functions in the same way.

Join Race

To join a race you must either:

• Type/copy the command after a race is hosted
• Press the Join Discord UI button

The User's single snail should be displayed as <snail name> (@user) in a list view. Using the command or button the discord response must have the ephemeral flag set so it doesn't flood the chat.

Flags

no-bets: This flag skips the ability to place bets. It will still run the "betting phase" but only displaying all the entrants, including the filled snails who are gonna race before it starts. The odds are still displayed as well.

no-fill: If this is set, then there wont be any additional snails added if the race has less than 4 snails. This opens up more win responses including making fun of a single snail race.

only-one: If this is set, then if there is a draw a new race will automatically begin with the drawn snails. If the next 5 races end in a draw it will give up and announce the drawn winners.

Win Responses

There must be inbetween 5-10 unique responses for the following win conditions:

Condition	Number of snails	Number of wins
Normal Win	4+	1
Normal Tie	4+	2
Normal 3 Way	4+	3
Normal Super Tie	4+	4+
Duel Win	2	1
Duel Tie	2	2
Single	1	1

[lcox74]

The following are the base win responses suggested. This is subject to change and can be amended. This isn't just limited to 10 responses per condition either. These are also found in the race doc.

Normal Win

• "We have a clear winner! {snail name} (@{owner}) leaves the competition behind and races to victory!"
• "In an astonishing performance, {snail name} (@{owner}) outpaces all the other snails and claims the first-place trophy!"
• "Congratulations to {snail name} (@{owner}) for a stunning display of snail athleticism! The victory is well-deserved!"
• "And the winner is... drumroll... {snail name} (@{owner})! Snailtastic job!"
• "In a thrilling finish, {snail name} (@{owner}) crosses the finish line first! Slow and steady wins the race!"`
• "Hooray! {snail name} (@{owner}) leaves the competition in the dust and emerges victorious!"
• "The crowd goes wild as {snail name} (@{owner}) emerges as the champion, leaving the competition in their slimy wake!"
• "A resounding victory for {snail name} (@{owner})! Their speed may be a mystery, but their determination is unmatched!"
• "In a stunning display of snail prowess, {snail name} (@{owner}) claims the top spot. What a race!"
• "With lightning-fast speed (relatively speaking), {snail name} (@{owner}) zips across the finish line, claiming the win!"

Normal Tie

• "We have a nail-biting tie! It's a shared victory between {snail name} (@{owner}) and {snail name} (@{owner})! Snails in sync!"
• "Unbelievable! {snail name} (@{owner}) and {snail name} (@{owner}) cross the finish line simultaneously! It's a snail photo finish!"
• "What are the odds? We have a tie between {snail name} (@{owner}) and {snail name} (@{owner})! These snails are true competitors!"
• "It's an incredible tie! {snail name} (@{owner}) and {snail name} (@{owner}) finish the race together, sharing the glory!"
• "The finish line witnesses a rare moment as {snail name} (@{owner}) and {snail name} (@{owner}) cross it simultaneously! We have dual champions!"
• "No one saw that coming! {snail name} (@{owner}) and {snail name} (@{owner}) match each other step for step and achieve a remarkable tie!"
• "We have a sensational tie! {snail name} (@{owner}) and {snail name} (@{owner}) share the glory in this nail-biting finish!"
• "It's a deadlock! {snail name} (@{owner}) and {snail name} (@{owner}) cross the finish line simultaneously, leaving us in awe!"
• "Wow, what a photo finish! {snail name} (@{owner}) and {snail name} (@{owner}) can't be separated. It's a tie!"
• "Two snails, one glorious finish! {snail name} (@{owner}) and {snail name} (@{owner}) prove that sharing is caring!"

Normal 3 Way

• "It's a miraculous three-way tie! {snail name} (@{owner}), {snail name} (@{owner}), and {snail name} (@{owner}) all cross the finish line together, leaving us in awe!"
• "Hold on to your shells! In an astonishing turn of events, {snail name} (@{owner}), {snail name} (@{owner}), and {snail name} (@{owner}) finish in perfect harmony. It's a remarkable three-way tie!"
• "In a display of snail synchronicity, {snail name} (@{owner}), {snail name} (@{owner}), and {snail name} (@{owner}) cross the finish line simultaneously. It's a three-way tie for the ages!"
• "It's a snail miracle! {snail name} (@{owner}), {snail name} (@{owner}), and {snail name} (@{owner}) defy the odds and create a breathtaking three-way tie!"
• "Three snails, one finish line, and an unforgettable result! {snail name} (@{owner}), {snail name} (@{owner}), and {snail name} (@{owner}) share the glory in an epic three-way tie!"
• "In a stunning twist of fate, {snail name} (@{owner}), {snail name} (@{owner}), and {snail name} (@{owner}) demonstrate their snail prowess by finishing together. It's a three-way tie for the record books!"
• "The race gods must be smiling upon us! {snail name} (@{owner}), {snail name} (@{owner}), and {snail name} (@{owner}) astound us with their snail racing perfection. It's a spectacular three-way tie!"
• "Three snails, three champions! {snail name} (@{owner}), {snail name} (@{owner}), and {snail name} (@{owner}) refuse to be outdone, resulting in an exhilarating three-way tie!"
• "Witness the magic of snail racing as {snail name} (@{owner}), {snail name} (@{owner}), and {snail name} (@{owner}) reach the finish line simultaneously. It's a sensational three-way tie!"
• "It's a snail extravaganza! {snail name} (@{owner}), {snail name} (@{owner}), and {snail name} (@{owner}) bring the crowd to their feet with a magnificent three-way tie!"

Normal Super Tie

• "We don't understand how this happened... but {snail name} (@{owner}), {snail name} (@{owner})... have drawn!"
• "In an unprecedented result, {snail name} (@{owner}), {snail name} (@{owner})... have all drawn!"
• "WHAT IS THIS MADNESS? {snail name} (@{owner}), {snail name} (@{owner}) ... WHAT DID YOU DO!! "
• "Much like life, there are no real winners here. But congrats anyway {snail name} (@{owner}), {snail name} (@{owner}) ..."
• "I'm not exactly sure how to handle this, but {snail name} (@{owner}), {snail name} (@{owner}) ... have all won"
• "If you aren't happy with the result, be the change you want to be. But anyway, well done {snail name} (@{owner}), {snail name} (@{owner}) ..."
• "Unbelievable! We have a historic tie between {snail name} (@{owner}), {snail name} (@{owner}) ..."
• "A party of snails have crossed the line! {snail name} (@{owner}), {snail name} (@{owner}) ..."
• "Hold your breath! There's perfect synchronisation between {snail name} (@{owner}), {snail name} (@{owner}) ..."
• "We have a snail traffic jam! {snail name} (@{owner}), {snail name} (@{owner}) ... have all crossed the line, resulting in a thrilling tie!"

Duel Win

• "It's a nail-biting duel, but {snail name} (@{owner}) outmaneuvers {snail name} (@{owner}) and secures a decisive victory! The snail supremacy is established!"
• "In a fierce showdown, {snail name} (@{owner}) proves its mettle and triumphs over its rival {snail name} (@{owner})! Victory is sweet for this determined snail!"
• "With incredible speed and precision, {snail name} (@{owner}) overtakes {snail name} (@{owner}), leaving no doubt about who the true champion is!"
• "In a battle of wills and sluggishness, {snail name} (@{owner}) outpaces {snail name} (@{owner}) to seize the win!"
• "It's a duel for the ages, and {snail name} (@{owner}) emerges as the snail champion, defeating {snail name} (@{owner}) with style!"
• "In a race filled with anticipation, {snail name} (@{owner}) emerges victorious, leaving {snail name} (@{owner}) in their slimy wake!"
• "With shells clashing and slime flying, {snail name} (@{owner}) outmaneuvers {snail name} (@{owner}) to claim the victory!"
• "In an intense snail showdown, {snail name} (@{owner}) emerges triumphant, leaving {snail name} (@{owner}) in disbelief!"
• "It's a fierce duel, but {snail name} (@{owner}) snails their way to victory, leaving {snail name} (@{owner}) in their slimy wake!"
• "{snail name} (@{owner}) proves their racing mettle by triumphing over {snail name} (@{owner}) in a thrilling head-to-head race!"

Duel Tie

• "A stunning twist of fate! {snail name} (@{owner}) and {snail name} (@{owner}) match each other stride for stride and conclude the race in a perfect tie!"
• "In an extraordinary display of skill, {snail name} (@{owner}) and {snail name} (@{owner}) finish the race together, unable to be separated! A dual triumph!"
• "In a showdown for the ages, {snail name} (@{owner}) and {snail name} (@{owner}) refuse to let the other take the glory. It's an incredible tie in their one-on-one race!"
• "It's a snail stalemate! {snail name} (@{owner}) and {snail name} (@{owner}) cross the finish line together in a thrilling duel. It's a tie!"
• "Hold your slime! {snail name} (@{owner}) and {snail name} (@{owner}) refuse to back down, resulting in a breathtaking tie in their duel!"
• "Two snails enter, two snails tie! {snail name} (@{owner}) and {snail name} (@{owner}) prove to be equally matched in this extraordinary race!"
• "In a surprising turn of events, {snail name} (@{owner}) and {snail name} (@{owner}) can't be separated. It's a thrilling tie in their one-on-one race!"
• "Two snails, one finish line, and a nail-biting result! {snail name} (@{owner}) and {snail name} (@{owner}) tie in an unforgettable duel!"
• "It's a snail standoff! {snail name} (@{owner}) and {snail name} (@{owner}) can't be separated. It's a glorious tie!"
• "In an extraordinary display of snail talent, {snail name} (@{owner}) and {snail name} (@{owner}) tie in an epic race!"

Single

• "In a race with only one contender, {snail name} (@{owner}) emerges as the undefeated champion! A magnificent solo performance!"
• "With no competitors to challenge it, {snail name} (@{owner}) races ahead to claim a flawless victory! A legendary snail achievement!"
• "{snail name} (@{owner}) wins by default in a race with no opponents! Sometimes, being the only snail has its advantages!"
• "In a surprising turn of events, {snail name} (@{owner}) wins the race uncontested. A true snail legend!"
• "{snail name} (@{owner}) shows up to an empty track but still manages to win. Now that's what we call snail power!"
• "It's a one-snail show! {snail name} (@{owner}) sprints to the finish line without any opponents in sight!"
• "Unchallenged and unbeatable, {snail name} (@{owner}) conquers the race without breaking a slimy sweat!"
• "No competitors? No problem! {snail name} (@{owner}) crosses the finish line alone, securing a solo victory!"
• "{snail name} (@{owner}) claims an uncontested victory! They were the only snail on the track, but they still rocked it!"
• "In a race against... well, no one, {snail name} (@{owner}) emerges as the sole champion!"

[lcox74]

As of writing this, this is the current design and function of the /snailrace init function and its responses. This doesn't include errors as it tries to avoid errors, but if it does it will follow the same design with a red bar and accompanying message.

[lcox74]

As of writing this comment this is the current behaviour and design of the /snailrace host command: