Jinsoul Guide

This guide was adapted from the guide in the official Jinsoul support server by OldWhiskeyGuy#7353 on Discord and from the official guide by Robic, Jinsoul's developer. All credit goes to them.

## Cards

Card format is based off of the SuperStar rhythm game series by DalcomSoft. Each card has a set of information associated with it.

* Group and Idol

* Card theme
	+ Group can have several themes in Jinsoul.
* Code
	+ This code is unique to each individual card, and is used for upgrading, trading, and selling.
* Card rank
	+ There are five ranks of cards in the game; C, B, A, S, and R. C through S rank cards each use a scale of one to five stars to determine level, while R rank cards have a number from 1 to 99 associated with their strength.
* Skill level
	+ Every card has a Dance, Rap or Vocal skill. The type cannot be changed and is predetermined for every idol. The values can be increased with upgrades and dungeons. Skills are used to battle bosses in dungeons. Specific ranks can only reach certain stat value:
		- R: 2000
		- S: 350
		- A: 250
		- B: 200
		- C: 150
* IV
	+ IV ranges from 1-10 and determines how much stats a card gains during upgrade. An IV 1 card will gain one stat point per upgrade, while an IV 10 card will gain 10 points per upgrade. Because of this, higher IV cards are preferred, with IV 10 being considered most desirable.

You can get more cards from drops, daily and weekly instances, and dungeons. You can also buy them on the market for fish (currency) that you obtain from dungeons or trading.

### Upgrades

Cards can be upgraded in Jinsoul. To do this, use the command !upgrade, followed by the card you want to upgrade, and finally the card(s) that you want to use to upgrade. Cards used for upgrading will be consumed and lost, regardless of the upgrade's success. An example of an upgrade command is shown below.

```
!upgrade SQYQ 1234 UPGRD

```
A successful upgrade will increase a card from rank C to S by one star; after five stars is reached, the next successful upgrade will put the card in the next highest tier. R rank cards will increase by one level until R99 is reached, at which point the card is fully maxed out and cannot be upgraded anymore.

When used to upgrade other cards, each rank has a predetermined level of likelihood to successfully cause an upgrade. This depends on the rank of the card being upgraded as well as the card being consumed in the upgrade.

* Cards of the same rank will have a 75% chance of success.
* Cards below the rank of the upgraded card will have a ***reduced chance of 25% per rank***, with the minimum being a 1% level of success.
	+ If a C rank card is used to upgrade a B rank card, the C rank card will have a 50% chance of success.
	+ However, if a C rank card is used to upgrade a S rank card, the C rank card will only have a 1% chance of success.
	+ When upgrading an R rank card, a C rank card will have a 1% chance of success, while a B rank card will have a 5% chance of success. All other ranks will follow standard chances.
* Cards above the rank of the upgraded card will have an ***increased chance of 25% per rank***, with a max of a 100% guarantee of success.
	+ If an R rank card is used to upgrade anything below another R rank card, there will always be a guaranteed upgrade.
* Using a card from the same group as the one being upgraded will ***always give a 25% increase to the level of success***, regardless of the rank of the card being used or the card being upgraded.
	+ This bonus also extends to groups and their specific subunits, as listed below.
		- NCT, NCT 127, NCT Dream, NCT U, and WayV
		- Red Velvet and Irene & Seulgi
		- VIXX and VIXX LR
		- WJSN and WJSN Chocome

## Command Events

There are several events that can be triggered on a by-user basis. These events are *drops,* along with *daily* and *weekly* bonuses.

### Drops

Drops can be triggered with the command !drop. This will prompt three random cards to be "dropped;" these cards can be of any IV level or rank except R, and include all standard card themes plus any current event cards. The user that triggered the drop will have seven seconds to react with either a 1, 2, or 3 emoji to claim the card they want, with the reaction coordinating with the cards from left to right. After either seven seconds or the original user has claimed a card, the drops will open for everyone in the server to choose a card.

There are certain odds of each rank of card or IV being included in a drop; the odds of each theme are equal with the exception of limited event cards, which function independently of regular theme odds.

* Rank Odds
	+ S: 0.1%
	+ A: 5%
	+ B: 40%
	+ C: 55%
* IV Odds
	+ 1-4: 15.9%
	+ 5: 12.7%
	+ 6-7: 8%
	+ 8-9: 3.2%
	+ 10: 1.6%

Players can only drop cards once every 10 minutes, and can collect cards from drops (theirs or otherwise) every 5 minutes.

### Daily and Weekly

Daily and Weekly are two separate command events, controlled by !daily and !weekly respectively. Each event drops a certain number of cards based upon the activity of the player; if the player has used !daily less than seven consecutive days one card will drop, 7-13 consecutive days will drop two cards, and anything over 14 days will drop three cards.

The player's weekly drops are also based upon daily activity, although they do not affect the daily streak. Weekly drops cannot be obtained if the player has not done at least one daily drop in the past week, and reset at midnight on Sundays CET, while daily drops reset 20 hours apart and can be redeemed at any point within a 32 hour period of availability to count for the player's streak. As of May 2, 2021, weekly card ranks and IV levels are much more strongly affected by the player's streak.

#### **Daily Odds**

* Rank Chances
	+ S: 5%
	+ A: 20%
	+ B: 35%
	+ C: 40%
* IV Chances
	+ 1-4: 15.9%
	+ 5: 12.7%
	+ 6-7: 8%
	+ 8-9: 3.2%
	+ 10: 1.6%

#### **Weekly Odds**

* Rank Chances (daily streak 0-49)
	+ R: 5%
	+ S: 40%
	+ A: 55%

Before a daily streak of 50, IV chances are the same as daily drops.

As of May 1, players with a daily streak of 50+ will always receive S or R rank cards (75% chance of an S rank card, 25% for R rank). At a 75+ streak, cards have a 25% chance of being iv 10, while this number increases to 50% for 100+ streaks.

Setting a favorite group and/or card can increase the chances of getting cards you want during daily, weekly, and drop events! Use !favorite set [code] to set a favorite card, or !group set [name] to set a favorite group. Setting a favorite group adds a 10% chance of collecting that group's cards during command events, while setting a favorite card adds a 10% chance of getting that specific member.

## Spawns

Spawns are events in which a card randomly appears in a server every 15 minutes. This event can only happen if spawns are enabled, which requires the server to have at least 69 members. Upon reacting to the message, a player will have a chance to gain the spawned card. They are guaranteed the card if they are the only player to react to the message, but if multiple players do so than the player who receives the card will be randomly selected. A player can only collect a spawned card ever 5 minutes.

## Inventory

Players can see all of the cards they have using !inventory. This will bring up every single card they own, and can be narrowed down using the group, idol, theme, or IV they are looking for after the command.

```
!inventory
!inventory red velvet
!inventory wendy
!inventory red flavor
!inventory wendy - red
!inventory iv 10

```
Note that the search "wendy - red" doesn't contain the full theme name! Themes can be searched by a small sample of the full name instead of the full version, which is handy for themes with long names. It isn't recommended that you do this with themes alone, though, as it can bring up matching themes from every group in the game.

Players can protect cards by adding them to their vault using "!vault add [code]." However, if they want to sell, trade, or gift that card, they must manually remove it using "!vault remove [code]" first.

## Dungeons

Dungeons are minigames in Jinsoul that are accessed through the !dungeon command. Dungeons contain cards of random values, which a player must defeat to gain stat levels on their cards, fish, and even have a chance of gaining a less powerful version of the card they defeated. Dungeons reset at 0:00, 6:00, 12:00, and 18:00 every day, and players can "reroll" (reset and select again) dungeons every four hours.

Players will use !dungeon to "roll" (select the difficulty of) dungeons, upon which the game will randomly select five cards within that difficulty for the player to battle. The player will have to manually use !dungeon after every dungeon to reenter the list of bosses.

There are eight ranks of dungeons: C, B, A, S, R1, R2, R3, and R4. Each level has a different card IV for bosses that increases by one per rank, with C rank bosses having an IV of 7, and R4 rank bosses having an IV of 14, and different rewards for victory.

#### **Dungeon Rewards**

* C
	+ One or two fish
	+ One stat point to the card
	+ Bonus: 8% chance of a C rank card drop
* B
	+ 3-5 fish
	+ One stat point
	+ Bonus: 16% chance of C rank card drop
* A
	+ 6-8 Fish
	+ One stat point
	+ Bonus: 23% chance of B rank card drop
* S
	+ 9-12 Fish
	+ One stat point (90% chance) or two stat points (10%)
	+ Bonus: 39% chance of A rank card drop
* R1
	+ 13-16 Fish
	+ Two stat points (90%) or three stat points (10%)
	+ Bonus: 75% chance of S rank card
* R2
	+ 17-20 Fish
	+ Two stat points (75%) or three stat points (25%)
	+ Bonus: 75% chance of R1 rank card drop
* R3
	+ 25-30 Fish
	+ 2 or 3 stat points (50% each)
	+ Bonus: 75% chance of R1 rank card drop
* R4
	+ 40-50 Fish
	+ 2 stat points (25%) or three stat points (75%)
	+ Bonus: 85% chance of R1 rank card drop

#### **IV Card Drop**

All cards dropped have the same chances of being of a certain IV.

* 1-4: Not Possible
* 5: 27%
* 6: 25%
* 7: 20%
* 8: 15%
* 9: 10%
* 10: 3%

### Raid Teams

A *raid team* is a player's three cards used in dungeons to fight bosses; ideally, these will consist of a player's strongest card in each skill. The raid team is made up of three cards, one with each skill (Rap, Dance, and Vocal). Players can add cards to their raid team using "!raidteam add [code]" or remove old cards using "!raidteam remove [code]," and can view their team by simply using "!raidteam."

## Buying, Selling, and Trading

Jinsoul is a card collecting game, and because of that there are ample options to buy, sell, and trade cards.

### Market

The Market is a place for users to sell and buy cards using fish, the in-game currency of Jinsoul. This currency can be collected through selling or trading cards, or by defeating bosses in dungeons. To access the market, type "!market" followed by the group, IV, idol, or theme you would like to search. These terms can be combined to make more specific searches.

```
!market red velvet
!market wendy
!market red flavor
!market wendy - red
!market iv 10

```
Note that the search "wendy - red" doesn't contain the full theme name! Themes can be searched by a small sample of the full name instead of the full version, which is handy for themes with long names. It isn't recommended that you do this with themes alone, though, as it can bring up matching themes from every group in the game.

### Trading

Players can also trade directly with each other using commands. To do this, one player will send "!offer @user [my card] [your card]," and the other player will have to manually accept or decline.

### Gifting

Players can also use !gift to send trades or even one-sided gifts to each other. To do this, the player will send "!gift @user [card code A] [card code B]..." to send anywhere from 1 to 15 cards to another player. The same thing can be done with fish using "!balance gift @user [amount]."

## Collections

Collections are a feature in Jinsoul that allows players to see their cards of a certain theme. To add or remove a card in a collection, use "!collection add/remove [code]." View collections using "!collection," and view specific themes by using "!collection [artist] - [theme]." Players can view cards missing from collections using "!collection missing [artist] - [theme]" and make collages using "!collection collage [artist] - [theme]." Players can only add one card per idol to a specific theme collection at a time, so if a player wishes to swap cards they will have to manually remove the old card first.

```
!collection
!collection add NAKO
!collection remove YHTLD
!collection hinapia - new start
!collection missing hinapia - new
!collection collage hinapia - new

```
Themes cannot be used alone here, they must be used in conjunction with an artist.

## Commands

The following is a list of all commands in Jinsoul and their purposes.

### Card Commands

* !daily
	+ Drop a daily card. number of cards depends on player streak.
* !drop
	+ Drop three cards, of which the player gets to choose one. cards open up to all players after 7 seconds or the player chooses.
* !view [code]
	+ View a certain card that the player owns.
* !list
	+ Views all groups in the game. use !list [artist] to view all themes for that artist.
* !upgrade [upgrading card] [consumed card]
	+ Used to upgrade cards. the card that is being upgraded must be listed first.
* !weekly
	+ Used for weekly drops. number of cards depends on player's daily streak.

### User Commands

* !collection
	+ Used to show cards added to collections, to add or remove cards from collections, to view missing items in collections, or to make collages of collections. See Collections section for more info.
	+ Can be shortened to !c
* !cooldowns
	+ Used to view a player's "cooldowns" (waiting time) for daily, weekly, and drop events, along with dungeon rerolls, drop claims, and spawn claims.
	+ Can be shortened to !cd
* !favorite
	+ Used to view a player's set favorite card. Use !favorite add [code] to add or change the favorite card.
	+ Can be shortened to !f
* !group
	+ Used to view a player's set favorite group. Use !group add [name] to add or change the favorite group.
	+ Can be shortened to !g
* !inventory
	+ Used to explore a person's inventory, along with modifiers such as group names, idol names, themes, and IV levels.
	+ Can be shortened to !i
* !profile
	+ Used to show a player's profile, which includes their number of cards, balance of fish, and favorite group and card.

### Stonks Commands

* !balance
	+ Used to view a player's balance. Can be used as !balance gift [@player] to send fish to other players.
	+ Can be shortened to !bal
* !gift
	+ Used as !gift [@player] [card code(s)] to give up to 15 cards to another player.
* !leaderboard
	+ Used to view the players with the most fish in Jinsoul.
* !market
	+ Used with modifiers such as groups, idol names, themes, and IV levels to search cards on sale.
	+ Can be shortened to !m
* !offer
	+ Used as !offer [@player] [your card] [their card] to initiate a trade. The other player must accept the trade.

### Dungeon Commands

* !dungeon
	+ Used to roll dungeons and enter the dungeon menu. Used as !dungeon reroll to reset the player's dungeons once every four hours.
	+ Can be shortened to !d
* !raidteam
	+ Used to view a player's raid team, can be used as !raidteam [add/remove] [code] to add or remove cards from the player's raid team
	+ Can be shortened to !rt

### Tech/Info Commands

* setchannel
	+ A technical command used to set the channel spawns will appear in
* spawns
	+ Used to toggle spawns
* !guide
	+ Used to give information about how to play Jinsoul
* !help
	+ Can be used with another command after to give detailed information about that command or feature
* !invite
	+ Gives access to the link to invite Jinsoul to new server. Invitations are currently closed.
* !prefix
	+ Used to change the prefix (symbol before commands) in Jinsoul. The default is an exclamation mark (!)
* !rules
	+ Used to show the rules for Jinsoul