## Plasmo Voice Nickname Addon<\/p>\n
A **Plasmo Voice** addon that displays player nicknames instead of their Minecraft usernames.<\/p>\n
Starting with **v2.0.0**, the addon ships as a **single universal jar** that runs on every server-side platform Plasmo Voice supports \u2014 drop it into `plugins\/` (Bukkit-family) or `mods\/` (Fabric, NeoForge via Sinytra Connector), no separate downloads.<\/p>\n
### Example
\n<\/p>\n
—<\/p>\n
## Tested matrix (v2.1.0)<\/p>\n
Verified by booting each combination with the addon and observing both successful PV addon registration and `Done (…)` from the server thread:<\/p>\n
| Loader | MC versions tested | Plasmo Voice | Java | Install addon in | Result |
\n| — | — | — | — | — | — |
\n| **Paper** | 1.20.1, 1.21.1, 1.21.11 | Paper 2.1.9 | 21 | `plugins\/` | \u2705 |
\n| **Folia** | 1.20.1, 1.21.4, 1.21.11 | Paper 2.1.9 | 21 | `plugins\/` | \u2705 |
\n| **Canvas** (Folia fork) | 26.1.2 | Paper 2.1.9 | 25 | `plugins\/` | \u2705 |
\n| **Fabric** | 1.20.1, 1.21.1, 1.21.4, 1.21.6, 1.21.11, 26.1.2 | Fabric 2.1.9 | 21 \/ 25 | `mods\/` | \u2705 |
\n| **Velocity** | 3.4.0-SNAPSHOT | Velocity 2.1.9 | 21 | `plugins\/` | \u2705 |
\n| **NeoForge** (native PV) | 21.1.228 \/ 1.21.1 | NeoForge 2.1.9 | 21 | `mods\/` | \u2705 |
\n| **Forge** (native PV) | 47.4.20 \/ 1.20.1, 52.1.14 \/ 1.21.1 | Forge 2.1.9 | 21 | `mods\/` | \u2705 |
\n| **Arclight Fabric** (Bukkit + Fabric hybrid) | 1.0.2-SNAPSHOT \/ 1.21.1 | Fabric 2.1.9 | 21 | `mods\/` | \u2705 |<\/p>\n
**Note for Forge \/ NeoForge users:** install **Plasmo Voice’s native Forge or NeoForge build** (e.g. `plasmovoice-forge-1.21.1-2.1.9.jar` or `plasmovoice-neoforge-1.21.1-2.1.9.jar`), not the Fabric jar with Sinytra Connector. The addon ships auto-generated Forge \/ NeoForge entrypoints that load cleanly against the native PV builds \u2014 no Connector required.<\/p>\n
The addon itself does not depend on any platform-internal API, so it should work on every other Plasmo-Voice-supported MC version (1.20.1 \u2192 26.1.2) on the loaders listed above; the table above is just what was actually booted and verified.<\/p>\n
—<\/p>\n
## Supported platforms<\/p>\n
One jar covers all of these:<\/p>\n
– **Bukkit \/ Spigot \/ Paper \/ Purpur \/ Folia** (and Folia forks like Canvas)
\n– **Fabric** (1.20.1 \u2192 26.1.x)
\n– **Forge** (uses Plasmo Voice’s native Forge build)
\n– **NeoForge** (uses Plasmo Voice’s native NeoForge build, no Connector required)
\n– **Velocity** (proxy)
\n– **BungeeCord** (proxy)<\/p>\n
—<\/p>\n
## Placeholder support<\/p>\n
The format string in `config.toml` is parsed by the best resolver available on the running platform:<\/p>\n
| Platform | Resolver | Notes |
\n| — | — | — |
\n| Bukkit \/ Paper \/ Folia \/ Purpur \/ Spigot | **PlaceholderAPI** | Optional. Falls back to built-in placeholders if not installed. |
\n| Fabric | **PB4 Text Placeholder API** | Optional. Falls back to built-in placeholders if not installed. |
\n| NeoForge \/ Velocity \/ BungeeCord | Built-in | Use the built-in placeholders below. |<\/p>\n
### Built-in placeholders<\/p>\n
Always available, regardless of platform:<\/p>\n
– `%player_name%`
\n– `%player_uuid%`
\n– `%player_displayname%`<\/p>\n
—<\/p>\n
## Commands & Permissions<\/p>\n
| Command | Permission | Default | Action |
\n| — | — | — | — |
\n| `\/pvnreload` | `pv.addon.nickname.reload` | `op` | Reload `config.toml` at runtime. Works with LuckPerms \/ Vault \/ PEX on Bukkit-family. |<\/p>\n
The config also reloads automatically when Plasmo Voice’s own `\/vreload` runs.<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Install **Plasmo Voice 2.1.9** on your server or proxy. Forge \/ NeoForge users: use the native PV Forge or NeoForge jar (no Connector needed). ### Default config<\/p>\n “`toml Reload with `\/pvnreload` (or Plasmo Voice’s `\/vreload`) after editing.<\/p>\n —<\/p>\n ## Migration from 1.x<\/p>\n – Old `1.0.0` (plugin) and `1.1` (NeoForge) splits are merged into a single jar starting at `2.0.0`. —<\/p>\n ## Source<\/p>\n GitHub: https:\/\/github.com\/alice-magic\/pv-addon-nickname<\/p>\n —<\/p>\n ## Contributors<\/p>\n – **AsamiKafune** \u2014 original NeoForge port and internal nickname system that inspired the unified built-in resolver. https:\/\/modrinth.com\/user\/AsamiKafune<\/p>\n","protected":false},"excerpt":{"rendered":" Plasmo Voice nickname addon. One universal jar – tested on Paper\/Folia\/Fabric\/Forge\/NeoForge\/Velocity\/Arclight (MC 1.20.1 to 26.1.2). PlaceholderAPI \/ PB4 supported.<\/p>\n","protected":false},"featured_media":126689,"template":"","meta":{"_minecraft_slug":"pv-addon-nickname","_minecraft_project_id":"kcWnKtP9","_minecraft_author":"aomkoyo","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":617,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"pv-addon-nickname.zip","_minecraft_size_bytes":479875,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T10:13:44.877038Z","_minecraft_date_created":"2025-12-01T07:31:26.188134Z","_minecraft_date_modified":"2026-05-10T10:27:50.783307Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/pv-addon-nickname","_minecraft_icon_attachment_id":126689,"_minecraft_imported_at":"2026-06-07T10:43:30+00:00","_minecraft_import_hash":"b299ac854dc49ce6cb720e7e95d1b310","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,894,97,125,104,89,126,158,127,128,867,129,92,985],"mod_loader":[130,895,99,131,106,160,132,133,134,986],"minecraft_version":[36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-126688","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-bungeecord","mod_category-fabric","mod_category-folia","mod_category-forge","mod_category-game-mechanics","mod_category-management","mod_category-neoforge","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_category-velocity","mod_loader-bukkit","mod_loader-bungeecord","mod_loader-fabric","mod_loader-folia","mod_loader-forge","mod_loader-neoforge","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","mod_loader-velocity","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n2. Drop `pv-addon-nickname-
\n3. Start the server. A config will be generated at `plugins\/pv-addon-nickname\/config.toml` (Bukkit) or `config\/pv-addon-nickname\/config.toml` (Fabric\/proxy).<\/p>\n
\n# Built-in placeholders: %player_name%, %player_uuid%, %player_displayname%
\n# On Bukkit\/Paper with PlaceholderAPI installed, all PAPI placeholders work.
\n# On Fabric with PB4 placeholder-api installed, %namespace:placeholder% syntax works.
\nformat = “%player_displayname%”
\n“`<\/p>\n
\n– Config format moved from JSON to TOML. Re-create your `format` value in the new TOML config.
\n– The NeoForge-only `\/pvn` command was removed; the addon now uses **Plasmo Voice’s player info** path on every platform, which is what client-side mods (e.g. nickname mods) expect.<\/p>\n