If your are looking for the current rank table and scoreboard visit the ranking-info folder of this repo.
Smash League is a bot used to handle the ranking of the Official Internal Smash League.
This is a custom point-based ranking system. The more points you have, the best you are placed in the ranking.
To earn points, the players needs to challenge other players and win. If the challenger wins the match, he will keep their coins intact while losing will drain 1 coin from their coins pool. Also a challenger winning the match will increase his range by 1. If the challenged player is the winner, he will gain one stand point.
At the end of the week the bot will calculate the earned points using the next formula:
"Earned points" = "Range" - "Coins at the start of week" - "Coins left at the end of week" + "Stand Points"
Then the earned points will be added to your current points and the other values will be reseted.
The rules to challenge or be challenged by someone are:
- You may challenge any player that has a rank superior of yours up to the range you currently have. (check the list below)
- You cannot challenge people in the same place that you are.
- People with 0 points can't be challenged.
- Unranked people cannot be challenged.
- In the case of a tie in rank, you may only challenge one player of said rank.
- You cannot challenge a player you have defeated this week.
- Also, the times You may be challenged is limitless.
To know if you can challenge someone, you have to follow this three questions:
- Is the person above you in the ranking?
- Do you have coins left?
- is your place in the ranking plus the range you currently have is lower or equals the player place you want to challenge?
If the answer is yes to the 3 questions, then you're good to challenge that player only if you haven't defeated that player this week.
For example: John Doe (rank 6) wants to challenge Rick (7), but Rick is a rank lower than him, so he may not challenge him. Then, he looks the ranking list, and saw that Mary (4) is two places above him. John still has 1 coin left and his range is 2, so the challenge is possible.
The number of coins is calculated using your current place in the ranking and divided by 5, except for the first place which has 0 coins. Also only the integer part of the result is used.
The exact same as your coins, except for the first place which starts with 0.
You can challenge as many people you want only if you still have coins and if there are still players you haven't defeated.
To see the rules during a match see the Match Rules section below.
This league uses the ELO system to calculate the points between players.
The score is important for the winner, so winning 3-0 will give mora points than winning 3-2. For the loser, it's the same points that he loses.
Inactive players will be punished after a week of inactivity. A person that didn't participate in any combat during a week is considered inactive.
The punish of an inactive player consist is losing to an unranked player, also if the ianctive player has ELO below an unranked player is removed from the league and it will considered an unranked player.
Use the @Smash League bot that lives in the mdc-smash channel. Always tag it so he can listen to your message, otherwise will ignore it.
Tag the bot and then post the result, it uses a natural language engine so it should be reported in a natural way. If a person can understand it the bot should too.
The players must play a 1vs1 match to determine a winner. The winner is the first one to win 3 games.
Couching during an in progress game is not allowed. Please stick to the rules.
This is the recommended ruleset for the offcial league matches:
- Stocks: 3
- Time limit: 7 min.
- Final Smash Meter: Off.
- Spirits: Off.
- Damage Handicap: Off.
- Stage Selection: Anyone.
- Items: Off and None.
- First to: 1 Win.
- Stage Morph: Off.
- Stage Hazards: Off.
- Team Attack: On.
- Launch Rate: 1.0x.
- Underdog Boost: Off.
- Pausing: On.
- Score Display: Off.
- % Show Damage: Yes.
- Custom Balance: Off.
- Echo Fighters: Separate.
- Radar: Big.
- Allowed Controllers: Nintendo GameCube, Nintendo Pro Controller, Nintendo Joy-Con, SmashBox.
- Mii Fighters: All moveset combinations are legal.
- Game one striking: (p1 - p2 - p2 - p1). In case both players don’t want to strike, the default starter stage will be Pokémon Stadium 2. You may not play on a stage that is not on the available stages list. This will result in a double disqualification/penalization.
In case of time out, the winner will be decided by the winner screen. In case of a tie, the winner will be the player with less damage at the end of the match. In case of a tie of damage or double KO, the players will play a one stock 3 minutes round on the same stage to decide the winner. In case of a player SD, the winner will be decided by the winner screen.
After each game, the winner bans 2 stages. Players may not counter pick to any stage they have won on during the set unless both players mutually agreed to.
Winning player is not locked into the same character for the next match, in case any player wants to switch characters between rounds, the winner player should change first. Once the loser player changes character the winner player cannot do it.
If both players agree, they can play on any stage without bans nor restrictions, but the players should pick only legal stages. If the players can't decide the stage to pick, then they should use the striking rules.
A player cannot deliberately persuade another player to play on a stage that the character or player has a clear advantage over the other player or character. If any witness of the match identifies this kind of behavior, the match will be declared invalid and the offender player will be punished by losing league points.
- Smashville
- Pokemon Stadium 2
- Town And City
- Battlefield (or any stage on Battlefield)
- Final Destination (or any omega)
- Lylat Cruise
- Kalos Pokemon League
- Yoshi’s Story
- Yoshi’s Island (Brawl)
If you want to contribute, you can rise issues or create your PR.
- Install Docker
- Install Visual Studio Code
- Add your Slack API token in a
.envfile. You can use the.env.TEMPLATEfile as example. - Press
F5to run & debug the project in VS Code
Note: Might not work on Windows
- Install Docker
- Add your Slack API token in a
.envfile. You can use the.env.TEMPLATEfile as example. - Run
docker build -t smash-league . - Run
docker run -it --rm -v ${PWD}/src:/usr/app/src -v ${PWD}/ranking-info:/usr/app/ranking-info -e SLACK_API_TOKEN="Your Slack API token here" smash-league npm run start:debug - You can run the test by running the
docker run -it --rm -v ${PWD}/src:/usr/app/src -v ${PWD}/ranking-info:/usr/app/ranking-info -e SLACK_API_TOKEN="Your Slack API token here" smash-league npm testcommand
Note: We mount the src & ranking-info folders for development, so you can see your changes without building again the Docker image.