Scoreboard ID

# Scoreboard ID A Minecraft datapack that assigns a unique 9-digit ID to each player, enabling easy player identification and management on multiplayer servers. !(https://img.shields.io/badge/Minecraft-1.21.9%2B-brightgreen) !(https://img.shields.io/badge/Format-88--107-blue) !(https://img.shields.io/badge/License-MIT-yellow) ## Features - **Automatic ID Assignment**: Each player receives a unique 9-digit ID (100000000-999999999) automatically upon joining - **Conflict Resolution**: Built-in detection and resolution system ensures no two players share the same ID - **Player Lookup**: Find players by their ID or view all player IDs - **Interactive Dialog System**: User-friendly interface with help menus and support options - **Easy-to-Use Commands**: Simple trigger-based commands for quick access to ID information ## Requirements - Minecraft Java Edition 1.21.9 or higher - Datapack format version 88-107 - Server Tools dependency (automatically loaded) ## Installation 1. Download the datapack file 2. Place it in your world's `datapacks` folder: ``` <world_folder>/datapacks/Scoreboard ID - 1.21.9+.zip ``` 3. Reload datapacks in-game: ```mcfunction /reload ``` 4. The datapack will automatically initialize and assign IDs to all online players ## Usage ### View Your Own ID ```mcfunction /trigger score_id.self_id set 1 ``` Displays your personal 9-digit ID in chat. ### View All Players' IDs ```mcfunction /trigger score_id.show_all set 1 ``` Shows the ID of all currently online players. ### Find Player by ID ```mcfunction /trigger score_id.show_player set <ID> ``` Replace `<ID>` with a 9-digit number to find which player owns that ID. **Example:** ```mcfunction /trigger score_id.show_player set 123456789 ``` ### Access Help Menu Open the pause menu and navigate to the Server Tools menu to access the help dialog with all available commands. ## Technical Details ### Scoreboard Objectives The datapack creates the following scoreboard objectives: - **`score_id`** (dummy): Stores each player's unique 9-digit ID - **`score_id.self_id`** (trigger): Trigger for viewing your own ID - **`score_id.show_all`** (trigger): Trigger for viewing all players' IDs - **`score_id.show_player`** (trigger): Trigger for looking up players by ID ### ID Generation - IDs are randomly generated within the range: `100000000` to `999999999` - Automatic conflict detection ensures uniqueness - If a conflict is detected, a new random ID is assigned ### File Structure ``` Scoreboard ID - 1.21.9+/ ├── pack.mcmeta # Datapack metadata ├── spyglass.json # Spyglass IDE configuration └── data/ ├── minecraft/ │ └── tags/ │ ├── dialog/ # Dialog tags for server tools integration │ └── function/ # Function tags └── score_id/ ├── dialog/ # Dialog definitions │ ├── help/ # Help menu dialogs │ ├── support/ # Support dialogs │ └── main_menu.json # Main menu configuration └── function/ # Function files ├── init.mcfunction # Initialization function ├── id.mcfunction # ID assignment logic └── show_id/ # ID display functions ├── show_all_id.mcfunction ├── show_id_self.mcfunction └── show_player_name.mcfunction ``` ## Commands Reference | Command | Description | Type | | --------- | ------------- | ------ | | `/trigger score_id.self_id set 1` | Display your own ID | Trigger | | `/trigger score_id.show_all set 1` | Display all online players' IDs | Trigger | | `/trigger score_id.show_player set <ID>` | Find player by their ID | Trigger | ## For Developers ### Dependencies This datapack requires the **Server Tools** framework: - Automatically loads via `#server_tools_init` function tag - Integrates with the server tools menu system ### Customization You can modify the following aspects: 1. **ID Range**: Edit `data/score_id/function/id.mcfunction` to change the ID range 2. **Messages**: Modify tellraw messages in the function files 3. **Dialog UI**: Customize dialog JSON files in `data/score_id/dialog/` ## Author ### FeSo4a - (https://modrinth.com/user/FeSo4a) - (https://github.com/FeSo4a) - (https://space.bilibili.com/FeSo4a) - (https://feso4a.github.io) ## License This project is open-source. Feel free to use, modify, and distribute according to your needs. ## Bug Reports & Support If you encounter any issues or have suggestions: 1. Check the help menu in-game: `/trigger` commands or pause menu 2. Contact the author through the platforms listed above 3. Submit an issue on GitHub --- **Enjoy managing your server with Scoreboard ID!**