# MapVNC – Your VNC Client, inside Minecraft<\/p>\n
\n
\n<\/p>\n
MapVNC is a powerful plugin that brings a fully interactive VNC client directly into the game world. Using the robust MapEngine API, it renders a remote desktop onto a dynamic grid of in-game maps, allowing players to view and control a remote computer from within Minecraft.<\/p>\n
Whether for server administration, remote monitoring, or just for fun, MapVNC provides a seamless and unique integration between Minecraft and any VNC-enabled machine.<\/p>\n
## Features<\/p>\n
– **Dynamic Display Creation**: Create VNC screens of any size, anywhere in the world.
\n– **Real-Time Rendering**: View a remote desktop with configurable color depth for performance tuning.
\n– **Full Interactivity**:
\n – **Mouse Control**: Point and click on the maps to control the remote cursor.
\n – **Mouse Dragging**: A sneak-based system to simulate clicking and dragging.
\n – **Text Input**: Type text directly into the remote session via commands.
\n – **Key Presses**: Send special key events like Enter, Shift, and Escape.
\n– **In-Game Management**: Easily move, resize, and remove VNC displays without restarting.
\n– **Proximity-Based Rendering**: Displays are only rendered for nearby players to ensure optimal server performance.
\n– **Quick Target Selector**: Use `-1` as an ID to automatically target the nearest screen.
\n– **Detailed Permission System**: Fine-grained control over who can create, manage, and interact with displays.
\n– **User-Friendly Commands**: Intuitive commands with rich tab-completion to guide users.<\/p>\n
## Prerequisites<\/p>\n
– **Server Software**: Paper, Spigot, or a compatible fork (1.21+ recommended).
\n– **Java**: Java 21 or higher.
\n– **Dependency**: **MapEngine 1.8.10+** is a **required** dependency. MapVNC will not start without it.<\/p>\n
## Installation<\/p>\n
1. Ensure you have **MapEngine 1.8.10+** installed on your server.
\n2. Download the latest `MapVNC-*-all.jar` file from the “Versions” tab.
\n3. Place the downloaded JAR file into your server’s `plugins` directory.
\n4. Restart or reload your server.<\/p>\n
## Commands & Usage<\/p>\n
The main command is `\/mapvnc`, which can be shortened to `\/mvnc`.<\/p>\n
—<\/p>\n
### Targeting the Nearest Screen<\/p>\n
For convenience, you don’t always need to know a display’s specific ID. For any command that requires an ` When you use `-1`, the plugin will automatically find and target the nearest VNC display within a **16-block radius** of your location. The distance is measured from the display’s anchor point (its top-left corner).<\/p>\n **Example:** Stand near a screen and type `\/mvnc connect -1` to connect it, without ever needing to run `\/mvnc list`.<\/p>\n This feature works for: `remove`, `set`, `connect`, `disconnect`, `input`, and `key`.<\/p>\n —<\/p>\n ### Command List<\/p>\n | Command | Description | Permission | —<\/p>\n ### Mouse Dragging<\/p>\n You can simulate clicking and dragging (e.g., to select text or move a window) with a special sneak-based mechanic:<\/p>\n 1. **Aim** at the spot on the map where you want to start the drag. —<\/p>\n ## Permissions<\/p>\n | Permission Node | Description | Default | ## License<\/p>\n This project is licensed under the MIT License. See the LICENSE file for details.<\/p>\n","protected":false},"excerpt":{"rendered":" A powerful plugin that brings a fully interactive VNC client directly into the Minecraft world.<\/p>\n","protected":false},"featured_media":98318,"template":"","meta":{"_minecraft_slug":"mapvnc","_minecraft_project_id":"sqYtP2lc","_minecraft_author":"Steve3184","_minecraft_license":"MIT","_minecraft_downloads":63,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mapvnc.zip","_minecraft_size_bytes":112478,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:42:55.776957Z","_minecraft_date_created":"2025-10-09T04:24:13.991107Z","_minecraft_date_modified":"2025-10-06T17:22:11.328888Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mapvnc","_minecraft_icon_attachment_id":98318,"_minecraft_imported_at":"2026-06-05T15:28:38+00:00","_minecraft_import_hash":"ffc606bb3f46b91fc8c59d3b36b5ba3f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,127,128,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[57,58,59,36,60,93,94,101,102,62,37,73,74,38,78,79,80,81,82],"class_list":["post-98317","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-19-3","minecraft_version-1-19-4","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-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| ————————————————– | —————————————————- | ————————- |
\n| `\/mvnc create
\n| `\/mvnc remove
\n| `\/mvnc list` | Lists all active VNC displays. | `mapvnc.command.list` |
\n| `\/mvnc set
\n| `\/mvnc set
\n| `\/mvnc set
\n| `\/mvnc set
\n| `\/mvnc set
\n| `\/mvnc connect
\n| `\/mvnc disconnect
\n| `\/mvnc input
\n| `\/mvnc key
\n2. **Hold down your Sneak key** (L-SHIFT by default).
\n3. While still sneaking, **Left-Click** on the map. A “Mouse Down” event is sent, and an ActionBar message will appear confirming you are in dragging mode.
\n4. To move the mouse while dragging, simply **click on other parts of the map**. You must remain in sneak mode.
\n5. When you are finished, **Release the Sneak key**. This sends the “Mouse Up” event, completing the drag operation.<\/p>\n
\n| ————————- | —————————————————————— | ——- |
\n| `mapvnc.*` | Grants access to all MapVNC features and commands. | OP |
\n| `mapvnc.command.*` | Grants access to all MapVNC subcommands. | OP |
\n| `mapvnc.command.base` | Allows using MapVNC’s main command. | OP |
\n| `mapvnc.command.create` | Allows creating new VNC displays. | OP |
\n| `mapvnc.command.remove` | Allows removing VNC displays. | OP |
\n| `mapvnc.command.list` | Allows listing active VNC displays. | OP |
\n| `mapvnc.command.set` | Allows modifying display properties (address, size, etc.). | OP |
\n| `mapvnc.command.connect` | Allows connecting a display to a VNC server. | OP |
\n| `mapvnc.command.disconnect`| Allows disconnecting a display. | OP |
\n| `mapvnc.command.input` | Allows typing text into a display. | OP |
\n| `mapvnc.command.key` | Allows sending key presses to a display. | OP |<\/p>\n