> For the complete documentation index, see [llms.txt](https://docs.tweetzy.ca/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tweetzy.ca/official-plugins/skulls/plugin-files.md).

# Plugin Files

### confi&#x67;**.yml**

```yaml
# Default language file
language: english
# Prefix to be used in chat
prefix: <GRADIENT:DD5E89>&lSkulls</GRADIENT:fbc7d4>&r &8»
# Should skulls charge users without permission for heads?
charge for heads: true
# You can use Vault or Item
economy: Vault
item economy item: GOLD_INGOT
enabled categories:
  alphabet: true
  animals: true
  blocks: true
  decoration: true
  food and drinks: true
  humans: true
  humanoids: true
  misc: true
  monsters: true
  plants: true
player head:
  name: '&e%player_name%'
  drop enabled: true
  drop chance: 50
gui:
  main:
    items:
      alphabet:
        slot: 11
      animals:
        slot: 12
      blocks:
        slot: 13
      decoration:
        slot: 14
      food and drinks:
        slot: 15
      humans:
        slot: 20
      humanoids:
        slot: 21
      misc:
        slot: 22
      monsters:
        slot: 23
      plants:
        slot: 24
default prices:
  alphabet: 1.0
  animals: 1.0
  blocks: 1.0
  decoration: 1.0
  food and drinks: 1.0
  humans: 1.0
  humanoids: 1.0
  misc: 1.0
  monsters: 1.0
  plants: 1.0
```

### englis&#x68;**.yml**

```yaml
misc:
  player not found: '&cThat category id is already in use!'
  not a number: '&cThat is not a valid number'
  no skull info: '&cCould not determine ID of that skull'
  no permission: '&cYou do not have permission to use that!'
  is false: '&cFalse'
  is disallowed: '&cDisallowed'
  skull not found: '&cNo skull by that id could be found'
  is true: '&ATrue'
  is allowed: '&aAllowed'
  category permission: '&cYou do not have permission to access that category!'
  not enough money: '&cYou do not have enough money!'
input:
  skull edit:
    title: '&eEditing Skull'
    price: '&fEnter the new skull price'
    name: '&FEnter the new name skull name'
  skull search:
    subtitle: '&fEnter search terms into chat'
    title: '&eSkull Search'
  category create:
    subtitle: '&fEnter id for new category'
    title: '&eCategory Creation'
categories:
  decoration: Decoration
  plants: Plants
  monsters: Monsters
  misc: Miscellaneous
  humans: Humans
  food and drinks: Food & Drinks
  alphabet: Alphabet
  animals: Animals
  blocks: Blocks
  humanoids: Humanoids
gui:
  custom category list:
    items:
      new:
        lore:
          - ''
          - '&e&lClick &8» &7To create new category'
        name: <GRADIENT:DD5E89>&lNew Category</GRADIENT:fbc7d4>
      category:
        lore:
          - '&8View heads by this category'
          - '&7Total Heads&F: &b%category_size%'
          - ''
          - '&e&lClick &8» &7To view category'
        name: '%category_name%'
    title: '&eSkulls &8> &7Custom Categories'
  skulls list:
    title:
      all: '&eSkulls &8> &7All'
      favourites: '&eSkulls &8> &7Favourites'
      search: '&eSkulls &8> &7%search_phrase%'
      category: '&eSkulls &8> &7%category_name%'
    items:
      skull:
        lore:
          un favourite: '&e&lRight Click &8» &7To unfavourite head'
          price: '&7Cost: &a$%skull_price%'
          blocked: '&c&oPurchase is blocked'
          favourited: '&e&lFAVOURITED'
          id: '&7Id: &e%skull_id%'
          tags: '&7Tags: &e%skull_tags%'
          take: '&e&lLeft Click &8» &7To take one'
          favourite: '&e&lRight Click &8» &7To favourite head'
          edit: '&b&lPress 1 &8» &7To edit this skull'
        name: '&e%skull_name%'
  edit:
    title: '&eSkulls &8> &7Edit &8> &7%skull_id%'
    items:
      name:
        lore:
          - ''
          - '&e&lClick &8» &7To change skull name'
        name: <GRADIENT:DD5E89>&lSkull Name</GRADIENT:fbc7d4>
      price:
        lore:
          - ''
          - '&e&lClick &8» &7To edit skull price'
        name: <GRADIENT:DD5E89>&lSkull Price</GRADIENT:fbc7d4>
      add category:
        lore:
          - ''
          - '&e&lClick &8» &7To add to another category'
        name: <GRADIENT:DD5E89>&lAdd To Category</GRADIENT:fbc7d4>
      blocked:
        lore:
          - ''
          - '&7Blocked&f: %is_true%'
          - ''
          - '&e&lClick &8» &7To toggle block status'
        name: <GRADIENT:DD5E89>&lSkull Blocked</GRADIENT:fbc7d4>
  histories:
    items:
      history:
        name: '&e%history_id%'
        lore:
          - ''
          - '&7Total Heads&f: &a%history_size%'
          - '&7Downloaded&f: %is_true%'
          - '&7Time&f: &a%history_time%'
          - ''
          - '&e&lClick &8» &7To download heads'
    title: '&eSkulls &8> &7Histories'
  main:
    items:
      search:
        lore:
          - ''
          - '&e&lClick &8» &7To search for heads'
        name: <GRADIENT:DD5E89>&lSearch</GRADIENT:fbc7d4>
      custom categories:
        lore:
          - ''
          - '&e&lClick &8» &7To view more categories'
        name: <GRADIENT:DD5E89>&lMore Categories</GRADIENT:fbc7d4>
      category:
        lore:
          - '&8View heads by this category'
          - '&7Total Heads&F: &b%category_size%'
          - ''
          - '&e&lClick &8» &7To view category'
        name: '&e%category_name%'
      favourites:
        lore:
          - '&7A collection of every single head'
          - '&7that you have favourited.'
          - ''
          - '&e&lClick &8» &7To view your favourites'
        name: <GRADIENT:DD5E89>&lFavourites</GRADIENT:fbc7d4>
    title: '&eSkulls'
  custom category selector:
    title: '&eSkulls &8> &7Select Category'
    items:
      category:
        lore:
          - '&e&lClick &8» &7To select category'
        name: '%category_name%'
skull:
  name: '&e%skull_name%'
inspect info:
  - '&8&m-----------------------------------------------------'
  - ''
  - '&eSkull ID&f: &a%skull_id%'
  - ''
  - '&8&m-----------------------------------------------------'

# This is the default language for Skulls to use another language
# change the default language in the config.yml
# if the file does not exists, it will generate using the default english
# translations, you can then make edits from there.
file language: english
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tweetzy.ca/official-plugins/skulls/plugin-files.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
