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

{
  "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