Skip to content

Commit 8bcc7b7

Browse files
improvements to readme
1 parent 03ca485 commit 8bcc7b7

File tree

1 file changed

+29
-11
lines changed

1 file changed

+29
-11
lines changed

README.md

Lines changed: 29 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,10 @@
33
44
---
55

6-
## 📊 Overview
6+
## Overview
77
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.
88

9-
## Features
9+
## Features
1010
| Feature | Description |
1111
|---------|-------------|
1212
| 💾 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
1616
| 🔄 Migration | Automatic migration from Arechi PlayerStats plugin |
1717
| 🖥️ User Interface | Optional UI for viewing PVP/PVE stats |
1818

19-
## 📊 Tracked Statistics
19+
## Tracked Statistics
2020

2121
### PVP Stats
2222
- Kills
@@ -34,19 +34,34 @@ Player Stats is a plugin that tracks various player statistics and provides rank
3434

3535
---
3636

37-
## 🔧 Configuration Options
37+
## Configuration Options
3838

3939
### Stats Mode (`<StatsMode>Both</StatsMode>`)
4040

41-
| Mode | Description |
41+
| StatsMode | Description |
4242
|------|-------------|
4343
| `Both` | The `/stats` command displays both PVP and PVE stats, but ranking, rewards and UI are based on PVP stats |
4444
| `PVP` | The `/stats` command displays only PVP stats, and ranking, rewards and UI are based on PVP stats |
4545
| `PVE` | The `/stats` command displays only PVE stats, and ranking, rewards and UI are based on PVE stats |
4646

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+
4762
---
4863

49-
## 🖥️ Workshop Integration (Optional)
64+
## Workshop (Optional)
5065
The UI is optional and provides a visual display for PVP stats.
5166

5267
- **Workshop Item**: [Player Stats UI](https://steamcommunity.com/sharedfiles/filedetails/?id=3352126593)
@@ -57,7 +72,7 @@ The UI is optional and provides a visual display for PVP stats.
5772
5873
---
5974

60-
## 🔑 Commands
75+
## Commands
6176

6277
| Command | Description |
6378
|---------|-------------|
@@ -71,7 +86,7 @@ The UI is optional and provides a visual display for PVP stats.
7186

7287
---
7388

74-
## 🔐 Permissions
89+
## Permissions
7590

7691
```xml
7792
<Permission Cooldown="0">playtime</Permission>
@@ -85,7 +100,7 @@ The UI is optional and provides a visual display for PVP stats.
85100

86101
---
87102

88-
## ⚙️ Configuration
103+
## Configuration
89104
```xml
90105
<?xml version="1.0" encoding="utf-8"?>
91106
<PlayerStatsConfiguration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
@@ -113,12 +128,12 @@ The UI is optional and provides a visual display for PVP stats.
113128

114129
---
115130

116-
## 👨‍💻 Credits
131+
## Credits
117132
UI made by **💪 Soer (Unbeaten)**. He also sponsored the creation of this plugin 💸.
118133

119134
---
120135

121-
## Frequently Asked Questions
136+
## Frequently Asked Questions
122137

123138
1. **How do I enable the UI?**
124139
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
129144
3. **How do I customize rewards?**
130145
Edit the `<Rewards>` section in the configuration file with your desired thresholds and permission groups.
131146

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+
132150
---
133151

134152
*For support, bug reports, or feature requests, please write on our forum or join our Discord.*

0 commit comments

Comments
 (0)