## \ud83d\udc7b **GuestMode \u2014 Visible Spectators for Your World**<\/p>\n
**GuestMode** is a lightweight plugin for **Folia (Minecraft 1.21+)** that lets your friends **join your world as visible spectators** \u2014 exploring freely **without affecting gameplay**.<\/p>\n
Players in **guest mode** are **completely isolated** from the world around them:<\/p>\n
* \u274c Cannot break or place blocks
\n* \u274c Cannot use doors, chests, beds, crafting tables, or any interactive blocks
\n* \u274c Cannot attack, take damage, pick up items, or collect XP
\n* \u274c Cannot interact with mobs, ride entities, or throw potions and projectiles
\n* \ud83d\udc41\ufe0f\u200d\ud83d\udde8\ufe0f Are ignored by all mobs (*but mobs can still look at them*)
\n* \ud83e\uddca Cannot push or move any entities \u2014 including players *(but normal players can still nudge guests)*
\n* \ud83d\udd4a\ufe0f Can **fly freely** for complete exploration freedom *(future updates may add per-player settings)*<\/p>\n
Guests **remain visible** and **can explore the world freely**, but they **cannot influence it in any way**.<\/p>\n
—<\/p>\n
## \ud83c\udd95 New in 1.3<\/p>\n
* You can now change **guest permissions** directly in the **config file** \u2014 the full configuration is included at the **bottom of this page**.<\/p>\n
—<\/p>\n
## \ud83c\udd95 New in 1.2<\/p>\n
* \ud83d\udca4 **Guests are not counted for sleeping** \u2013 only real players need to sleep to accelerate the night.
\n* \ud83d\udc7b **Phantom targeting fixed** \u2013 phantoms no longer spawn based on guest players.
\n* \u23f8\ufe0f **World pause logic** \u2013 the world is automatically paused when only guests (or no one) are online *(future updates may allow disabling this setting in the config)*<\/p>\n
—<\/p>\n
## \ud83e\udd1d Compatibility<\/p>\n
\u2705 **Fully compatible with RealisticSleep (Folia)** \u2014 guest players are automatically ignored by sleep checks, so only real players are required to sleep for the night to pass.<\/p>\n
—<\/p>\n
## \u2699\ufe0f **Commands**<\/p>\n
“` Toggle guest mode for any player instantly.<\/p>\n “` Show the GuestMode help menu.<\/p>\n —<\/p>\n ## \ud83e\udde9 **Configuration**<\/p>\n “`yaml # === PLAYER MODE LISTS === # =============================== # === MOVEMENT & PHYSICS === # === ANTI-PUSH SYSTEM === # AABB padding – safety margin around hitboxes (in blocks) # Top epsilon – gap when landing on entities (in blocks) # Detection radius – how far to check for nearby entities (in blocks) # Safe gap – minimum space maintained between hitboxes after push (in blocks) # Max resolution iterations – attempts to resolve complex overlaps # === WORLD FREEZING === # What to freeze when no normal players are present: # === EXPERIENCE ORBS === # === GUEST INVISIBILITY === # =============================== # What guests CAN do (set to true to allow, false to deny): # Items & inventory # Containers & storage # Entities # Animals & breeding # Beds & respawn # Combat & projectiles # Fire & explosions # Progression —<\/p>\n Invite your friends to **join, watch, and explore \u2014 without ever interfering** in your adventure.<\/p>\n","protected":false},"excerpt":{"rendered":" A plugin that turns players into visitors who cannot interact with the world in any way<\/p>\n","protected":false},"featured_media":78396,"template":"","meta":{"_minecraft_slug":"guestmode","_minecraft_project_id":"qXBcQhWZ","_minecraft_author":"DEN35","_minecraft_license":"MIT","_minecraft_downloads":117,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"guestmode.zip","_minecraft_size_bytes":69350,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T19:15:37.267849Z","_minecraft_date_created":"2025-10-22T03:46:27.513169Z","_minecraft_date_modified":"2025-11-01T23:17:23.568583Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/guestmode","_minecraft_icon_attachment_id":78396,"_minecraft_imported_at":"2026-06-04T12:28:53+00:00","_minecraft_import_hash":"35989f9a708ada384aff78719e88b6b2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,92],"mod_loader":[131],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-78395","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-utility","mod_loader-folia","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","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
\n\/guest
\n\/guest
\n“`<\/p>\n
\n# ===============================
\n# GuestMode configuration guide
\n# ===============================
\n#
\n# === PLAYER LISTS ===
\n# Two lists control who is a GUEST and who is NORMAL:
\n#
\n# – guests: players treated as GUESTS.
\n# – except: players treated as NORMAL (never guests).
\n#
\n# Special token:
\n# – “[all]” (must be quoted!) \u2014 a global switch.
\n#
\n# Modes
\n# —–
\n# 1) Individual mode (no “[all]” anywhere)
\n# – Only players listed under `guests` are guests.
\n# – Players in `except` are always normal.
\n#
\n# 2) Global guests mode (put “[all]” in `guests`)
\n# – Everyone is a guest EXCEPT the names listed in `except`.
\n# – `except` is the allow-list for being normal in this mode.
\n#
\n# 3) Global except mode (put “[all]” in `except`)
\n# – Everyone is normal EXCEPT the names listed in `guests`, who become guests.
\n# – `guests` is the allow-list for being a guest in this mode.
\n#<\/p>\n
\nexcept:
\n – Player1
\nguests:
\n – ‘[all]’
\n – Player2<\/p>\n
\n# GUEST ABILITIES & RESTRICTIONS
\n# ===============================<\/p>\n
\n# Auto-enable flight for guests
\nauto_flight: true<\/p>\n
\n# Prevents guests from pushing other players\/entities
\n# Guests phase through collisions without affecting normal players
\nanti_push:
\n enabled: true # tested<\/p>\n
\n # Larger = more separation, but may feel “floaty”
\n aabb_padding: 0.10 # Set to 0.65 so that guests are always one block apart from players and other entities (the player can dig without restrictions)<\/p>\n
\n top_epsilon: 0.05<\/p>\n
\n detection_radius: 3.0<\/p>\n
\n safe_gap: 0.05<\/p>\n
\n max_iterations: 5<\/p>\n
\n# When only guests (or no players) are in a world, freeze it to save resources
\nworld_freeze:<\/p>\n
\n freeze_daylight_cycle: true # Stop time progression
\n freeze_weather_cycle: true # Stop weather changes
\n freeze_mob_spawning: true # Prevent new mob spawns
\n freeze_random_ticks: true # Stop crop growth, leaf decay, etc.
\n freeze_mob_ai: true # Stop mob movement and targeting
\n freeze_mob_gravity: true # Make mobs float in place
\n make_mobs_invulnerable: true # Prevent damage to frozen mobs
\n enabled: false # tested; toggling unstable\u2014if world hangs, set true and restart<\/p>\n
\nexperience_orbs:
\n freeze_for_guests: true
\n freeze_radius: 10.0
\n position_tolerance: 0.25<\/p>\n
\n# Make guests invisible to mobs (and glow for players)
\ninvisibility:
\n enabled: true # tested
\n mob_attention_radius: 8.0
\n glow_for_players: true
\n glow_radius: 32.0<\/p>\n
\n# GUEST INTERACTION PERMISSIONS
\n# ===============================<\/p>\n
\npermissions:
\n # World interaction
\n break_blocks: false # tested \u2014 Set the player’s gamemode accordingly
\n place_blocks: false # tested
\n damage_blocks: false # tested (keep equal to break_blocks)
\n interact_blocks: false # tested (buttons, levers, doors, etc.)<\/p>\n
\n drop_items: false # tested
\n pickup_experience: false # tested
\n change_held_item: false # tested \u2014 BUG: can still change via middle-click (Pick Block)
\n swap_hands: true # tested
\n consume_items: false # tested \u2014 splash\/lingering potions are controlled by launch_projectiles
\n open_inventory: true # tested \u2014 requires interact_blocks; currently useless if interact_blocks is false.
\n # Future updates: per-block interaction allowlist will be added.<\/p>\n
\n use_buckets: false # tested \u2014 pouring works; filling (milk\/fish\/powdered snow) blocked; can allow via interact_entities or targeted exceptions
\n edit_books: false # tested
\n edit_signs: false # tested<\/p>\n
\n damage_entities: false # tested
\n interact_entities: false # tested
\n damage_vehicles: false # tested
\n destroy_vehicles: false # tested
\n place_hanging_entities: false # tested # Item frames, paintings
\n break_hanging_entities: false # tested
\n manipulate_armor_stands: false # tested<\/p>\n
\n tame_animals: false # tested
\n breed_animals: false # tested
\n shear_entities: false # tested
\n use_leash: false # tested<\/p>\n
\n use_beds: false # tested \u2014 BUG: sleep blocked, but spawn still sets<\/p>\n
\n launch_projectiles: false # tested
\n use_fishing_rod: false # tested<\/p>\n
\n ignite_blocks: false # tested \u2014 bug: only ignites TNT, no explosion if cause_explosions: false, requires interact_blocks: true
\n cause_explosions: false # tested<\/p>\n
\n earn_advancements: false # tested \u2014 consider showing a notice to guests
\n“`<\/p>\n