# NameTools - Player Prefix Management Plugin for Velocity
  
**NameTools** is a player prefix management plugin designed for Minecraft Velocity servers. It supports dynamically setting player prefixes via commands with color codes (e.g., `&b[VIP]`) and seamlessly integrates with cross-server chat plugins like [**ChatTools**](https://github.com/NSrank/ChatTools).
> **Note**: This plugin is AI-developed to simplify player identity management.
---
## Features
- **Dynamic Prefix Management**:
- Use `/nametools set ` and `/nametools del ` to manage prefixes in real-time.
- Supports Minecraft color codes (e.g., `&a[Admin]`, `&6[VIP]`).
- **Persistent Storage**:
- Prefix data is saved to `plugins/NameTools/config.yml` automatically.
- **Permission Control**:
- Admin permission nodes: `nametools.command.set` and `nametools.command.del`.
- **Compatibility**:
- Works with Velocity 3.3+ and Minecraft 1.16+.
- Displays prefixes across servers with [**ChatTools**](https://github.com/NSrank/ChatTools) (requires ChatTools 1.4+).
---
## Installation
### 1. Download the Plugin
Download the latest `NameTools.jar` from [GitHub](https://github.com/NSrank/NameTools) or other distribution channels.
### 2. Install the Plugin
Place `NameTools.jar` into the `plugins/` directory of your Velocity server.
### 3. Start the Server
Launch the Velocity server. The plugin will auto-generate the default configuration file `plugins/NameTools/config.yml`.
---
## Usage
### Commands
| Command | Permission | Description |
|-----------------------------|-----------------------|-----------------------------------------------------------------------------|
| `/nametools set ` | `nametools.command.set` | Set a color-coded prefix for a player (e.g., `/nametools set Steve &b[VIP]`). |
| `/nametools del ` | `nametools.command.del` | Remove a player's prefix. |
| `/nt set ` | `nametools.command.set` | Alias for `/nametools set`. |
### Examples
1. Set a VIP prefix for player `Steve`:
```bash
/nametools set Steve &b[VIP]
```
2. Remove the prefix from player `Steve`:
```bash
/nametools del Steve
```
---
## Configuration File
The `config.yml` file in `plugins/NameTools/` is used to manage player prefixes.
```yaml
# Player Prefix Configuration
prefixes:
Steve: "&b[VIP]"
Alex: "&c[admin]"
```
- Notes:
- Keys are player usernames, values are color-coded prefixes (e.g., `&a[Builder]`).
---
## Support and Feedback
If you encounter any issues while using the plugin or have suggestions for improvements, please contact us via:
- **GitHub Issues** : [Submit an Issue](https://github.com/NSrank/NameTools/issues)
---
### License & Disclaimer
- **Development Statement** : This plugin is AI-developed to provide an efficient player custom title tool for Minecraft Velocity servers.
- **License** : This plugin is licensed under the GNU General Public License v3.0. You are free to use, modify, and distribute the plugin, but must comply with the terms of the license.
- **Disclaimer** : The developer is not responsible for any issues arising from the use of this plugin.
---
### Acknowledgments
Special thanks to the following technologies and tools that support this plugin:
- [Velocity API](https://papermc.io/software/velocity)
- [Adventure API](https://github.com/KyoriPowered/adventure?spm=a2ty_o01.29997173.0.0.7c5733f51H3mj8)