> For the complete documentation index, see [llms.txt](https://mo-mi.gitbook.io/xiaomomi-plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mo-mi.gitbook.io/xiaomomi-plugins/customcrops/plugin-wiki/customcrops/format/pot.md). # 🪴 Pot Let's take `default`as an example to configure the pot settings **Unique Identifier for Your Pot**:\ Start by naming your pot under a unique identifier like `deault`. This makes it easy to reference and customize later on. **Set the Maximum Water Storage Capacity**:\ Use `max-water-storage` to define how much water your pot can store. For instance, setting it to `5` means the pot can hold up to five units of water. This ensures your plants have enough hydration between waterings. ```yaml # Maximum capacity for storing water in the pot storage: 5 ``` **Customize the Pot’s Basic Appearance**:\ The `base` section allows you to define the visual look of your pot under different conditions: * `dry`: The model ID used when the pot is dry, showing that it needs water. * `wet`: The model ID when the pot is hydrated and moist.\ These settings add a visual cue to the player, making it easy to see at a glance whether the pot needs watering. ```yaml # Basic settings for pot appearance and behavior base: # Models for the pot's appearance dry: dry_pot # Model ID when the pot is dry wet: wet_pot # Model ID when the pot is wet ``` **Control Pot’s Interaction with the Environment**: * `absorb-rainwater`: Set to `true` if you want your pot to automatically absorb water from rain, keeping it moist without manual watering. * `absorb-nearby-water`: Set to `false` to prevent the pot from absorbing water from nearby water sources. This setting ensures that your pot only gets watered when intended. ```yaml # Determines if the pot absorbs rainwater when it rains absorb-rainwater: true # Determines if water from nearby sources can wet the pot absorb-nearby-water: false ``` **Control Pot's Tick Mode** ```yaml # Sometimes you may have multiple pots configured, # and you want the pots to have different tick modes. # You can change the tick mode to ALL in config.yml # and then configure it separately here. ignore-random-tick: false ignore-scheduled-tick: true ``` **Manage Fertilizer Application**:\ The `max-fertilizers` parameter controls how many units of fertilizer can be applied to a pot at once. Setting it to `1` limits it to a single application, helping prevent over-fertilization which could harm the plants. For the moment it's recommended to keep it `1` as the hologram would show at most one fertilizer at the same time. ```yaml # Maximum number of fertilizers that can be applied to the pot max-fertilizers: 1 ``` **Define Custom Appearances for Fertilized Pots**:\ Under `fertilized-pots`, you can set unique models for pots based on different fertilizer effects. Each type (e.g., `quality`, `yield_increase`, `variation`, `soil_retain`, `speed_grow`) can have distinct `dry` and `wet` appearances. This customization adds depth, visually reflecting the benefits of different fertilizers applied to the pot. ```yaml # Custom appearances for pots with different fertilizer effects fertilized-pots: enable: false quality: dry: dry_pot # Model ID for dry pot with 'quality' fertilizer effect wet: wet_pot # Model ID for wet pot with 'quality' fertilizer effect yield_increase: dry: dry_pot # Model ID for dry pot with 'yield increase' fertilizer effect wet: wet_pot # Model ID for wet pot with 'yield increase' fertilizer effect variation: dry: dry_pot # Model ID for dry pot with 'variation' fertilizer effect wet: wet_pot # Model ID for wet pot with 'variation' fertilizer effect soil_retain: dry: dry_pot # Model ID for dry pot with 'soil retain' fertilizer effect wet: wet_pot # Model ID for wet pot with 'soil retain' fertilizer effect speed_grow: dry: dry_pot # Model ID for dry pot with 'speed grow' fertilizer effect wet: wet_pot # Model ID for wet pot with 'speed grow' fertilizer effect ``` **Configure Water Refill Methods**:\ The `fill-method` section allows you to define various methods for refilling the pot with water: * **Method 1**: Using a `WATER_BUCKET` adds `3` units of water. Upon refilling, the player receives an empty `BUCKET`. * **Method 2**: Using a `POTION` adds `1` unit of water and returns a `GLASS_BOTTLE`.\ Both methods include actions like playing a sound (`minecraft:item.bucket.fill` or `minecraft:item.bottle.fill`) and a hand-swing animation to provide feedback during the refill process. ```yaml # Methods available to refill the watering can with water fill-method: # Customizable refill method 1 method_1: # Item required to refill item: WATER_BUCKET # Item returned after refilling (optional) return: BUCKET # Amount of water added with this method amount: 3 actions: # Sound effect to play when refilling sound_action: type: sound value: source: player key: minecraft:item.bucket.fill volume: 1 pitch: 1 # Action of swinging hand during refill swing_hand_action: type: swing-hand value: true # Customizable refill method 2 method_2: item: POTION return: GLASS_BOTTLE amount: 1 actions: sound_action: type: sound value: source: player key: minecraft:item.bottle.fill volume: 1 pitch: 1 swing_hand_action: type: swing-hand value: true ``` **Customize the Water Level Display Bar**:\ The `water-bar` configuration allows you to create a unique visual indicator for the water level using custom characters. This display provides a quick and visually appealing way to check how much water is left in the can. ```yaml # Configuration for the water level display bar water-bar: left: '뀂' # Left cap of the water bar full: '뀁뀃' # Segment representing full water level empty: '뀁뀄' # Segment representing empty water level right: '뀁뀅' # Right cap of the water bar ``` **Set Up Events**:\ The `events` section is where the real magic happens. Here, you define how the game responds to different interactions with the pots. Available events: `place`/`break`/`interact`/`tick`/`reach_limitation`/`add_water`/`full`/`max_fertilizers` ```yaml # Event settings to handle interactions and effects events: add_water: particle_action: type: particle value: particle: WATER_SPLASH # Particle effect when water is added x: 0.5 y: 1.3 z: 0.5 count: 5 offset-x: 0.3 offset-z: 0.3 interact: # Action to display a hologram when holding a specified item conditional_action: type: conditional value: conditions: requirement_1: type: item-in-hand value: amount: 1 item: soil_surveyor actions: # Display hologram for fertilizer status if fertilizer exists conditional_fertilizer_action: type: conditional value: conditions: requirement_1: type: fertilizer value: has: true actions: fertilizer_hologram: type: hologram value: duration: 20 # Duration the hologram remains visible text: '{icon} {left_times}/{max_times}' apply-correction: true x: 0.5 y: 0.83 z: 0.5 visible-to-all: false # Display hologram showing current water level in the pot water_hologram: type: hologram value: duration: 20 # Duration the hologram remains visible text: '{water_bar}' apply-correction: true x: 0.5 y: 0.6 z: 0.5 visible-to-all: false ``` **Set Up Requirements**:\ Under `requirements`, you can configure the conditions player have to meet before using the pot. Available events: `break`/`place`/`use` ```yaml requirements: use: {} place: {} break: requirement_1: type: permission value: xxx.xxx ```