Oraxen
  • Getting started
  • Frequently Asked Questions
  • Usage
    • Commands
    • Default items
    • Recipes
  • Configuration
    • Understanding the basics
    • Plugin settings
    • Items (beginners)
    • Items (advanced)
      • Dyeable Items
    • Custom Armors
      • Component Based (1.21.2+)
      • Trims Based (1.20-1.21.1)
      • Shader Based (1.18-1.19.4)
    • Custom HUD
    • Item Appearance
    • Glyphs
      • Custom Gui
  • Mechanics
    • Introduction
    • All mechanics
      • Custom mechanic
      • clickAction Mechanic
    • Furniture Mechanic
      • Furniture Position
      • Display-Entity Furniture
      • Farming Mechanic
    • NoteBlock mechanic
      • Stripped log Mechanic
      • Directional mechanic
      • Farmblock Mechanic
    • StringBlock Mechanic
      • Sapling Mechanic
  • Compatibility
    • BossShopPro - shop
    • CrateReloaded - crates
    • ModelEngine - custom mobs
    • MythicMobs - custom mobs
    • TrMenu - custom inventories
    • MMoItems
    • MythicCrucible
    • HappyHUD
    • World Generators
      • Iris World Generator
      • EpicWorldGenerator
      • Custom Ore Generator
      • RealisticWorldGenerator
  • Vendors
    • Vendor Guidelines
  • Developers
    • Create your own Mechanic
    • Add Compatibility with a plugin
    • Custom hosting service
    • API
Powered by GitBook
On this page
  • Information
  • Configuration
  • Conditions
  • Actions

Was this helpful?

  1. Mechanics
  2. All mechanics

clickAction Mechanic

Run commands, play sounds, or send messages when a player clicks a block or furniture.

PreviousCustom mechanicNextFurniture Mechanic

Last updated 5 months ago

Was this helpful?

Information

The clickAction mechanic allows you to run commands, play sounds, or send messages when a player clicks on a furniture or a block.

Configuration

To get started, create a basic or .

Next, under the mechanics section, you can add the default clickAction mechanic under any noteblock-mechanic, furniture-mechanic or stringblock-mechanic item.

Mechanics:      
  noteblock/furniture/stringblock:
    clickActions:
      - conditions:
          - '#player.hasPermission("test.permission")'
        actions:
          - '[console] say <player> hello <player>!'

With this setup, players will only trigger the console command say hello <player> action if they have the permission test.permission.

If you are not using conditions, you need to place brackets where they would be:

Mechanics:
  noteblock/furniture/stringblock:
    clickActions:
      - conditions: []
        actions:
          - '[console] say <player> hello <player>!'

This mechanic does not support furniture with no hitbox.

Conditions

Conditions are VERY configurable. You can use any of the "get" methods for Player or Server. See the Spigot Javadocs for all methods.

Additionally, the Spring Documentation is a good resource for understanding how to use condition expressions.

Condition Examples

#server.getOnlinePlayers().size() > 10

#server.getAllowEnd()

#server.getDefaultGameMode()

#player.world.name == 'world'

#player.hasPermission("test.permission")

#player.gamemode.name() == 'ADVENTURE'

Actions

[console] <command>

[player] <command>

[message] <message>

[actionbar] <message>

{source=SOURCE volume=VOLUME pitch=PITCH} [sound] <sound name>

Action Examples

[console] say hello

[player] say hello

[message] <blue>Hello!

[actionbar] <gray>Hello from the actionbar!

{source=AMBIENT volume=0.1 pitch=1} [sound] minecraft:block.shulker_box.close

Block
Furniture
Page cover image
LogoPlayer (Spigot-API 1.18.1-R0.1-SNAPSHOT API)
LogoServer (Spigot-API 1.18.2-R0.1-SNAPSHOT API)
TIP! Click "CTRL + F" and search "get" to find valid methods.
Logo6. Spring Expression Language (SpEL)