Polymart is now Voxel Shop! We're upgrading many features of the site, and during this open beta you will experience occasional bugs. Learn more  
RulesGUI icon

RulesGUI 1.1.6

Displays server rules in an interactive and customizable graphical interface.

RulesGUI.png


Present your Minecraft server rules with style and ease using RulesGUI, a plugin for Spigot servers that displays the rules to players through a fully customizable graphical interface (GUI).


Main Features

  • Graphical rules interface: Display your server rules in a visual, easy-to-navigate menu tailored to your server's configuration.
  • Support for interactive books: Players can open books from menu items to view the rules.

libro.gif

  • Support for categories: Organize rules into different categories or sections within the graphical interface.

categoria.gif

  • Command execution: Configure actions or commands to be executed when clicking on specific menu items.

comando.gif

  • Support for custom heads: Allows displaying heads with custom textures in the GUI.
  • Configurable commands: The plugin allows defining multiple commands to open the GUI, adapting to different languages or server preferences.
  • Multilanguage support: Includes language files (e.g., English and Spanish) to customize all plugin messages and texts.
  • Inserting links in books: With this feature, you can add links to text within books using the syntax: (<text>)[<link>]
  • Inserting commands in books: With this feature, you can embed commands into text within books so that when the user clicks on the text, the command is executed automatically, using the syntax: (<text>){<command>}
  • Hex color support: You can now use hexadecimal colors in the rules interface to make it more colorful and visually appealing. For example, to use a hex color, type &#f5424e.
  • Hover text in books: Use the hover text system so that when you move the cursor over a piece of text, an informational tooltip appears above it. For example, you can use it like this: (text)[link]<text>

permissions.png


rulesgui.use - Access to the main /rulesgui command.


rulesgui.rules - Access to view the graphical rules interface.


rulesgui.reload - Permission to reload the plugin with /rulesgui reload.


 


configuration.png


config.yml:


# RulesGUI Configuration File
# This file contains general settings for the plugin's operation

# Command settings
# Configure the commands that players can use to interact with the plugin
commands:
# The command name(s) for opening the rules GUI (without the slash)
# You can set multiple commands by separating them with commas
# Example: 'rules, reglas, normas, info, help'
# Each command will be registered separately and will open the rules GUI
# The default 'rules' command is already included in plugin.yml
# Changes will take effect after a server restart or /rulesgui reload
rules: 'rules'

# Language settings
# Set the language for plugin messages
# Currently supported languages: en (English), es (Spanish)
language: 'en'

# Messages (DEPRECATED - Use language files instead)
# These will be removed in future versions
messages:
no-permission: '&cYou do not have permission to use this command.' # Shown when a player lacks permission
reload-success: '&aRulesGUI has been reloaded successfully!' # Shown after a successful reload
unknown-command: '&cUnknown command. Use /rulesgui for help.' # Shown for invalid subcommands

# Plugin settings
# Advanced configuration options
settings:
debug: false # Set to true to enable debug logging (helpful for troubleshooting)
# This will output additional information to the console

# Permissions:
# rulesgui.use - Access to the main /rulesgui command
# rulesgui.rules - Permission to open the rules GUI
# rulesgui.reload - Permission to reload the plugin configuration

inventory.yml:


# RulesGUI Inventory Configuration
# This file controls the layout, appearance and behavior of all GUI inventories
 
# Color Code Support:
# - Legacy colors: &a, &b, &c, &d, &e, &f, &0-9, &l (bold), &m (strikethrough), etc.
# - Hex colors: &#RRGGBB (example: &#80ffd9 for cyan, &#ff5555 for red)
 
# Main GUI Settings
# This is the first screen players see when they use /rules
rules-gui:
  title: '&#80ffd9&lServer Rules'  # The title displayed at the top of the inventory (using hex color)
  size: 27  # Size of the inventory (must be a multiple of 9, e.g., 9, 18, 27, 36, 45, 54)
 
  # Items Configuration
  # Each number represents a slot in the inventory (0-26 for a 3-row inventory)
  # Slots are numbered left to right, top to bottom, starting from 0
  items:
    # Welcome item explaining the menu (slot 11)
    11:
      material: BOOK  # Minecraft material type
      name: '&#ffd700&lWelcome to Rules Menu'  # Item name (supports color codes and hex colors)
      lore:  # Item description (supports color codes and hex colors)
        - '&7This menu provides access to all server rules'
        - '&7and information to help you play on our server.'
        - ''
        - '&#80ffd9→ Click on Rules to see the server rules'
        - '&#80ffd9→ Click on Server Information for details about the server'
      # Book configuration - what appears when this item is clicked
      # INTERACTIVE ELEMENTS:
      # - (text)[url] creates a clickable link (aqua/underlined)
      # - (text){command} creates a clickable command (green/underlined)
      # - (text)<hover> creates hover text (yellow/underlined)
      # - (text)[url]<hover> creates a clickable link with hover text
      # - (text){command}<hover> creates a clickable command with hover text
      # NOTE: You can use hex colors in hover text too! Example: <&#ff5555This is red text>
      book:
        book-title: '&#ffd700Welcome to Our Server'
        book-author: 'Server Admin'
        pages:  # Each string is a page in the book
          - "&#ffd700Welcome to Our Server!\n\n&7This guide will help you navigate the rules menu. We have organized our rules into different categories to help you understand how to play on our server."
          - "&#80ffd9Click on different sections to explore more.\n\n&7For more information, visit our (website)[https://www.spigotmc.org/resources/rulesgui.124462/]<&#80ffd9Click to open the plugin page>.\n\n&7Need help? Click (here){help}<&#80ffd9Executes /help command> to see available commands."
 
    # Rules category item (slot 13)
    # This opens a sub-inventory with the rules
    # Optional: Add "permission" to require a permission to interact with this item
    # Example: permission: "rulesgui.view.rules"
    # Players without the permission will see a "Locked - No Permission" message in the lore
    13:
      material: WRITABLE_BOOK
      name: '&c&lServer Rules'
      lore:
        - '&7View all server rules organized'
        - '&7by category to help you play properly'
        - ''
        - '&a→ Click to view rules categories'
      # Define which category to open (must match a category ID below)
      category: "rules"
      # permission: "rulesgui.view.rules"  # Uncomment to require permission
 
    # Teleport command button (slot 15)
    # This executes a command when clicked
    15:
      material: PLAYER_HEAD
      name: '&d&lTeleport to Spawn'
      lore:
        - '&7Click to teleport to the spawn area'
        - '&7A safe place for all players'
      # Custom texture for player head (optional)
      skull-texture: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNjFiNjM1YmM5MmRkMjAwMTFkNmU3ZDAxMjU3ZTZlYTczN2I0OWZiN2RlOTQxZDNiYmQxODc3MTA0ZmM1ZWIxZSJ9fX0='
      # Command configuration - executed when clicked
      command:
        player-execute: 'spawn'  # Command executed by the player (without /)
        # server-execute: 'tp %player% spawn'  # Command executed by the server (use %player% for the player's name)
 
    # Fill empty slots with decorative items
    # This makes the inventory look cleaner
    filler:
      enabled: true  # Set to false to disable fillers
      material: BLACK_STAINED_GLASS_PANE
      name: ' '  # Empty name for a clean look
      # List all slots to fill (all slots not explicitly configured above)
      slots: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 14, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26]
 
# Categories Configuration
# Define sub-inventories that can be opened from the main menu
categories:
  # Rules category - opened when clicking the rules item
  rules:
    title: '&c&lServer Rules'  # Title of this sub-inventory
    size: 27  # Size of the inventory (must be a multiple of 9)
 
    # Back button configuration - returns to the main menu
    back-button:
      enabled: true  # Set to false to disable the back button
      slot: 18  # Position of the back button
      material: PLAYER_HEAD
      name: '&2&l« Back to main menu'
      lore:
        - '&7Return to the main rules menu'
      skull-texture: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMzJmZjhhYWE0YjJlYzMwYmM1NTQxZDQxYzg3ODIxOTliYWEyNWFlNmQ4NTRjZGE2NTFmMTU5OWU2NTRjZmM3OSJ9fX0='
      is-back-button: true  # This flag identifies this as a back button
 
    # Items in the rules category sub-inventory
    items:
      # Rule #1 Book (slot 11)
      11:
        material: BOOK
        name: '&e&lRule #1: Respect'
        lore:
          - '&7Be respectful to all players'
          - '&7No offensive language or behavior'
          - ''
          - '&a→ Click to read more details'
        # Book configuration with interactive elements
        book:
          book-title: '&6Rule #1: Respect'
          book-author: 'Server Admin'
          pages:
            - "&6Rule #1: Respect\n\n&7All players must treat each other with respect. Harassment, bullying, or any form of disrespect will not be tolerated.\n\n&7This includes offensive language, personal attacks, and discriminatory behavior."
            - "&7Remember that there are real people behind each username. Treat others as you would like to be treated.\n\n&7If someone is bothering you, please (report them){report}<&eClick to open report menu> to staff instead of engaging in conflicts.\n\n&7Read our full (community guidelines)[https://www.spigotmc.org/resources/rulesgui.124462/]<&aOpens in your browser>.\n\n&7You can also see (examples)<&6Example:\n&7- No insults\n&7- No spam\n&7- Be kind> of respectful behavior."
   
      # Rule #2 Book (slot 13)
      13:
        material: WRITABLE_BOOK
        name: '&e&lRule #2: No Griefing'
        lore:
          - '&7No griefing or stealing'
          - '&7Respect others property'
          - ''
          - '&a→ Click to read more details'
        # Book configuration
        book:
          book-title: '&6Rule #2: No Griefing'
          book-author: 'Server Admin'
          pages:
            - "&6Rule #2: No Griefing\n\n&7Griefing and stealing are strictly prohibited on this server. This includes:\n\n&7- Breaking or placing blocks on others' builds without permission\n&7- Taking items from others' chests or containers"
            - "&7- Intentionally damaging or altering others' creations\n&7- Using TNT or other destructive methods on others' property\n\n&7Always ask for permission before interacting with another player's build."
   
      # Rule #3 Book (slot 15)
      15:
        material: ENCHANTED_BOOK
        name: '&e&lRule #3: No Cheating'
        lore:
          - '&7No hacking or using mods'
          - '&7that give unfair advantages'
          - ''
          - '&a→ Click to read more details'
        # Book configuration
        book:
          book-title: '&6Rule #3: No Cheating'
          book-author: 'Server Admin'
          pages:
            - "&6Rule #3: No Cheating\n\n&7The use of hacks, cheats, or mods that provide unfair advantages is strictly forbidden. This includes:\n\n&7- X-ray texture packs or mods\n&7- Fly hacks or speed hacks"
            - "&7- Auto-clickers or macros for combat/mining\n&7- Any mod that reveals information not normally available to players\n\n&7We use anti-cheat plugins and staff monitoring to detect and punish cheating."
   
      # Fill empty slots with decorative items
      filler:
        enabled: true
        material: WHITE_STAINED_GLASS_PANE
        name: ' '
        slots: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 12, 14, 16, 17, 19, 20, 21, 22, 23, 24, 25, 26]
 
# How to add a new item:
# 1. Choose an empty slot number not used by another item or filler
# 2. Copy an existing item section and modify it
# 3. Set material, name, and lore to your liking
# 4. Add one of these action types:
#    - book: Opens a book when clicked (add book-title, book-author, and pages)
#    - category: Opens a sub-inventory (add category ID that matches a section in categories)
#    - command: Executes a command (add player-execute or server-execute)
#
# How to add a new category:
# 1. Add a new section under 'categories' with a unique ID
# 2. Configure title, size, and back-button
# 3. Add items to the category following the same format as above
[/url]
Owned
Ready to download
This resource is already attached to your account. You can download the latest file any time.

rules

gui

menu

interfaz

tool