BetonQuest/BetonQuest

Implement `equip` action

已關閉

#4,207 建立於 2026年8月12日

 (0 則留言) (0 個反應) (0 位負責人)Java (178 個分叉)auto 404
Good First Issue

倉庫指標

星標
 (316 顆星)
PR 合併指標
 (PR 指標待抓取)

描述

Short introduction

Create an equip action to forcefully put items into equipment slots of players

Related

No response

Which common steps are required? This task requires...

  • Changes to the code
  • Changes to the database
  • Changes to the documentation
  • Updating changelog
  • Additional unit testing
  • Creating a migration
  • Bumping the version of the api or library module

Steps to complete

  1. Create the equip online action with syntax equip <item> <slot> {drop} {force}
  2. Create the matching factory for the equip action
  3. Document it in the Actions-List.md of the documentation files according to the style guidelines
  4. Add the new action under the Added section in the changelog for the current release

Additional context

The give doesn't cover this sufficiently. It should equip the specified item in the specified equipment slot of the players inventory. The drop will decide if handled items will be dropped and the force flag will decide if the action should replace existing equipment.

Flag Combination Result
(none) Only if the equipment slot is empty will the item by equipped.
drop If the equipment slot is filled will the item drop instead.
force The specified item will be equipped and any existing equipment will be overwritten.
drop force The specified item will be equipped and any existing equipment will drop.

貢獻者指南