This is the source code of a .NET Framework library written in C#. It is a RocketMod plugin for Unturned 3.24.x+ servers that persists basic player information in a MySQL database.
TPlayerDatabase is a lightweight data-collection plugin that tracks player identity across sessions. Whenever a player joins, the plugin records their Steam ID, Steam display name, in-game character name, and the timestamp of their last login.
- Player Tracking -- Records each player's Steam ID, Steam display name, character name, and last login time.
- Automatic Updates -- Detects character name changes on reconnect and updates the database record accordingly.
- MySQL Storage -- Persists all data in a MySQL database for reliable, server-side storage.
- Async & Thread-Safe -- All database operations run asynchronously on background threads with per-player locking to prevent race conditions.
- Graceful Error Handling -- Automatically unloads the plugin if the database connection fails, preventing log spam and server instability.
- Unturned 3.24.x or later
- RocketMod installed on the server
- Download the latest release and its libraries from the Releases page.
- Place
TPlayerDatabase.dllinto your server'sRocket/Plugins/directory. - Extract the libraries archive into
Rocket/Librariesdirectory. - Start or restart the server. The plugin will generate a default YAML configuration file on first load.
- Edit the configuration file to your liking, then reload the plugin or restart the server.
- .NET Framework 4.8 SDK / targeting pack
- Clone the repository:
git clone https://github.com/TavstalDev/TPlayerDatabase.git - Open
TPlayerDatabase.slnin your IDE. - Build the project:
dotnet build -c Release - The output DLL will be at
TPlayerDatabase/bin/Release/net48/TPlayerDatabase.dll.
This project is licensed under the GNU General Public License v3.0. See the LICENSE file for more details.
For issues or feature requests, please use the GitHub issue tracker.