DOCSEARCHbyAlgolia
Submit Docs

AdvancedArmorStands Documentation

website·Indexed 30 days ago

https://docs.advancedarmorstands.ir

Documentation for the AdvancedArmorStands Minecraft plugin, featuring guides on installation, main configuration, and multi-language support. Includes a developer API for creating armor stands, managing animations, and handling events, as well as instructions for integrating an AI system for interactive armor stands.

Tokens
25.3K
Snippets
102
Records
159
Agent score
48%

What's inside AdvancedArmorStands

  1. Use the Actions Menu to manage armor stand actions

    The Actions Menu is a paginated inventory used to view and manage all actions linked to a specific armor stand. Actions define the behavior triggered by specific events (e.g., player interaction). To access the Actions Menu, navigate to the ArmorStand Menu and click on 'Actions'.

  2. AdvancedArmorStands Plugin Overview and Compatibility

    AdvancedArmorStands is an open-source Minecraft plugin designed for armor stand customization. It supports Minecraft versions from 1.8x up to the latest version (1.21). The plugin provides a developer API for extending functionality and is free to use, modify, and distribute.

  3. View ArmorStand metadata in the Information Slot

    The final slot in the ArmorStand Menu provides read-only metadata about the current armor stand, including the Date Created, the Creator, the World, and the Location.

  5. Use the Options Menu to configure armor stands

    The Options Menu is a paginated inventory used to modify the appearance and properties of an armor stand. It can be accessed by clicking 'Options' within the ArmorStand Menu. Each item in the menu represents a configurable option; hovering over an item displays its lore (explanation), and clicking the item applies the change immediately.

  6. Open the ArmorStand Menu

    The ArmorStand Menu is the primary interface for managing and editing an armor stand. It can be accessed using a chat command or a physical interaction with a registered armor stand.
    /as settings <armorstand-name>

  7. Install prerequisites for AdvancedArmorStands development

    To develop for the AdvancedArmorStands plugin or build extensions via its API, ensure the following tools are installed on your system:

    • Java Development Kit (JDK) 8 or higher
    • Git
    • Maven or Gradle
    • A supported IDE (IntelliJ IDEA, Eclipse, or VS Code)

  8. Listen to AdvancedArmorStands API events

    All AdvancedArmorStands events are located in the com.parsa3323.aas.api.events package. These events are handled as standard Bukkit events using the @EventHandler annotation. To ensure the API is loaded before your plugin, you must declare a dependency or soft-dependency on AdvancedArmorStands in your plugin.yml file.
    @EventHandler
public void onCreate(ArmorStandCreateEvent event) {
    Bukkit.getLogger().info("Armor stand created: " + event.getArmorStand().getName());
}

  9. Edit or remove existing armor stand actions

    Within the Actions Menu, each item represents a configured action. You can modify or delete these actions using the following interactions:

    • Click: Opens the edit menu to change the command, trigger type, and other settings.
    • Shift + Click: Removes the action from the armor stand.

  10. Reload animations from configuration

    Use the reload() method to refresh animations at runtime after modifying them in the configuration or file system. This method throws a ReloadException if the reload fails due to configuration errors.
    try {
    manager.reload();
} catch (ReloadException e) {
    e.printStackTrace();
}

  11. Manage keyframes with Animation Editor Tools

    While in animation edit mode, use the Keyframe Tool to define the movement sequence:

    • Right-click: Adds a keyframe based on the armor stand's current pose and position.
    • Shift + Right-click: Opens the Keyframe Menu to manage existing keyframes, remove specific frames, or set the interval (in ticks) between keyframes.

  12. Navigate paginated options in the Options Menu

    The Options Menu supports multiple pages of configuration settings. Use the 'Next Page' and 'Previous Page' items located at the bottom of the inventory to move between different sets of options.