Script Logger V2 Arma Reforger Mod

ScriptLogger Shared named-logger library for Arma Reforger by ForgedInFire. NAMED LOGGER API Request a logger by name. GetLogger() creates it on first use and returns the same instance on subsequent requests. FiF_SL_Logger logger = FiF_SL_SLogger.GetLogger("RUPV2"); logger.Info("Player rank loaded", "RUPV2_RankStorage", "LoadRank"); logger.Error("Unable to load rank", "RUPV2_RankStorage", "LoadRank"); No configuration prefab, component, or world entity is required. LOGGER SETTINGS Each logger begins with the ScriptLogger defaults. ConsoleEnabled Default: true Route accepted entries to engine Print. DebugEnabled Default: false Allow DEBUG, VERBOSE, and SPAM messages. MinimumLevel Default: NORMAL Minimum accepted severity. RetentionLines Default: 10000 Secondary-log retention. LoggerLogEnabled Default: false Enable secondary-log output. LoggerLogPath Default: empty When secondary logging is enabled, an empty path derives: FiF_Logs/<logger name>.log Configure a logger with typed setters: logger.SetConsoleEnabled(false); logger.SetDebugEnabled(true); logger.SetMinimumLevel(LogLevel.DEBUG); logger.SetRetentionLines(5000); logger.SetLoggerLogEnabled(true); logger.SetLoggerLogPath("FiF_Logs/RUPV2.log"); BULK OVERRIDES Settings may also be supplied using FiF_SL_Overrides: FiF_SL_Overrides overrides = new FiF_SL_Overrides(); overrides.Insert("ConsoleEnabled", "false"); overrides.Insert("DebugEnabled", "true"); overrides.Insert("MinimumLevel", "DEBUG"); overrides.Insert("RetentionLines", "1000"); overrides.Insert("LoggerLogEnabled", "true"); overrides.Insert("LoggerLogPath", "FiF_Logs/RUPV2.log"); FiF_SL_Logger logger = FiF_SL_SLogger.GetLogger("RUPV2", overrides); MinimumLevel accepts: SPAM VERBOSE DEBUG NORMAL WARNING ERROR FATAL Overrides may also be applied with: logger.SetOverrides(overrides); SETTINGS AND OVERRIDES Inspect configuration with: logger.GetSettings(); logger.GetDefaults(); logger.GetOverrides(); GetOverrides() returns settings that currently differ from the ScriptLogger defaults. Restore one setting or all settings: logger.ResetSetting("MinimumLevel"); logger.ResetSettings(); LOG LEVELS logger.Spam("message"); logger.Verbose("message"); logger.Debug("message"); logger.Info("message"); logger.Warning("message"); logger.Error("message"); logger.Fatal("message"); DebugEnabled controls SPAM, VERBOSE, and DEBUG eligibility. MinimumLevel is then applied to accepted messages. Workbench may filter lower-severity console entries even when ScriptLogger accepts and writes them to file. MASTER LOG Every accepted message is always written to: $profile:FiF_Logs/ScriptLogger.log The master log path and retention are controlled internally and cannot be disabled by individual loggers. Example: 2026-09-23 10:05:58 [DEBUG] [RUPV2] RankStorage::LoadRank::Player rank loaded SECONDARY LOGS A logger may additionally write to its own secondary log: logger.SetLoggerLogPath("FiF_Logs/RUPV2.log"); logger.SetLoggerLogEnabled(true); The message is then written to both the master and secondary logs. Multiple named loggers may share a secondary file while retaining their logger identities. FiF_SL_Logger input = FiF_SL_SLogger.GetLogger("MyMod.Input"); FiF_SL_Logger output = FiF_SL_SLogger.GetLogger("MyMod.Output"); input.SetLoggerLogPath("FiF_Logs/MyMod_IO.log"); output.SetLoggerLogPath("FiF_Logs/MyMod_IO.log"); input.SetLoggerLogEnabled(true); output.SetLoggerLogEnabled(true); FILE HANDLING Secondary paths are relative to $profile:. ScriptLogger handles retention, temporary-file replacement, backup protection, and file-write failures internally. AUTHOR Author: ForgedInFire Contact: forgedinfire@drawingonhumanity.com