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.

贡献者指南