Feat/some new nice to have things

[TheBjoRedCraft]

This pull request introduces several enhancements and utility additions to the Bukkit and core API modules. The main focus is on extending messaging and inventory frameworks, improving packet handling, and adding new convenience functions and type aliases for clarity and ease of use.

Messaging and Audience Extensions:

• Added sendActionBar extension to Audience for sending action bar messages using a SurfComponentBuilder block.
• Introduced improved formatting and readability in Audience extension functions, including better error handling and formatting for displayName and permission checks.
• Added translatable function to SurfComponentBuilder for appending translatable components with color and decoration support.
• Introduced AdventureSound type alias for Sound to clarify usage in the core API.

Inventory and Bukkit Utilities:

• Added outlineItem property to View for generating a gray stained glass pane with an empty display name, useful for inventory UI outlines.
• Added utility functions for sending packets to players by UUID or Player object using PacketEvents, and a readableString extension for Location for improved debugging and logging. Also introduced BukkitSound type alias for Sound.

Dependency and Import Updates:

• Added necessary imports for new utility functions and extensions in Bukkit and core modules. [1] [2] [3]

Version Update:

• Updated project version in gradle.properties from 1.21.11-2.67.0 to 1.21.11-2.67.1.

[github-actions]

⚠️ API/ABI changes detected!

This PR contains changes that modified the public API. To update the reference ABI dumps:

./gradlew updateLegacyAbi
git add **/api/**
git commit -m "Update ABI reference"
git push

After updating, the CI will pass. Make sure the changes are backward compatible.

[Copilot]

Pull request overview

This PR adds small “nice-to-have” API conveniences across the core messaging utilities and Bukkit utilities, primarily to streamline Adventure component/sound usage, inventory UI building, and PacketEvents packet sending.

Changes:

• Add new messaging helpers: Audience.sendActionBar { ... } and SurfComponentBuilder.translatable(...).
• Add convenience aliases: AdventureSound (core) and BukkitSound (bukkit), plus an inventory View.outlineItem helper.
• Add Bukkit utility extensions for sending PacketEvents packets and a Location.readableString(...) formatter.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
surf-api-core/.../SurfComponentBuilder.kt	Adds translatable(...) builder helper and adjusts message imports.
surf-api-core/.../sound-extensions.kt	Adds AdventureSound typealias next to existing Sound DSL helpers.
surf-api-core/.../audience-extension.kt	Adds Audience.sendActionBar { ... } DSL-style extension and minor formatting.
surf-api-bukkit/.../bukkit-util.kt	Adds PacketEvents packet send helpers, Location.readableString, and BukkitSound alias.
surf-api-bukkit/.../inventory/framework/extensions.kt	Adds View.outlineItem convenience for UI outlines.
gradle.properties	Bumps project version to 1.21.11-2.67.1.

[github-actions]

⚠️ API/ABI changes detected!

This PR contains changes that modified the public API. To update the reference ABI dumps:

./gradlew updateLegacyAbi
git add **/api/**
git commit -m "Update ABI reference"
git push

After updating, the CI will pass. Make sure the changes are backward compatible.

[github-actions]

⚠️ API/ABI changes detected!

This PR contains changes that modified the public API. To update the reference ABI dumps:

./gradlew updateLegacyAbi
git add **/api/**
git commit -m "Update ABI reference"
git push

After updating, the CI will pass. Make sure the changes are backward compatible.

[github-actions]

⚠️ API/ABI changes detected!

This PR contains changes that modified the public API. To update the reference ABI dumps:

./gradlew updateLegacyAbi
git add **/api/**
git commit -m "Update ABI reference"
git push

After updating, the CI will pass. Make sure the changes are backward compatible.