Skip to content

Our-Island/liteMacro

Repository files navigation

liteMacro

Visitors Stars GitHub CI Hangar Modrinth

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 (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 Hangar, Modrinth, 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:

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.