Installation Instructions

1. Install MelonLoader
2. Run Game and close it when you get to T-Pose
3. Drop "Mods" Folder in to Rumble Source Directory
4. Run the Game.

How to Use

• If you have other mods installed that use this mod, they will store their statistics in their respective folders inside your UserData folder in the root game directory.
• If you don't have any mods installed that use this mod, it will store some base statistics that come with the mod.

Have fun!

Documentation

StatsMod Class

Properties

• ModName: Name of the mod for indentifying and organizing data files.
• storeEntryTime: Boolean value to include timestamps for each entry.

Methods

1. InitializeStatFile
   • Creates a new CSV file with specified columns.
   • Parameters:
     • fileName: Name of the CSV file.
     • columns: Dictionary (string, type) of column names and their data types.
   • Example:

     var columns = new Dictionary<string, Type>
     {
         { "Player Name", typeof(string) },
         { "Battle Points", typeof(int) }
     };
     mod.InitializeStatFile("PlayerStats", columns);
     

2. StatFileExists
   • Checks if a specific stat file exists.
   • Returns: true if the file exists, otherwise false.
3. GetAllRows
   • Reads all rows from a CSV file.
   • Parameters:
     • csvFileName: The name of the file to read.
     • skipHeader: Boolean value to skip the header row.
   • Returns: A list of string arrays representing rows.
4. AddStatRow
   • Adds a new row to the CSV file.
   • Parameters:
     • values: Array of object values for the row. Make sure they match the column types defined in the CSV file, in the same order, and the same amount of values.
     • csvFileName: The name of the file to add the row to.
   • Example:

     mod.AddStatRow(new object[] {
         "Player1",
         100
     }, "PlayerStats");
     

5. FormatValue
   • Converts a value to a CSV-compatible string format. This is automatically done by the AddStatRow method.

Main Class

Methods

1. RegisterCSVFile
   • Registers a CSV file for ModUI toggles
   • Parameters:
     • csvFileName: The name of the CSV file to register.
2. RegisterMod
   • Registers a mod for ModUI toggles
   • Parameters:
     • mod: The mod to register (of type StatsMod).

Example Mod

using MelonLoader;
using RumbleStats;
//other references...

namespace MyMod
{
    public class Main : MelonMod
    {
        StatsMod mod  = new StatsMod();
    
        public override void OnLateInitializeMelon()
        {
            mod.ModName = "MyModName";
            mod.storeEntryTime = true; //Stores entry timestamps when calling AddStatRow
            mod.storeEntryTime = false; //Does not store entry timestamps when calling AddStatRow
        
            var columns = new Dictionary<string, Type>
            {
                { "Column1Name", typeof(string) },
                { "Column2Name", typeof(int) },
                { "Column3Name", typeof(bool) },
                //etc...
            };
            
            mod.InitializeStatFile("CSVFileName", columns);
            RumbleStats.Main.instance.RegisterCSVFile("CSVFileName");

            RumbleStats.Main.instance.RegisterMod(mod);
            //Do this for each CSV file you want to store stats for...
        }
    
        private void SomeRandomMethod()
        {
            mod.AddStatRow(new object[]
            {
                "Stat1",
                1000101,
                true,
                //etc, same as the columns provided in the InitializeStatFile method...
            }, "CSVFileName");

            var rows = mod.GetAllRows("CSVFileName", skipHeader: true);
            foreach (var row in rows)
            {
                MelonLogger.Msg(string.Join(", ", row));
            }
        }
    }
}

Version 1.0.4

• Added a one second delay to adding moves to the csv file, which can cause lag right before a round ends, preventing the opponent from being able to block it sometimes.

Version 1.0.3

• Moves are now only written at the end of a round, hopefully reducing lag during gameplay.
• Replaced exceptions with error logging.
• Added GetAggregateData, RemoveRows, RemoveRow, and WriteAllRows

Version 1.0.2

• Fixed MatchData round results not getting stored correctly (You could win 3 times or win twice and then lose?)
• Moved documentation from README.md to the Wiki on thunderstore.

Version 1.0.1

• Added a Debug mode to the StatsMod class.
• Fixed some csv files not being stored to.

Version 1.0.0

• Created

Help And Other Resources

Get help and find other resources in the Modding Discord: https://discord.gg/fsbcnZgzfa