Mod
Limited Spectator
No reviews yet
A lightweight NeoForge mod that introduces a restricted spectator mode for Minecraft players.
Includes quality of life improvements and small tweaks to enhance and customize gameplay.
Neoforge is a fork of the Minecraft Forge available for versions 1.20.1+ of Minecraft. Many Forge mods are compatible with Neoforge and vice versa.
Fabric is a mod loader for versions 1.14+ of Minecraft, particularly popular for client side and optimization mods.
Quilt is a fork of the Fabric mod loader. Many Fabric mods are compatible with Quilt and vice versa.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
CurseForge
Modrinth
Compatibility
Supported Environments
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
About
Description
🧭 Limited Spectator
A multi-loader Minecraft mod that introduces a restricted spectator mode with configurable limitations.
Supported Loaders: NeoForge ✅ • Fabric ✅ • Quilt ✅ (Production Only)
📖 Overview
Limited Spectator allows players to enter a controlled spectator mode that limits what they can do while flying and observing the world. Unlike 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.
Perfect for:
• SMP;
• Builders who want visual observation without full spectator privileges.
✨ Features
✅ Fully Configurable Spectator Mode Comprehensive TOML-based configuration system allowing server owners to customize every aspect of spectator behavior.
✅ Limited Spectator Mode Players can enter a custom spectator state that allows free flight but prevents inventory use, PvP, and world interactions.
✅ Flexible Distance Limits Configure maximum travel distance from start position (default 75 blocks) or disable it entirely. Choose between teleport-back or warning behavior.
✅ Customizable Block Interactions Define exactly which blocks players can interact with using Minecraft block IDs. Default includes doors, trapdoors, and fence gates.
✅ Granular Permission Control
Set different permission levels (0-4) for /spectator and /survival commands, with optional OP requirement.
✅ Selective HUD Visibility HUD elements remain hidden by default but can be temporarily shown by pressing F1 (configurable).
✅ Dimension Travel Control Configure whether players can switch dimensions (Nether, End, etc.) while in spectator mode.
✅ Player Repositioning
Automatic position reset when exceeding distance limits or executing /survival command.
✅ Flight Capability Players in spectator mode can fly by double-pressing the space bar.
✅ Combat & Interaction Restrictions Individually toggle PvP, mob attacks, item drop/pickup, and inventory crafting.
✅ Hot-Reloadable Configuration
All settings can be changed in config/limitedspectator-common.toml and reloaded with /reload command.
✅ Server-Friendly All restrictions are handled server-side for secure multiplayer behavior.
✅ Multilingual Support Full translation support for 5 European languages (English, Italian, German, French, Spanish).
🧠 Technical Details
| Aspect | Value |
|---|---|
| Version | 2.0.0 |
| Minecraft | 1.21.1 → 1.21.11+ (cross-version compatible) |
| Mod Loaders | NeoForge ✅ • Fabric ✅ • Quilt ✅ |
| NeoForge | 21.1.217+ |
| Fabric Loader | 0.16.5+ |
| Fabric Loom | 1.7.3+ |
| Quilt Loader | 0.26.4+ |
| Quilt Loom | 1.7.3+ (Production only) |
| Java | 21 |
| Mod ID | limitedspectator |
⚙️ Commands
| Command | Description | Default Permission |
|---|---|---|
/spectator |
Switch to the limited spectator mode | Level 0 (everyone) |
/survival |
Return to normal gameplay and restore the HUD | Level 0 (everyone) |
🌍 Command feedback messages are fully localized in 5 languages: English, Italian, German, French, and Spanish.
Note: Permission levels can be customized in the config file. See Configuration section below.
⚙️ Configuration
Limited Spectator features a comprehensive configuration system. On first launch, a config file is automatically generated at:
Location: config/limitedspectator-common.toml
Configuration Categories
🚶 Movement Restrictions
max_distance- Maximum travel distance from start position (default: 75.0 blocks, -1 to disable)allow_dimension_travel- Allow dimension changes in spectator mode (default: false)teleport_back_on_exceed- Teleport back when exceeding distance vs. warning (default: true)reset_position_on_logout- Reset position on logout to prevent abuse (default: true)
🎮 Player Abilities
enable_invulnerability- Make players invulnerable (protects from mobs and environmental damage, not fall damage) (default: true)enable_flight- Allow flight in spectator mode (default: true)spectator_gamemode- GameMode to use: "ADVENTURE" or "SPECTATOR" (default: "ADVENTURE")
🔧 Interaction Restrictions
allow_pvp- Allow attacking other players (default: false)allow_item_drop- Allow dropping items (default: false)allow_item_pickup- Allow picking up items (default: false)allow_inventory_crafting- Allow inventory crafting (2x2 grid) (default: false)interactable_blocks- List of block IDs players can interact with (default: all doors, trapdoors, gates)
Note: Mob attacks are always disabled because mobs don't target players with mayfly=true ability (Minecraft core behavior).
🔐 Command Permissions
spectator_command_permission_level- Permission level for/spectator(0-4, default: 0)survival_command_permission_level- Permission level for/survival(0-4, default: 0)require_op_for_spectator- Require OP status for spectator commands (default: false)
🖥️ Client & HUD Behavior
- HUD automatically hides when entering spectator mode (hard-coded)
- F1 key toggles HUD visibility temporarily
💬 Message Settings
use_action_bar_messages- Show messages in action bar instead of chat (default: true)show_distance_warnings- Show warnings when approaching distance limit (default: true)
Example Configurations
Server with relaxed spectator mode:
[movement_restrictions]
max_distance = -1 # No distance limit
allow_dimension_travel = true
[interactions]
allow_item_pickup = true # Allow picking up items
interactable_blocks = ["minecraft:oak_door", "minecraft:lever", "minecraft:stone_button"]Strict survival server:
[permissions]
spectator_command_permission_level = 2 # Requires moderator rank
require_op_for_spectator = true
[movement_restrictions]
max_distance = 50.0 # Shorter distance limit
reset_position_on_logout = true # Prevent logout abuseAll configuration changes can be applied without restarting the server using /reload.
🔐 Default Restrictions in Spectator Mode
Note: Most restrictions below are configurable via config/limitedspectator-common.toml
• ❌ No block breaking or placing (enforced by ADVENTURE mode - cannot be changed)
• ❌ No chest, bed, crafting table, or item interactions (configurable via block whitelist)
• ❌ No inventory crafting (2x2 grid) - ingredients restored automatically (configurable)
• ❌ No dimension travel (configurable)
• ❌ No mob attacks (mobs don't target players with mayfly ability)
• ❌ No PvP (configurable)
• ❌ No item dropping or pickup (individually configurable)
• ✅ Doors, trapdoors, and fence gates remain interactable (fully customizable via block IDs)
• ✅ F1 toggles HUD visibility (configurable)
• ✅ Distance limit: 75 blocks (configurable, can be disabled)
🧩 Compatibility
• ✅ Minecraft 1.21.1+
• ✅ NeoForge 21.1.0+
• ✅ Multiplayer-safe
• ⚠️ 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.
🌐 Environment Requirements
Limited Spectator is a server-authoritative mod. The Modrinth "Client and server" tag refers to where the mod can be installed, not where it is required.
| Where to install | Required | Result |
|---|---|---|
| Server | ✅ Yes | All gameplay restrictions (distance limits, item drop/pickup, interactions, attacks, dimension travel, command permissions) are enforced here. The mod cannot function without being on the server. |
| Client | ⚪ Optional but highly recommended | Enables a richer UX: HUD auto-hide when entering /spectator, F1 toggle for temporary HUD reveal, and tighter sync with world events/interactions. |
Connection compatibility
- Vanilla clients can join a server running Limited Spectator. All restrictions still apply server-side — players just won't get the HUD-hide effect.
- Clients with Limited Spectator installed get the full intended experience (clean HUD, synced events).
Per-loader detail
- Fabric & Quilt builds: no client-side code currently exists, so the JAR is effectively server-only. Installing it on the client is harmless but adds no extra features today.
- NeoForge build: the only client-side piece is a small optional packet handler for HUD sync. The network channel is registered as optional, so connection handshake works against both modded and vanilla clients.
Recommended setup
| Use case | Server | Client |
|---|---|---|
| Public SMP with vanilla guests | Required | Vanilla works, install for full UX |
| Private server, all members modded | Required | Install on both for best experience |
| Single-player testing | n/a | Required (acts as local server) |
🧰 Installation
📦 Choose Your Loader
Download the correct version for your mod loader:
| Loader | File | Notes |
|---|---|---|
| NeoForge | LimitedSpectator-neoforge-2.0.0.jar |
Full config support |
| Fabric | LimitedSpectator-fabric-2.0.0.jar |
Hardcoded defaults |
| Quilt | LimitedSpectator-quilt-2.0.0.jar |
Uses Fabric API |
Installation Steps
- Install your mod loader (NeoForge 21.1.217+ / Fabric 0.16.5+ / Quilt 0.26.4+)
- Place the correct JAR into your
mods/folder - Launch Minecraft
- (NeoForge only) Config file auto-generates at
config/limitedspectator-common.toml - (NeoForge only) Reload changes with
/reloadcommand
Note: Fabric and Quilt versions use hardcoded defaults. Configuration system planned for future release.
🌍 Localization
Limited Spectator includes full translation support for the most common European languages:
Supported Languages:
- 🇬🇧 English (en_us) - Base language
- 🇮🇹 Italian (it_it) - Italiano
- 🇩🇪 German (de_de) - Deutsch
- 🇫🇷 French (fr_fr) - Français
- 🇪🇸 Spanish (es_es) - Español
Translated Messages:
- Command feedback (
/spectatorand/survival) - Distance limit notifications
- Error messages (dimension travel, crafting restrictions)
- All user-facing text
The mod automatically detects your Minecraft language setting and displays messages accordingly.
⚠️ Minecraft ADVENTURE Mode Limitations
Limited Spectator uses Minecraft's ADVENTURE mode (instead of SPECTATOR mode) to prevent noclip while allowing flight. This design choice introduces some inherent limitations:
Core Limitations (By Design)
These are NOT bugs - they are fundamental restrictions of Minecraft's ADVENTURE mode that cannot be overridden:
Manual Flight Activation: Players must double-press spacebar to start flying. Auto-start flying requires vanilla SPECTATOR mode (which enables noclip).
Fall Damage Only: When
mayfly=true, Minecraft's engine prevents fall damage calculation entirely. However,enable_invulnerability=trueDOES protect against mobs, lava, fire, cacti, and other environmental damage.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.
Why These Limitations Exist
Limited Spectator prioritizes observation without noclip over feature completeness. Enabling vanilla SPECTATOR mode would allow players to:
- Phase through walls and blocks (noclip)
- Access areas they shouldn't see
- Bypass server protections
These limitations preserve the mod's core purpose: balanced spectating for servers.
Alternative: Use SPECTATOR Mode
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.
🧾 License
This project is licensed under the MIT License. See the LICENSE file for details. Copyright (c) 2025 karashi
You may use, modify, and distribute this mod freely, provided that attribution is maintained.
📦 Project Links
| Platform | Link |
|---|---|
| CurseForge | Limited Spectator on CurseForge |
| GitHub | GitHub Repository |
| Issues | Report Bugs / Suggestions |
❤️ Credits
• Author: Karashi
• Development: Full custom codebase for NeoForge 1.21.1
• Icon Design: AI-generated minimalist design (OpenAI)
• Special thanks: Minecraft & NeoForge community
🚀 Future Roadmap
• 🧱 Optional integration with third-party permission systems (LuckPerms, FTB Chunks)
• 🔍 Extended API for custom spectator events (SpectatorModeEnterEvent, SpectatorModeExitEvent)
• 💾 Persistent state storage (save spectator positions across server restarts)
• ⏱️ Spectator time limits (configurable max duration in spectator mode)
• ✨ Particle effects or visual boundaries for distance limits
🧭 Limited Spectator
A multi-loader Minecraft mod that introduces a restricted spectator mode with configurable limitations.
Supported Loaders: NeoForge ✅ • Fabric ✅ • Quilt ✅ (Production Only)
📖 Overview
Limited Spectator allows players to enter a controlled spectator mode that limits what they can do while flying and observing the world. Unlike 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.
Perfect for:
• SMP;
• Builders who want visual observation without full spectator privileges.
✨ Features
✅ Fully Configurable Spectator Mode Comprehensive TOML-based configuration system allowing server owners to customize every aspect of spectator behavior.
✅ Limited Spectator Mode Players can enter a custom spectator state that allows free flight but prevents inventory use, PvP, and world interactions.
✅ Flexible Distance Limits Configure maximum travel distance from start position (default 75 blocks) or disable it entirely. Choose between teleport-back or warning behavior.
✅ Customizable Block Interactions Define exactly which blocks players can interact with using Minecraft block IDs. Default includes doors, trapdoors, and fence gates.
✅ Granular Permission Control
Set different permission levels (0-4) for /spectator and /survival commands, with optional OP requirement.
✅ Selective HUD Visibility HUD elements remain hidden by default but can be temporarily shown by pressing F1 (configurable).
✅ Dimension Travel Control Configure whether players can switch dimensions (Nether, End, etc.) while in spectator mode.
✅ Player Repositioning
Automatic position reset when exceeding distance limits or executing /survival command.
✅ Flight Capability Players in spectator mode can fly by double-pressing the space bar.
✅ Combat & Interaction Restrictions Individually toggle PvP, mob attacks, item drop/pickup, and inventory crafting.
✅ Hot-Reloadable Configuration
All settings can be changed in config/limitedspectator-common.toml and reloaded with /reload command.
✅ Server-Friendly All restrictions are handled server-side for secure multiplayer behavior.
✅ Multilingual Support Full translation support for 5 European languages (English, Italian, German, French, Spanish).
🧠 Technical Details
| Aspect | Value |
|---|---|
| Version | 2.0.0 |
| Minecraft | 1.21.1 → 1.21.11+ (cross-version compatible) |
| Mod Loaders | NeoForge ✅ • Fabric ✅ • Quilt ✅ |
| NeoForge | 21.1.217+ |
| Fabric Loader | 0.16.5+ |
| Fabric Loom | 1.7.3+ |
| Quilt Loader | 0.26.4+ |
| Quilt Loom | 1.7.3+ (Production only) |
| Java | 21 |
| Mod ID | limitedspectator |
⚙️ Commands
| Command | Description | Default Permission |
|---|---|---|
/spectator |
Switch to the limited spectator mode | Level 0 (everyone) |
/survival |
Return to normal gameplay and restore the HUD | Level 0 (everyone) |
🌍 Command feedback messages are fully localized in 5 languages: English, Italian, German, French, and Spanish.
Note: Permission levels can be customized in the config file. See Configuration section below.
⚙️ Configuration
Limited Spectator features a comprehensive configuration system. On first launch, a config file is automatically generated at:
Location: config/limitedspectator-common.toml
Configuration Categories
🚶 Movement Restrictions
max_distance- Maximum travel distance from start position (default: 75.0 blocks, -1 to disable)allow_dimension_travel- Allow dimension changes in spectator mode (default: false)teleport_back_on_exceed- Teleport back when exceeding distance vs. warning (default: true)reset_position_on_logout- Reset position on logout to prevent abuse (default: true)
🎮 Player Abilities
enable_invulnerability- Make players invulnerable (protects from mobs and environmental damage, not fall damage) (default: true)enable_flight- Allow flight in spectator mode (default: true)spectator_gamemode- GameMode to use: "ADVENTURE" or "SPECTATOR" (default: "ADVENTURE")
🔧 Interaction Restrictions
allow_pvp- Allow attacking other players (default: false)allow_item_drop- Allow dropping items (default: false)allow_item_pickup- Allow picking up items (default: false)allow_inventory_crafting- Allow inventory crafting (2x2 grid) (default: false)interactable_blocks- List of block IDs players can interact with (default: all doors, trapdoors, gates)
Note: Mob attacks are always disabled because mobs don't target players with mayfly=true ability (Minecraft core behavior).
🔐 Command Permissions
spectator_command_permission_level- Permission level for/spectator(0-4, default: 0)survival_command_permission_level- Permission level for/survival(0-4, default: 0)require_op_for_spectator- Require OP status for spectator commands (default: false)
🖥️ Client & HUD Behavior
- HUD automatically hides when entering spectator mode (hard-coded)
- F1 key toggles HUD visibility temporarily
💬 Message Settings
use_action_bar_messages- Show messages in action bar instead of chat (default: true)show_distance_warnings- Show warnings when approaching distance limit (default: true)
Example Configurations
Server with relaxed spectator mode:
[movement_restrictions]
max_distance = -1 # No distance limit
allow_dimension_travel = true
[interactions]
allow_item_pickup = true # Allow picking up items
interactable_blocks = ["minecraft:oak_door", "minecraft:lever", "minecraft:stone_button"]
Strict survival server:
[permissions]
spectator_command_permission_level = 2 # Requires moderator rank
require_op_for_spectator = true
[movement_restrictions]
max_distance = 50.0 # Shorter distance limit
reset_position_on_logout = true # Prevent logout abuse
All configuration changes can be applied without restarting the server using /reload.
🔐 Default Restrictions in Spectator Mode
Note: Most restrictions below are configurable via config/limitedspectator-common.toml
• ❌ No block breaking or placing (enforced by ADVENTURE mode - cannot be changed)
• ❌ No chest, bed, crafting table, or item interactions (configurable via block whitelist)
• ❌ No inventory crafting (2x2 grid) - ingredients restored automatically (configurable)
• ❌ No dimension travel (configurable)
• ❌ No mob attacks (mobs don't target players with mayfly ability)
• ❌ No PvP (configurable)
• ❌ No item dropping or pickup (individually configurable)
• ✅ Doors, trapdoors, and fence gates remain interactable (fully customizable via block IDs)
• ✅ F1 toggles HUD visibility (configurable)
• ✅ Distance limit: 75 blocks (configurable, can be disabled)
🧩 Compatibility
• ✅ Minecraft 1.21.1+
• ✅ NeoForge 21.1.0+
• ✅ Multiplayer-safe
• ⚠️ 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.
🌐 Environment Requirements
Limited Spectator is a server-authoritative mod. The Modrinth "Client and server" tag refers to where the mod can be installed, not where it is required.
| Where to install | Required | Result |
|---|---|---|
| Server | ✅ Yes | All gameplay restrictions (distance limits, item drop/pickup, interactions, attacks, dimension travel, command permissions) are enforced here. The mod cannot function without being on the server. |
| Client | ⚪ Optional but highly recommended | Enables a richer UX: HUD auto-hide when entering /spectator, F1 toggle for temporary HUD reveal, and tighter sync with world events/interactions. |
Connection compatibility
- Vanilla clients can join a server running Limited Spectator. All restrictions still apply server-side — players just won't get the HUD-hide effect.
- Clients with Limited Spectator installed get the full intended experience (clean HUD, synced events).
Per-loader detail
- Fabric & Quilt builds: no client-side code currently exists, so the JAR is effectively server-only. Installing it on the client is harmless but adds no extra features today.
- NeoForge build: the only client-side piece is a small optional packet handler for HUD sync. The network channel is registered as optional, so connection handshake works against both modded and vanilla clients.
Recommended setup
| Use case | Server | Client |
|---|---|---|
| Public SMP with vanilla guests | Required | Vanilla works, install for full UX |
| Private server, all members modded | Required | Install on both for best experience |
| Single-player testing | n/a | Required (acts as local server) |
🧰 Installation
📦 Choose Your Loader
Download the correct version for your mod loader:
| Loader | File | Notes |
|---|---|---|
| NeoForge | LimitedSpectator-neoforge-2.0.0.jar |
Full config support |
| Fabric | LimitedSpectator-fabric-2.0.0.jar |
Hardcoded defaults |
| Quilt | LimitedSpectator-quilt-2.0.0.jar |
Uses Fabric API |
Installation Steps
- Install your mod loader (NeoForge 21.1.217+ / Fabric 0.16.5+ / Quilt 0.26.4+)
- Place the correct JAR into your
mods/folder - Launch Minecraft
- (NeoForge only) Config file auto-generates at
config/limitedspectator-common.toml - (NeoForge only) Reload changes with
/reloadcommand
Note: Fabric and Quilt versions use hardcoded defaults. Configuration system planned for future release.
🌍 Localization
Limited Spectator includes full translation support for the most common European languages:
Supported Languages:
- 🇬🇧 English (en_us) - Base language
- 🇮🇹 Italian (it_it) - Italiano
- 🇩🇪 German (de_de) - Deutsch
- 🇫🇷 French (fr_fr) - Français
- 🇪🇸 Spanish (es_es) - Español
Translated Messages:
- Command feedback (
/spectatorand/survival) - Distance limit notifications
- Error messages (dimension travel, crafting restrictions)
- All user-facing text
The mod automatically detects your Minecraft language setting and displays messages accordingly.
⚠️ Minecraft ADVENTURE Mode Limitations
Limited Spectator uses Minecraft's ADVENTURE mode (instead of SPECTATOR mode) to prevent noclip while allowing flight. This design choice introduces some inherent limitations:
Core Limitations (By Design)
These are NOT bugs - they are fundamental restrictions of Minecraft's ADVENTURE mode that cannot be overridden:
-
Manual Flight Activation: Players must double-press spacebar to start flying. Auto-start flying requires vanilla SPECTATOR mode (which enables noclip).
-
Fall Damage Only: When
mayfly=true, Minecraft's engine prevents fall damage calculation entirely. However,enable_invulnerability=trueDOES protect against mobs, lava, fire, cacti, and other environmental damage. -
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.
Why These Limitations Exist
Limited Spectator prioritizes observation without noclip over feature completeness. Enabling vanilla SPECTATOR mode would allow players to:
- Phase through walls and blocks (noclip)
- Access areas they shouldn't see
- Bypass server protections
These limitations preserve the mod's core purpose: balanced spectating for servers.
Alternative: Use SPECTATOR Mode
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.
🧾 License
This project is licensed under the MIT License. See the LICENSE file for details. Copyright (c) 2025 karashi
You may use, modify, and distribute this mod freely, provided that attribution is maintained.
📦 Project Links
| Platform | Link |
|---|---|
| CurseForge | Limited Spectator on CurseForge |
| GitHub | GitHub Repository |
| Issues | Report Bugs / Suggestions |
❤️ Credits
• Author: Karashi
• Development: Full custom codebase for NeoForge 1.21.1
• Icon Design: AI-generated minimalist design (OpenAI)
• Special thanks: Minecraft & NeoForge community
🚀 Future Roadmap
• 🧱 Optional integration with third-party permission systems (LuckPerms, FTB Chunks)
• 🔍 Extended API for custom spectator events (SpectatorModeEnterEvent, SpectatorModeExitEvent)
• 💾 Persistent state storage (save spectator positions across server restarts)
• ⏱️ Spectator time limits (configurable max duration in spectator mode)
• ✨ Particle effects or visual boundaries for distance limits
Screenshots
Gallery
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers