Let Me Peek

A server-side Minecraft mod that allows you to observe the actions of friends and other players through simple commands - without the need for physical movement of your character.

🔄 How It Works

Imagine a system that saves your position, inventory, and active effects while you temporarily use the view from another player's perspective. After observation ends, you are automatically returned to your original state without losing anything.

🔧 Key Features

Observation of any player without moving your own character

System for automatic saving and restoring of your position, items, and status effects

Smooth switching between different observation targets

Flexible privacy settings: private mode, blacklist/whitelist, automatic request acceptance

Crash protection: state recovery even after unexpected server restarts

Fully customizable parameters through configuration file

Integration with LuckPerms for detailed access control via permissions

PlaceholderAPI support for compatibility with other mods and plugins

⚡ Main Commands

/peek player <player>               # Start observing a player
/peek accept <player>               # Accept incoming observation request
/peek deny <player>                 # Decline incoming observation request
/peek stop                         # Stop current observation session
/peek cancel [player]              # Cancel outgoing request or specific player
/peek who                          # Show who you're observing or who's observing you
/peek invite <player>               # Send observation invitation
/peek stats [player (operators only)]    # View observation statistics
/peek debug                        # Show debug information (operators only)

⚙️ Settings Commands

/peek settings private <on/off>           # Enable/disable private mode
/peek settings auto-accept <on/off>       # Enable/disable auto-accept requests
/peek settings blacklist <add/remove/list> [player]  # Manage blacklist
/peek settings whitelist <add/remove/list> [player]  # Manage whitelist

👨‍💻 Administrative Commands

/peek manage stats                    # View global statistics
/peek manage top [page]              # Show top players by observation count
/peek manage list [page] [sort]      # List all players with statistics
/peek manage player <player>         # Show detailed player information
/peek manage sessions                # View all active observation sessions
/peek manage force-stop <player>     # Force stop player's session
/peek manage cleanup                 # Perform data cleanup
/peek manage reload                  # Reload configuration
/peek manage about                   # Show mod information

🛠️ For Developers

PlaceholderAPI Integration

The mod provides several placeholders for use with other mods or display systems:

%peekmod:peek_count%      - Number of times the player has observed others
%peekmod:peeked_count%    - Number of times the player has been observed
%peekmod:total_duration%  - Total observation time (formatted)
%peekmod:is_peeking%      - Is player currently observing? (yes/no)
%peekmod:is_private%      - Is private mode enabled? (yes/no)

📋 Configuration

Main configuration file: config/peek/config.yml (YAML format)