Skip to content

Console‐Commands

Jump to bottom
Fed43 edited this page Oct 10, 2026 · 1 revision

Console Commands

MineAlphaProxy ships with a set of built-in console commands. These are available from the proxy console and manage the proxy itself — not to be confused with plugins that add player commands.

How to Use

While the proxy is running, type the command in the terminal and press Enter.

> help
[..] INFO  c.m.MineAlphaProxy - Available commands:
[..] INFO  c.m.MineAlphaProxy - /help - Show all available commands
[..] INFO  c.m.MineAlphaProxy - /stop - Stop the proxy
...

Commands can also be prefixed with / — both help and /help work.

Command List

Command Arguments Description
/help none Show all available commands
/stop none Stop the proxy gracefully
/reload none Reload core.yml and language files
/servers none List all configured backend servers
/plugins none List all loaded plugins (Velocity + MineAlpha)
/lang <code> Switch the console language
/proxy none Show proxy information
/version none Show the current proxy version

Command Details

/help

Shows all commands registered in the console dispatcher. Both core commands and MineAlpha plugin commands appear here.

> help
[..] INFO - Available commands:
[..] INFO - /help - Show all available commands
[..] INFO - /stop - Stop the proxy
[..] INFO - /reload - Reload core.yml and language files
[..] INFO - /servers - List configured servers
[..] INFO - /plugins - List loaded plugins
[..] INFO - /lang <en|ru|...> - Change the language
[..] INFO - /proxy - Show proxy information
[..] INFO - /version - Show proxy version

/stop

Stops the proxy gracefully:

  1. Fires ProxyStopEvent to plugins
  2. Disables all plugins (onDisable)
  3. Shuts down the scheduler
  4. Closes the Netty server
  5. Exits the JVM
> stop
[..] INFO - Stopping proxy...
[..] INFO - Stopping network server...
[..] INFO - ViaProxy stopped

Do not close the terminal window manually — always use /stop so plugins save their data.

/reload

Reloads the config and language files without restarting.

> reload
[..] INFO - Loading config from core.yml
[..] INFO - Loaded language: ru
[..] INFO - Config and language reloaded

What is reloaded:

  • core.yml values (MOTD, servers, default-server, advanced settings)
  • Language files from lang/

What is NOT reloaded (requires full restart):

  • bind.host and bind.port
  • plugins.velocity-dir and plugins.bungee-dir
  • Loaded plugins
  • Modern forwarding secret

/servers

Lists all backend servers with their addresses and marks the default one.

> servers
[..] INFO - Configured servers:
[..] INFO - lobby -> 127.0.0.1:25566 (default)
[..] INFO - survival -> 127.0.0.1:25567

/plugins

Lists all loaded plugins grouped by type.

> plugins
[..] INFO - Loaded plugins:
[..] INFO - [Velocity] 0 plugin(s)
[..] INFO - [MineAlpha] 1 plugin(s)
[..] INFO -   - minealphaproxy_tools

If no plugins are loaded:

> plugins
[..] INFO - No plugins loaded.

/lang

Switches the console language. Available codes depend on the files in lang/:

> lang ru
[..] INFO - Loaded language: ru
[..] INFO - Язык переключён на: ru

After switching, all subsequent plugin messages that use Messages.get(...) come out in the new language.

Note: Only the language of messages shown to the console changes. Player messages keep the language set in core.yml until restart or /reload.

/proxy

Shows a summary of the running proxy.

> proxy
[..] INFO - Proxy: MineAlphaProxy v1.0.1-ALPHA | bind: 0.0.0.0:25577 | default-server: lobby

/version

Shows only the version string.

> version
[..] INFO - MineAlphaProxy v1.0.1-ALPHA

Plugin Commands

Commands added by MineAlpha plugins are also available in the console, as long as the plugin registers them.

For example, after installing MineAlphaProxyTools:

Command Description
/alert <msg> Broadcast a formatted alert to all players
/broadcast <msg> Broadcast with a decorative frame
/find <nick> Show player UUID, IP and online status
/ip <nick> Show the player's IP address
/kick <nick> [reason] Kick a player
/mlist List online players
/ping Show proxy status
/send <nick> <server> Move a player to another server (WIP)
/server <name> Switch server (WIP)
/tools Show all plugin commands

See MineAlphaProxyTools for full details.

Color Output

Console output supports ANSI escape codes on Windows 10+, Linux and macOS. Color codes used in messages:

  • §a / &a → green
  • §c / &c → red
  • §e / &e → yellow
  • §7 / &7 → gray
  • §b / &b → aqua
  • §l / &l → bold

If your terminal does not show colors (older Windows cmd.exe), use Windows Terminal instead.

UTF-8 Output

On Windows, always launch the proxy through run.bat (which includes chcp 65001 and -Dfile.encoding=UTF-8 flags). Otherwise Cyrillic and other UTF-8 characters may appear as ??????.

Tab Completion

Tab completion is not yet implemented in 1.0.1-ALPHA. It is planned for a future release.

Next Steps

Clone this wiki locally