Plan/documentation/Configuration.md
2017-05-12 13:18:02 +03:00

6.5 KiB

Player Analytics

Configuration

This page is an in depth documentation on what each Setting does in the config.

Settings

Basic settings

Config.Point Version introduced Type Default Description
Debug 3.0.0 boolean false Enables debug messages on console.
Locale 2.5.0 String default Two letter Locale combination. Can be set to one of the Available locales. If a faulty combination is used, default locale will be used. Available locales
UseTextUI 3.0.0 boolean false Redirects /plan inspect and /plan analyze commands to display same messages as /plan qinspect & /plan qanalyze
Data.GatherLocations 2.2.0 boolean true Enables PlanPlayerMoveEventListener

Analysis settings

Config.Point Version introduced Type Default Description
LogProgressOnConsole 2.4.0 boolean false More detailed analysis progress to console.
NotifyWhenFinished 3.0.0 boolean true Enables "Analysis Complete"-message will be shown on the console after analysis is complete.
MinutesPlayedUntilConsidiredActive 2.0.0 Integer 10 This setting affects how the Analysis treats player's activity. Whether or not a player is active is determined with 3 values: Last Login, Playtime and Login Times. If the player has logged in in the last 2 weeks, has playtime higher than in the config, and has logged in 3 times, the player is considered active. Otherwise the player is counted as inactive.

Cache settings

Config.Point Version introduced Type Default Description
Processing.GetLimit 2.8.0 Integer 2000 Changes the queue size for database get actions. If queue runs out notification is given on console.
Processing.SaveLimit 2.8.0 Integer 1000 Changes the queue size for database save actions. If queue runs out notification is given on console.
Processing.ClearLimit 2.8.0 Integer 1000 Changes the queue size for clearing datacache. If queue runs out notification is given on console.
AnalysisCache.RefreshAnalysisCacheOnEnable 2.?.0 boolean true Enables Analysis refresh 30 seconds after boot/reload
AnalysisCache.RefreshEveryXMinutes 2.4.0 Integer  -1 Enables periodic Analysis refresh, -1 to disable
DataCache.SaveEveryXMinutes 2.0.0 Integer 2 Determines how often cache is saved to the Database.
DataCache.ClearCacheEveryXSaves 2.0.0 Integer 5 Determines how often cache clear attempt is made. This is done in case some data is left lingering even after the player has been gone for a long time.

WebServer settings

Config.Point Version introduced Type Default Description
Enabled 2.1.0 boolean true Enables the Webserver
Port 2.0.0 Integer  8804 Port of the Webserver
InternalIP 3.0.0 String 0.0.0.0 Internal InetAddress to start the WebSocketServer on. Code enabling the socket server
ShowAlternativeServerIP 2.0.0 boolean false Enables the use of the link below in the inspect and analyze commands.
AlternativeIP 2.0.0 String your.ip.here:%port% Address to use as link in inspect and analyze commands if setting above is enabled. %port% will be replaced with the Port automatically. If you have port-forwarded an alternate address to the webserver port, %port% is not required.
Security.DisplayIPsAndUUIDs 2.5.0 boolean true Toggles visibility of UUIDs and IPs on player Inspect page.
Security.AddressSecurityCode 2.5.0 String bAkEd This string is added to the url so that outsiders can not access the /server and /player/<playername> pages just by knowing your IP and that your server uses Plan. Example: bAkEd -> localhost:8804/bAkEd/server

Customization settings

Config.Point Version introduced Type Default Description
Colors.Commands 2.1.0 String Color codes used with the /plan commands.
Colors.HTML 2.1.0 String   These HTML Color codes are used when generating the Html pages. Use without the # (hashtag)
DemographicsTriggers.Trigger 2.1.0 String An attempt to gather info is only made if message contains one of these words.
DemographicsTriggers.IgnoreWhen 2.1.0 String If an attempt is made and message contains one of these words, the info is disregarded.
Plugins.Factions.HideFactions 3.1.0 String list - ExampleFaction Add a list of Faction names you don't want to show up on the Analysis page.
Plugins.Towny.HideTowns 3.1.0 String list - ExampleTown Add a list of Town names you don't want to show up on the Analysis page.

Database settings

Config.Point Version introduced Type Default Description
database.type 2.0.0 String sqlite  Determines the type of database the plugin will use. sqLite - sqLite database file will be created. MySQL - MySQL settings are used.
mysql.host  2.0.0  String  localhost  IP of the MySQL-database
mysql.port 2.0.0 Integer 3306 Port of the MySQL-database
mysql.user 2.0.0 String root MySQL user
mysql.password 2.0.0 String minecraft  User's password
mysql.database  2.0.0 String  Plan  Name of the database that has already been created. Please note, that you have to create this database in your mysql solution (eg. MariaDB)!

End

If you don't see explanation for a config point or need help setting up the plugin, don't hesitate to ask for help! :)