Plan | Player Analytics

Plan | Player Analytics 5.6 build 2820

5.1 build 791 - Change log
This update brings lots of improvements made by contributors, as well as bugfixes.
Special thanks to Vankka, FluxCapacitor2 & antonok-edm for their contributions!

Thank you for the numerous answers to the feedback survey. I have looked at the 54 answers and did some analysis of them on discord.
You can also find answers to some of the questions posted on the survey here #1624.

Change log
Website

  • Added things that stop search engine spiders like Google from crawling the Plan website. This should stop your Plan appearing on google search in the future. (thanks FluxCapacitor2) Please note that exported files don't contain robots.txt.
  • FullCalendar updated to v5 and the style to go with it (thanks FluxCapacitor2)
  • Browser back button goes to the previous page instead of the previous tab. Reduces the amount of back button clicks by a ton (thanks FluxCapacitor2)
  • Night mode can now be set as default in theme.yml by setting DefaultColor to night (thanks FluxCapacitor2)
  • Fixed DefaultColor setting in theme.yml. (thanks FluxCapacitor2) Note: If you missed 4.x.x to 5.0 migration the panel might appear light green after the update instead of Plan green
  • Removed special error case for Brave browser adblock as /v1/performance endpoint should no longer be blocked by adblockers. (easylist was updated) (thanks antonok-edm)
  • Removed scroll to top button (it was broken)
Commands
  • Fixed db move subcommand clearing the source database and failing to move data
  • Register command now says "Registration failed, try again (code expires in 15 minutes)" instead of "User not found" when the register code is not found.
Webserver
  • Webserver no longer displays warnings on console related to 204 HTTP response (thanks FluxCapacitor2)
  • Future proofed cookies by adding SameSite=Lax; Secure; to them as Firefox was warning that they might break soon.
Export
  • Fixed player links on exported server pages on networks going to /server/player instead of /player
Extensions
  • Added Floodgate / geysermc extension (thanks Vankka)
  • Added mcMMO extension (supports the new mcMMO and mcMMO classic) (thanks Vankka)
  • Fixed FactionsUUID extension throwing an error with SaberFactions
5.1 build 770 - Command Rework +hotfix for b768
Hotfix for build 768
  • Fixed NoClassDefFoundError: TextStringBuilder
[IMG]

This update contains reworked command system and permissions.

Special thanks to Shadowhackercz and Vankka for their contributions to this update.

If you would like to affect Plan development priorities, fulfill this survey. It might take around 5-10 minutes.
https://forms.gle/w9ZniR8vfe1U1aHm6

Major changes
Command system rewrite

  • All platforms now use same permissions for same commands
  • All platforms now have all of the commands that have been available
  • When using commands as a player the help menu now has more information on hover
  • Actions that remove data now ask for confirmation instead of -a argument
  • Some commands that previously did not have a specific permission now have a permission (such as /plan register)
  • /planbungee and /planvelocity now called /planproxy (They still work as aliases though). Another alias /planp
See https://github.com/plan-player-analytics/Plan/wiki/Commands-&-Permissions for updated permission & command information

Website
  • Login page now logs in when Enter is pressed
  • Login page now uses a <button> instead of <a> (might help password managers)
DataExtensions
  • Vankka contributed a FactionsUUID Extension that should support FactionsUUID and forks eg. SaberFactions (and the now dead SavageFactions)
  • EssentialsX Extension no longer stores economy information due to large amount of "Economy lag" messages.
Locale
  • Shadowhackercz contributed a Czech locale, use it by setting locale to CS
  • Lots of the command related messages had to be updated so some messages might be in English because they have not been translated yet.
If you run into any issues, please open a ticket at http://bugs.playeranalytics.net
5.1 build 768 - Command Rework
[IMG]

This update contains reworked command system and permissions.
Special thanks to Shadowhackercz and Vankka for their contributions to this update.

If you would like to affect Plan development priorities, fulfill this survey. It might take around 5-10 minutes.
https://forms.gle/w9ZniR8vfe1U1aHm6

Major changes
Command system rewrite

  • All platforms now use same permissions for same commands
  • All platforms now have all of the commands that have been available
  • When using commands as a player the help menu now has more information on hover
  • Actions that remove data now ask for confirmation instead of -a argument
  • Some commands that previously did not have a specific permission now have a permission (such as /plan register)
  • /planbungee and /planvelocity now called /planproxy (They still work as aliases though). Another alias /planp
See https://github.com/plan-player-analytics/Plan/wiki/Commands-&-Permissions for updated permission & command information

Website
  • Login page now logs in when Enter is pressed
  • Login page now uses a <button> instead of <a> (might help password managers)
DataExtensions
  • Vankka contributed a FactionsUUID Extension that should support FactionsUUID and forks eg. SaberFactions (and the now dead SavageFactions)
  • EssentialsX Extension no longer stores economy information due to large amount of "Economy lag" messages.
Locale
  • Shadowhackercz contributed a Czech locale, use it by setting locale to CS
  • Lots of the command related messages had to be updated so some messages might be in English because they have not been translated yet.
If you run into any issues, please open a ticket at http://bugs.playeranalytics.net
5.1 build 657
This update has taken a while to get together, as I've been busy at work.
None the less, this update contains lots of bugfixes, quite many related to database related exceptions.

Special thanks to Saph1s for their contribution to this update.

Change log
Database

  • New tables are now created with utf8mb4 as the default charset to avoid character encoding errors.
  • Increased deadlock retry attempts to 5, and added the attempt count to the error context.
  • If the database fails to do tasks related to opening (Such as creating tables or patching schema) the plugin now disables.
  • If the database is under heavy load (Visible as "Lock wait timeout exceeded" errors) Plan now attempts to reduce the load for 10 minutes each time. If the reduction is not enough, a pause between transactions is increased.
Bugfixes
  • Fixed JSON serialization of /v1/players endpoint when a datapoint had \ character in it that broke the players table.
  • Fixed IllegalArgumentException fromKey > toKey when adding ping to sessions on /player page (56bb3b3a6a)
  • Fixed incompatibility with AAC due to use of Reflection during class loading (Moved reflection use to enable)
  • Possibly fixed logo appearing stretched on the login page when using Safari
Webserver
  • Webserver is now enabled by default when installing on Sponge servers
Locale
  • Russian Locale was updated by Saph1s
Error instructions ('What to do')
  • If character encoding is wrong in the database the user is instructed how to convert the charset of their MySQL.
  • If MySQL user is missing privileges, the user is instructed to give privileges to the user (Usually REFERENCES privilege is missing).
  • If SQLite has corrupted, the user is given instructions to restore the database, and a link to repair article.
5.1 build 624 - Hotfix

Bugfixes
Fixed an infinite loop in the error handling code when an Exception had a cause (most exceptions)

There was an infinite loop in the error handling code that has been causing high CPU usage and OutOfMemory crashes.
The loop prevented the actual exception from being logged, and was a very dumb mistake in the code, that is easy to miss.
I should have originally written some unit tests, but at least they are here now, and the error handling code is confirmed to work properly.
5.1 build 615
This build contains one new feature (IP whitelist) and bugfixes.
Special thanks to Elguerrero & MastoryMd5 for their contributions to this update

Change log
Commands

  • Fixed permission check issue with /plan unregister that allowed anyone to unregister any user by if they knew their username.
  • Fixed these commands from executing database queries on server thread:
    • /plan players
    • /plan network
    • /plan register
    • /plan manage raw
  • Fixed /plan inspect throwing an NPE when a player tried to view someone elses profile without 'plan.inspect.other' permisison
Error Handling
  • Crash due to OutOfMemoryException should now be resolved (The error handling should no longer consume so much memory)
Webserver
Added IP Whitelist

Config now contains Webserver.Security.IP_Whitelist and Webserver.Security.IP_Whitelist.Whitelist settings for whitelisting IP addresses that can access the webserver.

  • The whitelist is disabled by default
  • Default whitelist has IP addresses for local machine
  • When enabled all requests from non-whitelisted IPs will be forbidden (403)
  • Denied attempts are logged.
    [IMG]
Database
  • MySQL Launch Options setting now has &serverTimezone=UTC by default (not added to existing settings automatically)
Locale
  • Spanish locale updated by Elguerrero
  • Italian locale updated by MastoryMd5
Placeholders
  • Fixed an NPE when a plugin gave PlaceholderAPI a null Player that was passed to Plan.
5.1 build 600
This update has some bugfixes in it, and adds a deprecation warning for H2.
Special thanks to enterih & hallo1142 for their contributions to this update.
Changes
Database
  • Added a warning for h2 users: h2 will be deprecated in 5.2 See issue #1472
    • Added user and password settings for H2 that are separate from MySQL's. Because the old versions use same user and password as MySQL, you might need to copy the user and pass field over if using h2.
    • Fixed Moving data from H2 to MySQL.
  • MySQL connection improvements
    • Possibly fixed 'unknown timezone' error when connecting
    • Possibly fixed Plan not using the MySQL driver included inside Plan.jar
Webserver
  • Made logout links relative (Fixes logout for some subdirectory reverse-proxy setups)
  • Made /login?from=<link> link relative (Fixes login redirect for some subdirectory reverse-proxy setups)
Placeholders
  • Added %plan_sessions_unique_players_today% placeholder: Shows unique players for current day (based on timezone) while plan_sessions_unique_players_day shows last 24h
Errors
  • Fixed high CPU usage when an Extension ran into an exception
    • Extensions service no longer attempts again when an extension method fails.
    • Stacktrace logger duplicate line finding optimized to not use HashSet
Locale
  • Deutsch locale updated by enterih and hallo1142
  • Like
Reactions: revpixel
Change log 5.1 build 586

Here is an update with some improvements.

Special thanks to all contributors to this update; Fur_xia (Updates to Chinese locale), hallo1142 (Updates to Deutsch locale), itaquito (Updates to Spanish locale) Karlatemp (Bugfixes related to locale + async update check)

Change log
Website

  • Added a 'Hour by Hour' graph similar to 'Day by Day' graph to server and network pages. It displays hourly new players and unique players for the last 7 days.
Error handling
  • Error handling was rewritten to address the issue of large error log files. Now each exception is assigned an unique hash to avoid duplicates of same exception being logged.
    [IMG]
    • Error context was added so that it is easier to solve issues
    • The context can also include "What to do" instructions to the user in case they can fix the issue themselves, in cases like File permission errors.
    • Up to 5 contexts are logged in order to avoid these log files from growing endlessly.
    • Error stacktraces are no longer logged to console to avoid console logs becoming large.
    • Default log deletion setting was reverted back to 7 days
  • Extension method disabling (if a method throws an exception) should now work properly
Locale
  • Chinese locale was updated by Fur_xia and Karlatemp
  • Deutsch locale was updated by hallo1142
  • Spanish locale was updated by itaquito
  • Some pages erroring when using a locale were fixed by Karlatemp
  • Some links getting translated was fixed by Karlatemp
Other
  • Update check is now performed asynchronously on enable (by Karlatemp)
  • A typo in a comment in ServerInfoFile.yml was fixed by aimorris
  • Registration information now expires after 15 minutes (Fixes a memory leak)
Change log 5.1 build 563

This update contains bugfixes.
Special thanks to yukieiji, Saph1s & shaokeyibb for their contributions to this update.

Changes
Activity Index

  • Fixed activity index inconsistencies between player and server/network/players pages. The inconsistencies were due to the SQL ignoring weeks with no playtime, leading to higher activity index than supposed to. The issue was not caught earlier due to improper unit testing, but now the consistency is guaranteed with randomized data in the tests.
Website
  • Passwords that include characters &, = or ? can be used again
  • Login cookies now expire appropriately in the backend (Fixes a small memory leak)
  • HEAD http requests now return no request body
  • Network page serverlist scrollbar height increased from 60% to 85%
  • Fixed Ping graph colors not being applied
Locale
  • Added Russian (RU) locale by Saph1s
  • Japanese locale was updated by yukieiji
  • Chinese locale was updated by shaokeyibb
Other
  • A couple users have been reporting large error logs due to "MySQL Connection Pool is closed". As a remedy default log deletion threshold in config was reduced to 2 days. In addition some more timeouts were added to HTTP connections in IP2C geolocator in case the pool close is caused by a socket leak. Issue #1246 to improve error file logging was bumped to high priority.
Login Page - Change log 5.1 build 545

This update changes how login and registration is handled when authentication is enabled (requires https to be set up). In addition, a lot of smaller changes also got into the update.

Special thanks to Catalina (Spanish locale), Creeperface01 (Nukkit PlaceholderAPI support), developStorm (Emphasized online sessions) & qsefthuopq (Chinese locale) for contributions to this update!
:)


Change log
Website

  • Online and offline sessions are now distinguished on the website. Offline sessions have an outline and online sessions are emphasised. Original PR by @developStorm
    [IMG]
  • Fixed several issues with page width and plugin tabs not being accessible when (No data) was in the title.
  • Changed session average to median on player page to reduce impact of quick relogs.
Added Login & Register pages
[IMG]

This was one of the most requested features on the feature backlog and discord.
  • Login is now based on Cookies instead of Basic Authentication.
  • You can now logout without closing the browser using a button on the website.
  • Username and in-game name are no longer required to be the same for viewing own player page (permission level 2) - User needs to be linked instead (see below).
  • Registration page allows registering users without showing the password on the console:
Webuser - Player linking
Webusers and players now link together so that the username doesn't need to be same as their IGN. This is in preparation for an upcoming webuser permission overhaul.
  • PageExtension API now has a new method that returns the username. The existing method now returns the player's name or 'console' the account is tied to.
  • The user is linked upon registration, users can be linked to 'console' as well.
  • Existing users are automatically linked by matching playernames. If no match is found the user is linked to 'console'.
  • Note that this means permission level 2 users can no longer be registered via /plan register [pass] [name] 2. Guide the players to self register via the website instead.
More about why:
The new registration form on the page does not know about permissions of the player, and cannot force users to register with their IGN. The permission levels will be replaced with a permission system in the future, so the best effort solution was to link player uuid to the username when the player uses the register command in game. This allows the users to still access their own player page when they have permission level 2.

Commands
  • Added /plan unregister command for removing linked user
  • Added Active playtime and AFK time to /plan qinspect [player]
Database
  • Optimized query for playerbase activity grouping that is used for the graphs. This should speed up the loading for that graph.
  • Added online session playtime method to CommonQueries in Query API.
  • Fixed an unhandled deadlock error case
Locale
  • Added Spanish (ES) Locale made by Catalina
  • Chinese (CN) Locale updated by qsefthuopq
  • Fixed plugin tabs not being available when some locales were in use
Placeholders
  • Nukkit PlaceholderAPI support added by @Creeperface01
    The Placeholder API code was refactored and improved to support both Nukkit and Bukkit PlaceholderAPI with similar information.
  • Fixed plan_sessions_recent_peak_date placeholder not showing anything
DataExtensions
  • Fixed Litebans loading after Plan on Spigot based servers
  • Fixed Litebans /server table headers not matching content
  • Stoped logging any Buycraft API connection exceptions.
Top