.png?fit=max&auto=format&n=VrRd9ylcA_lbpmt6&q=85&s=4eb75c6784eda09d9cdee2d5224ca0e8){kind=logo}
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 JavadocsOverview
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
- Tools & Mining Equipment
- Modern 1.21 & Trial Chambers
- Redstone & Mechanisms
- Building Stones, Wood & Glass
- Armor Trims, Sherds & Collectibles
- Legacy Enums (Deprecated)
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 |
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 |
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 |
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 |
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 |
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 |
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_ (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:
config.yml
# 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:
config.yml
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:
menu/gui.yml
gui:
fill: BLACK_STAINED_GLASS_PANE
items:
crystal-optimizer:
slot: 12
material: END_CRYSTAL
night-vision:
slot: 14
material: POTION