Playtime Logger Mod

Main Purpose

If you've ever needed to monitor player activity on your server, this modification offers the perfect solution. Using Playtime Logger, all player connections and disconnections are automatically recorded via Google Spreadsheets API. It calculates the duration of each gaming session and presents the results in an easily digestible format.

Setup Process

Download and install the mod on your dedicated server. Next, you'll need to configure integration with Google Sheets.

Create a new project through the Google Cloud console, enable the required API. Set up the OAuth consent screen with "External User" type—this allows using the created project in testing mode. It's important to specify the "./auth/spreadsheets" scope.

Download the generated OAuth client data in JSON format, rename the file to "credentials.json", and place it in the "/config/playtimelogger/" folder. After restarting the server, an authorization link will appear in the console—follow it and grant access to your Google project. Playtime Logger uses this data to create and update the spreadsheet.

How to Use

After successful configuration, the mod will begin tracking all players' gaming time. Log into Google Sheets and find the document named "Playtime Logger" (or another name if you changed it in the configuration).

The spreadsheet contains two sheets:

• Total Playtime (default "Total Playtime") - contains a list of unique players who have visited the server since the mod was installed. Shows usernames, UUIDs (for offline mode servers), total playtime for the specified period, and last login date.

• Event Logs (default "Logs") - displays individual player connection and disconnection events. Events are marked with timestamps (in seconds), converted to dates using the =EPOCHTODATE formula, showing session duration in seconds.

License

The project is distributed under the MIT license. Developers are free to study the source code and adapt it for their own purposes.