PerfixTitleSystem

TitleTextMod Command System

TitleTextMod provides a comprehensive command system for managing player experience/levels, ranks, titles (prefix/suffix), and flight permissions. Below is a detailed guide to all available commands.

---

📋 Command Overview

Command	Permission Level	Purpose
/exp	Admin (Level 2)	Manage player experience and levels
/level	Admin (Level 2)	Manage levels only (legacy compatibility)
/rank	Admin (Level 2)	Set player rank
/set	Admin (Level 2)	Set player titles (prefix/suffix)
/fly	Admin (Level 2)	Toggle flight (VIP+ only)
/info	Everyone	View player information

---

🔹 /exp — Experience & Level Management

The core command for managing player experience and levels. Supports two modes: independent and shared.

Syntax

/exp add <points> [player]
/exp set <points> [player]
/exp remove <points> [player]
/exp level add <levels> [player]
/exp level set <levels> [player]
/exp level remove <levels> [player]
/exp query [player]

Parameters

Parameter	Type	Description
points	Integer	Amount of experience (add/remove require ≥ 1, set requires ≥ 0)
levels	Integer	Number of levels
player	Player selector	Optional, defaults to the command executor

Examples

# Add 100 experience points to yourself
/exp add 100

# Set Steve's experience to 5000 points
/exp set 5000 Steve

# Remove 200 experience points from Alex
/exp remove 200 Alex

# Add 5 levels to all players
/exp level add 5 @a

# Set your own level to 10
/exp level set 10

# Query Steve's current experience and level
/exp query Steve

Feedback

• Experience updated: Set <player>'s experience to <value>
• Level updated: Set <player>'s level to <level name>
• Query result: Displays current experience, level, and mode (independent/shared)

---

🔹 /level — Level Management (Standalone)

Similar to /exp level, but as a standalone command for legacy compatibility.

Syntax

/level add <amount>
/level set <amount>
/level remove <amount>

Parameters

Parameter	Type	Description
amount	Integer	add/remove require ≥ 1, set requires 0 ≤ value ≤ max level

Examples

/level add 3       # Add 3 levels
/level set 20      # Set level to 20
/level remove 1    # Remove 1 level

Notes

• Only works in independent experience mode.
• In shared mode, returns Shared mode does not support level operations.

---

🔹 /rank — Rank Management

Sets a player's rank. Supports tab completion.

Syntax

/rank <player> <rank>

Parameters

Parameter	Type	Description
player	Player selector	Target player
rank	String	Rank name (see below)

Available Ranks

Rank	Description
NONE	No rank
VIP	VIP member
MVP	MVP member
ADMIN	Administrator

Tab completion will suggest available ranks automatically.

Examples

/rank Steve VIP
/rank Alex MVP
/rank Notch ADMIN

Feedback

• Success: Set <player>'s rank to <rank>

---

🔹 /set — Title Management

Sets custom prefix/suffix (titles) for players. Supports rich text (color, bold, etc.).

Syntax

/set setPrefix <targets> <prefix>
/set setSuffix <targets> <suffix>
/set clear <targets>
/set get <player>

Parameters

Parameter	Type	Description
targets	Player selector	Supports multiple targets (@a, @p, etc.)
prefix	Text component	Supports Minecraft formatting codes, e.g., §6[VIP]
suffix	Text component	Same as above

Examples

# Set Steve's prefix to golden [VIP]
/set setPrefix Steve {"text":"[VIP]","color":"gold"}

# Set all players' suffix to [Adventurer]
/set setSuffix @a {"text":"[Adventurer]","color":"aqua"}

# Clear Alex's title
/set clear Alex

# View Notch's current title
/set get Notch

Feedback

• Prefix set: Set <player>'s prefix to <content>
• Batch operation: Set suffix for <count> players
• Cleared: Cleared <player>'s title
• Query result: Displays target player's prefix and suffix

Notes

• If the new title is identical to the current one, returns Title unchanged and aborts.
• Supports multiple players at once.

---

🔹 /fly — Flight Control

Toggles flight for a player. Only available to VIP or higher in survival mode.

Syntax

/fly <true|false>

Parameters

Parameter	Type	Description
true	Boolean	Enable flight
false	Boolean	Disable flight

Examples

/fly true     # Enable flight
/fly false    # Disable flight

Requirements

• Executor must be a player.
• Player must be in survival mode.
• Player rank must be VIP or higher.

Feedback

• Success: Toggled flight for <player>
• Failure: Flight command failed / Insufficient permissions, VIP or higher required

---

🔹 /info — Player Information

View a player's current experience, level, title, and more.

Syntax

/info
/info <player>

Parameters

Parameter	Type	Description
player	Player selector	Optional, defaults to yourself

Examples

/info             # View your own info
/info Steve       # View Steve's info

Output Example

=== Player Info ===
Name: Steve
Level: Elite Adventurer
Experience: 12580
Prefix: [VIP]
Suffix: [Starlight]

Permission

Available to all players.

---

🛡️ Permission Levels

Minecraft command permissions follow these levels (corresponding to Commands.LEVEL_*):

Level	Constant	Description
0	LEVEL_ALL	All players
1	LEVEL_MODERATORS	Moderator
2	LEVEL_GAMEMASTERS	Game Master (OP level 2)
3	LEVEL_ADMINS	Administrator (OP level 3)
4	LEVEL_OWNERS	Owner (OP level 4)

All commands in this document except /info require Level 2 (Admin) or higher.

---

🌍 Localization

All command feedback messages use Component.translatable and support automatic client-side language switching. Translation keys include:

Key	Meaning
commands.exp.success.exp	Experience modified successfully
commands.exp.success.level	Level modified successfully
commands.exp.query	Query result
commands.exp.error.notPlayer	Executor is not a player
commands.exp.error.invalidAmount	Invalid amount
commands.exp.error.sharedModeUnsupported	Shared mode unsupported
commands.rank.success	Rank set successfully
commands.rank.error.invalid_rank	Invalid rank
commands.title.setPrefix.success.single	Single prefix set successfully
commands.title.setPrefix.success.multiple	Batch prefix set successfully
commands.title.clear.success.single	Single title cleared successfully
commands.title.get	Title query result
commands.fly.success	Flight toggled successfully
commands.fly.error.rank	Insufficient rank
commands.info.*	Info query related

---

📌 Usage Tips

1. Prefer /exp over /level — it offers more features and target selectors.
2. Batch operations — use @a, @p, etc., to manage multiple players at once.
3. Debugging — pair with /info to verify results in real time.
4. Shared experience mode — only /exp add and /exp query are available; direct level setting is disabled.

---

This document is maintained by the HongHuan Team. For questions, please submit an issue or contact the server owner..