You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+29-11Lines changed: 29 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,10 +3,10 @@
3
3
4
4
---
5
5
6
-
## 📊 Overview
6
+
## Overview
7
7
Player Stats is a plugin that tracks various player statistics and provides ranking for both PVP and PVE gameplay. The plugin supports permission-based rewards and includes an optional visual UI.
8
8
9
-
## ✨ Features
9
+
## Features
10
10
| Feature | Description |
11
11
|---------|-------------|
12
12
| 💾 Data Storage | Store player stats in a JSON file or MySQL database |
@@ -16,7 +16,7 @@ Player Stats is a plugin that tracks various player statistics and provides rank
| 🖥️ User Interface | Optional UI for viewing PVP/PVE stats |
18
18
19
-
## 📊 Tracked Statistics
19
+
## Tracked Statistics
20
20
21
21
### PVP Stats
22
22
- Kills
@@ -34,19 +34,34 @@ Player Stats is a plugin that tracks various player statistics and provides rank
34
34
35
35
---
36
36
37
-
## 🔧 Configuration Options
37
+
## Configuration Options
38
38
39
39
### Stats Mode (`<StatsMode>Both</StatsMode>`)
40
40
41
-
|Mode| Description |
41
+
|StatsMode| Description |
42
42
|------|-------------|
43
43
|`Both`| The `/stats` command displays both PVP and PVE stats, but ranking, rewards and UI are based on PVP stats |
44
44
|`PVP`| The `/stats` command displays only PVP stats, and ranking, rewards and UI are based on PVP stats |
45
45
|`PVE`| The `/stats` command displays only PVE stats, and ranking, rewards and UI are based on PVE stats |
46
46
47
+
### Other Options
48
+
49
+
The plugin offers several additional options to customize functionality:
50
+
51
+
| Option | Default | Description |
52
+
|--------|---------|-------------|
53
+
|`DatabaseProvider`|`json`| Choose between `json` or `mysql` for data storage |
54
+
|`SaveIntervalSeconds`|`300`| Interval in seconds for saving player stats from memory to the database |
55
+
|`ShowCombinedDeaths`|`true`| When enabled, deaths in statistics count both PVE (zombies, animals, suicides) and PVP deaths. When disabled, only deaths matching the current `StatsMode` are counted |
56
+
|`EnableUIEffect`|`false`| Activates the optional UI for viewing statistics. Make sure to install the workshop mod to use it |
57
+
|`ShowUIEffectByDefault`|`true`| Whether the UI should be shown by default when players join. Players can toggle it using `/statsui` command |
58
+
|`EnableJoinLeaveMessages`|`true`| Displays messages when players join or leave the server (with their rank if they reached a minimum ranking treshold) |
59
+
|`MinimumRankingTreshold`|`25`| Minimum number of kills required to appear on the ranking |
60
+
|`EnableRewards`|`true`| Activates the permission-based rewards system |
61
+
47
62
---
48
63
49
-
## 🖥️ Workshop Integration (Optional)
64
+
## Workshop (Optional)
50
65
The UI is optional and provides a visual display for PVP stats.
@@ -113,12 +128,12 @@ The UI is optional and provides a visual display for PVP stats.
113
128
114
129
---
115
130
116
-
## 👨💻 Credits
131
+
## Credits
117
132
UI made by **💪 Soer (Unbeaten)**. He also sponsored the creation of this plugin 💸.
118
133
119
134
---
120
135
121
-
## ❓ Frequently Asked Questions
136
+
## Frequently Asked Questions
122
137
123
138
1.**How do I enable the UI?**
124
139
Set `<EnableUIEffect>true</EnableUIEffect>` in the configuration and subscribe to the workshop item.
@@ -129,6 +144,9 @@ UI made by **💪 Soer (Unbeaten)**. He also sponsored the creation of this plug
129
144
3.**How do I customize rewards?**
130
145
Edit the `<Rewards>` section in the configuration file with your desired thresholds and permission groups.
131
146
147
+
4.**How can I create a custom UI?**
148
+
You can download the `statsui.unitypackage` from the [All versions](versions) page and import it into your Unity project. Then, customize the UI as needed and reupload it to the workshop.
149
+
132
150
---
133
151
134
152
*For support, bug reports, or feature requests, please write on our forum or join our Discord.*
0 commit comments