{"id":22832905,"url":"https://github.com/brycecanyoncounty/bcc-userlog","last_synced_at":"2025-04-14T04:33:25.218Z","repository":{"id":267188989,"uuid":"891855896","full_name":"BryceCanyonCounty/bcc-userlog","owner":"BryceCanyonCounty","description":"An in-depth and immersive user logging system for tracking player activity","archived":false,"fork":false,"pushed_at":"2025-01-26T01:41:29.000Z","size":48,"stargazers_count":0,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-27T18:22:03.049Z","etag":null,"topics":["cfx","lua","redm"],"latest_commit_sha":null,"homepage":"https://bcc-scripts.com/","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BryceCanyonCounty.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-21T04:28:36.000Z","updated_at":"2025-01-26T01:41:33.000Z","dependencies_parsed_at":"2024-12-08T23:26:55.802Z","dependency_job_id":"82c4b1a7-3b0d-4ad5-b411-d508f97d4b2d","html_url":"https://github.com/BryceCanyonCounty/bcc-userlog","commit_stats":null,"previous_names":["brycecanyoncounty/bcc-userlog"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BryceCanyonCounty%2Fbcc-userlog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BryceCanyonCounty%2Fbcc-userlog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BryceCanyonCounty%2Fbcc-userlog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BryceCanyonCounty%2Fbcc-userlog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BryceCanyonCounty","download_url":"https://codeload.github.com/BryceCanyonCounty/bcc-userlog/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248822558,"owners_count":21167072,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cfx","lua","redm"],"created_at":"2024-12-12T21:10:56.660Z","updated_at":"2025-04-14T04:33:25.197Z","avatar_url":"https://github.com/BryceCanyonCounty.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bcc-userlog\n\n\u003e This script provides an in-depth and immersive user logging system for tracking player activity! With features like total playtime tracking, session times, leaderboards, and more, this script offers a quality experience for both players and administrators.\n\n## Features\n\n- **Playtime Tracking**: Accurately tracks total playtime and session durations for each player.\n- **Leaderboards**: Provides daily, weekly, and monthly leaderboards to showcase the most active players.\n- **Automatic Resets**: Leaderboards reset automatically at the end of each day, week, and month.\n- **Historical Data**: Stores historical leaderboard data for administrative review.\n- **Player Commands**:\n  - `/playtime` – Shows your total accumulated playtime.\n  - `/lastsession` – Displays details about your last game session.\n  - `/leaderboard` – Opens the leaderboard menu to view top players.\n- **Admin Commands**:\n  - `/userlog` – Opens the user log system with detailed player information (admin access only).\n- **Player Details**: Administrators can view detailed information about players, including identifiers, playtime, and account status.\n- **Localization**: Easy to translate with support for multiple languages (English and Romanian included).\n- **Discord Integration**: In-depth webhooks for player connection and disconnection notifications.\n- **Version Checking**: Helps you keep the script up to date with automatic version checks.\n\n## How It Works\n\n- **Playtime Accumulation**: The script tracks when players connect and disconnect, calculating their session durations and adding them to their total playtime.\n- **Leaderboards**: Players' playtimes are compiled into daily, weekly, and monthly leaderboards, which reset automatically at specified intervals.\n- **Data Storage**: All player data and leaderboard histories are stored in the database, ensuring persistence and accuracy.\n- **Admin Interface**: Administrators can access a dedicated menu to view player logs and leaderboard histories, manage player data, and more.\n- **Player Interaction**: Players can use in-game commands to check their own playtime stats and view leaderboards to see how they rank among others.\n\n## How to Install\n\n1. **Download and Install Dependencies**: Ensure all required scripts and dependencies are installed and running.\n2. **Add the Script**: Place the `bcc-userlog` script into your server's resources folder.\n3. **Configure the Script**:\n   - Edit the `config.lua` file to adjust settings such as command names, permissions, and other options.\n   - Customize localization files if needed.\n4. **Start the Script**:\n   - Add `ensure bcc-userlog` to your server configuration file (`server.cfg`).\n5. **Database Setup**:\n   - The script will automatically create the necessary database tables upon first launch.\n   - If required, run any provided SQL files to set up the database schema.\n6. **Restart the Server**: Restart your server to load the new script and apply all changes.\n\n## Commands\n\n- **Player Commands**:\n  - `/playtime` – Displays your total playtime on the server.\n  - `/lastsession` – Shows information about your last game session, including duration.\n  - `/leaderboard` – Opens the leaderboard menu to view daily, weekly, and monthly top players.\n- **Admin Commands** (restricted to authorized staff):\n  - `/userlog` – Accesses the user log system with detailed player information and leaderboard history.\n\n## Requirements\n\n- vorp_core\n- vorp_character\n- feather-menu\n- bcc-utils\n- MySQL database\n\n## Side Notes\n\n- **Feedback and Support**: This is a comprehensive project, and we welcome any suggestions or bug reports. Please share your feedback to help us improve!\n- **Leaderboard History**: Currently, only administrators can view the leaderboard history to monitor player activity over time.\n- **Data Privacy**: Ensure you handle player data responsibly and comply with any applicable privacy regulations.\n- **Customization**: The script is designed to be easily customizable and translatable. Adjust settings and localization files to fit your server's needs.\n- **Join Our Community**: Need assistance or want to stay updated? Join the BCC Discord community: [Discord Link](https://discord.gg/VrZEEpBgZJ)\n\n---\n\nThank you for choosing `bcc-userlog`! We hope this script enhances your server's player engagement and management capabilities.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrycecanyoncounty%2Fbcc-userlog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrycecanyoncounty%2Fbcc-userlog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrycecanyoncounty%2Fbcc-userlog/lists"}