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