Class TwoDimArray

Namespace: Anvil.API

Assembly: NWN.Anvil.dll

A two dimensional array data resource.

public class TwoDimArray

Inheritance: object

TwoDimArray

Derived: TwoDimArray<T>

Inherited Members: object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

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 2da.

Columns: Gets the column labels/names for this 2da.

RowCount: Gets the number of rows in this 2da.

Methods

GetBool(int, int): Gets the specified boolean value.

GetBool(int, string): Gets the specified boolean value.

GetColumnIndex(string): Gets the index of the column with the specified name/label.

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

GetEnum<T>(int, string): Gets the specified StrRef value.

GetFloat(int, int): Gets the specified float value.

GetFloat(int, string): Gets the specified float value.

GetInt(int, int): Gets the specified int value.

GetInt(int, string): Gets the specified int value.

GetStrRef(int, int): Gets the specified StrRef value.

GetStrRef(int, string): Gets the specified StrRef value.

GetString(int, int): Gets the specified string value.

GetString(int, string): Gets the specified string value.

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

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

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

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

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

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

Table of Contents

Class TwoDimArray

Examples

Properties

Methods