Description
Gallery
Changelog
Versions
VelocityPlayerListQuery
A Velocity plugin that shows current players in the server list.
Inspired by https://github.com/rtm516/SimplePlayerListQuery.
Configuration options
| option | default | description |
|---|---|---|
playerListMode |
"REPLACE" |
Configure how players are shown in the player list.
|
serverListEntryFormat |
"%1$s" |
Configure how players are shown in the server list.
|
maxListEntries |
16 |
Configure how many players are shown in the server list. <= 0 for unlimited (for backwards compatibility). |
replaceOnlinePlayerCount |
false |
Should the online player count be replaced with the number of players currently connected to Velocity? Useful when using ping-passthrough = "all". |
replaceMaxPlayerCount |
false |
Should the maximum player count be replaced with the Velocity configured amount? Useful when using ping-passthrough = "all". |
fillMissingVersionInfo |
false |
Should the version information be replaced with what is set in versionProtocol and versionName, when no version is detected? Useful when the backend server/s is/are unavailable or still starting. |
replaceVersionInfo |
false |
Should the version information always be replaced with what is set in versionProtocol and versionName? Extends fillMissingVersionInfo. Useful when using ping-passthrough = "all". |
versionProtocol |
4 (= 1.7.2) |
The protocol number to be set. You can find all available protocol versions at https://minecraft.fandom.com/wiki/Protocol_version#Java_Edition_2. Used by fillMissingVersionInfo and replaceVersionInfo. |
versionName |
"Velocity" |
The version name to be set. Used by fillMissingVersionInfo and replaceVersionInfo. |
[1.4.0] 1.4.0
by voruti on Oct 15, 2026
Download
#### Features
- Fixes [#52 Duplicate information](https://github.com/voruti/VelocityPlayerListQuery/issues/52)
- Update dependencies
[1.3.0] 1.3.0
by voruti on Oct 15, 2026
Download
#### Features
#### Commits
- Support for VanishBridge (@Loapu) [#27](https://github.com/voruti/VelocityPlayerListQuery/pull/27)
#### Commits
- af7d5f9: Update Config.java (voruti)
- 8631cb0: Update plugin io.freefair.lombok to v8.2.1 (renovate[bot]) [#17](https://github.com/voruti/VelocityPlayerListQuery/pull/17)
- 4f5edeb: Update plugin io.freefair.lombok to v8.2.2 (renovate[bot]) [#18](https://github.com/voruti/VelocityPlayerListQuery/pull/18)
- 01f840f: Update dependency gradle to v8.3 (renovate[bot]) [#19](https://github.com/voruti/VelocityPlayerListQuery/pull/19)
- d9f6218: Update plugin io.freefair.lombok to v8.3 (renovate[bot]) [#20](https://github.com/voruti/VelocityPlayerListQuery/pull/20)
- 5333f69: Update rickstaa/action-contains-tag action to v1.2.9 (renovate[bot]) [#21](https://github.com/voruti/VelocityPlayerListQuery/pull/21)
- 0990c33: Update plugin xyz.jpenilla.run-velocity to v2.2.0 (renovate[bot]) [#23](https://github.com/voruti/VelocityPlayerListQuery/pull/23)
- 9372760: Update dependency gradle to v8.4 (renovate[bot]) [#24](https://github.com/voruti/VelocityPlayerListQuery/pull/24)
- c05a67b: Update plugin io.freefair.lombok to v8.4 (renovate[bot]) [#25](https://github.com/voruti/VelocityPlayerListQuery/pull/25)
- 46129ad: Update actions/checkout action to v4 (renovate[bot]) [#22](https://github.com/voruti/VelocityPlayerListQuery/pull/22)
- 1572d61: Added support for VanishBridge. Raised the target Java version from 11 to 17. (Benjamin Selig) [#27](https://github.com/voruti/VelocityPlayerListQuery/pull/27)
- 0ac2252: Update actions (voruti)
- b8a2928: Update plugin xyz.jpenilla.run-velocity to v2.2.1 (renovate[bot]) [#28](https://github.com/voruti/VelocityPlayerListQuery/pull/28)
- 5e34cdf: Update plugin xyz.jpenilla.run-velocity to v2.2.2 (renovate[bot]) [#29](https://github.com/voruti/VelocityPlayerListQuery/pull/29)
- 6143418: Update dependency gradle to v8.5 (renovate[bot]) [#30](https://github.com/voruti/VelocityPlayerListQuery/pull/30)
- 92e0b88: Update actions/setup-java action to v4 (renovate[bot]) [#31](https://github.com/voruti/VelocityPlayerListQuery/pull/31)
- b0c3c17: Update gradle (voruti)
- db7968a: Use Java 11 (voruti)
- c47d81c: Merge branch 'main' of https://github.com/voruti/VelocityPlayerListQuery (voruti)
- 37338dd: Update build.gradle (voruti)
- 0f40540: Revert "Use Java 11" (voruti)
- 8982c71: Bump version (voruti)
[1.2.0] 1.2.0
by voruti on Oct 15, 2026
Download
#### Features
#### Commits
- Configurable replacement of version and player information (@C0D3-M4513R) [#11](https://github.com/voruti/VelocityPlayerListQuery/pull/11)
#### Commits
- 64d3282: Actually set online Player count too (C0D3 M4513R) [#11](https://github.com/voruti/VelocityPlayerListQuery/pull/11)
- f62b62f: Bump version (C0D3 M4513R) [#11](https://github.com/voruti/VelocityPlayerListQuery/pull/11)
- f6a1826: Merge branch 'main' into main (C0D3 M4513R) [#11](https://github.com/voruti/VelocityPlayerListQuery/pull/11)
- 97c4694: Make config adjustable (C0D3 M4513R) [#11](https://github.com/voruti/VelocityPlayerListQuery/pull/11)
- 5373be7: Handle invalid pings (voruti) [#15](https://github.com/voruti/VelocityPlayerListQuery/pull/15)
- af7e7e7: Allow setting a limit on the player list (voruti) [#16](https://github.com/voruti/VelocityPlayerListQuery/pull/16)
- 0dd2fc1: Merge remote-tracking branch 'official/main' (C0D3 M4513R) [#11](https://github.com/voruti/VelocityPlayerListQuery/pull/11)
- 4917c45: Merge Version (C0D3 M4513R) [#11](https://github.com/voruti/VelocityPlayerListQuery/pull/11)
- a41162e: Fix players would appear twice on server list (C0D3 M4513R) [#11](https://github.com/voruti/VelocityPlayerListQuery/pull/11)
- 464b8eb: Add reload listener (C0D3 M4513R) [#11](https://github.com/voruti/VelocityPlayerListQuery/pull/11)
- fa52ab1: Bump mod version (voruti)
- 55bc490: Extract method (voruti)
- ff9658a: Renaming/refactoring (voruti)
- a54e3e4: Rename vars (voruti)
- 6cd2b58: Update Config.java (voruti)
- f309d64: Rename var (voruti)
- d95793d: Types & safety (voruti)
- 298c750: Injection (voruti)
- d7f5ece: Fix injection (voruti)
- 00cd160: Add playerListMode config option (voruti)
[1.1.0] 1.1.0
by voruti on Oct 15, 2026
Download
- bf95c2a: Add renovate.json (renovate[bot]) [#1](https://github.com/voruti/VelocityPlayerListQuery/pull/1)
- 2499740: Update rickstaa/action-contains-tag action to v1.2.7 (renovate[bot]) [#2](https://github.com/voruti/VelocityPlayerListQuery/pull/2)
- 9320383: Update plugin org.jetbrains.gradle.plugin.idea-ext to v1.1.7 (renovate[bot]) [#5](https://github.com/voruti/VelocityPlayerListQuery/pull/5)
- a03066b: Update actions/checkout action to v3 (renovate[bot]) [#6](https://github.com/voruti/VelocityPlayerListQuery/pull/6)
- c51adb4: Update dependency gradle to v8 (renovate[bot]) [#7](https://github.com/voruti/VelocityPlayerListQuery/pull/7)
- 616162b: Add fetch-depth: 0 (voruti) [#6](https://github.com/voruti/VelocityPlayerListQuery/pull/6)
- 6373e24: Update renovate.json (voruti)
- 2648843: Update rickstaa/action-contains-tag action to v1.2.8 (renovate[bot]) [#8](https://github.com/voruti/VelocityPlayerListQuery/pull/8)
- f8031e6: Update dependency gradle to v8.2 (renovate[bot]) [#9](https://github.com/voruti/VelocityPlayerListQuery/pull/9)
- fc1fdd4: Update dependency gradle to v8.2.1 (renovate[bot]) [#10](https://github.com/voruti/VelocityPlayerListQuery/pull/10)
- c6c5616: Update gradle.properties (voruti) [#12](https://github.com/voruti/VelocityPlayerListQuery/pull/12)
- a2761fe: Update Velocity version (voruti) [#12](https://github.com/voruti/VelocityPlayerListQuery/pull/12)
- 53a1ed2: Add jpenilla.run-velocity (voruti) [#12](https://github.com/voruti/VelocityPlayerListQuery/pull/12)
- e2d96b2: Add lombok (voruti) [#12](https://github.com/voruti/VelocityPlayerListQuery/pull/12)
- 5f2b086: Add config file with customizable server list entry (voruti) [#12](https://github.com/voruti/VelocityPlayerListQuery/pull/12)
- 4f46df3: Bump plugin version (voruti) [#12](https://github.com/voruti/VelocityPlayerListQuery/pull/12)
[1.0.1] 1.0.1
by voruti on Oct 15, 2026
Download
Initial release
