AdminScope Mod (Fabric)

The AdminScope Mod is a server-side moderation tool that lets authorized staff spectate a player using the target player's POV, then instantly return to their exact position and gamemode. It is built for survival servers and avoids freecam abuse by enforcing a configurable distance limit.

Key Features

Direct spectate command: /spectate <player> immediately switches you to the target player's POV.
Accurate restore: Position, gamemode, and dimension are restored when spectate ends.
Freecam distance limit: Configurable boundary (default 30 blocks) with automatic snap-back and warnings.
Cooldown: Configurable cooldown between spectate sessions (default 30 seconds).
Combat safety: Optional block when in combat or near hostile mobs.
Player-only POV: Camera is forced back to the target player if it switches to mobs or other entities.
Disconnect handling: Spectating ends automatically if the target leaves the server.
Jail Mod compatibility: Jailed players cannot spectate.
Crash recovery: Spectate sessions are persisted to disk.
Auto-patching config: New config fields are added automatically on update.

How to use:

Install the mod and Fabric API on the server.
Start the server once to generate configuration files.
Run /spectate <player> to start spectating.
Use /spectate stop to return to your saved position.
Use /spectate reload after editing the config.

Requirements

Minecraft 26.1
Fabric Loader
Fabric API
Java 25

Installation

Place the mod's .jar file in the server mods folder.
Start the server to generate configuration files.

Download

The mod is available on:

Modrinth: https://modrinth.com/project/W8fUtxyA
CurseForge: https://www.curseforge.com/minecraft/mc-mods/adminscope

Available Commands

1. `/spectate player`

Description: Spectate a specific player immediately.
Who can use it: Only admins or server operators.
Syntax: /spectate player_name
Example: /spectate Steve

2. `/spectate stop`

Description: Stop spectating and return to your original position.
Who can use it: Only admins or server operators.
Example: /spectate stop

3. `/spectate reload`

Description: Reloads the configuration without restarting the server.
Who can use it: Only admins or server operators.
Example: /spectate reload

Spectate Rules

While spectating, the following rules apply:

You can only use the target player's POV (no mob POV).
Freecam distance is limited by freecam_distance_limit.
If you push the limit repeatedly, you are snapped back to the target POV.
If the target leaves the server, spectating ends automatically.

Jail Mod Compatibility

If Jail Mod is installed, jailed players cannot use /spectate.

Configuration file

`config/spectatemod/config.json`

This file is automatically generated and updated. Here are the options you can find:

admin_roles: Roles/tags that grant /spectate access. You can use either "op,admin,mod" or ["op", "admin", "mod"]. Use "op" to include operators.
spectate_cooldown: Cooldown in seconds between spectate sessions.
prevent_combat_spectate: If true, prevents spectating while in combat or near hostile mobs.
combat_check_radius: Radius in blocks to check for hostile mobs.
save_spectate_positions: If true, saves spectate state to disk for crash recovery.
freecam_distance_limit: Max distance (in blocks) from the target player while in freecam. Use 0 to disable.

Example configuration:

{
  "_config_guide": "SpectateMod Configuration Guide: \n- admin_roles: Roles/tags that grant /spectate access. Supports either 'op,admin,mod' or ['op','admin','mod'].\n- spectate_cooldown: Cooldown time in seconds before an admin can spectate again after stopping.\n- prevent_combat_spectate: If true, prevents spectating when the admin is in combat or near hostile mobs.\n- combat_check_radius: Radius in blocks to check for hostile mobs when prevent_combat_spectate is enabled.\n- save_spectate_positions: If true, saves spectate positions to disk to prevent data loss on crashes.\n- freecam_distance_limit: Max distance (in blocks) you can move away from the spectated player while in freecam.",
  "admin_roles": "op",
  "spectate_cooldown": 30,
  "prevent_combat_spectate": true,
  "combat_check_radius": 16.0,
  "save_spectate_positions": true,
  "freecam_distance_limit": 30.0
}

Data persistence

Active spectate sessions are saved to:

config/spectatemod/spectate_data.json

This allows the server to restore admins to their correct position after crashes or restarts (when enabled in config).

Usage Tips

Use the /spectate reload command after changing configuration. If you use custom roles, add tags like:

/tag @p add admin