\ud83e\udded Limited Spectator
\n======================<\/p>\n
A multi-loader Minecraft mod that introduces a restricted spectator mode with configurable limitations.<\/p>\n
**Supported Loaders**: NeoForge \u2705 \u2022 Fabric \u2705 \u2022 Quilt \u2705<\/p>\n
\ud83d\udcd6 Overview
\n=============<\/p>\n
Limited Spectator allows players to enter a controlled spectator mode that limits what they can do while flying and observing the world.
\nUnlike the vanilla spectator mode, this version allows to press F1 to show HUD and restricts interactions to preserve game balance on servers or custom worlds.<\/p>\n
Perfect for:<\/p>\n
\u2022 SMP;<\/p>\n
\u2022 Builders who want visual observation without full spectator privileges.<\/p>\n
\u2728 Features
\n=============<\/p>\n
\u2705 **Fully Configurable Spectator Mode**
\nComprehensive TOML-based configuration system allowing server owners to customize every aspect of spectator behavior.<\/p>\n
\u2705 **Limited Spectator Mode**
\nPlayers can enter a custom spectator state that allows free flight but prevents inventory use, PvP, and world interactions.<\/p>\n
\u2705 **Flexible Distance Limits**
\nConfigure maximum travel distance from start position (default 75 blocks) or disable it entirely. Choose between teleport-back or warning behavior.<\/p>\n
\u2705 **Customizable Block Interactions**
\nDefine exactly which blocks players can interact with using Minecraft block IDs. Default includes doors, trapdoors, and fence gates.<\/p>\n
\u2705 **Granular Permission Control**
\nSet different permission levels (0-4) for `\/spectator` and `\/survival` commands, with optional OP requirement.<\/p>\n
\u2705 **Selective HUD Visibility**
\nHUD elements remain hidden by default but can be temporarily shown by pressing F1 (configurable).<\/p>\n
\u2705 **Dimension Travel Control**
\nConfigure whether players can switch dimensions (Nether, End, etc.) while in spectator mode.<\/p>\n
\u2705 **Player Repositioning**
\nAutomatic position reset when exceeding distance limits or executing `\/survival` command.<\/p>\n
\u2705 **Flight Capability**
\nPlayers in spectator mode can fly by double-pressing the space bar.<\/p>\n
\u2705 **Combat & Interaction Restrictions**
\nIndividually toggle PvP, mob attacks, item drop\/pickup, and inventory crafting.<\/p>\n
\u2705 **Hot-Reloadable Configuration**
\nAll settings can be changed in `config\/limitedspectator-common.toml` and reloaded with `\/reload` command.<\/p>\n
\u2705 **Server-Friendly**
\nAll restrictions are handled server-side for secure multiplayer behavior.<\/p>\n
\u2705 **Multilingual Support**
\nFull translation support for 5 European languages (English, Italian, German, French, Spanish).<\/p>\n
\ud83e\udde0 Technical Details
\n=====================<\/p>\n
| Aspect | Value |
\n| ——————— | —————————— |
\n| **Version** | 2.0.0 |
\n| **Minecraft** | 1.21.1 \u2192 1.21.11+ (cross-version compatible) |
\n| **Mod Loaders** | NeoForge \u2705 \u2022 Fabric \u2705 \u2022 Quilt \u2705 |
\n| **NeoForge** | 21.1.217+ |
\n| **Fabric Loader** | 0.16.5+ |
\n| **Fabric Loom** | 1.7.3+ |
\n| **Quilt Loader** | 0.26.4+ |
\n| **Quilt Loom** | 1.7.3+ (Production only) |
\n| **Java** | 21 |
\n| **Mod ID** | `limitedspectator` |<\/p>\n
\u2699\ufe0f Commands
\n=============<\/p>\n
| Command | Description | Default Permission |
\n| ———— | ——————————————— | —————— |
\n| `\/spectator` | Switch to the limited spectator mode | Level 0 (everyone) |
\n| `\/survival` | Return to normal gameplay and restore the HUD | Level 0 (everyone) |<\/p>\n
\ud83c\udf0d Command feedback messages are fully localized in 5 languages: **English**, **Italian**, **German**, **French**, and **Spanish**.<\/p>\n
**Note**: Permission levels can be customized in the config file. See Configuration section below.<\/p>\n
\u2699\ufe0f Configuration
\n==================<\/p>\n
Limited Spectator features a comprehensive configuration system. On first launch, a config file is automatically generated at:<\/p>\n
**Location**: `config\/limitedspectator-common.toml`<\/p>\n
### Configuration Categories<\/p>\n
#### \ud83d\udeb6 Movement Restrictions
\n– `max_distance` – Maximum travel distance from start position (default: 75.0 blocks, -1 to disable)
\n– `allow_dimension_travel` – Allow dimension changes in spectator mode (default: false)
\n– `teleport_back_on_exceed` – Teleport back when exceeding distance vs. warning (default: true)
\n– `reset_position_on_logout` – Reset position on logout to prevent abuse (default: true)<\/p>\n
#### \ud83c\udfae Player Abilities
\n– `enable_invulnerability` – Make players invulnerable (protects from mobs and environmental damage, not fall damage) (default: true)
\n– `enable_flight` – Allow flight in spectator mode (default: true)
\n– `spectator_gamemode` – GameMode to use: “ADVENTURE” or “SPECTATOR” (default: “ADVENTURE”)<\/p>\n
#### \ud83d\udd27 Interaction Restrictions
\n– `allow_pvp` – Allow attacking other players (default: false)
\n– `allow_item_drop` – Allow dropping items (default: false)
\n– `allow_item_pickup` – Allow picking up items (default: false)
\n– `allow_inventory_crafting` – Allow inventory crafting (2×2 grid) (default: false)
\n– `interactable_blocks` – List of block IDs players can interact with (default: all doors, trapdoors, gates)<\/p>\n
**Note**: Mob attacks are always disabled because mobs don’t target players with `mayfly=true` ability (Minecraft core behavior).<\/p>\n
#### \ud83d\udd10 Command Permissions
\n– `spectator_command_permission_level` – Permission level for `\/spectator` (0-4, default: 0)
\n– `survival_command_permission_level` – Permission level for `\/survival` (0-4, default: 0)
\n– `require_op_for_spectator` – Require OP status for spectator commands (default: false)<\/p>\n
#### \ud83d\udda5\ufe0f Client & HUD Behavior
\n– HUD automatically hides when entering spectator mode (hard-coded)
\n– F1 key toggles HUD visibility temporarily<\/p>\n
#### \ud83d\udcac Message Settings
\n– `use_action_bar_messages` – Show messages in action bar instead of chat (default: true)
\n– `show_distance_warnings` – Show warnings when approaching distance limit (default: true)<\/p>\n
### Example Configurations<\/p>\n
**Server with relaxed spectator mode:**
\n“`toml
\n[movement_restrictions]
\n max_distance = -1 # No distance limit
\n allow_dimension_travel = true<\/p>\n
[interactions]
\n allow_item_pickup = true # Allow picking up items
\n interactable_blocks = [“minecraft:oak_door”, “minecraft:lever”, “minecraft:stone_button”]
\n“`<\/p>\n
**Strict survival server:**
\n“`toml
\n[permissions]
\n spectator_command_permission_level = 2 # Requires moderator rank
\n require_op_for_spectator = true<\/p>\n
[movement_restrictions]
\n max_distance = 50.0 # Shorter distance limit
\n reset_position_on_logout = true # Prevent logout abuse
\n“`<\/p>\n
All configuration changes can be applied without restarting the server using `\/reload`.<\/p>\n
\ud83d\udd10 Default Restrictions in Spectator Mode
\n===========================================<\/p>\n
**Note**: Most restrictions below are configurable via `config\/limitedspectator-common.toml`<\/p>\n
\u2022 \u274c No block breaking or placing (enforced by ADVENTURE mode – cannot be changed)<\/p>\n
\u2022 \u274c No chest, bed, crafting table, or item interactions (configurable via block whitelist)<\/p>\n
\u2022 \u274c No inventory crafting (2×2 grid) – ingredients restored automatically (configurable)<\/p>\n
\u2022 \u274c No dimension travel (configurable)<\/p>\n
\u2022 \u274c No mob attacks (mobs don’t target players with mayfly ability)<\/p>\n
\u2022 \u274c No PvP (configurable)<\/p>\n
\u2022 \u274c No item dropping or pickup (individually configurable)<\/p>\n
\u2022 \u2705 Doors, trapdoors, and fence gates remain interactable (fully customizable via block IDs)<\/p>\n
\u2022 \u2705 F1 toggles HUD visibility (configurable)<\/p>\n
\u2022 \u2705 Distance limit: 75 blocks (configurable, can be disabled)<\/p>\n
\ud83e\udde9 Compatibility
\n==================<\/p>\n
\u2022 \u2705 Minecraft 1.21.1+<\/p>\n
\u2022 \u2705 NeoForge 21.1.0+<\/p>\n
\u2022 \u2705 Multiplayer-safe<\/p>\n
\u2022 \u26a0\ufe0f Limited Spectator uses standard NeoForge event hooks and should be compatible with most mods. However, mods that deeply alter player gamemode handling or HUD rendering may interfere with its behavior.<\/p>\n
\ud83e\uddf0 Installation
\n=================<\/p>\n
### \ud83d\udce6 Choose Your Loader<\/p>\n
Download the correct version for your mod loader:<\/p>\n
| Loader | File | Notes |
\n|——–|——|——-|
\n| **NeoForge** | `LimitedSpectator-neoforge-2.0.0.jar` | Full config support |
\n| **Fabric** | `LimitedSpectator-fabric-2.0.0.jar` | Hardcoded defaults |
\n| **Quilt** | `LimitedSpectator-quilt-2.0.0.jar` | Uses Fabric API |<\/p>\n
### Installation Steps<\/p>\n
1. Install your mod loader (NeoForge 21.1.217+ \/ Fabric 0.16.5+ \/ Quilt 0.26.4+)
\n2. Place the correct JAR into your `mods\/` folder
\n3. Launch Minecraft
\n4. **(NeoForge only)** Config file auto-generates at `config\/limitedspectator-common.toml`
\n5. **(NeoForge only)** Reload changes with `\/reload` command<\/p>\n
**Note**: Fabric and Quilt versions use hardcoded defaults. Configuration system planned for future release.<\/p>\n
\ud83c\udf0d Localization
\n=================<\/p>\n
Limited Spectator includes full translation support for the most common European languages:<\/p>\n
**Supported Languages:**
\n– \ud83c\uddec\ud83c\udde7 **English** (en_us) – Base language
\n– \ud83c\uddee\ud83c\uddf9 **Italian** (it_it) – Italiano
\n– \ud83c\udde9\ud83c\uddea **German** (de_de) – Deutsch
\n– \ud83c\uddeb\ud83c\uddf7 **French** (fr_fr) – Fran\u00e7ais
\n– \ud83c\uddea\ud83c\uddf8 **Spanish** (es_es) – Espa\u00f1ol<\/p>\n
**Translated Messages:**
\n– Command feedback (`\/spectator` and `\/survival`)
\n– Distance limit notifications
\n– Error messages (dimension travel, crafting restrictions)
\n– All user-facing text<\/p>\n
The mod automatically detects your Minecraft language setting and displays messages accordingly.<\/p>\n
\u26a0\ufe0f Minecraft ADVENTURE Mode Limitations
\n=========================================<\/p>\n
Limited Spectator uses Minecraft’s ADVENTURE mode (instead of SPECTATOR mode) to prevent noclip while allowing flight. This design choice introduces some inherent limitations:<\/p>\n
### Core Limitations (By Design)<\/p>\n
**These are NOT bugs** – they are fundamental restrictions of Minecraft’s ADVENTURE mode that cannot be overridden:<\/p>\n
1. **Manual Flight Activation**: Players must double-press spacebar to start flying. Auto-start flying requires vanilla SPECTATOR mode (which enables noclip).<\/p>\n
2. **Fall Damage Only**: When `mayfly=true`, Minecraft’s engine prevents fall damage calculation entirely. However, `enable_invulnerability=true` **DOES protect** against mobs, lava, fire, cacti, and other environmental damage.<\/p>\n
3. **Block Breaking\/Placing Disabled**: ADVENTURE mode blocks all building actions at the GameMode level. This cannot be changed without deep Mixins into Minecraft’s core engine.<\/p>\n
### Why These Limitations Exist<\/p>\n
Limited Spectator prioritizes **observation without noclip** over feature completeness. Enabling vanilla SPECTATOR mode would allow players to:
\n– Phase through walls and blocks (noclip)
\n– Access areas they shouldn’t see
\n– Bypass server protections<\/p>\n
These limitations preserve the mod’s core purpose: **balanced spectating for servers**.<\/p>\n
### Alternative: Use SPECTATOR Mode<\/p>\n
If you need full vanilla spectator features (invulnerability, noclip, etc.), set `spectator_gamemode = “SPECTATOR”` in the config. Note that this enables noclip and reduces security for multiplayer servers.<\/p>\n
\ud83d\udce6 Project Links
\n==================<\/p>\n
| Platform | Link |
\n| ———— | ———————————————————————————————— |
\n| **Modrinth** | Limited Spectator on Modrinth |
\n| **CurseForge** | Limited Spectator on CurseForge |
\n| **GitHub** | GitHub Repository |
\n| **Issues** | Report Bugs \/ Suggestions |<\/p>\n
\u2764\ufe0f Credits
\n============<\/p>\n
\u2022 Author: Karashi<\/p>\n
\u2022 Icon Design: AI-generated minimalist design (OpenAI)<\/p>\n
\u2022 Special thanks: Minecraft & NeoForge community<\/p>\n
\ud83d\ude80 Future Roadmap
\n===================<\/p>\n
\u2022 \ud83e\uddf1 Optional integration with third-party permission systems (LuckPerms, FTB Chunks)<\/p>\n
\u2022 \ud83d\udd0d Extended API for custom spectator events (SpectatorModeEnterEvent, SpectatorModeExitEvent)<\/p>\n
\u2022 \ud83d\udcbe Persistent state storage (save spectator positions across server restarts)<\/p>\n
\u2022 \u23f1\ufe0f Spectator time limits (configurable max duration in spectator mode)<\/p>\n
\u2022 \u2728 Particle effects or visual boundaries for distance limits<\/p>\n","protected":false},"excerpt":{"rendered":"
A lightweight NeoForge mod that introduces a restricted spectator mode for Minecraft players (fully customizable).<\/p>\n","protected":false},"featured_media":94281,"template":"","meta":{"_minecraft_slug":"limited-spectator","_minecraft_project_id":"1h1Nfg72","_minecraft_author":"karashi","_minecraft_license":"MIT","_minecraft_downloads":775,"_minecraft_follows":2,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"limited-spectator.zip","_minecraft_size_bytes":2583408,"_minecraft_version_count":11,"_minecraft_updated_at":"2026-05-15T21:40:47.221531Z","_minecraft_date_created":"2025-11-05T07:11:33.068255Z","_minecraft_date_modified":"2026-01-23T17:14:48.548822Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/limited-spectator","_minecraft_icon_attachment_id":94281,"_minecraft_imported_at":"2026-06-05T09:29:52+00:00","_minecraft_import_hash":"830319d5bd3a4bec6002688f8413371e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,89,158,98,92],"mod_loader":[160],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-94280","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-game-mechanics","mod_category-neoforge","mod_category-quilt","mod_category-utility","mod_loader-neoforge","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n