v1.3.0 for Paper 1.21.4

Additions

• Added new config option prevent-void-damage-in-spec in config.yml to prevent players in spec from taking damage from the void and dying.

Changes & Fixes

• Switched from using the Spigot API to using the Paper API
• Works with Minecraft 1.21.4
  • Specifically, floating heads displayed by ProtocolLib now work properly again for Minecraft 1.21.4.

Other Notes

• This version of SlashSpec has been tested to work with ProtocolLib 5.3.0.

Full Changelog: v1.2.0...v1.3.0

v1.2.0 for Minecraft 1.20.2 (works with 1.21)

Additions

• Added spec teleportation.
  • /spec tp <player> [slashspec.teleport] — Allows you to teleport to another player while you are in spec. The other player can disable this if desired.
  • /spec tptoggle [<enable/disable>] [<player> (for admins)] [slashspec.teleport.toggle[.others]] — Toggle whether other players are allowed to teleport to you (or another player, for admins). If disabled, other people will not be able to use /spec tp to teleport to you.
  • Config option: teleportable-to-default: true. Sets whether players may be teleported to by other players by default.
• Added spec combat tagging. Players will not be able to enter enter spec if they have recently been attacked by another player or if they have recently attacked another player. This is useful if players are abusing spec to escape combat situations. This will work for both melee and ranged attacks.
  • Config option: combat-timer-seconds: 30. Controls the number of seconds after a player attacks another during which neither player may enter spec.

Changes

• Spec fireworks (/spec firework) are no longer instant by default, spawning a flight duration 3 rocket instead.

Other Notes

Tested for Minecraft 1.20.2. Should work for 1.20.4.

Full Changelog: v1.1.1...v1.2.0

v1.1.1 for Minecraft 1.20.2

Fixed the floating heads feature, allowing it to work with Minecraft 1.20.2 (that is the version I tested it on), though it should also work on Minecraft 1.20.4 (though I haven't yet tested this as of writing).

v1.1.0

Bug Fixes

• A player logging out while in spec and logging back in caused their floating head to get stuck at the location where they logged back in and would remain stuck until the server restarts.
• /spec firework would require you to specify a player even when you are not the console.
  You can now just type the command without any other arguments to launch a default firework.
• Sometimes, players would see their own floating head while they were in spec.

Technical Changes

• Plugin now stores player spec states using PersistentDataContainer instead of playerdata.yml

Full Changelog

v1.0.0...v1.1.0

v1.0.0

Features

Main /spec command

Permission Node: slashspec.use (granted by default)
Aliases:

• /sp
• /s

• Temporarily go into spectator mode and fly around freely. Be teleported back when you run the command again.
• Your location, gamemode, flying state, fall damage, air bubbles, fire and freezing ticks will all be remembered, and they will be restored when you come out of spec.
• Other players can see you as a floating head (requires dependency ProtocolLib) while you are in spectator mode.
  • If the server does not have ProtocolLib installed, other players will see a white particle trail instead.
• Admins can toggle spec mode for other people.
  • Syntax: /spec force <player> [<in/out>]
  • Permission: slashspec.ghost.others

Ghost Mode /spec ghost

Permission Node: slashspec.ghost
Syntax: /spec ghost [<enable/disable>] [<other player> (for admins)]

• Ghost mode is off by default; other people can see you while you are in spectator mode by default.
• Turn on ghost mode to turn off the floating head feature that makes you visible to other players.
• Admins can toggle ghost mode for other people. Permission: slashspec.ghost.others

Firework /spec firework

Permission Node: slashspec.firework
Syntax: /spec firework [<colour>] [<flight duration>/instant] [<other player> (for admins)]

• Launches a firework at your location. Might be useful for signalling your location.
• You don't have to be in spectator mode to use it (although you do need the permission node)
• Admins can launch fireworks at other people's locations. Permission: slashspec.firework.others

The spectator mode hotbar teleport teleportation menu is disabled by default.

Permission Node: slashspec.use_hotbar_teleport_menu (denied by default)

The spectator mode hotbar teleport menu is a feature that is apparently not that well known.

If a number key is pressed, the player can teleport to a specific player on that server by pressing 1, or the player can teleport to a team member by pressing 2 and afterward clicking on the number of the player twice to be teleported or once to see their name.
From the Minecraft Wiki

However, as players in spectator mode might be able to use it to teleport to whoever they wish, this plugin makes the menu not usable by default. Attempting to teleport using the menu will not work unless the player specifically has the permission node granted. Server operators are not affected by this.

Dependency

ProtocolLib

ProtocolLib is an optional dependency for this plugin, but it is required for the floating heads feature to work.

If you don't already have it installed, download ProtocolLib from https://www.spigotmc.org/resources/protocollib.1997/ and add the plugin to the server along with SlashSpec.

Full Changelog

https://github.com/SeriousGuy888/SlashSpec/commits/v1.0.0