Описание
# Scoredex
## 📋 Description
Scoredex is a Minecraft mod that automatically generates a scoreboard image based on the number of Pokémon captured by each player. This mod runs server-side and requires no client-side installation.
## ✨ Features
- Automatic generation of a scoreboard image
- Periodic refresh of capture statistics
- Accessible interface via integrated web server
- Customizable configuration
- Multi-column display for servers with many players
- Complete customization of scoreboard colors
- Option to hide the last update date
- `/reloadscoredex` command to reload the config without restarting the server
## 🚀 Installation
1. Make sure the Cobblemon mod is installed
2. Place the Scoredex `.jar` file in the `mods` folder of your server
3. Start or restart your server to activate the mod
## ⚙️ Configuration
The configuration file is automatically created when the server is first started. You will find it in the `config` folder of your Minecraft server under the name `scoredex.json`.
### Example Configuration
```json
{
"port": 8080,
"updateIntervalMinutes": 5,
"imageTitle": "Scoreboard - Captured Pokémon",
"timeZone": "Europe/Paris",
"autoDetectDataFolder": true,
"manualDataFolderPath": "",
"maxPlayers": 100,
"rowsPerColumn": 10,
"showLastUpdate": true,
"lastUpdateText": "Dernière mise à jour :",
"colors": {
"background": "#141414",
"titleBackground": "#3232C8",
"titleText": "#FFFFFF",
"topPlayerText": "#FFFFFF",
"firstPlaceBackground": "#FFD700",
"secondPlaceBackground": "#C0C0C0",
"thirdPlaceBackground": "#CD7F32",
"text": "#FFFFFF",
"footerText": "#FFFF00"
}
}
```
### Available Options
| Option | Description | Default Value |
|--------|-------------|-------------------|
| `port` | Web server listening port | 8080 |
| `updateIntervalMinutes` | Scoreboard update frequency (in minutes) | 5 |
| `imageTitle` | Title displayed on the scoreboard | "Scoreboard - Captured Pokémon" |
| `timeZone` | Time zone for timestamps | "Europe/Paris" |
| `autoDetectDataFolder` | Enable automatic detection of the data folder | true |
| `manualDataFolderPath` | Manual path to the data folder (if `autoDetectDataFolder` is disabled) | "" |
| `maxPlayers` | Maximum number of players to display on the scoreboard | 100 |
| `rowsPerColumn` | Number of rows per column | 10 |
| `showLastUpdate` | Show or hide the date and time of the last update | true |
| `colors` | Dictionary of scoreboard colors (hexadecimal format) | See example |
### Color Customization
The scoreboard can be completely customized by modifying the following colors:
- `background`: General background color of the scoreboard
- `titleBackground`: Background color of the title
- `titleText`: Color of the title text
- `topPlayerText`: Text color for players in the top 3 positions
- `firstPlaceBackground`: Background color for first place
- `secondPlaceBackground`: Background color for second place
- `thirdPlaceBackground`: Background color for third place
- `text`: Text color for other players
- `footerText`: Footer text color (update date)
### Scoreboard Layout
The layout of the scoreboard is automatically adjusted based on the `maxPlayers` and `rowsPerColumn` parameters:
- The number of columns is automatically calculated based on the number of players and the number of rows per column
- If you have many players, increase `rowsPerColumn` to create taller columns
- To limit the number of players displayed, adjust the `maxPlayers` value
## 🖼️ Accessing the Image
Example to access the scoreboard image:
- If your Minecraft connection IP is `122.244.17.217:27235`
- Then the image URL will be `http://122.244.17.217:8080/scoreboard.png`
Image URL format: `http://MINECRAFTIP:8080/scoreboard.png`
## ⚠️ Important Notes
- The configured port must be accessible from the outside if you want the image to be visible outside your local network
- Remember to restart your server after any configuration changes
- Verify that your firewall allows connections on the configured port
- If the mod doesn't work correctly, please contact your server host's support
## 🔄 Compatibility
- Supported Minecraft version: 1.21.1
- Requires the Cobblemon mod