SpecLock

SpecLock

When a player is in Spectator Mode and belongs to a team, they can *only* spectate teammates, and they can only stay within a configurable block radius of them. Stray too far, try to fly off, or follow a teammate into another dimension, and you'll be snapped right back. Players with no team assigned are completely unrestricted.

Made to complement my Manhunt Plugin, or any scenario where you want spectators to still enjoy the spectating experience without being able to abuse it.

---

Features

- Persistent teams: spectators can only use the hotbar menu to teleport to players on their own team(mate) - Persistent teams: set the maximum distance a spectator can be from their teammates (default: 10 blocks) - Persistent teams: checked every second; if a spectator wanders too far they are instantly snapped back to the nearest teammate - Persistent teams: if a spectator's team(mate) moves to another dimension, the spectator is teleported with them - Persistent teams: players not assigned to any team are fully unrestricted in spectator mode - Persistent teams: teams and memberships survive server restarts

---

Commands

All commands require `speclock.admin` permission (usually just OP)

| Command | Description | |---|---| | `/sl team_add <name>` | Create a new team | | `/sl team_remove <name>` | Delete a team and remove all its members | | `/sl add <player> <team>` | Add an online player to a team | | `/sl remove <player> <team>` | Remove an online player from a team | | `/sl reset` | Delete all teams and clear all memberships |

---

Configuration

Found in `plugins/SpecLock/config.yml` after first launch:

```yaml

The maximum distance (in blocks) a spectator can be from their alive teammates.

max-distance: 10.0 ```

Change `max-distance` to any value you like, then restart or reload the server.

---

Technical Details

Built for Paper 1.21.1 but probably compatible with Spigot and maybe Bukkit, message `qpso` on Discord for bugs or suggestions.