> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sentrystudios.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Bukkit Materials Reference

> Complete catalog of Minecraft 1.21.x / Paper 26.3 Material enum constants for Sentry plugin configurations.

> [!NOTE]
>
> **Official PaperMC API Documentation**: Sentry Studios plugins use standard Bukkit / Paper `org.bukkit.Material` enum constants. For official class methods, inheritance trees, and developer API javadocs, view the official source: [Paper 26.3 org.bukkit.Material Javadocs](https://jd.papermc.io/paper/26.3/org/bukkit/Material.html)

## Overview

When configuring **SentryLore** (e.g. `specific-descriptions`, `materials`), **SentryWipe** (e.g. item purge filters), or **SentrySettings** (e.g. GUI fill items, category icons), all material identifiers must match the exact case-sensitive Bukkit `Material` enum name.

***

## Modern Material Catalog

**Weapons, Armor & Combat**

Essential combat gear, weapons, armor trims, and projectile items:

| Material Enum | Category | Max Stack | Notes |
| :- | :- | :- | :- |
| `MACE` | Weapon | 1 | Smash attack kinetic weapon (1.21) |
| `SWORD` (All Variants) | Weapon | 1 | `WOODEN_SWORD`, `STONE_SWORD`, `COPPER_SWORD`, `IRON_SWORD`, `GOLDEN_SWORD`, `DIAMOND_SWORD`, `NETHERITE_SWORD` |
| `SPEAR` (All Variants) | Weapon | 1 | `WOODEN_SPEAR`, `STONE_SPEAR`, `COPPER_SPEAR`, `IRON_SPEAR`, `GOLDEN_SPEAR`, `DIAMOND_SPEAR`, `NETHERITE_SPEAR` |
| `TRIDENT` | Weapon | 1 | Ranged / Melee aquatic weapon |
| `BOW` | Ranged | 1 | Standard projectile launcher |
| `CROSSBOW` | Ranged | 1 | High-velocity projectile launcher |
| `SHIELD` | Defense | 1 | Off-hand damage mitigation |
| `HELMET` (All Sets) | Armor | 1 | `LEATHER_HELMET`, `COPPER_HELMET`, `CHAINMAIL_HELMET`, `IRON_HELMET`, `GOLDEN_HELMET`, `DIAMOND_HELMET`, `NETHERITE_HELMET`, `TURTLE_HELMET` |
| `CHESTPLATE` (All Sets) | Armor | 1 | `LEATHER_CHESTPLATE`, `COPPER_CHESTPLATE`, `CHAINMAIL_CHESTPLATE`, `IRON_CHESTPLATE`, `GOLDEN_CHESTPLATE`, `DIAMOND_CHESTPLATE`, `NETHERITE_CHESTPLATE` |
| `LEGGINGS` (All Sets) | Armor | 1 | `LEATHER_LEGGINGS`, `COPPER_LEGGINGS`, `CHAINMAIL_LEGGINGS`, `IRON_LEGGINGS`, `GOLDEN_LEGGINGS`, `DIAMOND_LEGGINGS`, `NETHERITE_LEGGINGS` |
| `BOOTS` (All Sets) | Armor | 1 | `LEATHER_BOOTS`, `COPPER_BOOTS`, `CHAINMAIL_BOOTS`, `IRON_BOOTS`, `GOLDEN_BOOTS`, `DIAMOND_BOOTS`, `NETHERITE_BOOTS` |
| `WOLF_ARMOR` | Companion | 1 | Armadillo scute crafted armor |
| `HORSE_ARMOR` (All Sets) | Mount | 1 | `LEATHER_HORSE_ARMOR`, `COPPER_HORSE_ARMOR`, `IRON_HORSE_ARMOR`, `GOLDEN_HORSE_ARMOR`, `DIAMOND_HORSE_ARMOR`, `NETHERITE_HORSE_ARMOR` |
| `NAUTILUS_ARMOR` (All Sets) | Mount | 1 | `COPPER_NAUTILUS_ARMOR`, `IRON_NAUTILUS_ARMOR`, `GOLDEN_NAUTILUS_ARMOR`, `DIAMOND_NAUTILUS_ARMOR`, `NETHERITE_NAUTILUS_ARMOR` |
| `ARROW` / `SPECTRAL_ARROW` | Ammunition | 64 | Projectile ammunition |
| `TIPPED_ARROW` | Ammunition | 64 | Potion-imbued ammunition |
| `WIND_CHARGE` | Weapon | 64 | Breeze projectile burst |
| `FIRE_CHARGE` | Weapon | 64 | Incendiary projectile |
| `TOTEM_OF_UNDYING` | Artifact | 1 | Lethal damage revival |
| `ELYTRA` | Mobility | 1 | Flight glider |

**Tools & Mining Equipment**

Resource gathering tools and utilities:

| Material Enum | Category | Max Stack | Notes |
| :- | :- | :- | :- |
| `PICKAXE` (All Variants) | Tool | 1 | `WOODEN_PICKAXE`, `STONE_PICKAXE`, `COPPER_PICKAXE`, `IRON_PICKAXE`, `GOLDEN_PICKAXE`, `DIAMOND_PICKAXE`, `NETHERITE_PICKAXE` |
| `AXE` (All Variants) | Tool | 1 | `WOODEN_AXE`, `STONE_AXE`, `COPPER_AXE`, `IRON_AXE`, `GOLDEN_AXE`, `DIAMOND_AXE`, `NETHERITE_AXE` |
| `SHOVEL` (All Variants) | Tool | 1 | `WOODEN_SHOVEL`, `STONE_SHOVEL`, `COPPER_SHOVEL`, `IRON_SHOVEL`, `GOLDEN_SHOVEL`, `DIAMOND_SHOVEL`, `NETHERITE_SHOVEL` |
| `HOE` (All Variants) | Tool | 1 | `WOODEN_HOE`, `STONE_HOE`, `COPPER_HOE`, `IRON_HOE`, `GOLDEN_HOE`, `DIAMOND_HOE`, `NETHERITE_HOE` |
| `FISHING_ROD` | Tool | 1 | Aquatic harvesting |
| `FLINT_AND_STEEL` | Tool | 1 | Ignition tool |
| `SHEARS` | Tool | 1 | Wool and leaf harvesting |
| `BRUSH` | Tool | 1 | Archaeology dusting tool |
| `SPYGLASS` | Utility | 1 | Distant reconnaissance |
| `COMPASS` / `RECOVERY_COMPASS` | Navigation | 64 / 1 | Waypoint tracking |
| `CLOCK` | Utility | 64 | Time tracking |
| `LEAD` / `NAME_TAG` | Utility | 64 | Entity management |

**Modern 1.21 & Trial Chambers**

Items, blocks, and keys introduced in Minecraft 1.21 Tricky Trials & subsequent updates:

| Material Enum | BlockData | Description |
| :- | :- | :- |
| `CRAFTER` | `Crafter` | Automated redstone crafting workstation |
| `TRIAL_SPAWNER` | `TrialSpawner` | Dynamic mob challenge generator |
| `TRIAL_KEY` / `OMINOUS_TRIAL_KEY` | None | Vault unlock keys |
| `VAULT` | `Vault` | Multi-player loot container |
| `OMINOUS_BOTTLE` | None | Bad Omen amplifier (levels I-V) |
| `HEAVY_CORE` | `Waterlogged` | Core component used to craft the Mace |
| `BREEZE_ROD` | None | Breeze mob drop used for Wind Charges and Mace |
| `CREAKING_HEART` | `CreakingHeart` | Pale Garden creaking entity anchor |
| `PALE_OAK_LOG` / `PALE_OAK_WOOD` | `Orientable` | Pale garden timber |
| `PALE_OAK_PLANKS` / `PALE_OAK_STAIRS` | `Stairs` | Pale oak construction |
| `PALE_MOSS_BLOCK` / `PALE_MOSS_CARPET` | `MossyCarpet` | Pale garden vegetation |
| `PALE_HANGING_MOSS` | `HangingMoss` | Pale garden ceiling canopy |
| `RESIN_CLUMP` / `RESIN_BLOCK` | `ResinClump` | Creaking heart byproduct |
| `RESIN_BRICKS` (All Blocks/Stairs/Slabs) | `Stairs` / `Slab` | Hardened resin masonry |
| `COPPER_BULB` (All Oxidation States) | `CopperBulb` | Toggleable light emitter |
| `COPPER_GRATE` (All Oxidation States) | `Waterlogged` | Decorative grate with waterlogging |
| `COPPER_DOOR` / `COPPER_TRAPDOOR` | `Door` / `TrapDoor` | Oxidizable copper barriers |
| `COPPER_GOLEM_STATUE` | `CopperGolemStatue` | Copper golem monument |
| `CINNABAR` (All Blocks/Stairs/Slabs/Walls) | `Stairs` / `Slab` | Deep underground mineral blocks |
| `SULFUR` / `POTENT_SULFUR` | `PotentSulfur` | Explosive volcanic mineral |

**Redstone & Mechanisms**

Automation, wiring, logic gates, and server interaction blocks:

| Material Enum | BlockData | Description |
| :- | :- | :- |
| `REDSTONE` / `REDSTONE_WIRE` | `RedstoneWire` | Signal transmission dust |
| `REDSTONE_BLOCK` | None | Constant power source block |
| `REDSTONE_TORCH` / `WALL_TORCH` | `Lightable` | Inverting power torch |
| `REPEATER` | `Repeater` | Signal delay and diode |
| `COMPARATOR` | `Comparator` | Signal subtraction and inventory measure |
| `TARGET` | `AnaloguePowerable` | Projectile impact detector |
| `OBSERVER` | `Observer` | Block update packet detector |
| `PISTON` / `STICKY_PISTON` | `Piston` | Block displacement mechanisms |
| `HOPPER` | `Hopper` | Item filtration and transfer |
| `DISPENSER` / `DROPPER` | `Dispenser` | Item ejection mechanisms |
| `LECTERN` | `Lectern` | Book presentation and comparator signal |
| `DAYLIGHT_DETECTOR` | `DaylightDetector` | Solar and lunar cycle sensor |
| `SCULK_SENSOR` / `CALIBRATED_SCULK_SENSOR` | `SculkSensor` | Wireless vibration acoustics |
| `TRIPWIRE_HOOK` / `TRIPWIRE` | `TripwireHook` | Physical boundary trip triggers |
| `TNT` | `TNT` | Explosive block |
| `REDSTONE_LAMP` | `Lightable` | Redstone-driven lighting |
| `NOTE_BLOCK` | `NoteBlock` | Instrument audio generator |

**Building Stones, Wood & Glass**

Comprehensive building palette:

| Category | Material Enum Roots |
| :- | :- |
| **Stone Types** | `STONE`, `GRANITE`, `DIORITE`, `ANDESITE`, `DEEPSLATE`, `CALCITE`, `TUFF`, `BLACKSTONE`, `BASALT`, `OBSIDIAN`, `BEDROCK` |
| **Polished & Bricks** | `POLISHED_GRANITE`, `POLISHED_DIORITE`, `POLISHED_ANDESITE`, `POLISHED_DEEPSLATE`, `POLISHED_TUFF`, `POLISHED_BLACKSTONE`, `STONE_BRICKS`, `DEEPSLATE_BRICKS`, `DEEPSLATE_TILES`, `MUD_BRICKS`, `NETHER_BRICKS`, `END_STONE_BRICKS` |
| **Wood Families** | `OAK_*`, `SPRUCE_*`, `BIRCH_*`, `JUNGLE_*`, `ACACIA_*`, `DARK_OAK_*`, `CHERRY_*`, `MANGROVE_*`, `BAMBOO_*`, `CRIMSON_*`, `WARPED_*`, `PALE_OAK_*`, `POPLAR_*` |
| **Wood Formats** | For every wood family: `_LOG`, `_WOOD`, `_PLANKS`, `_STAIRS`, `_SLAB`, `_FENCE`, `_FENCE_GATE`, `_DOOR`, `_TRAPDOOR`, `_PRESSURE_PLATE`, `_BUTTON`, `_SIGN`, `_HANGING_SIGN`, `_SHELF` |
| **Glass & Panes** | `GLASS`, `TINTED_GLASS`, `GLASS_PANE`, plus 16 stained color variants (`WHITE_STAINED_GLASS`, `BLACK_STAINED_GLASS`, etc.) |
| **Concrete & Wool** | `*_CONCRETE`, `*_CONCRETE_POWDER`, `*_CONCRETE_STAIRS`, `*_CONCRETE_SLAB`, `*_WOOL`, `*_WOOL_STAIRS`, `*_WOOL_SLAB`, `*_CARPET` for all 16 colors |
| **Terracotta** | `TERRACOTTA`, 16 `*_TERRACOTTA` dyed blocks, and 16 `*_GLAZED_TERRACOTTA` pattern blocks |

**Armor Trims, Sherds & Collectibles**

Smithing templates, pottery sherds, and decorative patterns:

| Material Enum | Type | Description |
| :- | :- | :- |
| `NETHERITE_UPGRADE_SMITHING_TEMPLATE` | Template | Diamond-to-Netherite upgrade |
| `SENTRY_ARMOR_TRIM_SMITHING_TEMPLATE` | Trim | Sentry outpost armor pattern |
| `FLOW_ARMOR_TRIM_SMITHING_TEMPLATE` | Trim | Trial chamber wind pattern |
| `BOLT_ARMOR_TRIM_SMITHING_TEMPLATE` | Trim | Trial chamber lightning pattern |
| `SILENCE_ARMOR_TRIM_SMITHING_TEMPLATE` | Trim | Ancient city rare pattern |
| `TIDE_ARMOR_TRIM_SMITHING_TEMPLATE` | Trim | Ocean monument elder guardian drop |
| Other Trims | Trim | `DUNE_*`, `COAST_*`, `WILD_*`, `WARD_*`, `EYE_*`, `VEX_*`, `SNOUT_*`, `RIB_*`, `SPIRE_*`, `WAYFINDER_*`, `SHAPER_*`, `RAISER_*`, `HOST_*` |
| Pottery Sherds | Sherd | `ANGLER_*`, `ARCHER_*`, `ARMS_UP_*`, `BLADE_*`, `BREWER_*`, `BURN_*`, `DANGER_*`, `EXPLORER_*`, `FLOW_*`, `FRIEND_*`, `GUSTER_*`, `HEART_*`, `HEARTBREAK_*`, `HOWL_*`, `MINER_*`, `MOURNER_*`, `PLENTY_*`, `PRIZE_*`, `SCRAPE_*`, `SHEAF_*`, `SHELTER_*`, `SKULL_*`, `SNORT_*` |
| Music Discs | Disc | `MUSIC_DISC_13`, `CAT`, `BLOCKS`, `CHIRP`, `FAR`, `MALL`, `MELLOHI`, `STAL`, `STRAD`, `WARD`, `11`, `WAIT`, `OTHERSIDE`, `5`, `PIGSTEP`, `RELIC`, `CREATOR`, `CREATOR_MUSIC_BOX`, `PRECIPICE`, `BOUNCE`, `TEARS`, `LAVA_CHICKEN` |

**Legacy Enums (Deprecated)**

> [!WARNING]
>
> Materials prefixed with `LEGACY_` (e.g. `LEGACY_DIAMOND_SWORD`, `LEGACY_IRON_DOOR`, `LEGACY_LOG`) represent numeric-ID era Minecraft items (pre-1.13 "The Flattening"). **Do not use `LEGACY_` names in production Sentry configurations.** Sentry automatically maps vanilla names to modern flat IDs.

Legacy enums are retained solely for backwards binary compatibility with legacy Spigot plugins. When configuring SentryLore, SentryWipe, or SentrySettings, always use the clean modern name without `LEGACY_` (e.g., use `DIAMOND_SWORD`, never `LEGACY_DIAMOND_SWORD`).

***

## Configuration Usage Examples

### SentryLore (`config.yml`)

Match items by their exact Bukkit Material enum under `specific-descriptions`:

```yaml config.yml theme={null}
# Note: Item names must match exact Bukkit Material enums!
# Full list: https://docs.sentrystudios.org/materials
specific-descriptions:
  DIAMOND_SWORD:
    - "A powerful, durable blade forged"
    - "from refined subterranean diamonds."
  NETHERITE_SWORD:
    - "Forged in the darkest depths"
    - "of the Nether's scorching lakes."
  MACE:
    - "A devastating heavy weapon that"
    - "crushes armor with raw kinetic force."
```

### SentryWipe (`config.yml`)

Specify materials for purge confirmation or filter items:

```yaml config.yml theme={null}
menu:
  fill-material: BLACK_STAINED_GLASS_PANE
  confirm-material: LIME_CONCRETE
  cancel-material: RED_CONCRETE
```

### SentrySettings (`menu/gui.yml`)

Define interactive slots in the user settings GUI:

```yaml menu/gui.yml theme={null}
gui:
  fill: BLACK_STAINED_GLASS_PANE
  items:
    crystal-optimizer:
      slot: 12
      material: END_CRYSTAL
    night-vision:
      slot: 14
      material: POTION
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.