-
Notifications
You must be signed in to change notification settings - Fork 0
Beta Features (v1.1.0‐beta)
This page documents the beta version 1.1.0 of Limited Spectator, which introduces a complete configuration system and many new features.
This is a BETA release with known issues. Do not use on production servers without thorough testing.
✅ Use Beta if:
- You're testing on a development/test server
- You need configurable distance limits or permissions
- You want to customize interaction restrictions
- You're comfortable troubleshooting issues
❌ Use Stable (v1.0.2) if:
- You're running a production server
- You need 100% reliability
- You're okay with hardcoded settings
- You want a tested, stable experience
The biggest change: everything is now configurable via config/limitedspectator-common.toml.
The config file is automatically generated on first launch with 25+ options organized into sections:
[movement]
max_distance = 75.0
allow_dimension_travel = false
teleport_back_on_exceed = true
reset_position_on_logout = true
[player_abilities]
enable_invulnerability = true
enable_flight = true
spectator_gamemode = "ADVENTURE"
[interactions]
allow_pvp = false
allow_item_drop = false
allow_item_pickup = false
allow_inventory_crafting = false
interactable_blocks = ["minecraft:oak_door", ...]
[commands]
spectator_command_permission_level = 0
survival_command_permission_level = 0
require_op_for_spectator = false
[messages]
use_action_bar_messages = true
show_distance_warnings = trueSee the full Configuration Guide for details on every option.
Stable v1.0.2: Fixed 75 blocks (hardcoded) Beta v1.1.0: Fully configurable
[movement]
# Set to -1 for unlimited distance
max_distance = 75.0
# Choose teleport vs warning
teleport_back_on_exceed = trueExamples:
-
max_distance = 50.0- Tight restriction -
max_distance = 200.0- Wide area -
max_distance = -1.0- Unlimited (not recommended)
Stable v1.0.2: All players can use commands (permission level 0) Beta v1.1.0: Configurable per-command
[commands]
# 0 = all players, 2 = operators, 4 = console only
spectator_command_permission_level = 0
survival_command_permission_level = 0
# Require OP status regardless of level
require_op_for_spectator = falseUse Cases:
- Public servers: Set
spectator_command_permission_level = 2(ops only) - Private servers: Keep at
0(all players) - Strict control: Enable
require_op_for_spectator = true
Stable v1.0.2: Hardcoded (doors, trapdoors, gates only) Beta v1.1.0: Per-interaction toggles + custom block whitelist
[interactions]
allow_pvp = false
allow_item_drop = false
allow_item_pickup = false
allow_inventory_crafting = false
# Custom block whitelist (any Minecraft block ID)
interactable_blocks = [
"minecraft:oak_door",
"minecraft:stone_button",
"minecraft:lever",
"create:copper_valve_handle" # Modded blocks too!
]Comparison:
| Feature | Stable | Beta |
|---|---|---|
| PvP Toggle | ❌ Always off | ✅ Configurable |
| Mob Attacks | ❌ Always off | ✅ Configurable |
| Item Drop | ❌ Always off | ✅ Configurable |
| Item Pickup | ❌ Always off | ✅ Configurable |
| Block Whitelist | ❌ Hardcoded | ✅ Custom list |
Stable v1.0.2: Requires restart to change settings (hardcoded)
Beta v1.1.0: Live reload via /reload command
Changes take effect immediately:
/reload
No server restart needed for config changes!
Stable v1.0.2: Always uses Adventure mode Beta v1.1.0: Choose between Adventure or vanilla Spectator
[abilities]
# "ADVENTURE" or "SPECTATOR"
spectator_gamemode = "ADVENTURE""SPECTATOR" may allow noclip and bypass restrictions. Only use on trusted servers.
Stable v1.0.2: Always invulnerable Beta v1.1.0: Configurable
[abilities]
enable_invulnerability = trueNote: Due to a known issue, disabling this doesn't enable fall damage (see Known Issues below).
Stable v1.0.2: Action bar messages only Beta v1.1.0: Choose action bar or chat
[messages]
use_action_bar_messages = true
show_distance_warnings = trueStable v1.0.2: Bug when switching dimensions Beta v1.1.0: Fixed with proper dimension tracking
The beta correctly saves and restores your dimension when using /survival, preventing cross-dimension bugs.
Status: Minecraft Engine Limitation (Not a Bug) Severity: N/A
Description: Fall damage is always prevented when mayfly=true (Minecraft core behavior). This cannot be changed even with enable_invulnerability=false.
Workaround: None. This is a Minecraft engine limitation, not a mod issue.
Impact: Spectators are always protected from fall damage. enable_invulnerability protects against other damage types (drowning, lava, fire, etc.)
| Feature | Stable v1.0.2 | Beta v1.1.0 |
|---|---|---|
| Stability | ✅ Production-ready | |
| Configuration File | ❌ No config | ✅ Full TOML config |
| Distance Limit | 🔒 75 blocks (hardcoded) | ✅ Configurable |
| Permission Levels | 🔒 Level 0 (hardcoded) | ✅ Configurable |
| Interaction Toggles | 🔒 Hardcoded | ✅ Individual toggles |
| Block Whitelist | 🔒 Doors/gates only | ✅ Custom list |
| Hot-Reload | ❌ Restart needed | ✅ /reload support |
| Dimension Fix | ✅ Fixed | |
| Known Issues | ✅ None | |
| Best For | Production servers | Testing/advanced |
Upgrading from v1.0.2 to v1.1.0-beta:
# Backup your server
cp -r server/ server-backup/
# Backup player data
cp -r world/playerdata/ world/playerdata-backup/- Stop the server
- Remove
LimitedSpectator-1.21.1-1.0.2.jarfrommods/ - Add
LimitedSpectator-1.21.1-1.1.0-beta.jartomods/ - Start the server
The config file generates automatically at config/limitedspectator-common.toml with defaults matching stable behavior:
[movement]
max_distance = 75.0 # Same as stable
allow_dimension_travel = false # Same as stable
[interactions]
# All false - same as stable
interactable_blocks = [doors, trapdoors, gates] # Same as stableDefault config replicates stable v1.0.2 behavior, so no changes needed unless you want to customize.
Test on a development server first:
- Test
/spectatorand/survivalcommands - Verify distance limits work
- Test dimension travel blocking
- Verify interactions are blocked correctly
- Check HUD hiding
- Test with multiple players
If testing succeeds, deploy to production. If issues occur:
- Stop server
- Restore stable JAR:
cp server-backup/mods/LimitedSpectator-1.21.1-1.0.2.jar mods/ - Delete beta JAR
- Delete config:
rm config/limitedspectator-common.toml - Start server
Help improve Limited Spectator by testing the beta!
- Go to GitHub Issues
- Title:
[Beta 1.1.0] <short description> - Include:
- Steps to reproduce
- Expected vs actual behavior
- Config file (
limitedspectator-common.toml) - Server logs (
logs/latest.log) - Minecraft/NeoForge versions
Priority testing areas:
- Configuration hot-reloading
- Custom permission levels
- Custom block whitelists
- Distance limit variations (50, 100, 500, unlimited)
- Interaction toggles (PvP, mob attacks, items)
- Dimension travel blocking
- Multi-player scenarios
The following must be resolved before v1.1.0 goes stable:
- Fix auto-start flying (high priority)
- Document or fix fall damage (high priority)
- Resolve block breaking/placing or remove config options (medium priority)
- Testing period: At least 2 weeks of beta testing on various servers
Estimated: 2-4 weeks after v1.1.0-beta (TBD based on testing feedback)
- Configuration Guide - Full configuration reference (beta only)
- Version Comparison - Detailed feature comparison
- Installation - How to install beta version
- FAQ & Troubleshooting - Common issues
Ready to test? Download v1.1.0-beta and report your findings on GitHub Issues!