{"id":94518,"date":"2026-06-05T12:50:54","date_gmt":"2026-06-05T09:50:54","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/litemacro\/"},"modified":"2026-06-05T12:50:54","modified_gmt":"2026-06-05T09:50:54","slug":"litemacro","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/litemacro\/","title":{"rendered":"liteMacro"},"content":{"rendered":"
\n

# liteMacro<\/p>\n

![Stars](https:\/\/github.com\/Our-Island\/liteMacro\/)
\n![GitHub CI](https:\/\/github.com\/Our-Island\/liteMacro\/actions\/workflows\/ci.yml)
\n![Hangar](https:\/\/hangar.papermc.io\/Our-Island\/LiteMacro)
\n![Modrinth](https:\/\/modrinth.com\/plugin\/litemacro\/)<\/p>\n<\/div>\n

LiteMacro is a lightweight Velocity plugin that lets you create custom commands by chaining simple actions.
\nFor example, you can add `\/hub` as a shortcut for `\/server hub`\u2014fewer keystrokes, same result.<\/p>\n

## Supported Actions<\/p>\n

A macro command is defined by a list of actions. Actions are executed **in order**.<\/p>\n

### `command`<\/p>\n

Run a command as either the **player** or the **console**.<\/p>\n

– `cmd` (required): The command to execute (without the leading `\/`)
\n– `run_as` (required): Who runs the command (`player` or `console`)<\/p>\n

### `message`<\/p>\n

Send a chat message to the command executor.<\/p>\n

– `text` (required): The message to send<\/p>\n

### `delay`<\/p>\n

Pause execution for a specified duration.<\/p>\n

– `millis` (required): Delay time in milliseconds<\/p>\n

### `transfer`<\/p>\n

Transfer the executing player to another Velocity registered server.<\/p>\n

– `target` (required): Target server name
\n– `message` (optional): Message to send to the player before transferring<\/p>\n

## Quick Start<\/p>\n

### 1) Install<\/p>\n

1. Download the latest release from **Hangar**, **Modrinth**, or **GitHub Releases**.
\n2. Put the jar into your Velocity `plugins\/` folder.
\n3. Restart the proxy.<\/p>\n

### 2) Generate config<\/p>\n

On first startup, LiteMacro will create a configuration file:<\/p>\n

– `plugins\/liteMacro\/command.yml`<\/p>\n

It also uses language files in:<\/p>\n

– `plugins\/liteMacro\/lang\/`<\/p>\n

### 3) Choose a language<\/p>\n

Open `plugins\/liteMacro\/command.yml` and set:<\/p>\n

“`yml
\nlang: “en_US”
\n“`<\/p>\n

Make sure the corresponding language file exists (for example `plugins\/liteMacro\/lang\/en_US.properties`).<\/p>\n

### 4) Create your first macro<\/p>\n

Add a macro under `macros:`. Example: `\/hub`<\/p>\n

“`yml
\nmacros:
\n hub:
\n description: “Transfer player to hub.”
\n permission: “litemacro.default.hub”
\n aliases: [ “lobby”, “tohub” ]
\n actions:
\n – type: message
\n options:
\n text: “Transferring to hub…”
\n – type: transfer
\n options:
\n target: “Hub”
\n“`<\/p>\n

### 5) Reload<\/p>\n

After editing `command.yml`, reload the plugin:<\/p>\n

“`text
\n\/litemacro reload
\n“`<\/p>\n

### 6) Test<\/p>\n

Run the command in-game:<\/p>\n

“`text
\n\/hub
\n“`<\/p>\n

If everything is configured correctly, the macro will execute actions in order.<\/p>\n

## Contributing<\/p>\n

Issues and pull requests are welcome.
\nIf you have ideas, bug reports, or improvements, feel free to open an issue or submit a PR.<\/p>\n

## License<\/p>\n

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.<\/p>\n","protected":false},"excerpt":{"rendered":"

A lightweight macro command plugin for Velocity.<\/p>\n","protected":false},"featured_media":94519,"template":"","meta":{"_minecraft_slug":"litemacro","_minecraft_project_id":"pgMtZFXv","_minecraft_author":"Chiloven945","_minecraft_license":"MIT","_minecraft_downloads":32,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"litemacro.zip","_minecraft_size_bytes":54315,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T21:58:12.923345Z","_minecraft_date_created":"2025-12-28T23:22:51.467887Z","_minecraft_date_modified":"2026-01-30T17:21:46.129986Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/litemacro","_minecraft_icon_attachment_id":94519,"_minecraft_imported_at":"2026-06-05T09:50:54+00:00","_minecraft_import_hash":"1ab9ac55860c295debc1b0ae66de8ba1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,92,985],"mod_loader":[986],"minecraft_version":[438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-94518","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\nliteMacro - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/litemacro\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"liteMacro - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A lightweight macro command plugin for Velocity.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/litemacro\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/litemacro\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/litemacro\\\/\",\"name\":\"liteMacro - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/litemacro\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/litemacro\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/litemacro-icon-ce9a5861b5955985667c01e1f9c8c49f818ef807_96.webp\",\"datePublished\":\"2026-06-05T09:50:54+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/litemacro\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/litemacro\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/litemacro\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/litemacro-icon-ce9a5861b5955985667c01e1f9c8c49f818ef807_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/litemacro-icon-ce9a5861b5955985667c01e1f9c8c49f818ef807_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/litemacro\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"liteMacro\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"liteMacro - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/litemacro\/","og_locale":"en_US","og_type":"article","og_title":"liteMacro - Minecraft","og_description":"A lightweight macro command plugin for Velocity.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/litemacro\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/litemacro\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/litemacro\/","name":"liteMacro - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/litemacro\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/litemacro\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/litemacro-icon-ce9a5861b5955985667c01e1f9c8c49f818ef807_96.webp","datePublished":"2026-06-05T09:50:54+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/litemacro\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/litemacro\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/litemacro\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/litemacro-icon-ce9a5861b5955985667c01e1f9c8c49f818ef807_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/litemacro-icon-ce9a5861b5955985667c01e1f9c8c49f818ef807_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/litemacro\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"liteMacro"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/94518","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/94519"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=94518"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=94518"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=94518"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=94518"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}