MapVNC - 你的 VNC 客户端,内置于 Minecraft
MapVNC 是一款强大的插件,它将一个完全交互式的 VNC 客户端直接带入游戏世界。借助强大的 MapEngine API,它会将远程桌面渲染到由动态网格组成的游戏地图中,允许玩家直接在 Minecraft 内查看和控制远程计算机。
无论是用于服务器管理、远程监控,还是仅仅为了好玩,MapVNC 都在 Minecraft 和任何支持 VNC 的机器之间提供了无缝且独特的集成体验。
特性
- 动态显示创建:在世界中的任何位置创建任意大小的 VNC 屏幕。
- 实时渲染:查看远程桌面,并可通过配置颜色深度来调整性能。
- 完全交互性:
- 鼠标控制:在地图上点击以控制远程光标。
- 鼠标拖拽:基于潜行键的系统,模拟点击和拖拽操作。
- 文本输入:通过命令直接将文本输入到远程会话中。
- 按键发送:发送 Enter、Shift 和 Escape 等特殊按键事件。
- 游戏内管理:无需重启即可轻松移动、调整大小和移除 VNC 显示。
- 基于距离的渲染:仅对附近的玩家渲染显示内容,以确保最佳服务器性能。
- 快速目标选择器:使用
-1 作为 ID 可自动锁定最近的屏幕。
- 详细的权限系统:精细控制谁可以创建、管理和与显示内容进行交互。
- 用户友好的命令:直观的命令配合丰富的 Tab 补全功能,引导用户使用。
前置要求
- 服务器软件:Paper、Spigot 或兼容的分支(推荐 1.21+)。
- Java:Java 21 或更高版本。
- 依赖项:MapEngine 1.8.10+ 是必需的依赖项。如果没有它,MapVNC 将无法启动。
安装
- 确保你的服务器上已安装 MapEngine 1.8.10+。
- 从“Versions”选项卡下载最新的
MapVNC-*-all.jar 文件。
- 将下载的 JAR 文件放入服务器的
plugins 目录中。
- 重启或重载你的服务器。
命令与用法
主要命令为 /mapvnc,可简写为 /mvnc。
锁定最近的屏幕
为了方便起见,你并不总是需要知道显示内容的特定 ID。对于任何需要 <id> 的命令,你可以使用 -1 作为特殊占位符。
当你使用 -1 时,插件会自动在你位置 16 格半径 范围内找到并锁定最近的 VNC 显示。距离是从显示的锚点(其左上角)开始计算的。
示例:站在屏幕附近并输入 /mvnc connect -1 进行连接,无需先运行 /mvnc list。
此功能适用于:remove、set、connect、disconnect、input 和 key。
命令列表
| 命令 |
描述 |
权限 |
/mvnc create <x> <y> <z> <width> <height> |
在指定坐标处创建一个新的 VNC 显示。 |
mapvnc.command.create |
/mvnc remove <id> |
移除具有给定 ID 的 VNC 显示。 |
mapvnc.command.remove |
/mvnc list |
列出所有活动的 VNC 显示。 |
mapvnc.command.list |
/mvnc set <id> address <ip> <port> |
设置显示的 VNC 服务器地址。 |
mapvnc.command.set |
/mvnc set <id> password [password] |
设置或清除显示的密码。 |
mapvnc.command.set |
/mvnc set <id> colordepth <8|16|24> |
设置连接质量(每像素位数)。 |
mapvnc.command.set |
/mvnc set <id> pos <x> <y> <z> |
将显示移动到新的位置。 |
mapvnc.command.set |
/mvnc set <id> size <width> <height> |
调整显示的大小。 |
mapvnc.command.set |
/mvnc connect <id> |
将显示连接到其配置的 VNC 服务器。 |
mapvnc.command.connect |
/mvnc disconnect <id> |
将显示从 VNC 服务器断开连接。 |
mapvnc.command.disconnect |
/mvnc input <id> <text...> |
在连接的显示中输入给定的文本。 |
mapvnc.command.input |
/mvnc key <id> <keyName> |
发送单个按键事件(例如 ENTER、SHIFT)。 |
mapvnc.command.key |
鼠标拖拽
你可以利用特殊的潜行机制来模拟点击和拖拽(例如,选中文本或移动窗口):
- 瞄准地图上你想开始拖拽的位置。
- 按住你的潜行键(默认为 L-SHIFT)。
- 在保持潜行的同时,左键点击地图。这将发送一个“鼠标按下”事件,并且动作栏会出现一条消息,确认你已进入拖拽模式。
- 要在拖拽过程中移动鼠标,只需点击地图的其他部分。你必须保持潜行状态。
- 完成后,释放潜行键。这将发送“鼠标抬起”事件,完成拖拽操作。
权限
| 权限节点 |
描述 |
默认值 |
mapvnc.* |
授予所有 MapVNC 功能和命令的访问权限。 |
OP |
mapvnc.command.* |
授予所有 MapVNC 子命令的访问权限。 |
OP |
mapvnc.command.base |
允许使用 MapVNC 的主命令。 |
OP |
mapvnc.command.create |
允许创建新的 VNC 显示。 |
OP |
mapvnc.command.remove |
允许移除 VNC 显示。 |
OP |
mapvnc.command.list |
允许列出活动的 VNC 显示。 |
OP |
mapvnc.command.set |
允许修改显示属性(地址、大小等)。 |
OP |
mapvnc.command.connect |
允许将显示连接到 VNC 服务器。 |
OP |
mapvnc.command.disconnect |
允许断开显示连接。 |
OP |
mapvnc.command.input |
允许在显示中输入文本。 |
OP |
mapvnc.command.key |
允许向显示发送按键操作。 |
OP |
许可证
本项目遵循 MIT 许可证。详情请参见 LICENSE 文件。
MapVNC - Your VNC Client, inside Minecraft
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.
Whether for server administration, remote monitoring, or just for fun, MapVNC provides a seamless and unique integration between Minecraft and any VNC-enabled machine.
Features
- Dynamic Display Creation: Create VNC screens of any size, anywhere in the world.
- Real-Time Rendering: View a remote desktop with configurable color depth for performance tuning.
- Full Interactivity:
- Mouse Control: Point and click on the maps to control the remote cursor.
- Mouse Dragging: A sneak-based system to simulate clicking and dragging.
- Text Input: Type text directly into the remote session via commands.
- Key Presses: Send special key events like Enter, Shift, and Escape.
- In-Game Management: Easily move, resize, and remove VNC displays without restarting.
- Proximity-Based Rendering: Displays are only rendered for nearby players to ensure optimal server performance.
- Quick Target Selector: Use
-1 as an ID to automatically target the nearest screen.
- Detailed Permission System: Fine-grained control over who can create, manage, and interact with displays.
- User-Friendly Commands: Intuitive commands with rich tab-completion to guide users.
Prerequisites
- Server Software: Paper, Spigot, or a compatible fork (1.21+ recommended).
- Java: Java 21 or higher.
- Dependency: MapEngine 1.8.10+ is a required dependency. MapVNC will not start without it.
Installation
- Ensure you have MapEngine 1.8.10+ installed on your server.
- Download the latest
MapVNC-*-all.jar file from the "Versions" tab.
- Place the downloaded JAR file into your server's
plugins directory.
- Restart or reload your server.
Commands & Usage
The main command is /mapvnc, which can be shortened to /mvnc.
Targeting the Nearest Screen
For convenience, you don't always need to know a display's specific ID. For any command that requires an <id>, you can use -1 as a special placeholder.
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).
Example: Stand near a screen and type /mvnc connect -1 to connect it, without ever needing to run /mvnc list.
This feature works for: remove, set, connect, disconnect, input, and key.
Command List
| Command |
Description |
Permission |
/mvnc create <x> <y> <z> <width> <height> |
Creates a new VNC display at the specified coordinates. |
mapvnc.command.create |
/mvnc remove <id> |
Removes the VNC display with the given ID. |
mapvnc.command.remove |
/mvnc list |
Lists all active VNC displays. |
mapvnc.command.list |
/mvnc set <id> address <ip> <port> |
Sets the VNC server address for a display. |
mapvnc.command.set |
/mvnc set <id> password [password] |
Sets or clears the password for a display. |
mapvnc.command.set |
/mvnc set <id> colordepth <8|16|24> |
Sets the connection quality (bits per pixel). |
mapvnc.command.set |
/mvnc set <id> pos <x> <y> <z> |
Moves a display to a new location. |
mapvnc.command.set |
/mvnc set <id> size <width> <height> |
Resizes a display. |
mapvnc.command.set |
/mvnc connect <id> |
Connects the display to its configured VNC server. |
mapvnc.command.connect |
/mvnc disconnect <id> |
Disconnects the display from the VNC server. |
mapvnc.command.disconnect |
/mvnc input <id> <text...> |
Types the given text into the connected display. |
mapvnc.command.input |
/mvnc key <id> <keyName> |
Sends a single key press (e.g., ENTER, SHIFT). |
mapvnc.command.key |
Mouse Dragging
You can simulate clicking and dragging (e.g., to select text or move a window) with a special sneak-based mechanic:
- Aim at the spot on the map where you want to start the drag.
- Hold down your Sneak key (L-SHIFT by default).
- 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.
- To move the mouse while dragging, simply click on other parts of the map. You must remain in sneak mode.
- When you are finished, Release the Sneak key. This sends the "Mouse Up" event, completing the drag operation.
Permissions
| Permission Node |
Description |
Default |
mapvnc.* |
Grants access to all MapVNC features and commands. |
OP |
mapvnc.command.* |
Grants access to all MapVNC subcommands. |
OP |
mapvnc.command.base |
Allows using MapVNC's main command. |
OP |
mapvnc.command.create |
Allows creating new VNC displays. |
OP |
mapvnc.command.remove |
Allows removing VNC displays. |
OP |
mapvnc.command.list |
Allows listing active VNC displays. |
OP |
mapvnc.command.set |
Allows modifying display properties (address, size, etc.). |
OP |
mapvnc.command.connect |
Allows connecting a display to a VNC server. |
OP |
mapvnc.command.disconnect |
Allows disconnecting a display. |
OP |
mapvnc.command.input |
Allows typing text into a display. |
OP |
mapvnc.command.key |
Allows sending key presses to a display. |
OP |
License
This project is licensed under the MIT License. See the LICENSE file for details.
评论 0
登录后参与评分
还没有评论,来抢沙发吧