FindTrade

A Minecraft plugin for finding villagers with specific enchantment trades using visual particle guidance.

Features

• Enchantment Search: Find nearby villagers selling specific enchantment books
• Pathfinding: Realistic walkable path visualization using the pathetic-bukkit library
• Region Management: Define regions to identify villager locations easily
• Interactive TUI: Text-based user interface for search results and region management
• Customizable Particles: Configure multiple particle types for pillar and path effects

Commands

/findtrade search <enchantment>

Search for nearby villagers offering a specific enchantment book.

• Displays results in an interactive TUI
• Click on a result to show particle effects guiding you to the villager
• Shows region name if the villager is within a defined region

/findtrade region

Opens the region management TUI for creating, editing, and deleting regions.

• Create: Define a region with a name and coordinates (supports WorldEdit selection)
• List: View all defined regions
• Edit: Modify region name or coordinates
• Delete: Remove a region

Aliases: /ft

Permissions

| Permission | Description | Default |
|------------|-------------|---------|
| findtrade.use | Use search and view regions | true |
| findtrade.write | Create, edit, and delete regions | op |

Configuration

The configuration file is located at plugins/FindTrade/config.yml.

Particle Effects

particle-effects:
  duration: 30  # How long particles are displayed (seconds)

  # Pillar particles above villager location
  pillar:
    enabled: true
    interval: 1
    particles:
      - type: "HAPPY_VILLAGER"
        height: 20
        count: 10
      - type: "END_ROD"
        height: 20
        count: 5

  # Path particles between player and villager
  path:
    enabled: true
    use-pathfinding: true  # false = straight line (lower server load)
    update-interval: 0.1
    particles:
      - type: "END_ROD"
        count: 1
        offset-x: 0.5
        offset-y: 0.5
        offset-z: 0.5
        randomness-x: 0.0
        randomness-y: 0.0
        randomness-z: 0.0
        speed: 0.0

Pathfinding

The plugin uses A* pathfinding to show realistic walkable paths. This runs asynchronously and has minimal server impact. If you experience performance issues, set use-pathfinding: false to use simple straight-line visualization.

Localization

Language files are located in plugins/FindTrade/localization/. Supported languages:

• English (en.yml)
• Korean (ko.yml)

Dependencies

• WorldEdit (optional) - For region selection using WorldEdit wand

Installation

1. Download the latest release from the releases page
2. Place the .jar file in your server's plugins folder
3. Restart your server

Changelog

0.4.0

• Major refactor: Consolidated commands into /findtrade
• Added A* pathfinding for realistic path visualization (pathetic-bukkit)
• Added interactive TUI for search results and region management
• Configurable multiple particle types for pillar and path effects
• Added particle offset, randomness, and speed settings
• Improved fallback to straight line when pathfinding fails

0.3.0

• Added EasyVillagerTrade integration with TUI interface
• Added interactive Text User Interface for enchantment management
• Enhanced search to include both registered and nearby villagers
• Added clickable chat messages for better interaction

0.2.0

• Added region-based villager trade management
• Enhanced /findvillager command to search for specific enchantments
• Added WorldEdit integration for region selection

0.1.0

• Initial release
• Basic villager trade management
• Enchantment search functionality
• Particle effect visualization

License

This project is licensed under the MIT License.