Creating Aliases

Learn how to create command aliases that will save you time and make complex commands simple.

What is an Alias?

An alias is a short name for a command (or group of commands) that you use frequently. Instead of typing the full command every time, you can create a shortcut.

Example:
Instead of: /teleport @s 0 64 0
Type: /home

Basic Alias Format

{
  "alias_name": "actual command"
}

In your aliases.json file:

  • Key (left side): The short name you'll type
  • Value (right side): The command that will execute

Simple Examples

Greeting Alias

"greet": "say Hello, everyone!"

Type: /greet
Executes: say Hello, everyone!

Creative Mode Alias

"creative": "gamemode creative @s"

Type: /creative
Executes: gamemode creative @s

Give Items Alias

"sword": "give @s diamond_sword 1"

Type: /sword
Executes: give @s diamond_sword 1

Aliases with Variables

Make your aliases even more powerful with built-in variables that get replaced with actual values:

Supported Variables

  • ${player} - Current player's name
  • ${x} - Player's X coordinate
  • ${y} - Player's Y coordinate
  • ${z} - Player's Z coordinate

Variable Examples

"home": "tp ${player} 0 64 0"

When you type /home, it replaces ${player} with your actual name.

"coord": "say I am at ${x}, ${y}, ${z}"

Displays your current coordinates in chat.

"tp_steve": "tp Steve ${x} ${y} ${z}"

Teleports Steve to your current location.

Creating an Alias File

Method 1: Edit aliases.json

  1. Open config/CommandMaker/aliases.json in a text editor
  2. Add your alias: "myalias": "my command"
  3. Make sure JSON is valid (proper commas, quotes)
  4. Save the file
  5. Run /addcommand reload in-game

Method 2: Use In-Game Command

Add aliases without editing files:

/addcommand add myalias "my command"

The alias is immediately available to use.

Method 3: Custom Syntax

For advanced aliases with parameters, use the Custom Syntax System:

Learn about Custom Syntax →

Complete Example Configuration

{
  "home": "tp ${player} 0 64 0",
  "spawn": "tp ${player} 100 100 100",
  "creative": "gamemode creative @s",
  "survival": "gamemode survival @s",
  "greet": "say Hello, ${player}!",
  "getcoords": "say I am at ${x}, ${y}, ${z}",
  "day": "time set day",
  "night": "time set night",
  "rain": "weather rain",
  "clear": "weather clear",
  "stop": "stop"
}

Naming Conventions

Best Practices:

  • Use lowercase names: home instead of Home
  • Use underscores for multi-word aliases: pet_heal
  • Keep names short and memorable
  • Avoid special characters except underscores
  • Don't use existing Minecraft command names

❌ Poor Names: H, tp_player_to_coords_123
✅ Good Names: home, pvp_arena

Managing Your Aliases

List All Aliases

Look in your aliases.json file to see all defined aliases.

Edit an Alias

Edit the value in aliases.json and reload:

/addcommand reload

Delete an Alias

Use the in-game command:

/addcommand del myalias

Or open the GUI:

/deletealiases-gui

Common Issues

❌ Alias not working?

  • Did you reload with /addcommand reload?
  • Is the command valid Minecraft syntax?
  • Check for typos in the alias name

❌ Syntax error message?

  • Check your JSON formatting
  • Ensure quotes are matched correctly
  • Use a JSON validator

Next Steps

  1. Create your first simple alias
  2. Try using variables like ${player}
  3. Learn about Custom Syntax for parameters
  4. Check out Examples for inspiration