About Buttons
Buttons is a Rust plugin that allows server owners to add customizable buttons to the in-game user interface.
These buttons can be used to trigger commands, open menus, send messages, or execute any server-side action, offering a more interactive and user-friendly experience for players. With support for custom positioning, styling, and permissions, Buttons makes it easy to enhance gameplay and streamline interactions through intuitive UI elements.
Permissions:
- buttons.use - Allows group/player to use the buttons.
- buttons.toggle - Allows group/player to toggle the buttons.
-
Each button can optionally define its own permission. An empty permission requires only buttons.use, when configured, the player must have both buttons.use and the button permission.
Configured button permissions are registered automatically. The UI is refreshed when relevant player or group permissions change.
Chat Commands:
- /buttons - Toggle the buttons (require buttons.toggle).
Console Commands:
- buttons.open <index> - Execute the button command.
Image Handling:
ImageLibrary is optional and is detected dynamically when loaded or unloaded. Buttons automatically refreshes active interfaces when the integration changes and falls back to local images or direct URLs when ImageLibrary is unavailable.
Image priority: local image, ImageLibrary cached image, direct URL.
Configuration:
{
"Settings": {
"Buttons": [
{
"Image Url": "https://i.ibb.co/Gv8YKB8g/info.png",
"Local Image (oxide/data/Buttons/images - eg: image.png)": "",
"Command": "info",
"Permission (Empty = No Permission Required)": "",
"Background Color": "0.65 0.65 0.65 0.3",
"Always Show": false,
"Display Types (Hud/Overlay/Under/Inventory/TechTree/Crafting/Contacts/Clans/Map)": [
"Overlay"
],
"Show Overlay Only In (Looting/Vending/NpcConversation/Mounted/MLRS - Empty = Disabled)": [],
"Enable Hybrid Display Types": false,
"Hybrid Contexts (Looting/Vending/NpcConversation/Mounted/MLRS - Empty = Looting)": [
"Looting"
],
"Hybrid Fallback Display Types When No Context Is Active (Hud/Overlay/Under/Inventory/TechTree/Crafting/Contacts/Clans/Map)": [
"Hud"
],
"Alignment": {
"Anchor Min": "0 1",
"Anchor Max": "0 1",
"Offset Min": "18 -60",
"Offset Max": "56 -22"
}
},
{
"Image Url": "https://i.ibb.co/VYz1NcLL/leaderboard.png",
"Local Image (oxide/data/Buttons/images - eg: image.png)": "",
"Command": "leaderboard",
"Permission (Empty = No Permission Required)": "",
"Background Color": "0.65 0.65 0.65 0.3",
"Always Show": false,
"Display Types (Hud/Overlay/Under/Inventory/TechTree/Crafting/Contacts/Clans/Map)": [
"Overlay"
],
"Show Overlay Only In (Looting/Vending/NpcConversation/Mounted/MLRS - Empty = Disabled)": [],
"Enable Hybrid Display Types": false,
"Hybrid Contexts (Looting/Vending/NpcConversation/Mounted/MLRS - Empty = Looting)": [
"Looting"
],
"Hybrid Fallback Display Types When No Context Is Active (Hud/Overlay/Under/Inventory/TechTree/Crafting/Contacts/Clans/Map)": [
"Hud"
],
"Alignment": {
"Anchor Min": "0 1",
"Anchor Max": "0 1",
"Offset Min": "58 -60",
"Offset Max": "96 -22"
}
},
{
"Image Url": "https://i.ibb.co/V06FLK38/shop.png",
"Local Image (oxide/data/Buttons/images - eg: image.png)": "",
"Command": "shop",
"Permission (Empty = No Permission Required)": "",
"Background Color": "0.65 0.65 0.65 0.3",
"Always Show": false,
"Display Types (Hud/Overlay/Under/Inventory/TechTree/Crafting/Contacts/Clans/Map)": [
"Overlay"
],
"Show Overlay Only In (Looting/Vending/NpcConversation/Mounted/MLRS - Empty = Disabled)": [],
"Enable Hybrid Display Types": false,
"Hybrid Contexts (Looting/Vending/NpcConversation/Mounted/MLRS - Empty = Looting)": [
"Looting"
],
"Hybrid Fallback Display Types When No Context Is Active (Hud/Overlay/Under/Inventory/TechTree/Crafting/Contacts/Clans/Map)": [
"Hud"
],
"Alignment": {
"Anchor Min": "0 1",
"Anchor Max": "0 1",
"Offset Min": "98 -60",
"Offset Max": "136 -22"
}
},
{
"Image Url": "https://i.ibb.co/ksjLcnx5/kits.png",
"Local Image (oxide/data/Buttons/images - eg: image.png)": "",
"Command": "kits",
"Permission (Empty = No Permission Required)": "",
"Background Color": "0.65 0.65 0.65 0.3",
"Always Show": false,
"Display Types (Hud/Overlay/Under/Inventory/TechTree/Crafting/Contacts/Clans/Map)": [
"Overlay"
],
"Show Overlay Only In (Looting/Vending/NpcConversation/Mounted/MLRS - Empty = Disabled)": [],
"Enable Hybrid Display Types": false,
"Hybrid Contexts (Looting/Vending/NpcConversation/Mounted/MLRS - Empty = Looting)": [
"Looting"
],
"Hybrid Fallback Display Types When No Context Is Active (Hud/Overlay/Under/Inventory/TechTree/Crafting/Contacts/Clans/Map)": [
"Hud"
],
"Alignment": {
"Anchor Min": "0 1",
"Anchor Max": "0 1",
"Offset Min": "138 -60",
"Offset Max": "176 -22"
}
}
],
"Open By Default": true
}
}
Languages:
Buttons have two languages by default (English and Romanian), but you can add more in Oxide lang folder.
