## Readme<\/p>\n
AdminScope Mod (Fabric)
\n============================<\/p>\n
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.<\/p>\n
—————————————————————-<\/p>\n
Key Features
\n————<\/p>\n
* **Direct spectate command**: `\/spectate How to use: 1. Install the mod and Fabric API on the server. Requirements * Minecraft 26.1 Installation 1. Place the mod’s `.jar` file in the server `mods` folder. Available Commands ### 1. `\/spectate player`<\/p>\n * **Description**: Spectate a specific player immediately. ### 2. `\/spectate stop`<\/p>\n * **Description**: Stop spectating and return to your original position. ### 3. `\/spectate reload`<\/p>\n * **Description**: Reloads the configuration without restarting the server. Spectate Rules While spectating, the following rules apply:<\/p>\n * You can only use the target player’s POV (no mob POV). Jail Mod Compatibility If Jail Mod is installed, jailed players cannot use `\/spectate`.<\/p>\n Configuration file ### `config\/spectatemod\/config.json`<\/p>\n This file is automatically generated and updated. Here are the options you can find:<\/p>\n * **`admin_roles`**: Roles\/tags that grant \/spectate access. You can use either `”op,admin,mod”` or `[“op”, “admin”, “mod”]`. Use `”op”` to include operators. #### Example configuration: Data persistence Active spectate sessions are saved to:<\/p>\n `config\/spectatemod\/spectate_data.json`<\/p>\n This allows the server to restore admins to their correct position after crashes or restarts (when enabled in config).<\/p>\n Usage Tips Use the `\/spectate reload` command after changing configuration. If you use custom roles, add tags like:<\/p>\n “`bash A lightweight, survival-friendly utility that allows moderation staff to silently monitor and spectate players without disrupting the vanilla gameplay experience.<\/p>\n","protected":false},"featured_media":6421,"template":"","meta":{"_minecraft_slug":"adminscope","_minecraft_project_id":"W8fUtxyA","_minecraft_author":"Abdo9616","_minecraft_license":"MIT","_minecraft_downloads":261,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"adminscope.zip","_minecraft_size_bytes":121482,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T20:25:48.245270Z","_minecraft_date_created":"2026-02-07T02:15:37.902874Z","_minecraft_date_modified":"2026-05-07T16:16:58.247897Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/adminscope","_minecraft_icon_attachment_id":6421,"_minecraft_imported_at":"2026-05-31T14:16:26+00:00","_minecraft_import_hash":"aed03bdfdbabd65daf2a5e803a480555","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,89,126,92],"mod_loader":[99],"minecraft_version":[41,83,167,163],"class_list":["post-6420","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-game-mechanics","mod_category-management","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-11","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n* **Accurate restore**: Position, gamemode, and dimension are restored when spectate ends.
\n* **Freecam distance limit**: Configurable boundary (default 30 blocks) with automatic snap-back and warnings.
\n* **Cooldown**: Configurable cooldown between spectate sessions (default 30 seconds).
\n* **Combat safety**: Optional block when in combat or near hostile mobs.
\n* **Player-only POV**: Camera is forced back to the target player if it switches to mobs or other entities.
\n* **Disconnect handling**: Spectating ends automatically if the target leaves the server.
\n* **Jail Mod compatibility**: Jailed players cannot spectate.
\n* **Crash recovery**: Spectate sessions are persisted to disk.
\n* **Auto-patching config**: New config fields are added automatically on update.<\/p>\n
\n———–<\/p>\n
\n2. Start the server once to generate configuration files.
\n3. Run `\/spectate
\n4. Use `\/spectate stop` to return to your saved position.
\n5. Use `\/spectate reload` after editing the config.<\/p>\n
\n————<\/p>\n
\n* Fabric Loader
\n* Fabric API
\n* Java 25<\/p>\n
\n————<\/p>\n
\n2. Start the server to generate configuration files.<\/p>\n
\n——————<\/p>\n
\n* **Who can use it**: Only admins or server operators.
\n* **Syntax**: `\/spectate player_name`
\n* **Example**: `\/spectate Steve`<\/p>\n
\n* **Who can use it**: Only admins or server operators.
\n* **Example**: `\/spectate stop`<\/p>\n
\n* **Who can use it**: Only admins or server operators.
\n* **Example**: `\/spectate reload`<\/p>\n
\n————–<\/p>\n
\n* Freecam distance is limited by `freecam_distance_limit`.
\n* If you push the limit repeatedly, you are snapped back to the target POV.
\n* If the target leaves the server, spectating ends automatically.<\/p>\n
\n———————-<\/p>\n
\n——————<\/p>\n
\n* **`spectate_cooldown`**: Cooldown in seconds between spectate sessions.
\n* **`prevent_combat_spectate`**: If true, prevents spectating while in combat or near hostile mobs.
\n* **`combat_check_radius`**: Radius in blocks to check for hostile mobs.
\n* **`save_spectate_positions`**: If true, saves spectate state to disk for crash recovery.
\n* **`freecam_distance_limit`**: Max distance (in blocks) from the target player while in freecam. Use `0` to disable.<\/p>\n
\n“`json
\n{
\n “_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.”,
\n “admin_roles”: “op”,
\n “spectate_cooldown”: 30,
\n “prevent_combat_spectate”: true,
\n “combat_check_radius”: 16.0,
\n “save_spectate_positions”: true,
\n “freecam_distance_limit”: 30.0
\n}
\n“`<\/p>\n
\n—————-<\/p>\n
\n———-<\/p>\n
\n\/tag @p add admin
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"