Statistic Books

This datapack enables tracking of all game statistics through the score system and displays leaderboards in special books placed on lecterns.

Core Features

The system automatically collects data on any Minecraft statistics and presents them as ranking tables in books. All metrics are sorted in descending order, showing players with the highest achievements.

Important to remember: tracking begins only after creating the corresponding score objectives. For convenience, the pack includes an automatic setup function for all possible targets - simply execute /function sb:setup_objectives after loading the datapack.

System Limitations

Due to the specifics of Minecraft's score system, statistics collection starts only from the moment objectives are added, not from world creation. It's recommended to install this datapack at the beginning of gameplay.

Data updates occur every 5 minutes, therefore:

• Metrics are not updated in real-time
• Players online for less than 5 minutes might not appear in statistics
• Books update only when placed in lecterns

Creating Statistics Books

Take a writable book, write the name of the tracked objective on the first page (without spaces or line breaks), sign the book with the name "MCStats". Conversion happens automatically when placing the book in a lectern.

Determining Objective Names

You can track any scoreboard objectives, including custom ones. For standard statistics, the format sb.<category>.<statistic> is used, for example:

• sb.custom.walk_one_cm - distance walked
• sb.mined.stone - mined stone
• sb.killed.zombie - killed zombies

Privacy Mode

With the setting enabled, players can activate "secret mode" for books in lecterns using the command /trigger sb.secret. Three options are available:

• Normal: all data displayed
• Hidden Names: only scores visible
• Hidden Scores: only names visible

System Settings

All configuration parameters are stored in the sb.settings objective and can be modified by operators of level 2 and above.

autoOptIn

Default: 1

When set to 1, all players are automatically included in statistics collection. When 0 - requires executing /trigger sb.optin for participation.

allowSecret

Default: 1

Enables secret mode usage. Value 2 allows mode changes only by administrators via /function sb:admin/secret.

refreshType

Default: 0

Defines the book update method:

• 0: When opening lectern
• 1: Via /trigger sb.update for current lectern
• 2: Update all lecterns within 16-block radius
• 3: Automatic update every 5 minutes
• 4: Administrators only via special commands

Additional Features

Text Localization

All system texts use translation keys, allowing easy modification through resource packs.

Combined Scoreboards

Starting from version 1.5.1, you can create combined scoreboards that merge multiple statistics through the sb:run_before function.

For administrative assistance, contacting the developer is recommended.