liteMacro

A lightweight macro command plugin for Velocity.

32
Download

liteMacro

<div align="center">

liteMacro

StarsStars

GitHub CIGitHub CI

HangarHangar

ModrinthModrinth

</div>

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 console or the console.

- `cmd` (required): The command to execute (without the leading `/`) - `run_as` (required): Who runs the command (`player` or `console`)

`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 name - `message` (optional): Message to send to the player before transferring

Quick Start

1) Install

1. Download the latest release from GitHub Releases, GitHub Releases, or GitHub Releases. 2. Put the jar into your Velocity `plugins/` folder. 3. 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:

```yml 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`

```yml 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:

```text /litemacro reload ```

6) Test

Run the command in-game:

```text /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.

Gallery

ADS