# Config

AliienResize is highly modular and is managed through 5 distinct configuration files: `settings.yml`, `sizes.yml`, `messages.yml`, `main-menu.yml`, and `confirmation-menu.yml`.

Below is an overview of the primary configuration files you will interact with.

### Example settings.yml

This file controls the core mechanics, hooks, logging, and world blacklists.

```yaml
# Toggle the hooks
hooks:
  placeholder-api:
    enabled: true
  vault: 
    enabled: true
  experience: 
    enabled: false
  # ... (Other economy hooks listed here)

# Toggle the confirmation menu for purchases
confirmation-menu:
  enabled: true

# Blacklisted worlds (Players revert to 1.0x scale here)
blacklisted-worlds:
  - "example-world"

# Sounds settings (Supports Vanilla & Resource Pack sounds)
sounds:
  enabled: true
  click: "UI_BUTTON_CLICK:1.0:1.0"
  success: "ENTITY_PLAYER_LEVELUP:1.0:1.0"
  error: "ENTITY_VILLAGER_NO:1.0:1.0"
  clear: "ENTITY_EXPERIENCE_ORB_PICKUP:1.0:0.5"

# Logs successful purchases into a .txt file
purchase-logging:
  enabled: true
  file-name: "logs.txt"
```

### Example sizes.yml

This is where you define every available size, its scale, its GUI item, and its price.

```yaml
sizes:
  tiny:
    scale: 0.5
    permission: "aliien.resize.tiny"
    gui:
      material: LIGHT_BLUE_DYE
      slot: 11
      page: 1
      name: "<aqua><bold>Tiny Size</bold> <dark_gray>(0.5x)"
      lore:
        - "<gray>Click to shrink yourself down!</gray>"
        - "<white>Price: <gold>%price%</gold></white>"
      lore-without-perm: [] 
      model-data: 0
      item-flags: [HIDE_ATTRIBUTES]
    price:
      enabled: false
      currency: "VAULT"
      amount: 0.0

  huge:
    scale: 2.0
    permission: "aliien.resize.huge"
    gui:
      material: RED_DYE
      slot: 15
      page: 1
      name: "<red><bold>Huge Size</bold> <dark_gray>(2.0x)"
      lore: []
      lore-without-perm: []
      model-data: 0
      item-flags: []
    price:
      enabled: true
      currency: "VAULT"
      amount: 5000.0
```


---

# Agent Instructions: 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://aliien.gitbook.io/aliien-docs/aliienresize/config.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.