YGO-Progression-Bot

KO | EN

gitlite — search

#javascript #python #llm #golang #android #rust #docker #nodejs #windows #awesome #kubernetes #awesome-list #security #open-source

YGO-Progression-Bot

(★ 15)

This Project aims to created a Safe Sealed Draft Yu-Gi-Oh format online experience similar to the Yu-Gi-Oh Progression Series.

YGO-Progression-Bot 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">
  <br>
    <img src="https://github.com/EMachad0/YGO-Prog-Web-Front/blob/main/src/assets/logo.png" alt="" width="75%">
  <br>
    YGO-Progression-Bot
  <br>
</h1>

<h4 align="center">Yu-Gi-Oh, Progression Series, Sealed Draft, Pack Opener, Deck Builder, Bot and Web</h4>

<p align="center">
  <a href="#overview">Overview</a>
  •
  <a href="#contribute">Contribute</a>
  •
  <a href="#user-guide">User Guide</a>
  •
  <a href="#credits">Credits</a>
  •
  <a href="#license">License</a>
</p>

# Overview

This Project aims to create a Safe Sealed Draft Yu-Gi-Oh format online experience similar to the Yu-Gi-Oh Progression Series.

The project currently is divided into four applications:

* [YGO-Progression-Bot](https://github.com/EMachad0/YGO-Progression-Bot): The star of the project, this bot lets players open-packs and add cards to their collection while the admin configures from which set are those pack from, the amount of packs each player can open, and the desired ban-list.

* [YGO-Progression-Web](https://github.com/EMachad0/YGO-Progression-Web): The bulk of the project, built using Vue.js, this site lets players see their collection, build a deck and export it to battle on their preferred Yu-Gi-Oh dueling system.

* [YGO-Progression-Web-Back](https://github.com/EMachad0/YGO-Progression-Web-Back): The Backbone of the project, this Flask/SQLAlchemy application exposes the card/set/banlist/player database to the site.

* [YGO-Progression-db](https://github.com/EMachad0/YGO-Progression-db): The less exciting part of the project, scripts for getting and parsing yu-gi-oh data and adding those to the database for the others applications to use.

# Contribute

This project was develop by a single Brazilian CS Student, while I don't expect to live by this project, I do plan to continue improving this for years to come as this is such a passion project and the biggest thing I have ever built.

However, currently the project has monetary limitations, I can't pay for the servers this project runs on, that's why I need your contribution.

**With the current server there is a limit of 10000 database lines, that's why some newer sets are missing.**
(there exists more cards than the database line limit).

You can also contribute by opening issues if you found any problem. Any pull request welcome.

Any questions? You can contact me on this [Discord](https://discord.gg/ztj2kSk) Server.

# User Guide

## Bot

First, Add the [Bot](https://discord.com/api/oauth2/authorize?client_id=859241519781642251&permissions=59456&scope=bot) to your server!

https://discord.com/api/oauth2/authorize?client_id=859241519781642251&permissions=59456&scope=bot

As admin, configure which channels the bot has access to, then send the following message:
```
$new_game
```
This will register a game in your server.

at any point you can finish the game with following command:
```
$end_game
```
Beware, sending *end_game* deletes **all** data, including player's collection.

Now every player who wants to participate can join with: 
```
$enter
```

And players can open packs with the *pack* command,
```
$pack 7
```
Here the 7 is the number of packs to open, passing no number will open only 1 pack.

This can take a while depending on the amount of cached images the bot has, however the bot will respond with *"Opening..."* to ensure you it's working correctly.

Also, the bot tries to reduce the amount of flooding by grouping maximum 5 packs per image.

After running the command, all shown cards will be automatically be added into the player collection.

However, to open packs, players need to have available packs.

A player can see their available packs and collection url using:
```
$status
```

The admin needs to distribute packs to the players, using *give_pack* and the set code:
```
$give_pack 24 LOB
```
Here *LOB* is the code for *Legend of Blue Eyes*, and the *24* is the number of packs each player will recieve.
Players need to open packs on their own with the *pack* command.
If needed, the command supports an arbitrary number of usernames, so you can give specific packs to specific players:
```
$give_pack MRD 5 @player1 @player2
```
<details>
  <summary>Available pack codes</summary>
  
  |Code|Name                            |
  |--- |--------------------------------|
  |LOB |Legend of Blue Eyes White Dragon|
  |MRD |Metal Raiders                   |
  |TP1 |Tournament Pack: 1st Season     |
  |MRL |Magic Ruler                     |
  |TP2 |Tournament Pack: 2nd Season     |
  |PSV |Pharaoh's Servant               |
  |TP3 |Tournament Pack: 3rd Season     |
  |LON |Labyrinth of Nightmare          |
  |LOD |Legacy of Darkness              |
  |PGD |Pharaonic Guardian              |
  |TP4 |Tournament Pack 4               |
  |MFC |Magician's Force                |
  |DCR |Dark Crisis                     |
  |IOC |Invasion of Chaos               |
  |AST |Ancient Sanctuary               |
  |SOD |Soul of the Duelist             |
  |TP5 |Tournament Pack 5               |
  |RDS |Rise of Destiny                 |
  |FET |Flaming Eternity                |
  |TP6 |Tournament Pack 6               |
  |TLM |The Lost Millennium             |
  |CRV |Cybernetic Revolution           |
  |TP7 |Tournament Pack 7               |
  |EEN |Elemental Energy                |
  |DP1 |Duelist Pack: Jaden Yuki        |
  |DP2 |Duelist Pack: Chazz Princeton   |
  |SOI |Shadow of Infinity              |
  |TP8 |Tournament Pack 8               |
  |EOJ |Enemy of Justice                |
  |CP01|Champion Pack: Game One         |
  |CP02|Champion Pack: Game Two         |
  |DP05|Duelist Pack: Aster Phoenix     |
  |DP03|Duelist Pack: Jaden Yuki 2      |
  |STON|Strike of Neos                  |
  |DP04|Duelist Pack: Zane Truesdale    |
  |CP03|Champion Pack: Game Three       |
  |FOTB|Force of the Breaker            |
  |TAEV|Tactical Evolution              |
  |CP04|Champion Pack: Game Four        |
  |GLAS|Gladiator's Assault             |
  |CP05|Champion Pack: Game Five        |
  |PTDN|Phantom Darkness                |
  |CP06|Champion Pack: Game Six         |
  |LODT|Light of Destruction            |
  |CP07|Champion Pack: Game Seven       |
  |TDGS|The Duelist Genesis             |
  |CSOC|Crossroads of Chaos             |
  |CP08|Champion Pack: Game Eight       |
  |ANPR|Ancient Prophecy                |
  |SOVR|Stardust Overdrive              |
  |ABPF|Absolute Powerforce             |
  |TSHD|The Shining Darkness            |
</details>

The command *give_card* has yet to be implemented.

Any questions? You can contact me on this [Discord](https://discord.gg/ztj2kSk) Server.

### Bot Screenshot:
<h1 align="center">
    <img src="/screenshots/discord_screenshot.png" alt="" width="30%">
</h1>

### Configs

Configs are keywords to make so the admin can customize the game and implement the format he considers the best, like so:
```
$config ban_list May 2002
```
Here, *ban_list* is the key while *May 2002* is the value, this command is setting the server banlist to the [May 2002](https://yugipedia.com/wiki/May_2002_Lists_(TCG)) list.

Supported configs for now:
|Key         |Supported Values                    |Info                                                  |Default Behavior               |
|------------|------------------------------------|------------------------------------------------------|-------------------------------|
|ban_list    |"Month Year" of any official banlist|Let admin set the deck builder banlist                |No ban list                    |
|private_pack|"False"                             |*$pack* response is sent on the channel of the command|*$pack* response is sent via DM|

Passing an invalid key will do nothing while passing a invalid value will change the key to it's default behavior.

## Web

The Site will display only your entire collection, you can't add cards you haven't pull and those won't appear if you search for then.

Also, the cards may take a while to load depending on the size of your collection, don't panic if it looks stuck.

Use the fields and Options to filter/sort, and you can Drag/Drop or Right Click on cards to add/remove then from deck.

That is it, there is no magic here, the ui should be intuitive enough, but you can message me any questions.

[Example collection](https://ygo-prog-web-front.herokuapp.com/#/collection/456912106864902144/203615933539942400)

Any questions? You can contact me on this [Discord](https://discord.gg/ztj2kSk) Server.

### Web Screenshot:
<h1 align="center" float="left">
    <img src="/screenshots/collection_screenshot.png" alt="" width="45%">
    <img src="/screenshots/deck_builder_screenshot.png" alt="" width="45%">
</h1>

# Dev Guide

(to do)

Any questions? You can contact me on this [Discord](https://discord.gg/ztj2kSk) Server.

# Credits

Credit where credit is due

Special Thanks for all my friends who helped on the development, specially [Igor](https://github.com/IgorFroehner), [Joao](https://github.com/joao-frohlich) and [Felipe](https://github.com/Markhyz).

Thanks to [Cimooo](https://www.youtube.com/channel/UCrEMDvUyGV1p66Vf5P0O1pg) for creating the Progression Series and being the inspiration of this project.

Thanks to [YGOPRODECK](https://ygoprodeck.com/) for the great and well documented api.

# license

Released under the [MPL 2.0](https://www.mozilla.org/en-US/MPL/) license.

YGO-Progression-Bot

YGO-Progression-Bot 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

YGO-Progression-Bot

YGO-Progression-Bot 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README