BetonQuest/BetonQuest

Implement `equip` action

クローズ

#4,207 opened on 2026/08/12

 (0 件のコメント) (0 件のリアクション) (0 人の担当者)Java (178 件のフォーク)auto 404
Good First Issue

Repository metrics

Stars
 (316 個のスター)
PR merge metrics
 (平均マージ 2d 9h) (30d で 77 merged PRs)

説明

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.

コントリビューターガイド