# 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

# RulesGUI Inventory Configuration
# This file controls the layout, appearance and behavior of all GUI inventories

# Main GUI Settings
# This is the first screen players see when they use /rules
rules-gui:
  title: '&b&lServer Rules'  # The title displayed at the top of the inventory
  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: '&e&lWelcome to Rules Menu'  # Item name (supports color codes)
     lore:  # Item description (supports color codes)
       - '&7This menu provides access to all server rules'
       - '&7and information to help you play on our server.'
       - ''
       - '&a→ Click on Rules to see the server rules'
       - '&a→ Click on Server Information for details about the server'
     # Book configuration - what appears when this item is clicked
     book:
       book-title: '&6Welcome to Our Server'
       book-author: 'Server Admin'
       pages:  # Each string is a page in the book
         - "&6Welcome 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.\n\n&7Click on different sections to explore more."
 
   # Rules category item (slot 13)
   # This opens a sub-inventory with the rules
   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"
 
   # 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
       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 to staff instead of engaging in conflicts."
 
     # 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