Opens a GUI displaying search results for furniture.
<keyword>: The search term. It will search by the item's name first, then by its id if no name match is found.
Special: If the <keyword> is - (a hyphen), it will display all furniture items without filtering by name.
[category]: (Optional) If specified, the search will be restricted to that particular category.
[dye]: (Optional) If dye is specified (and the HMCColor system is enabled), only furniture items that are dyeable will be shown.
Tab Completion:dye will only appear as a tab completion option if HMCColor is enabled.
Examples:
/nwfurnitureopen search chair (Searches for "chair" across all categories)
/nwfurnitureopen search table furnitures (Searches for "table" only within the "furnitures" category)
/nwfurnitureopen search red dye (Searches for "red" across all dyeable categories)
/nwfurnitureopen search - (Displays all furniture items from all categories)
/nwfurnitureopen search - furnitures (Displays all furniture items within the "furnitures" category)
/nwfurnitureopen search chair furnitures dye (Searches for "chair" in the "furnitures" category, and it must be dyeable)
Config
1. Configuration Settings (config.yml File)
The config.yml file is the central hub for customizing the plugin's behavior and messages. You can tailor various sections as follows:
# when click right = Buy
# When you enable enable-price: true, it means you are allowing the furniture to be purchasable.
# Command /nwfurnitureshow price true/false
enable-price: true
close-gui-when-click-furniture: true
permissions:
admin: command.admin
player: command.player
# display furniture settings
# When Bug /minecraft:kill @e[type=item_display,distance=1..2]
settings:
cooldown: 5 # 5s
rotate: 1 # 0=False / 1=True
setGlow: 0 # 0=False / 1=True
setBrightness: 10 # 1-15
setSkyLight: 10 # 1-15
#Required HMCColor
hmc-color:
enabled: true
gui:
dye-menu-input-slot: 10 # Slot for the furniture item to be dyed
dye-menu-output-slot: 16 # Slot for the resulting furniture item
material-dyeable: # List of items that can be dyed
- LEATHER_HORSE_ARMOR
gui:
title: <gradient:#5e4fa2:#f79459>Furniture Show</gradient>
search-title: '<gradient:#FF9800:#F44336>Search Results for: <yellow><search></yellow></gradient>'
rows: 6
page-size: 45
previous-page-item:
# use Nexo ID Or Itemsadder Namespaces or CraftEngine ID
material: ARROW
name: <gold>Previous Page</gold>
slot: 48
current-page-item:
material: PAPER
name: <white>Page <current>/<total></white>
slot: 49
command: say %player% hi
next-page-item:
material: ARROW
name: <gold>Next Page</gold>
slot: 50
message:
default-lore-when-additem:
- "<gradient:gold:yellow>Price: {price} THB</gradient>"
- "<#00FF00>Left-click to preview</#00FF00>"
- "<#FF0000>Right-click to purchase</#FF0000>"
invalid-price-message: <red>Invalid value! Use true or false
enable-price-message: <green>Enable Price
disable-price-message: <red>Disable Price
set-location-message: <red>Furniture set location success
usage: '<red>Usage: /furnitureshow <config|price> [value]'
no-permission: <red>You don't have permission!
reload-command: <#C7E91D>Reloaded
error: Invalid
not-found-page: Page Not Found
invalid-page: Invalid Page
cooldown-message: <yellow>Please wait <gradient:red:yellow><time></gradient> seconds</yellow>
set-location-warning: <gradient:yellow:gold>Use /nwfurnitureshow setlocation to
set location.</gradient>
not-enough-money: '<red>Not enough money! Price: <price></red>'
purchase-successful: <green>You bought <item> for <price></green>
inventory-full: <red>Inventory Full
hold-item: <yellow>You need to be holding the furniture item in your hand.</yellow>
not-furniture: <red>The item you are holding is not recognized as furniture.</red>
furniture-exists: <yellow>This furniture item is already listed in the configuration.</yellow>
furniture-added: <green>Successfully added the furniture item to the configuration.</green>
furniture-added-to-category: <green>Furniture has been added to the Category <yellow>%category%</yellow>!</green>
category-not-found: <red>Category named <yellow>%category%</yellow> not found!</red>
usage-open-command: '<red>Usage: /nwfurnitureopen <filename> [page] or /nwfurnitureopen
search <name> [category]</red>'
search-no-results: '<yellow>No furniture found matching the search: <red>%search%</red>.</yellow>'
search-no-value:
- <yellow>Please specify the keyword for the furniture you are looking for:</yellow>
- '<gray>Example: /nwfurnitureopen search chair</gray>'
# /nwfurnitureshow setlocation
location:
world: newtown
x: 62.485110317948134
y: 95.0
z: -46.364349776775526
yaw: -0.12893677
pitch: 0.8999848
Key Settings:
permission: Defines the permission node players need to open the plugin's GUI.
close-gui-on-click: Set to true if you want the GUI to close immediately after a player clicks on a furniture item (e.g., to purchase it).
rows / page-size: Control the GUI's dimensions and the number of items displayed per page. Be careful to align page-size with rows and the positions of page navigation buttons.
search-title: The format for the GUI's title when players use the search command. <search> will be replaced by the actual search term.
*-page-item: Configure the material, name (supports MiniMessage), and slot position for the previous, current, and next page navigation buttons.
message: This section allows you to customize various messages the plugin sends to players, such as no-permission warnings, invalid command usage, or search results. It supports MiniMessage for rich text formatting.
The plugin stores furniture data categorized into separate .yml files within the plugins/nwFurnitureShow/furniture/ folder, for example, plugins/nwFurnitureShow/furniture/furnitures.yml.
# plugins/nwFurnitureShow/furniture/furnitures.yml
hide-this-category: false # Set to true if this category should not appear in the default /nwfurnitureopen GUI
furniture_show:
arm_chair:
# Use Nexo ID Or Itemsadder Namespaces or CraftEngine ID
id: arm_chair
name: "Arm Chair"
price: 500 # Price of the furniture item
lore: # Lore displayed in the GUI (supports MiniMessage)
- '<gradient:gold:yellow>Price: {price} THB</gradient>'
- <gray>Medium-sized wooden armchair, good condition.</gray>
- <#00FF00>Left-click to preview</#00FF00>
- <#FF0000>Right-click to purchase</#FF0000>
coffee_table:
# Use Nexo ID Or Itemsadder Namespaces or CraftEngine ID
id: coffee_table
name: "Coffee Table"
price: 1200
lore:
- '<gradient:gold:yellow>Price: {price} THB</gradient>'
- <gray>Modern style coffee table.</gray>
- <#00FF00>Left-click to preview</#00FF00>
- <#FF0000>Right-click to purchase</#FF0000>
3. Minimessage
MiniMessage formatting. This means you can use a wide range of colors, styles, and advanced text features to customize how messages appear in-game.
