? GuestMode — 可见的旁观者,让你的世界更有趣
GuestMode 是一款专为 Folia (Minecraft 1.21+) 设计的轻量级插件,允许你的朋友以可见的旁观者身份加入你的世界——自由探索,同时不会影响游戏进程。
处于宾客模式的玩家与周围的世界完全隔离:
- ❌ 无法破坏或放置方块
- ❌ 无法使用门、箱子、床、工作台或任何交互方块
- ❌ 无法攻击、受到伤害、拾取物品或收集经验值
- ❌ 无法与生物互动、骑乘实体或投掷药水及投射物
- ?️?️ 会被所有生物忽略(但生物仍可以看向他们)
- ? 无法推动或移动任何实体——包括玩家 (但普通玩家仍然可以轻推宾客)
- ?️ 可以自由飞行,实现完全的探索自由 (未来的更新可能会添加针对每个玩家的设置)
宾客保持可见并可以自由探索世界,但他们无法以任何方式影响世界。
? 1.3 新增功能
- 你现在可以直接在配置文件中更改宾客权限——完整配置包含在本页面的底部。
? 1.2 新增功能
- ? 宾客不计入睡眠人数——只有真实玩家需要睡觉来加速夜晚。
- ? 修复了幻翼锁定问题——幻翼不再基于宾客玩家生成。
- ⏸️ 世界暂停逻辑——当只有宾客(或无人)在线时,世界会自动暂停 (未来的更新可能允许在配置文件中禁用此设置)
? 兼容性
✅ 完全兼容 RealisticSleep (Folia) —— 宾客玩家会自动被睡眠检查忽略,因此只有真实玩家需要睡觉才能让夜晚过去。
⚙️ 命令
/guest <player>
立即切换任意玩家的宾客模式。
/guest
显示 GuestMode 帮助菜单。
? 配置
# ===============================
# GuestMode 配置指南
# ===============================
#
# === 玩家列表 ===
# 两个列表控制谁是 GUEST(宾客),谁是 NORMAL(普通):
#
# - guests: 被视为 GUESTS 的玩家。
# - except: 被视为 NORMAL 的玩家(永远不会是宾客)。
#
# 特殊标记:
# - "[all]"(必须加引号!)—— 全局开关。
#
# 模式
# -----
# 1) 个体模式(任何地方都没有 "[all]")
# - 只有列在 `guests` 下的玩家是宾客。
# - 列在 `except` 中的玩家始终是普通玩家。
#
# 2) 全局宾客模式(将 "[all]" 放入 `guests`)
# - 除了 `except` 中列出的名字外,所有人都是宾客。
# - `except` 是在此模式下被视为普通的白名单。
#
# 3) 全局排除模式(将 "[all]" 放入 `except`)
# - 除了 `guests` 中列出的名字外,所有人都是普通玩家,这些人将成为宾客。
# - `guests` 是在此模式下成为宾客的白名单。
#
# === 玩家模式列表 ===
except:
- Player1
guests:
- '[all]'
- Player2
# ===============================
# 宾客能力与限制
# ===============================
# === 移动与物理 ===
# 自动为宾客启用飞行
auto_flight: true
# === 防推挤系统 ===
# 防止宾客推动其他玩家/实体
# 宾客穿过碰撞区域而不影响普通玩家
anti_push:
enabled: true # 已测试
# AABB 填充 - 命中框周围的安全余量(以方块为单位)
# 数值越大 = 分离度越高,但可能会感觉“漂浮”
aabb_padding: 0.10 # 设置为 0.65,使宾客始终与普通玩家和其他实体保持一个方块的距离(玩家可以无限制地挖掘)
# 顶部 epsilon - 落在实体上时的间隙(以方块为单位)
top_epsilon: 0.05
# 检测半径 - 检查附近实体的距离(以方块为单位)
detection_radius: 3.0
# 安全间隙 - 推开后命中框之间保持的最小空间(以方块为单位)
safe_gap: 0.05
# 最大解析迭代次数 - 尝试解决复杂的重叠
max_iterations: 5
# === 世界冻结 ===
# 当世界中只有宾客(或没有玩家)时,冻结它以节省资源
world_freeze:
# 当没有普通玩家在场时冻结什么:
freeze_daylight_cycle: true # 停止时间流逝
freeze_weather_cycle: true # 停止天气变化
freeze_mob_spawning: true # 阻止新生物生成
freeze_random_ticks: true # 停止作物生长、树叶腐烂等
freeze_mob_ai: true # 停止生物移动和锁定目标
freeze_mob_gravity: true # 使生物悬浮在原地
make_mobs_invulnerable: true # 防止冻结的生物受到伤害
enabled: false # 已测试;切换不稳定——如果世界卡住,请设置为 true 并重启
# === 经验球 ===
experience_orbs:
freeze_for_guests: true
freeze_radius: 10.0
position_tolerance: 0.25
# === 宾客隐身 ===
# 使宾客对生物不可见(并对玩家发光)
invisibility:
enabled: true # 已测试
mob_attention_radius: 8.0
glow_for_players: true
glow_radius: 32.0
# ===============================
# 宾客交互权限
# ===============================
# 宾客可以做什么(设置为 true 以允许,false 以禁止):
permissions:
# 世界交互
break_blocks: false # 已测试 — 相应地设置玩家的游戏模式
place_blocks: false # 已测试
damage_blocks: false # 已测试(应与 break_blocks 保持一致)
interact_blocks: false # 已测试(按钮、拉杆、门等)
# 物品与背包
drop_items: false # 已测试
pickup_experience: false # 已测试
change_held_item: false # 已测试 — BUG:仍可通过中键点击(快速选取)更改
swap_hands: true # 已测试
consume_items: false # 已测试 — 溅射/滞留药水的效果由 launch_projectiles 控制
open_inventory: true # 已测试 — 需要 interact_blocks;如果 interact_blocks 为 false,目前无用。
# 未来更新:将添加针对每个方块的交互白名单。
# 容器与存储
use_buckets: false # 已测试 — 倾倒操作有效;填充(牛奶/鱼/细雪)被阻止;可通过 interact_entities 或定向例外允许
edit_books: false # 已测试
edit_signs: false # 已测试
# 实体
damage_entities: false # 已测试
interact_entities: false # 已测试
damage_vehicles: false # 已测试
destroy_vehicles: false # 已测试
place_hanging_entities: false # 已测试 # 物品展示框、画作
break_hanging_entities: false # 已测试
manipulate_armor_stands: false # 已测试
# 动物与繁殖
tame_animals: false # 已测试
breed_animals: false # 已测试
shear_entities: false # 已测试
use_leash: false # 已测试
# 床与重生
use_beds: false # 已测试 — BUG:睡眠被阻止,但出生点设置仍然生效
# 战斗与投射物
launch_projectiles: false # 已测试
use_fishing_rod: false # 已测试
# 火焰与爆炸
ignite_blocks: false # 已测试 — bug:仅点燃 TNT,若 cause_explosions: false 则无爆炸效果,需要 interact_blocks: true
cause_explosions: false # 已测试
# 进度
earn_advancements: false # 已测试 — 建议向访客显示提示通知
---
邀请你的朋友**加入、观看和探索——而不会干扰你的冒险**。
? GuestMode — Visible Spectators for Your World
GuestMode is a lightweight plugin for Folia (Minecraft 1.21+) that lets your friends join your world as visible spectators — exploring freely without affecting gameplay.
Players in guest mode are completely isolated from the world around them:
- ❌ Cannot break or place blocks
- ❌ Cannot use doors, chests, beds, crafting tables, or any interactive blocks
- ❌ Cannot attack, take damage, pick up items, or collect XP
- ❌ Cannot interact with mobs, ride entities, or throw potions and projectiles
- ?️?️ Are ignored by all mobs (but mobs can still look at them)
- ? Cannot push or move any entities — including players (but normal players can still nudge guests)
- ?️ Can fly freely for complete exploration freedom (future updates may add per-player settings)
Guests remain visible and can explore the world freely, but they cannot influence it in any way.
? New in 1.3
- You can now change guest permissions directly in the config file — the full configuration is included at the bottom of this page.
? New in 1.2
- ? Guests are not counted for sleeping – only real players need to sleep to accelerate the night.
- ? Phantom targeting fixed – phantoms no longer spawn based on guest players.
- ⏸️ World pause logic – the world is automatically paused when only guests (or no one) are online (future updates may allow disabling this setting in the config)
? Compatibility
✅ Fully compatible with RealisticSleep (Folia) — guest players are automatically ignored by sleep checks, so only real players are required to sleep for the night to pass.
⚙️ Commands
/guest <player>
Toggle guest mode for any player instantly.
/guest
Show the GuestMode help menu.
? Configuration
# ===============================
# GuestMode configuration guide
# ===============================
#
# === PLAYER LISTS ===
# Two lists control who is a GUEST and who is NORMAL:
#
# - guests: players treated as GUESTS.
# - except: players treated as NORMAL (never guests).
#
# Special token:
# - "[all]" (must be quoted!) — a global switch.
#
# Modes
# -----
# 1) Individual mode (no "[all]" anywhere)
# - Only players listed under `guests` are guests.
# - Players in `except` are always normal.
#
# 2) Global guests mode (put "[all]" in `guests`)
# - Everyone is a guest EXCEPT the names listed in `except`.
# - `except` is the allow-list for being normal in this mode.
#
# 3) Global except mode (put "[all]" in `except`)
# - Everyone is normal EXCEPT the names listed in `guests`, who become guests.
# - `guests` is the allow-list for being a guest in this mode.
#
# === PLAYER MODE LISTS ===
except:
- Player1
guests:
- '[all]'
- Player2
# ===============================
# GUEST ABILITIES & RESTRICTIONS
# ===============================
# === MOVEMENT & PHYSICS ===
# Auto-enable flight for guests
auto_flight: true
# === ANTI-PUSH SYSTEM ===
# Prevents guests from pushing other players/entities
# Guests phase through collisions without affecting normal players
anti_push:
enabled: true # tested
# AABB padding - safety margin around hitboxes (in blocks)
# Larger = more separation, but may feel "floaty"
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)
# Top epsilon - gap when landing on entities (in blocks)
top_epsilon: 0.05
# Detection radius - how far to check for nearby entities (in blocks)
detection_radius: 3.0
# Safe gap - minimum space maintained between hitboxes after push (in blocks)
safe_gap: 0.05
# Max resolution iterations - attempts to resolve complex overlaps
max_iterations: 5
# === WORLD FREEZING ===
# When only guests (or no players) are in a world, freeze it to save resources
world_freeze:
# What to freeze when no normal players are present:
freeze_daylight_cycle: true # Stop time progression
freeze_weather_cycle: true # Stop weather changes
freeze_mob_spawning: true # Prevent new mob spawns
freeze_random_ticks: true # Stop crop growth, leaf decay, etc.
freeze_mob_ai: true # Stop mob movement and targeting
freeze_mob_gravity: true # Make mobs float in place
make_mobs_invulnerable: true # Prevent damage to frozen mobs
enabled: false # tested; toggling unstable—if world hangs, set true and restart
# === EXPERIENCE ORBS ===
experience_orbs:
freeze_for_guests: true
freeze_radius: 10.0
position_tolerance: 0.25
# === GUEST INVISIBILITY ===
# Make guests invisible to mobs (and glow for players)
invisibility:
enabled: true # tested
mob_attention_radius: 8.0
glow_for_players: true
glow_radius: 32.0
# ===============================
# GUEST INTERACTION PERMISSIONS
# ===============================
# What guests CAN do (set to true to allow, false to deny):
permissions:
# World interaction
break_blocks: false # tested — Set the player's gamemode accordingly
place_blocks: false # tested
damage_blocks: false # tested (keep equal to break_blocks)
interact_blocks: false # tested (buttons, levers, doors, etc.)
# Items & inventory
drop_items: false # tested
pickup_experience: false # tested
change_held_item: false # tested — BUG: can still change via middle-click (Pick Block)
swap_hands: true # tested
consume_items: false # tested — splash/lingering potions are controlled by launch_projectiles
open_inventory: true # tested — requires interact_blocks; currently useless if interact_blocks is false.
# Future updates: per-block interaction allowlist will be added.
# Containers & storage
use_buckets: false # tested — pouring works; filling (milk/fish/powdered snow) blocked; can allow via interact_entities or targeted exceptions
edit_books: false # tested
edit_signs: false # tested
# Entities
damage_entities: false # tested
interact_entities: false # tested
damage_vehicles: false # tested
destroy_vehicles: false # tested
place_hanging_entities: false # tested # Item frames, paintings
break_hanging_entities: false # tested
manipulate_armor_stands: false # tested
# Animals & breeding
tame_animals: false # tested
breed_animals: false # tested
shear_entities: false # tested
use_leash: false # tested
# Beds & respawn
use_beds: false # tested — BUG: sleep blocked, but spawn still sets
# Combat & projectiles
launch_projectiles: false # tested
use_fishing_rod: false # tested
# Fire & explosions
ignite_blocks: false # tested — bug: only ignites TNT, no explosion if cause_explosions: false, requires interact_blocks: true
cause_explosions: false # tested
# Progression
earn_advancements: false # tested — consider showing a notice to guests
Invite your friends to join, watch, and explore — without ever interfering in your adventure.
评论 0
登录后参与评分
还没有评论,来抢沙发吧