Leaderboards Addon for Arma Reforger

Step 1: Download and Install the Addon

First, you'll need to get the Leaderboards addon files:

Method 1: Workshop Installation

1. Find the Leaderboards addon on the Steam Workshop
2. Note the Workshop ID (e.g., 2851234567)
3. Add the Workshop ID to the mods parameter in your server's startup parameters. For example: -mods=2851234567. You can add multiple mods by separating the IDs with a comma: -mods=2851234567,2851234568

Method 2: Manual Installation

1. Download the addon files from the official source
2. Access your server's File Manager
3. Navigate to the addons folder
4. Upload the addon files to the appropriate directory

File Manager interface showing the addons folder where custom addons are installed

Step 2: Configure Server Settings

The Leaderboards addon requires specific server configuration:

Update Startup Parameters

1. Go to Configuration → Startup Parameters
2. Ensure the following settings are configured:

Startup Parameters where you configure addon-specific settings

Step 3: Configure the Addon

Most leaderboard addons come with configuration files that need to be customized:

Locate Configuration Files

1. In the File Manager, navigate to the addon's folder
2. Look for files like config.json or settings.conf
3. Edit these files to customize the addon behavior

Common Configuration Options

{
  "leaderboards": {
    "enabled": true,
    "updateInterval": 30,
    "displayTop": 10,
    "trackStats": {
      "kills": true,
      "deaths": true,
      "playtime": true,
      "score": true
    },
    "database": {
      "saveInterval": 300,
      "backupInterval": 3600,
      "retentionDays": 30
    },
    "display": {
      "showOnConnect": true,
      "showOnDeath": false,
      "commandEnabled": true,
      "command": "!stats"
    }
  }
}

Step 4: Database Setup

The Leaderboards addon typically requires a database to store player statistics:

Built-in Database

Most addons come with a built-in file-based database:

• No additional setup required
• Data stored in JSON or XML files
• Automatic backup and recovery
• Suitable for most servers

External Database (Advanced)

For larger servers, you might want to use an external database:

• MySQL or PostgreSQL support
• Better performance for high-traffic servers
• Advanced querying capabilities
• Requires additional configuration

Step 5: Test the Installation

After installation and configuration:

1. Start your server and monitor the console for any errors
2. Connect to the server as a player
3. Test the leaderboard commands (usually !stats or !leaderboard)
4. Verify that statistics are being tracked
5. Check that data persists after server restarts

Common Leaderboard Commands

Once installed, players can typically use these commands:

Customizing the Display

Most leaderboard addons allow you to customize how statistics are displayed:

Display Options

• HUD Integration: Show stats on player's HUD
• Chat Messages: Display leaderboards in chat
• Scoreboard: Integrate with game scoreboard
• Web Interface: External web-based leaderboards

Customization Examples

Performance Considerations

Leaderboard addons can impact server performance if not configured properly:

Optimization Tips

• Set reasonable update intervals (30-60 seconds)
• Limit the number of tracked statistics
• Use efficient database storage methods
• Implement data cleanup routines
• Monitor server performance after installation

Backup and Data Management

Protecting your leaderboard data is crucial:

Automatic Backups

1. Configure the addon to create automatic backups
2. Set up regular server backups through the control panel
3. Store backups in multiple locations
4. Test backup restoration procedures

Data Migration

If you need to move or reset your leaderboard data:

• Export current statistics before making changes
• Use the addon's built-in migration tools
• Test data integrity after migration
• Communicate changes to your community

Troubleshooting Common Issues

Statistics Not Saving

• Check file permissions in the addon directory
• Verify database configuration settings
• Monitor console for error messages
• Ensure sufficient disk space

Commands Not Working

• Verify command syntax and prefixes
• Check if commands are enabled in config
• Ensure players have necessary permissions
• Test commands as admin first

Performance Issues

• Reduce update frequency
• Limit tracked statistics
• Optimize database queries
• Consider using external database

Advanced Features

Many leaderboard addons offer advanced features:

Achievement System

• Custom achievement definitions
• Milestone rewards
• Badge and title systems
• Progress tracking

Seasonal Resets

• Periodic leaderboard resets
• Season-based competitions
• Historical data preservation
• Reward distribution

Integration Options

• Discord bot integration
• Web dashboard
• API endpoints for external tools
• Cross-server statistics

Maintenance and Updates

Keep your leaderboard addon running smoothly:

• Regularly update the addon to the latest version
• Monitor for compatibility with game updates
• Review and optimize configuration periodically
• Clean up old data to maintain performance
• Backup data before making major changes

Need Help?

If you need assistance with the Leaderboards addon:

• Discord: Join our Discord for community support
• Support Tickets: Submit detailed tickets through your control panel
• Documentation: Check the addon's official documentation
• Community Forums: Connect with other server administrators