What is KoishiPRO
KoishiPRO(ygopro_222.exe) is a custom YGOPRO version, forked from Mercury233's YGOPRO repo, which is by extension a version of the original repo.
KoishiPRO is maintained by purerosefallen, aka Komeiji Koishi. It's originally a version of YGOPRO used on 222 Server, another custom card server owned by her. It features an extended OCGCORE to support more effects that would be used to make custom cards.
Anyone want to add to the custom OCGCORE can contact Komeiji Koishi#4392 in our Discord.
So why is it special?
For starters, this specific YGOPRO version features an extended YGOCORE and added code that allows you to do the following:
- Adding BGM/SE on card activation.
- Adding effect to cards that you may want to use such like removing/adding link markers, getting the current ruleset, completely overwrite a card with another (for double-faced cards.)
- Can connect to any YGOPRO server by auto-matching version.
- ...and more custom card friendly functions!
Here's just a partial list of added procedures in its OCGCORE.
static int32 card_get_affecting_effect(lua_State *L);
static int32 card_set_entity_code(lua_State *L);
static int32 card_filter_effect(lua_State *L);
static int32 card_set_card_data(lua_State *L);
static int32 effect_set_owner(lua_State *L);
static int32 effect_get_range(lua_State *L);
static int32 effect_get_count_limit(lua_State *L);
static int32 duel_select_field(lua_State *L);
static int32 duel_get_master_rule(lua_State *L);
static int32 duel_filter_player_effect(lua_State *L);
static int32 duel_read_card(lua_State *L);
static int32 duel_exile(lua_State *L);
static int32 duel_disable_action_check(lua_State *L);
static int32 duel_setmetatable(lua_State *L);
If I code a card against KoishiPRO, can it work on other YGOPROs?
Since KoishiPRO is a direct fork of Mercury233's original YGOPRO repo, and no existing OCGCORE elements get changed, a card coded for KoishiPRO will work on all other YGOPRO branches including YGOPRO2 as long as
- The other client does not modify their OCGCORE.
- You did not use any KoishiPRO exclusive OCGCORE procedure.
Great, so how can I download this?
Due to an agreement between Koishi, we're not publicly releasing the download link. You can join our discord server, and look in channel #download_packs, search for the most recent repack (the most recent repack as of this post is 171129), then search for the newest update of ygopro_222.exe (if there's any), posted either by me or Koishi. unzip the entirety of the repack in a single folder, then if you got an update of ygopro_222.exe, overwrite the original. New updates of the client are released generally once per week with the newest OCGCORE updates by Mercury233, and any possible OCGCORE additions in 222 server.
Due to Koishi releasing the limitations on providing the downloads of KoishiPRO in June 2018, the download process will be detailed in the below post.
Pre-release cards? Beta cards?
You can get those unofficial cards scripts from their respective Github Repos.
Scripts:https://github.com/Fluorohydride/ygopro-pre-script
Updater? How to use?
Starting from late October, KoishiPRO comes with an updater to keep you up-to-date with all cards on our Moon Server. The cards update automatically each day, on 12:00:06 PM Pacific Time. Run the updater and it will automatically download the new or changed files for you.
Downloading KoishiPRO
You can find the download link of KoishiPRO at the below address:
https://github.com/purerosefallen/ygopro/releases
On this page, find the most recent download, then click on the appropriate file, based on your operating system.
for most people, you'll be looking at KoishiPro-date.7z
Download and unzip, you can try running ygopro.exe, it should work without issues.
if you cannot run it (i.e. a blank screen appears then close out), refer to the below FAQs.
Downloading/Updating YGOCC Custom Card Repo
The above download contains only the KoishiPRO executable and all OCG/TCG card data, to play on our server using our custom cards, you need to download a copy of our Custom Card Repo.
just download the update.zip attached in this post and unzip the update folder at the root of the KoishiPRO folder (if done right, you shall see the update folder alongside folders such like deck, pics, etc.)
Then, going into update folder and run update.exe, it will download all the files needed for custom cards.
Wait until you see the message:
UPDATE COMPLETE!! You can safely close this window, press any key to quit.
Press Any Key to continue ... ...
You can safely close the window, the Download / Upgrade of the YGOCC Card Repo has been completed.
Updating KoishiPRO (This includes new OCG/TCG cards)
Run update.exe / update-without-sound.bat within the update-KoishiPRO folder.
Since the updater program is the same, refer to the above.
(NOTE: Updating will overwrite the files in Texture folder, please make a backup if you added/modified skin or texture files.)
FAQ
Q: I run ygopro.exe, however, the program closes on its own...
A: This could be of multiple issues, it's most likely a font problem due to YGOPRO uses a specific font (SimHei.ttf, one of the Chinese system fonts that is built in Windows from 7 and up.) to display the texts, if your computer lacks this file, issues will happen.
To solve the font issue, create a font folder at the root of the KoishiPRO folder (i.e. alongside deck, pics, etc), then place a font file in it. I recommend this, since it supports all kinds of languages (most importantly, symbols such like ★ ☆ ● ↑ ↓ ← →, etc, which are used when displaying card details) and is completely free to use:
SourceHanSansCN-Regular.otf
(You can grab this font file in our discord server.)
then, open system_user.conf with notepad, find the line that starts with textfont, change its values accordingly, for example:
textfont = font/SourceHanSansCN-Regular.otf 14
the number that's after the font name is the size of the displayed font.
Q: The above problem still persists...
A: Try changing the value of use_d3d from 1 to 0, or vice versa. If you still cannot open ygopro.exe, contact Koishi in the ygocc server.
Q: The interface and cards are all in Chinese!
A: Since KoishiPRO automatically detects your system language when loading the databases, this is very unlikely to happen, but if in case you find the client is in a language you cannot understand, go to Deck Edit (4th option in the main menu), then Settings Tab (The last tab under the card pic), then change the language from the dropdown.
If, in the rarest cases, there's nothing in the dropdown, check if there's an en-US folder and if all contents (there should be 3 files) in that folder are intact, if not, you can download them from this repo:
https://github.com/purerosefallen/ygopro-database
Q: My antivirus is flagging Bot.exe / Windbot.exe / Update.exe as Trojans!
Bot.exe and Windbot.exe are the files used to make Local AI work.
The Local AI works by opening a local server on your machine, which, coincidently, is also most Trojans would be doing.
Since each version comes with a newly compiled Windbot instance, it's not uncommon for Antivirus software to just flag them as potential trojans due to its nature.
A similar problem would also cause the antivirus to flag update.exe as a Trojan, due to it being a downloader. However, this should be rarely seen since update.exe are compiled some time ago and most antivirus knows that it's a good file.
If you don't trust those files, you can check their original source codes in the above repo:
Windbot: https://github.com/purerosefallen/windbot
Updater: https://github.com/purerosefallen/update