LiteMacro is a lightweight Velocity plugin that lets you create custom commands by chaining simple actions.
For example, you can add /hub as a shortcut for /server hub—fewer keystrokes, same result.
Supported Actions
A macro command is defined by a list of actions. Actions are executed in order.
command
Run a command as either the player or the console.
cmd(required): The command to execute (without the leading/)run_as(required): Who runs the command (playerorconsole)
message
Send a chat message to the command executor.
text(required): The message to send
delay
Pause execution for a specified duration.
millis(required): Delay time in milliseconds
transfer
Transfer the executing player to another Velocity registered server.
target(required): Target server namemessage(optional): Message to send to the player before transferring
Quick Start
1) Install
- Download the latest release from Hangar, Modrinth, or GitHub Releases.
- Put the jar into your Velocity
plugins/folder. - Restart the proxy.
2) Generate config
On first startup, LiteMacro will create a configuration file:
plugins/liteMacro/command.yml
It also uses language files in:
plugins/liteMacro/lang/
3) Choose a language
Open plugins/liteMacro/command.yml and set:
lang: "en_US"
Make sure the corresponding language file exists (for example plugins/liteMacro/lang/en_US.properties).
4) Create your first macro
Add a macro under macros:. Example: /hub
macros:
hub:
description: "Transfer player to hub."
permission: "litemacro.default.hub"
aliases: [ "lobby", "tohub" ]
actions:
- type: message
options:
text: "Transferring to hub..."
- type: transfer
options:
target: "Hub"
5) Reload
After editing command.yml, reload the plugin:
/litemacro reload
6) Test
Run the command in-game:
/hub
If everything is configured correctly, the macro will execute actions in order.
Contributing
Issues and pull requests are welcome. If you have ideas, bug reports, or improvements, feel free to open an issue or submit a PR.
License
This project is licensed under the MIT License. See the LICENSE file for details.