Skip to main content
Aliases allow you to define custom names for items, making your scripts more readable and maintainable. You can create temporary aliases in scripts or permanent ones in separate files.

​
What Are Aliases?

Aliases are alternative names for Minecraft items and blocks. Instead of writing stone, cobblestone, and andesite repeatedly, you can create an alias like stone types that includes all of them.
Skript includes hundreds of default aliases for items, blocks, and entities. You can override these or add your own.

​
In-Script Aliases

Define aliases directly in your script files using the aliases: section. These aliases are only available within that script.

​
Basic Syntax

aliases:
	blacklisted = TNT, bedrock, obsidian, spawner, lava, lava bucket

command /item <items>:
	trigger:
		loop argument:
			if loop-item is not blacklisted:
				give loop-item to player
			else:
				send "<red>%loop-item%<reset> is blacklisted." to player
Aliases are defined in a section at the top of your script: 
aliases:
	alias_name = item1, item2, item3
	another_alias = different items
Multiple items in an alias are separated by commas.

​
Using Aliases

Once defined, use aliases anywhere you would use an item type: 
if player is holding custom helmets:
	send "Nice helmet!"

if {_item} is blacklisted:
	cancel event

​
Global Alias Files

For aliases used across multiple scripts, create permanent alias files in plugins/Skript/aliases/.

​
File Structure

plugins/Skript/
├── aliases/
│   ├── custom-items.sk
│   ├── ranks.sk
│   └── building-materials.sk
└── scripts/

​
Example Alias File

# Custom server items
rare items = diamond, emerald, netherite ingot, elytra
building blocks = stone, cobblestone, oak planks, bricks
tools = wooden pickaxe, stone pickaxe, iron pickaxe, diamond pickaxe
armor pieces = leather helmet, leather chestplate, leather leggings, leather boots

# Combine aliases
valuable loot = rare items, tools, armor pieces
You can reference other aliases within an alias definition.

​
Default Aliases

Skript includes comprehensive default aliases: 
load default aliases: true
Set this to false in config.sk to disable default aliases and use only your custom ones.
Default aliases include:
  • Item variations (oak wood, birch wood, etc.)
  • Potion types (potion of strength, etc.)
  • Entity types (hostile mobs, passive mobs, etc.)
  • Material categories (ores, crops, etc.)

​
Viewing Default Aliases

Default aliases are included in the Skript JAR file. To view them:
  1. Open Skript.jar as a ZIP file
  2. Navigate to the aliases-english.zip file
  3. Extract and view the alias definitions
Alternatively, find them on GitHub: https://github.com/SkriptLang/skript-aliases

​
Advanced Alias Features

​
Plurals in Aliases

Use ¦ to define plural forms: 
aliases:
	special stone¦s = diamond, emerald, gold ore
This creates both special stone (singular) and special stones (plural).

​
Item Tags and Data

Aliases can include item tags (NBT data) for specific properties: 
aliases:
	enchanted sword = diamond sword of sharpness 5
	custom book = written book named "Server Guide"
Item tags use Skript’s item syntax, including enchantments, names, and lore.

​
Common Alias Patterns

aliases:
	wood types = oak log, birch log, spruce log, jungle log, acacia log, dark oak log
	stone types = stone, cobblestone, andesite, diorite, granite
	ore blocks = coal ore, iron ore, gold ore, diamond ore, emerald ore
Group similar items for easier scripting.
aliases:
	donator items = diamond, golden apple, elytra
	staff tools = command block, barrier, structure block
	building materials = all blocks except staff tools
Define item sets based on access levels.
aliases:
	banned items = tnt, bedrock, command block, barrier
	disallowed blocks = lava, water, fire
Create blacklists for restricted items.
aliases:
	food items = bread, cooked beef, golden apple, cake
	combat gear = diamond sword, diamond armor, bow, arrow
	farming supplies = seeds, hoe, bone meal, water bucket
Organize shop inventory by category.

​
Alias Best Practices

Use Descriptive Names

Choose clear, meaningful names: rare_items instead of items1

Keep Aliases Organized

Group related aliases in dedicated files

Comment Your Aliases

Document what each alias represents

Avoid Conflicts

Don’t override default aliases unless necessary

​
Example: Well-Organized Aliases

# building-blocks.sk - Construction materials categorized by type

# Natural blocks
natural blocks = dirt, grass block, stone, sand, gravel

# Processed materials  
processed blocks = planks, bricks, stone bricks, polished stone

# Decorative items
decorations = flowers, paintings, item frames, carpets

# All building materials
all building materials = natural blocks, processed blocks, decorations

​
Troubleshooting

Common causes:
  • Typo in alias name
  • Alias defined after it’s used (move aliases: section to top)
  • Alias in wrong file (use global aliases or check file path)
# Wrong - alias used before definition
command /test:
	trigger:
		give custom_item to player

aliases:
	custom_item = diamond

# Correct - aliases first
aliases:
	custom_item = diamond

command /test:
	trigger:
		give custom_item to player
If an alias conflicts with a default alias:
  1. Your custom alias takes precedence in global alias files
  2. Check for typos that might create unintended overrides
  3. Use unique names to avoid conflicts
# May conflict with default "stone" alias
stone = diamond  # Not recommended

# Better - unique name
custom_stone = diamond
Ensure item names exactly match Minecraft IDs:
# Wrong - incorrect item name
tools = iron_pick, diamond_pick

# Correct - proper Minecraft names
tools = iron pickaxe, diamond pickaxe
Reference: https://minecraft.wiki/w/Java_Edition_data_values

​
Aliases in Examples

The Skript source includes practical alias examples: 
aliases:
	# Creates an alias `blacklisted` for this list of items.
	blacklisted = TNT, bedrock, obsidian, spawner, lava, lava bucket
These demonstrate real-world usage in complete scripts.

​
Configuration

Alias behavior is controlled in config.sk: 
load default aliases: true
# Whether to load Skript's default item aliases
# Set to false to use only custom aliases
See Configuration for more details on alias settings.

Commands

Using aliases in custom commands

Configuration

Alias configuration options

Default Aliases

Browse Skript’s default aliases on GitHub

Minecraft IDs

Official Minecraft item and block IDs

Build docs developers (and LLMs) love

Get started for freeTalk to us