Overview
VIM Agent is the official backend companion plugin for VelocityInstanceManager (VIM).

Installed directly on Paper, Spigot or Purpur servers, it receives commands sent by the Velocity proxy and executes them securely on the target backend server.

This enables advanced network-wide administration, automation and dynamic server management.

Features
✔ Remote command execution from Velocity

✔ Placeholder support ({player})

✔ Lightweight and optimized

✔ No external dependencies

✔ Paper / Spigot / Purpur compatible

✔ Command blacklist system

✔ Custom placeholders

✔ Optional debug mode

✔ Seamless integration with VelocityInstanceManager

How It Works
When VelocityInstanceManager sends a command through the plugin messaging channel:

1. VIM Agent receives the request.
   
   
2. Variables are replaced.
   
   
3. Security checks are applied.
   
   
4. The command is executed by the backend console.

Example:

Velocity:

/instance exec survival-1 "give {player} diamond 1" Steve

Backend execution:

give Steve diamond 1

Configuration
Example configuration:

debug: false

blocked_commands:
- "op"
- "deop"
- "stop"
- "restart"

custom_placeholders:
"{server}": "survival-1"

Security
VIM Agent only accepts commands originating from the Velocity proxy.

Additional protections include:

• Command blacklist
  
  
• Placeholder validation
  
  
• Permission checks through VIM
  
  
• Local execution only

Recommended blocked commands:

• op
  
  
• deop
  
  
• stop
  
  
• restart
  
  
• plugman reload

Installation

1. Download VIM-Agent.jar
   
   
2. Place it in your plugins folder
   
   
3. Restart the server
   
   
4. Done

No further setup required.
Documentation
Full documentation:

https://devlynx.fr/plugins/vim-agent

Velocity companion plugin:

https://devlynx.fr/plugins/vim

Discord support:

https://discord.gg/devlynx

Developed by DevLynx.