### Drop Configuration JSON Example

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/drop

Full example of a drop configuration with all fields, including item, conditions, and tips. Use as a template for creating a new drop.

```json
{
    "id": "COD_1",
    "chance": 50.0,
    "health": 1,
    "exp": 5,
    "vanilla_experience": 0,
    "weight": "1-4",
    "random_durability": false,
    "random_enchant": false,
    "catch_info": true,
    "rarity_info": true,
    "price": 0.32,
    "level": 0,
    "item": {
        "material": "PUFFERFISH",
        "display_name": "§x§5§E§D§6§3§ADewdrop Puffer"
    },
    "commands": [],
    "conditions": {
        "time": "NIGHT",
        "weather": "RAIN"
    },
    "not_discovered_tips": [
        "<gray>Conditions:",
        "<gray>- Raining",
        "<gray>- Night"
    ]
}
```

--------------------------------

### Full Loot Table Configuration Example

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/loot-table.md

A complete example showing the structure of a loot table with multiple drops, including item materials, permissions, stack sizes, chances, experience, and commands.

```yaml
table:
  amount:
    min: 1
    max: 10
  drops:
    - id: drop_1
      item:
        material: DIAMOND
      permission: vip.1
      stack_size:
        min: 1
        max: 10
      chance: 50
      exp: 50
      commands:
        - money give %player% 100
    - id: drop_2
      chance: 50.0
      item:
        material: APPLE
```

--------------------------------

### Ask documentation via HTTP GET with ask and goal parameters

Source: https://paw-studio.gitbook.io/paw-studio-docs/litecooking

Use this HTTP GET request to ask a question about the documentation. The `ask` parameter is required and should be a specific, self-contained natural language question; `goal` is optional and describes the broader end goal. The response contains a direct answer with relevant excerpts and sources.

```http
GET https://paw-studio.gitbook.io/paw-studio-docs/welcome-to-litecore-v2.md?ask=<question>&goal=<end_goal>
```

--------------------------------

### Drop Link Configuration JSON Example

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/drop

Example of a drop configuration that links to an existing drop using the link_id field. Use this to reuse an existing drop configuration.

```json
{
    "link_id": "COD_1"
}
```

--------------------------------

### Aquarium Configuration YAML

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/drop/aquarium

Complete configuration example for the aquarium, including max_fish, base_growth, notification messages, aquarium_item, water_material, and GUI settings.

```yaml
max_fish: 3
base_growth: 1
notification:
  messages: 
    PLACE: You have place %aquarium_name%
    BREAK: You have break %aquarium_name%
    BAD: There are fish in the aquarium
aquarium_item:
  material: GLASS
  display_name: <gradient:blue:red>Aquarium
water_material:
  - BLUE_STAINED_GLASS
gui:
  title: 'Aquarium'
  sound: ENTITY_EXPERIENCE_ORB_PICKUP:0.5:2
  icons:
    - id: '1'
      pattern: fish_slot
    - id: '2'
      icon: { material: BLACK_STAINED_GLASS_PANE, display_name: '<gray>Free slot' }
    - id: '0'
      icon: {material: BLUE_STAINED_GLASS_PANE, display_name: ' '}
  map:
    - '0 0 1 0 1 0 1 0 0'
```

--------------------------------

### Usage example: seed item without compare

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/liteitem.md

Example of a seed item created via GUI without a compare field.

```json
{
  "seed_item": {
    "amount": 1,
    "material": "WHEAT_SEEDS",
    "display_name": "§fトマトの種",
    "custom_model_data": "10009"
  }
}
```

--------------------------------

### Fishing Spot JSON Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/fishing-spot

Example configuration for a fishing spot, defining the drop table, modifiers, storage, lifespan, and display properties.

```json
{
  "category_id": "skull_drop_table",
  "modificator_id": "skull_modificator",
  "storage": 100,
  "time": 10,
  "item": {
    "material": "NETHER_STAR",
    "display_name": "§x§C§7§F§D§F§F Nether Bait"
  },
  "animation": {
    "id": "spot_animation"
  },
  "display_text": [
    "<#484EFF>☠ <#69D1FF>§lFishing Spot §r<#484EFF>☠",
    " ",
    "<gray>Catch left: <white>%storage%",
    "<gray>Bite time: <white>%time%",
    " "
  ]
}
```

--------------------------------

### Heavy Blocks YAML Configuration Example

Source: https://paw-studio.gitbook.io/paw-studio-docs/liteweight/weight_items/heavy-blocks-system

Example configuration for a heavy block targeting IRON_ORE, with offhand enabled, offhand size 4, minecart size 4, and weight 40.

```yaml
target:  
    - IRON_ORE
off_hand: true
offhand_size: 4
minecart_size: 4
weight: 40

```

--------------------------------

### Enchantment Configuration Example

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/custom-rod/enchantments

A sample JSON configuration for an enchantment, defining its name, level, and associated modifier values.

```json
{
  "name": "luck_of_the_sea",
  "level": 3,
  "modificator": {
    "drop_inc": 3,
    "drop_health": 0,
    "speed_inc": 0,
    "size_inc": 0,
    "player_health": 0,
    "luck_inc": 30.0,
    "auto_fishing": false,
    "bobber_amount": 0,
    "path": "plugins/LiteFish/modificators/"
  }
}
```

--------------------------------

### Configure Level 2 requirements and rewards

Source: https://paw-studio.gitbook.io/paw-studio-docs/liteguild/guild-configurationguild-config

This example shows how to define requirements and modifiers for reaching level 2, including experience thresholds and shop item additions.

```json
"levels": {
  "2": {
    "requirements": {
      "exp": 200,
      "money": 0
    },
    "display_name": "2 Level",
    "adders": [
      "max_players:+20"
    ],
    "add_shop_items": [
      {
        "item": {
          "material": "DIAMOND"
        },
        "amount": 10,
        "price": 100.0
      }
    ]
  }
}
```

--------------------------------

### Example of compare field

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/liteitem.md

Shows how to specify which fields are used for item comparison. If a player renames the item and display_name is in compare, the item will no longer match.

```json
{
  "lite_item": {
    "material": "OAK_LOG",
    "display_name": "§aMy log",
    "custom_model_data": "1001",
    "compare": "material,display_name,custom_model_data"
  }
}
```

--------------------------------

### Iron Ingot Delivery Quest Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/litequest/quest-config

Example configuration for a quest requiring the delivery of 10 Iron Ingots with associated rewards.

```json
{
  "display_item": {
    "material": "IRON_PICKAXE",
    "display_name": "{#8D8D8D}Stone quest!",
    "lore": [
      "{#A3FF86}We need to get stone for our village!"
    ]
  },
  "conditions": [
    {
      "display_tip": "{#8D8D8D}Iron ingot",
      "action": "INSERT",
      "target": "IRON_INGOT",
      "amount": "10",
      "insert_item": {
        "material": "IRON_INGOT"
      }
    }
  ],
  "reward_config": {
    "rewards": {
      "0": [
        "plugin_message {#8D8D8D}Stone quest {#A3FF86}completed!\n§7Reward:\n {#FFFC26}⁑ Money: {#FF9601}500$\n {#A3FF86}⁑ Exp: {#FF9601}250",
        "money add %player_name% 500",
        "experience add %player_name% 250"
      ]
    }
  }
}
```

--------------------------------

### Bait configuration example (JSON)

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/custom-rod/bait

Full JSON configuration for a bait item. The 'durability' field determines type: 0 for Eternal, 1 for Single-Use, >1 for Durable. 'conflict' with "ALL" means the bait must be used alone.

```json
{
  "item": {
    "material": "GLOW_BERRIES",
    "display_name": "<#EE9444>Bobber multiplier",
    "lore":[
      "<#D1823C>Bobber count: <accent>+2"
    ]
  },
  "durability": 0,
  "modificator": {
    "drop_inc": 0,
    "drop_health": 0,
    "speed_inc": 0,
    "size_inc": 0,
    "player_health": 0,
    "luck_inc": 0.0,
    "auto_fishing": false,
    "bobber_amount": 2
  },
  "conflict":["ALL"]
}
```

--------------------------------

### Weight Tier Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/drop/weight-system

Example configuration for defining weight tiers in weight_config.yml. Each tier uses range_min and range_max as percentages to determine which format string to display.

```yaml
tiers:
  - format: "<gray>Weight: <gray>%weight%kg [Tiny]"
    range_min: 0
    range_max: 20
  - format: "<gray>Weight: <white>%weight%kg [Small]"
    range_min: 20
    range_max: 40
  - format: "<gray>Weight: <green>%weight%kg [Medium]"
    range_min: 40
    range_max: 60
  - format: "<gray>Weight: <blue>%weight%kg [Large]"
    range_min: 60
    range_max: 85
  - format: "<gray>Weight: <dark_purple>%weight%kg [Huge]"
    range_min: 85
    range_max: 92
  - format: "<gray>Weight: <gold>%weight%kg [Giant]"
    range_min: 92
    range_max: 97
  - format: "<gray>Weight: <light_purple>%weight%kg [Colossal]"
    range_min: 97
    range_max: 99.5
  - format: "<gray>Weight: <red>%weight%kg [Leviathan]"
    range_min: 99.5
    range_max: 100
```

--------------------------------

### Command to get LiteItem data

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/liteitem.md

Run this command in-game while holding an item to have the plugin print a LiteItem model based on the held item.

```text
/[your_plugin] core data
```

--------------------------------

### Configure a Fish Trap

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/fish-trap

Example JSON configuration for a Fish Trap, defining the display name, material, catch interval, and storage capacity.

```json
{
  "item": {
    "display_name": "<#0FDCFF>Fish Trap",
    "material": "SCULK_SHRIEKER"
  },
  "catch_time": 30,
  "storage_size": 10
}
```

--------------------------------

### Usage example: seed item with compare

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/liteitem.md

Limits comparison to custom_model_data to avoid mismatches if the player renames the item.

```json
{
  "seed_item": {
    "amount": 1,
    "material": "WHEAT_SEEDS",
    "display_name": "§fトマトの種",
    "custom_model_data": "10009",
    "compare": "custom_model_data"
  }
}
```

--------------------------------

### Adventurer Character Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/liteguild/guild-configurationguild-config

An example of a character role definition, showing how to apply modifiers like quest cooldown reductions using the 'adders' field.

```json
"characters": {
  "adventurer": [
    {
      "requirements": {"exp": 0, "money": 0},
      "icon": {
        "material": "PLAYER_HEAD",
        "display_name": "Adventurer",
        "lore": ["Reduces guild quest cooldowns"]
      },
      "adders": ["quests_update:-1"]
    }
  ]
}
```

--------------------------------

### Configure automatic rarity lore with game.rarity_lore

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/rarity-system

JSON configuration example for the 'game.rarity_lore' key. The value uses '<insert_position:1>' to place the lore at the top of the item's lore and '%rarity%' as a placeholder for the selected rarity name.

```json
"game.rarity_lore": "<insert_position:1>%rarity%"
```

--------------------------------

### Custom Rod Configuration with compare Field

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/custom-rod

Example custom rod configuration showing the `compare` field set to `display_name`. Only the display name is used to identify the rod; other attributes like lore, NBT, and damage are ignored.

```json
"item": {
  "material": "FISHING_ROD",
  "display_name": "§cCustom Rod",
  "lore": [
    "§7A custom fishing rod.",
    "§7Holds two bait slots."
  ],
  "compare": "display_name"
}
```

--------------------------------

### Miner Quest Dynamic Configuration JSON

Source: https://paw-studio.gitbook.io/paw-studio-docs/litequest/quest-config

Example configuration for a dynamic quest where the objective amount is randomized (100-500) and rewards are calculated per unit. The reward_config uses placeholders %money% and %exp% which are replaced with calculated totals.

```json
{
  "display_item": {
    "material": "IRON_PICKAXE",
    "display_name": "{#8D8D8D}Stone quest",
    "lore": [
      "{#A3FF86}We need to get stone for our village!"
    ]
  },
  "conditions": [
    {
      "display_tip": "{#8D8D8D}Stone",
      "action": "BREAK",
      "target": "STONE",
      "amount": "100-500",
      "reward_per_unit": {
        "money": 10.0,
        "exp": 5.0
      }
    }
  ],
  "reward_config": {
    "rewards": {
      "0": [
        "plugin_message %quest_name% {#A3FF86}completed!\n§7Reward:\n {#FFFC26}⁑ Money: {#FF9601}%money%\n {#A3FF86}⁑ Exp: {#FF9601}%exp%",
        "money add %player_name% %money%",
        "experience add %player_name% %exp%"
      ]
    }
  }
}
```

--------------------------------

### Mining Perk Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/liteguild/guild-configurationguild-config

An example of a mining perk defined with multiple levels, including requirements, UI icons, shop items, and quest unlocks.

```json
"perks": {
  "mining": [
    {
      "requirements": {"exp": 0, "money": 0},
      "icon": {
        "material": "WOODEN_PICKAXE",
        "display_name": "Mining I",
        "lore": [
          "Adds mining shop items and quests",
          "Next upgrade: 200$"
        ]
      },
      "add_shop_items": [
        {"item": {"material": "COAL"}, "amount": 100, "price": 0.5}
      ],
      "add_quests": ["mining_1"]
    },
    {
      "requirements": {"exp": 0, "money": 200},
      "icon": {
        "material": "STONE_PICKAXE",
        "display_name": "Mining II",
        "lore": [
          "Adds more mining shop items and quests",
          "Next upgrade: 500$"
        ]
      },
      "add_shop_items": [
        {
          "item": {"material": "COAL"}, "amount": 100, "price": 0.5
        },
        {
          "item": {"material": "IRON_INGOT"}, "amount": 64, "price": 3.0
        }
      ],
      "add_quests": ["mining_1","mining_2"]
    }
  ]
}
```

--------------------------------

### Customize scoreboard title via gui.quest_tracker

Source: https://paw-studio.gitbook.io/paw-studio-docs/litequest/track-system

Sets the scoreboard title using the translations system. The example uses the key "gui.quest_tracker" with a value that includes a color code (§6).

```json
"gui.quest_tracker": "§6Quest Tracker"
```

--------------------------------

### Configuration File Path

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/fishing-spot

The directory where all fishing spot configurations are stored.

```text
plugins/LiteFish/spots
```

--------------------------------

### Core Configuration Format

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/json-yml.md

The main configuration file contains a core section where the format is defined.

```json
{
...
  "core": {
    "format": "json"
  }
...
}
```

--------------------------------

### Define base guild level system parameters

Source: https://paw-studio.gitbook.io/paw-studio-docs/liteguild/guild-configurationguild-config

The base configuration defines default values for player capacity, shop settings, and quest settings that apply to the guild level system.

```json
"level_system": {
  "base_max_players": 10,
  "base_shop_size": 5,
  "base_shop_update": 20,
  "base_quests_size": 3,
  "base_quests_update": 20,
  "base_shop_items": [],
  "base_quests": [],
  "levels": {}
}
```

--------------------------------

### Click Minigame Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/minigames.md

Defines the click minigame settings using placeholders for progress, clicks, and time.

```json
{
  "config": {
    "type": "click",
    "speed": 0,
    "time": 15,
    "visual": {
      "title": "<red>%progress%",
      "subtitle": "<gray>Left click <white>%clicks% <gray>times to win. Time left %time%"
    }
  }
}
```

--------------------------------

### Configure custom economy command in main config

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/economy

Add this YAML snippet to the main config to define a custom economy command. The command uses placeholders %player% and %money% to add money to a player.

```yaml
core:
  economy_command: money add %player% %money%

```

--------------------------------

### Drop Animation Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/animations/drop-animation.md

A complete configuration object for the drop_animation property, defining delay, effects, sound, and velocity.

```json
"drop_animation": {
  "delay": 5,
  "effects": [
    "TELEPORT_TO_PLAYER"
  ],
  "drop_sound": {
    "sound_name": "ENTITY_ITEM_PICKUP",
    "pitch": 1,
    "volume": 1
  },
  "velocity": {
    "type": "FOUNTAIN",
    "power": 0.4
  }
}
```

--------------------------------

### Define a basic sound animation

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/animations/sound-animation.md

Configures a sequence of sounds with optional delays in ticks. If no delay is provided, the sound plays immediately after the previous one.

```json
"sound_animation": {
  "sounds": [
    {
      "sound_name": "ENTITY_FISHING_BOBBER_RETRIEVE",
      "pitch": 1,
      "volume": 1
    },
    {
      "delay": 20,
      "sound_name": "ITEM_SHIELD_BREAK",
      "pitch": 1.5,
      "volume": 1
    }
  ]
}
```

--------------------------------

### Define sound animations with actions

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/animations/sound-animation.md

Maps specific action names to lists of sounds, allowing different audio feedback based on event outcomes like success or failure.

```json
"sound_animation": {
  "actions": {
    "SUCCESS": [
      {
        "sound_name": "ENTITY_FISHING_BOBBER_RETRIEVE",
        "pitch": 1,
        "volume": 1
      }
    ],
    "FAIL": [
      {
        "sound_name": "ITEM_SHIELD_BREAK",
        "pitch": 1.5,
        "volume": 1
      }
    ]
  }
}
```

--------------------------------

### Base Minigame Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/minigames.md

Defines the base minigame settings including size, speed, health, and target score with visual element mappings.

```json
{
  "config": {
    "type": "base",
    "size": 10,
    "speed": 5,
    "health": 2,
    "target_score": 3,
    "visual": {
      "target": "<#FF5858>●",
      "hook": "<#2052FF>●",
      "line": "<#96D0FF>●",
      "sub_title_symbol": "<#2052FF>●",
      "sub_title_symbol_dark": "§8●",
      "health": "<#2052FF>🎣"
    }
  }
}
```

--------------------------------

### Drop Sound Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/animations/drop-animation.md

Defines the sound played each time a single item is dropped.

```json
"drop_sound": {
  "sound_name": "ENTITY_ITEM_PICKUP",
  "pitch": 1,
  "volume": 1
}
```

--------------------------------

### Guild Configuration Structure

Source: https://paw-studio.gitbook.io/paw-studio-docs/liteguild/guild-configurationguild-config

The base JSON structure for defining guild settings such as icons, creation costs, upgrades, and level systems.

```json
{
  "icon": {...},
  "create_cost": 1000,
  "upgrade": {...},
  "level_system": {...}
}
```

--------------------------------

### Fill Minigame Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/minigames.md

Defines the fill minigame settings with specific size and target score requirements.

```json
{
  "config": {
    "type": "fill",
    "size": 10,
    "target_score": 20,
    "visual": {
      "hook": "<#2052FF>●",
      "line": "<#96D0FF>●"
    }
  }
}
```

--------------------------------

### Open LiteQuest Menu Command

Source: https://paw-studio.gitbook.io/paw-studio-docs/litequest/quest-config

Command used by players to access the quest menu.

```text
/lquest menu
```

--------------------------------

### Readable JSON LiteItem format

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/liteitem.md

Easier to modify manually and recommended when you only care about certain properties. Includes fields like material, display_name, lore, head_url, custom_model_data, item_model, compare, use_sounds, damage, and nbt.

```json
{
  "lite_item": {
    "amount": 64,
    "material": "OAK_LOG",
    "display_name": "§aMy log",
    "lore": [
      "Hello!",
      "This is my log =)"
    ],
    "head_url": "f2f52f927efffd...",
    "custom_model_data": "1001",
    "item_model": "nexo:custom_model"
    "compare": "material,display_name,custom_model_data",
    "use_sounds": [
      "ENTITY_SHEEP_SHEAR",
      "ENTITY_SHEEP_SHEAR:0.5:2"
    ],
    "damage": 10,
    "nbt": {
      "plugin_name:log_key": "oak_log"
    }
  }
}
```

--------------------------------

### Velocity Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/animations/drop-animation.md

Controls the movement behavior of dropped items after spawning.

```json
"velocity": {
  "type": "FOUNTAIN",
  "power": 0.4
}
```

--------------------------------

### Hold Minigame Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/minigames.md

Defines the hold minigame settings with target, hook, and line visual configurations.

```json
{
  "config": {
    "type": "hold",
    "size": 10,
    "speed": 10,
    "target_score": 5,
    "visual": {
      "target": "<#FF5858>●",
      "hook": "<#2052FF>●",
      "line": "<#96D0FF>●",
      "sub_title_symbol": "<#2052FF>●",
      "sub_title_symbol_dark": "§8●"
    }
  }
}
```

--------------------------------

### Configure track_type parameter

Source: https://paw-studio.gitbook.io/paw-studio-docs/litequest/track-system

Sets the tracking display mode for a quest. Use "BOSS_BAR" to show only the next incomplete objective, or "SCOREBOARD" to show all objectives in a sidebar.

```json
"track_type": "BOSS_BAR"
```

```json
"track_type": "SCOREBOARD"
```

--------------------------------

### Access trap configuration directory

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/fish-trap

The path where all trap configuration files are stored.

```text
plugins/LiteFish/traps
```

--------------------------------

### Configure weight_items entry

Source: https://paw-studio.gitbook.io/paw-studio-docs/liteweight/weight_items

Defines the weight value for a specific item or list of materials. This configuration structure is used in files like armor.yml, tools.yml, and custom.yml.

```yaml
target:  - IRON_HELMET
weight: 20
```

--------------------------------

### Animation file directory path

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/animations.md

The location where all animation files must be stored within the plugin folder.

```text
plugin\core\animations
```

--------------------------------

### Loot Table Command Execution

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/loot-table.md

Defines commands to run when a drop is generated. The %player% placeholder is replaced by the recipient's name.

```yaml
commands:  - money give %player% 100
```

--------------------------------

### Dance Minigame Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/minigames.md

Defines the dance minigame settings with directional input symbols and color-coded feedback states.

```json
{
  "config": {
    "type": "dance",
    "target_score": 10,
    "size": 10,
    "time": 15,
    "visual": {
      "subtitle": "<gray>Dance to win. Time left %time%",
      "left": "←",
      "right": "→",
      "up": "↑",
      "down": "↓",
      "normal": "<gray>",
      "correct": "<green>",
      "wrong": "<red>",
      "current": "<gold>"
    }
  }
}
```

--------------------------------

### Default Weight Lore Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/drop/weight-system

The default lore key used in the translation file.

```yaml
game.weight_lore
```

--------------------------------

### Upgrade System Structure

Source: https://paw-studio.gitbook.io/paw-studio-docs/liteguild/guild-configurationguild-config

The top-level JSON structure for the guild upgrade system, containing perks and characters.

```json
"upgrade": {
  "perks": {},
  "characters": {}
}
```

--------------------------------

### Loot Table Amount Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/loot-table.md

Defines the number of drop iterations. Use a fixed number or a range to determine how many times the loot generation process runs.

```yaml
10
```

```yaml
1-10
```

--------------------------------

### Animation reference directory path

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/animations.md

The directory path used when referencing existing animation files.

```text
plugin/core/animations
```

--------------------------------

### Hold Advanced Minigame Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/minigames.md

Defines the advanced hold minigame settings, utilizing a frame system for dynamic visual updates.

```json
{
  "config": {
    "type": "hold_advanced",
    "speed": 0,
    "visual": {
      "target": "<g:green_line_%progress%>",
      "hook": "<g:hook>",
      "hook_on_target": "<g:hook_target>",
      "line": "<shift:-5>%frame%",
      "frame_system":{
        "frame_line": 40,
        "frames": {
          "0": "<g:water_bar_1>",
          "5": "<g:water_bar_2>",
          "10": "<g:water_bar_3>",
          "15": "<g:water_bar_4>",
          "20": "<g:water_bar_5>",
          "25": "<g:water_bar_6>",
          "30": "<g:water_bar_7>",
          "35": "<g:water_bar_8>"
        }
      }
    }
  }
}
```

--------------------------------

### Configure weight-based effects in weight_config.yml

Source: https://paw-studio.gitbook.io/paw-studio-docs/liteweight/weight_config.yml

Configuration for weight-based effects. The weight_map uses percentage ranges (e.g., 50-80) to apply effects; the first matching range is used. The 80-100 entry with jump and transport disabled overrides the earlier 80-100 entry, applying SLOWNESS level 4 and preventing jumping and vehicle use.

```yaml
default_storage: 100 ## base maximum player weight
weight_map:
  50-80:
    effect:
      - name: SLOWNESS
        level: 1
  80-100:
    effect:
      - name: SLOWNESS
        level: 2
  100+:
    effect:
      - name: SLOWNESS
        level: 3
  80-100:
    jump: false ## The player cannot jump
    transport: false ## The player cannot use vehicles.
    effect:
      - name: SLOWNESS
        level: 4

```

--------------------------------

### Pull Minigame Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/minigames.md

Defines the pull minigame settings including health and time constraints.

```json
{
  "config": {
    "type": "pull",
    "size": 10,
    "speed": 5,
    "health":10,
    "time": 15,
    "visual": {
      "target": "<#FF5858>●",
      "line": "<#96D0FF>●",
      "sub_title_symbol": "<#2052FF>●",
      "sub_title_symbol_dark": "§8●"
    }
  }
}
```

--------------------------------

### Single-Use Bait lore format

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/custom-rod/bait

Lore format for Single-Use Bait, which is consumed after each use. Uses placeholder %bait_name%.

```plaintext
"game.bait_lore_1": "%bait_name%"
```

--------------------------------

### Animation file root structure

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/animations.md

The base JSON structure for an animation file, supporting drop, sound, and particle animations.

```json
{
  "drop_animation": {},
  "sound_animation": {},
  "particle_animation": {}
}
```

--------------------------------

### Miner Quest static configuration JSON

Source: https://paw-studio.gitbook.io/paw-studio-docs/litequest/quest-config

Defines a static quest that requires breaking 100 stone blocks. The quest displays an iron pickaxe with a custom name and lore, and rewards players ranked 1-3 with a plugin message, money, and experience.

```json
{
  "display_item": {
    "material": "IRON_PICKAXE",
    "display_name": "{#8D8D8D}Stone quest!",
    "lore": [
      "{#A3FF86}We need to get stone for our village!"
    ]
  },
  "conditions": [
    {
      "display_tip": "{#8D8D8D}Stone",
      "action": "BREAK",
      "target": "STONE",
      "amount": "100"
    }
  ],
  "reward_config": {
    "rewards": {
      "1-3": [
        "plugin_message {#8D8D8D}Stone quest {#A3FF86}completed!\n§7Reward:\n {#FFFC26}⁑ Money: {#FF9601}500$\n {#A3FF86}⁑ Exp: {#FF9601}250",
        "money add %player_name% 500",
        "experience add %player_name% 250"
      ]
    }
  }
}
```

--------------------------------

### Eternal Bait lore format

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/custom-rod/bait

Lore format for Eternal Bait, which provides permanent effects and does not consume durability. Uses placeholders %bait_name% and %amount%.

```plaintext
"game.bait_lore": "%bait_name% §7%amount%"
```

--------------------------------

### Limit Active Hotspots

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/fishing-spot

Configuration setting to limit the number of active hotspots per player in config.json.

```json
"max_spot_amount": 3
```

--------------------------------

### Full NBT Encoded LiteItem format

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/liteitem.md

Stores the complete internal NBT data of the item. This method is exact but not editable by hand.

```json
{
  "lite_item": {
    "amount": 1,
    "data": "rO0ABXNyABp..."
  }
}
```

--------------------------------

### Reward Calculation Formulas

Source: https://paw-studio.gitbook.io/paw-studio-docs/litequest/quest-config

Formulas for calculating total rewards based on units completed and per-unit reward values. These are used to compute the final money and experience rewards.

```text
Total_Money = Units_Completed × money_per_unit
Total_Exp   = Units_Completed × exp_per_unit
```

--------------------------------

### Compare with only custom_model_data

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/liteitem.md

Reduces comparison to non-editable fields. The plugin identifies any item with the same custom_model_data, regardless of name or damage.

```json
"compare": "custom_model_data"
```

--------------------------------

### Durable Bait lore format

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/custom-rod/bait

Lore format for Durable Bait, which has durability and displays current/max values. Uses placeholders %bait_name%, %now%, and %max%.

```plaintext
"game.bait_lore_2": "%bait_name% §7[%now%/%max%]"
```

--------------------------------

### Active Hotspots Data Path

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/fishing-spot

The directory where data for currently active hotspots is saved.

```text
plugins/LiteFish/data/spots
```

--------------------------------

### Empty Slot Lore Configuration

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/custom-rod

Defines the lore line used to indicate an empty bait or rune slot on a custom rod. The plugin searches for this exact string in the item lore when inserting or removing slot items.

```yaml
lang.slot_empty: "<#555555><bait slot>"
```

--------------------------------

### Loot Table Stack Size

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/loot-table.md

Specifies the quantity of items generated when a drop is selected, supporting fixed values or ranges.

```yaml
1
```

```yaml
1-10
```

--------------------------------

### Access player-placed trap data

Source: https://paw-studio.gitbook.io/paw-studio-docs/litefish/fish-trap

The path where data for all player-placed traps is saved.

```text
plugins/LiteFish/data/traps
```

--------------------------------

### Animation reference structure

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/animations.md

The JSON structure used to reference an existing animation file by its ID.

```json
{
  animation: {
    "id": "id_animation"
  }
}
```

--------------------------------

### Loot Table Permission Requirement

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/loot-table.md

Restricts a drop to players possessing the specified permission node.

```yaml
vip.1
```

--------------------------------

### Loot Table Drop Chance

Source: https://paw-studio.gitbook.io/paw-studio-docs/overview/loot-table.md

Sets the probability of a specific drop occurring during an iteration.

```yaml
Chance: 50%
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.