Class TwoDimArrayEntry

Namespace: Anvil.API

Assembly: NWN.Anvil.dll

2da row data.

public sealed class TwoDimArrayEntry

Inheritance: object

TwoDimArrayEntry

Inherited Members: object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Extension Methods: CollectionExtensions.SafeYield<T>(T?)

CollectionExtensions.Yield<T>(T)

Examples

/*
 * Define a implementation to deserialize "xptable.2da", and use this class to determine how much XP is remaining until the next level.
 */

using System.Linq;
using Anvil.API;
using Anvil.API.Events;
using Anvil.Services;

namespace NWN.Anvil.Samples.Services
{
  // This is the deserialization class for this specific type of 2da.
  // We can implement our own helper functions here that operate on the 2da data, and cache it.
  public sealed class ExpTableEntry : ITwoDimArrayEntry
  {
    public int Level { get; private set; }

    public int XP { get; private set; }

    // RowIndex is already populated externally, and we do not need to assign it in InterpretEntry.
    public int RowIndex { get; init; }

    // InterpretEntry is where we populate our entry properties (Level & XP) with the correct data.
    public void InterpretEntry(TwoDimArrayEntry entry)
    {
      Level = entry.GetInt("Level").GetValueOrDefault(0);
      XP = entry.GetInt("XP").GetValueOrDefault(0);
    }
  }

  [ServiceBinding(typeof(XPReportService))]
  public class XPReportService
  {
    // The TwoDimArray is created here.
    // ExpTableEntry (the type above) is passed in as a type parameter to be used to create our row data from exptable.2da.
    private readonly TwoDimArray<ExpTableEntry> expTable = NwGameTables.GetTable<ExpTableEntry>("exptable.2da")!;

    public XPReportService()
    {
      NwModule.Instance.OnClientEnter += OnClientEnter;
    }

    private void OnClientEnter(ModuleEvents.OnClientEnter onClientEnter)
    {
      NwPlayer player = onClientEnter.Player;
      NwCreature? creature = player.ControlledCreature;
      if (creature == null)
      {
        return;
      }

      int nextLevel = GetLevelFromXp(creature.Xp) + 1;
      if (nextLevel > MaxLevel)
      {
        return;
      }

      player.SendServerMessage($"Next level up: {GetXpForLevel(nextLevel) - creature.Xp}");
    }

    /// <summary>
    /// Gets the max possible player level.
    /// </summary>
    public int MaxLevel => expTable[^1].Level;

    /// <summary>
    /// Gets the amount of XP needed for the specified level.
    /// </summary>
    /// <param name="level">The level to lookup.</param>
    public int GetXpForLevel(int level)
    {
      return expTable.First(entry => entry.Level == level).XP;
    }

    /// <summary>
    /// Gets the current level for a player with the specified XP.
    /// </summary>
    /// <param name="xp">The amount of xp.</param>
    public int GetLevelFromXp(int xp)
    {
      int level = 1;
      foreach (ExpTableEntry entry in expTable.Rows)
      {
        if (entry.XP > xp)
        {
          break;
        }

        level = entry.Level;
      }

      return level;
    }
  }
}

Properties

ColumnCount: Gets the number of columns in this row.

Columns: Gets the column labels/names for this row.

Methods

GetBool(int): Gets the specified boolean value.

GetBool(string): Gets the specified boolean value.

GetEnum<T>(int): Gets the specified enum value.

GetEnum<T>(string): Gets the specified enum value.

GetFloat(int): Gets the specified float value.

GetFloat(string): Gets the specified float value.

GetInt(int): Gets the specified int value.

GetInt(string): Gets the specified int value.

GetStrRef(int): Gets the specified StrRef value.

GetStrRef(string): Gets the specified StrRef value.

GetString(int): Gets the specified string value.

GetString(string): Gets the specified string value.

GetTableEntry<T>(int, TwoDimArray<T>): Interprets the specified value as a table index, and returns the associated table entry.

GetTableEntry<T>(string, TwoDimArray<T>): Interprets the specified value as a table index, and returns the associated table entry.

GetTable<T>(int): Interprets the specified value as a table index, and returns the associated table entry.

GetTable<T>(string): Interprets the specified value as a table index, and returns the associated table entry.

GetVector3(int, int, int): Gets the specified Vector3 value.

GetVector3(string, string, string): Gets the specified Vector3 value.

Table of Contents

Class TwoDimArrayEntry

Examples

Properties

Methods