Developer Portal

English

Korean

English

Korean

Appearance

Arena ​

Once you’ve developed your avatar through the Adventure, you’ll have access to Arena content where you can compete against other players. For more information, see the official documentation.

Round ​

The Arena operates in rounds. Each round lasts for a certain amount of block range and is of one of the following types: seasonal, offseason, or championship.

Join ​

To join a round, use the Nekoyume.Action.JoinArena action.
Each round has a requirement or cost to join, which you can see in the table below.

offseasonseasonchampionshipref
Conditions of entryXXONekoyume.TableData.ArenaSheet.Row.RequiredMedalCount
Entry FeeXOONekoyume.TableData.ArenaSheet.Row.EntranceFee

Conditions of Entry ​

All Championship rounds have their own medal items that must be collected in a certain amount to be eligible to participate in each Championship Round.

Entry Fee ​

To participate in Seasons and Championship rounds, players must pay an entry fee in crystals that is proportional to the level of the participating avatar.

States ​

List of round participants

Participant’s round information

Participant’s score

Battle(ArenaSimulator) ​

The battle uses the Nekoyume.Action.BattleArena action and utilizes the Nekoyume.Arena.ArenaSimulator class to perform the battle.

Tickets ​

Arena tickets are required to fight battles. When you first join a round, you are automatically issued the maximum number of tickets. These tickets are issued anew to participants in that round at each round’s ticket reset cycle.

Buy Tickets

If you run out of tickets, you can purchase them directly to use in battle. There is a maximum amount and price of tickets that can be purchased within a round or ticket reset cycle.

  • Maximum number of tickets you can purchase within a round: Nekoyume.TableData.ArenaSheet.RoundData.MaxPurchaseCount
  • Maximum number of tickets you can purchase within a ticket reset cycle: Nekoyume.TableData.ArenaSheet.RoundData.MaxPurchaseCountWithInterval
  • Ticket purchase price: The purchase price of tickets is determined by a set price for each round and the number of tickets already purchased, as shown in the code below.
    cs
    public FungibleAssetValue GetTicketPrice(
    ArenaSheet.RoundData round,
    int alreadyPurchasedCount)
{
    return GetTickgetPrice(
        round.TicketPrice,
        round.AdditionalTicketPrice,
        alreadyPurchasedCount);
}

public FungibleAssetValue GetTicketPrice(
    decimal price,
    decimal additionalprice,
    int alreadyPurchasedCount)
{
    return price.DivRem(100, out _) +
        additionalprice.DivRem(100, out _) * alreadyPurchasedCount;
}

Battle Target Limit ​

In Arena, there is a limit to who you can battle. This is the score limit, see the code below.

https://github.com/planetarium/lib9c/blob/1.17.3/Lib9c/Action/BattleArena.cs#L274

cs
if (!ArenaHelper.ValidateScoreDifference(
    ArenaHelper.ScoreLimits,
    roundData.ArenaType,
    myArenaScore.Score,
    enemyArenaScore.Score))
{
    // ...
}

In the code above, the ArenaHelper.ValidateScoreDifference method validates the difference between the player’s and enemy’s scores to determine if a battle is possible. It takes in ArenaHelper.ScoreLimits, the arena type from the round data, and the player’s and enemy’s scores as arguments to determine if the score difference is within an acceptable range.

The current score limits are shown in the table below.

attacker score - defender Scoreoffseasonseasonchampionships
minimum score difference--100-100
max score difference-200200

For example, when fighting in the Offseason round, you can challenge anyone to a fight with no score limit, while in the Season or Championship round, if your player avatar has a score of 2000, the opponent you can challenge must have a score between 1900 and 2200.

Rules(different from the Adventure) ​

Unlike the Adventure, Arena battles are fought between players(PvP). The basic battle rules are the same as for the Adventure, but see below for the differences.

Attack skill hits.

Battles in the Arena follow different rules than in Adventure when determining whether an attack skill hits.

  • See also: Adventure > Normal Attack Hits
  • Determines the hit of all attack skills, not just normal attack.
  • Does not take into account the level difference between attacker and defender.
ContentHit or Miss CoverageVariables
ArenaAll attack skills, including normal attackHIT stat
AdventureNormal AttackAvatar Level, HIT Stat

Below is the order in which hits are determined in the Arena.

Rewards ​

Rewards in Arena battles are divided into base rewards and victory rewards.

Base Reward

Base Rewards are determined by Avatar’s Arena Score and range in quantity and type based on Avatar’s level.

Victory Rewards(Medals)

When you win an Arena battle, you receive one medal for the Championship that the round belongs to. For more information, see the Nekoyume.Action.BettleArena action and the Nekoyume.Arena.ArenaHelper.GetMedal method.

Score ​

When you join a round, you start with a score of 1000 points(Nekoyume.Model.Arena.ArenaScore.ArenaScoreDefault).
After that, the score changes through the battle, which is affected by the difference between the attacker’s and defender’s scores. For more information, see the Nekoyume.Action.BettleArena action and the Nekoyume.Arena.ArenaHelper.GetScores method.

Ranking ​

The ranking is determined by the score in the arena. It’s important to note that the ranking is not handled by the blockchain state, but by an external service.

Handle Ties

In Nine Chronicles’ Arena Rankings, ties are broken by bundling them into a lower ranking. For example, if the highest score in a particular round is 2000 points and there are three ties, they will all be treated as third place.

Actions ​

List of actions related to the arena:

  • JoinArena: An action to join a specific round in the Arena.
  • BattleArena: An action in which you battle other avatars in a specific round of the Arena.