nanahira/windbot repository overview

⁠WindBot

A C# bot for YGOPro, compatible with the YGOSharp⁠ and SRVPro⁠ server.

⁠How to use:

• Compile WindBot.sln using Visual Studio or Mono.

• Put cards.cdb next to the compiled WindBot.exe.

• Run YGOPro, create a host.

• Run WindBot and observe.

⁠Supported commandlines

Name
The nickname for the bot.

Deck
The deck to be used by the bot. Available decks are listed below. Keep empty to use random deck.

DeckFile
The deck file (.ydk) to be used by the bot. Will be set by Deck automatically, but you can override it.

Note: Most cards not in the original deck are unknown to the bot, and won't be summoned or activated in the duel.

Dialog
The dialog texts to be used by the bot. See Dialogs folder for list.

Host
The IP of the host to be connected to.

Port
The port of the host to be connected to.

HostInfo
The host info (password) to be used.

Version
The version of YGOPro.

Hand
If you are testing deck, you may want to make sure the bot go first or second. Hand=1 will make the bot always show Scissors, 2 for Rock, 3 for Paper.

Chat False to turn the chat of bot off.

Debug Print verbose log of card movement info. False at default. (May be updated in future)

AutoQuit Automatically quit the room when opponent leaves. Default false.

ServerMode and ServerPort
WindBot can run as a "server", provide a http interface to create bot.

⁠Available decks

Easy:

• Burn

• Frog

• Horus

• MokeyMokey

• MokeyMokeyKing

• OldSchool

Normal:

• Altergeist

• Blue-Eyes

• BlueEyesMaxDragon

• ChainBurn

• DarkMagician

• Dragun

• Dragunity

• GrenMajuThunderBoarder

• Level VIII

• LightswornShaddoldinosour

• Orcust

• Phantasm

• Qliphort

• Rainbow

• Rank V

• Salamangreat

• SkyStriker

• ST1732

• Toadally Awesome

• Trickstar

• Yosenju

• Zexal Weapons

• Zoodiac

⁠Unfinished decks

• Blackwing

• CyberDragon

• Evilswarm

• Gravekeeper

• Graydle

• Lightsworn

• Nekroz

⁠AI Template Generator

A Java program which generate executor code from deck, made by Levyaton. https://github.com/Levyaton/WindbotTemplateGenerator⁠

⁠Server mode

WindBot can run as a "server", provide a http interface to create bot.

eg. http://127.0.0.1:2399/?name=%E2%91%A8&deck=Blue-Eyes&host=127.0.0.1&port=7911&dialog=cirno.zh-CN

In this situation, it will be multi-threaded. This can be useful for servers, since it don't use large amount memory.

The parameters are same as commandlines, but low cased.

⁠Known issues

• If one chain includes two activation that use AI.SelectCard, the second one won't select correctly.

⁠Changelog

⁠v0x134A (2019-05-30)

• Update YGOPro protrol to 0x134A
• New decks: Altergeist, BlueEyesMaxDragon, GrenMajuThunderBoarder, Level8, Orcust, Phantasm, Salamangreat
• Use LINQ in codes
• Add random bot feature to BotWrapper
• Add ClientCard.Sequence, ClientCard.ProcCompleted, ClientCard.IsSpecialSummoned
• Add ClientCard.EquipCards, ClientCard.OwnTargets, handle equip cards
• Add ClientCard.IsCode, handle card alias
• Add ClientCard.GetLinkedZones, ClientCard.HasSetcode
• Add ClientField.UnderAttack, ClientField.GetLinkedZones, ClientField.GetFieldSpellCard
• Add Duel.SummoningCards, Duel.LastSummonedCards
• Add Util.GetTotalAttackingMonsterAttack, Util.GetBotAvailZonesFromExtraDeck
• Add GetMatchingCards, GetFirstMatchingCard, IsExistingMatchingCard
• Add ExecutorType.GoToBattlePhase, ExecutorType.GoToMainPhase2, ExecutorType.GoToEndPhase
• Add DefaultScapegoat, DefaultMaxxC, DefaultAshBlossomAndJoyousSpring, DefaultGhostOgreAndSnowRabbit, DefaultGhostBelleAndHauntedMansion, DefaultEffectVeiler, DefaultCalledByTheGrave, DefaultInfiniteImpermanence
• Rename AIFunctions to AIUtil (Usage: AI.Utils. -> Util.)
• Rename AIFunctions.CompareCardAttack to CardContainer.CompareCardAttack
• Update Util.SelectPreferredCards and Util.CheckSelectCount to return the result
• Update ClientField.HasInMonstersZone to support check face-up card
• Update AI.SelectCard #59⁠
• Handle swap control of cards
• Change some int location to CardLocation location
• Update default OnPreBattleBetween to recognize more cards
• Misc updates to default executors
• Misc updates to the AI of some decks
• Update the known card enums
• Fix CardSelector.Select
• Fix OnSelectEffectYn didn't have ActivateDescription
• Fix ClientCard.Attacked
• Fix infinite activation of ZexalWeapons

⁠v0x1344 (2018-06-05)

• Update YGOPro protrol to 0x1344
• New decks: DarkMagician, SkyStriker
• Add param to turn chat off
• Add param to print verbose log
• Add part of Zones enum and AI.SelectPlace
• Add ClientCard.IsTuner, ClientCard.LinkMarker, ClientCard.HasLinkMarker
• Add ShouldNotBeTarget and ShouldBeDisabledBeforeItUseEffectMonster enum
• Add AI.Utils.GetBestBotMonster, AI.Utils.GetWorstBotMonster and AI.Utils.ChainContainPlayer
• Add Executor.OnCardSorting and Executor.OnDraw
• Add ClientField.GetColumnCount and ClientField.HasInHandOrInSpellZone etc.
• Misc updates to LightswornShaddoldinosour and ChainBurn deck
• Misc updates to default executors
• Fix OnSelectUnselectCard
• Fix OnMove to keep card data when moving

⁠v0x1343 (2018-04-11)

• Update YGOPro protrol to 0x1343
• New decks: Trickstar, LightswornShaddoldinosour, ChainBurn
• Update OnBattle, add Executor.OnSelectAttacker and Executor.OnSelectAttackTarget
• Add Executor.OnSelectPosition, Executor.OnSelectBattleReplay
• Add Bot.BattlingMonster
• Add and update some default executors
• Change Duel.LifePoints[0] to Bot.LifePoints
• Change LastChainPlayer and CurrentChain to Duel class
• Change ChainContainsCard and GetLastChainCard etc. to AI.Utils class
• Fix turn count in match duel
• Fix don't turn 0 atk monster to atk pos

⁠v0x1342 (2017-12-26)

• Update YGOPro protrol to 0x1342
• Add Linux BotWrapper (a simple bash script)

⁠v0x1341 (2017-11-27)

• Update YGOPro protrol to 0x1341
• Change the program to x86 only
• Add BotWrapper for YGOPro bot mode
• Add AI.SelectMaterials, OnSelectFusionMaterial, OnSelectPendulumSummon, AI.Utils.SelectPreferredCards etc.
• Fix AI.Utils.GetBestEnemySpell to not return normal spell currently activating
• Fix AI don't attack defense Crystal Wing or S39
• Fix ZexalWeapons AI don't change defense S39 back
• Minor updates

⁠v0x1340 (2017-11-06)

• Update YGOPro protrol to 0x1340
• Add support for the New Master Rule
• Decks update
• New commandline parameters
• Add support for Match and TAG duel
• Add server mode
• Bot dialogs now customable
• Only use normal deck when random picking decks
• Send sorry when the AI did something wrong that make the duel can't continue (for example, selected illegal card)
• Send info when the deck of the AI is illegal (for example, lflist dismatch)
• Fix the issue that the bot will attack Dupe Frog with low attack monster when there is monster next to Dupe Frog
• Fix the issue that synchro summon stuck in some condition #7⁠
• Fix C#6.0 (VS2015) support
• Fix OnUpdateData
• New and updated DefaultExecutor
• New and updated AI.Utils, ClientCard, ClientField functions
• Add OnNewTurn, AI.SelectYesNo, AI.SelectThirdCard, Duel.ChainTargets, Duel.LastSummonPlayer
• Shortcut Bot for Duel.Fields[0], Enemy for Duel.Fields[1]
• CardId is now class instead of enum so (int) is no longer needed
• Update the known card enums, add Floodgate, OneForXyz, FusionSpell, MonsterHasPreventActivationEffectInBattle
• Update OnPreBattleBetween to calculate the ATK of cards like Number S39: Utopia the Lightning
• Update direct attack handling

⁠v0x133D (2017-09-24)

• Update YGOPro protrol to 0x133D
• Use the latest YGOSharp.Network to improve performances
• Update the namespace of YGOSharp.OCGWrapper
• Fix the default trap cards not always activating

⁠TODO list

• More decks

• Documents for creating AI

• AI.SelectPlace for linked zones or not linked zones

• AI.SelectTribute

• Get equip of card.

• Better new master rule support

• Update the known card enums

• More default common cards executor

⁠Features in this branch

• Added support for Group.SelectUnselect. This is mainly to support KoishiPro or EdoPro.