Permissions

clearframe.give

• Description: Allows a player to give themselves a single invisible item frame.
• Default: Operator
• Command Usage: /clearframe

clearframe.givemultiple

• Description: Permits a player to give themselves multiple invisible item frames at once.
• Default: Operator
• Command Usage: /clearframe <quantity>

clearframe.giveplayer

• Description: Allows a player to give a single invisible item frame to another player.
• Default: Operator
• Command Usage: /clearframe 1 <player>

clearframe.giveplayermultiple

• Description: Enables a player to give multiple invisible item frames to another player.
• Default: Operator
• Command Usage: /clearframe <quantity> <player>

Commands

/clearframe

• Usage: /clearframe [quantity] [player]
• Permission Required: clearframe.give for self, clearframe.giveplayer for others.
• Description: Gives invisible item frames to the command executor or another player.
• Examples:
  • /clearframe — Gives 1 invisible item frame to the player executing the command.
  • /clearframe 5 — Gives 5 invisible item frames to the player executing the command.
  • /clearframe 3 Alex — Gives 3 invisible item frames to player Alex.

Arguments:

• quantity (Optional): Number of frames to give (default is 1 if not specified).
• player (Optional): The target player to receive the frames.

Note: Ensure you have the appropriate permissions set up as described in the Permissions section above.

Changelog

Version 1.0.4

• Added - New configuration setting under `settings.server`: - `all-item-frames-clear`: Determines if all item frames should be made invisible upon placement. Default is `false`
• Improved - Enhanced configuration validation to ensure that all necessary settings are present in the `config.yml` file. If any settings are missing, they are now automatically filled with default values from the default config without resetting the user's current configurations.
• Fixed - Corrected a syntax error in the `validateConfig` method by adding a missing logical operator.
• Implemented `ensureConfigDefaults` method to check and set default values for individual configuration keys if they are not set, thus preserving existing configurations.
• Added `checkDefault` method to facilitate the setting of default values for missing configuration keys.

Version 1.0.3

• Improved: The consumeItem method to ensure that the specified item is correctly consumed from the player's inventory when placing a clear frame. The method now accurately checks for the item, adjusts the quantity if more than one is present, or removes the stack if it's the last item.
• Fixed: Issue where clear frames were placed but not deducted from the player's inventory.
• Fixed: Bug where normal items were placed as blocks instead of being replaced by invisible item frames when the specified material was not an ITEM_FRAME. Now, only the designated material triggers the creation of an invisible item frame, preventing unexpected block placement.
• Added: Break event to ensure that when a clear frame is broken, it drops a clear frame item with all its properties instead of a normal item frame. Additionally, the clear frame item is now dropped one block in front of the direction the frame was facing, improving the intuitiveness of retrieval after destruction.

Version 1.0.2

• Added: Command arguments to specify quantity and recipient player.
• Improved: Performance optimizations for servers with large player bases.

Version 1.0.1

• Added: Configuration options for custom model data and item frame material.
• Updated: Enhanced permission control for giving item frames to other players.

Version 1.0.0

• Features: Command to give a single invisible item frame, configurable through config.yml.
• Setup: Default configuration setup and documentation.