v2.1.1

Supported Versions

• Paper: 26.3, 26.2, 26.1.2, 26.1.1, 1.21.11
• Folia: 26.2, 26.1.2, 1.21.11

---

2.1.1 (2026-09-27)

Bug Fixes

• allow auto-replenish when both hands hold items for tree farms (ceb46d6)

v2.1.0

Supported Versions

• Paper: 26.3, 26.2, 26.1.2, 26.1.1, 1.21.11
• Folia: 26.2, 26.1.2, 1.21.11

---

2.1.0 (2026-09-27)

⚠ BREAKING CHANGES

The version consolidate the followQuitting settings into keepingMode and remove followQuittingDelay setting.

• keepingMode controls how the fake player is kept and restored:
  • ALWAYS : Always keep the fake player. Automatically restore it on server startup, including its active actions.
  • FOLLOW_SPAWNER : Remove the fake player when the spawner quits and restore it when the spawner joins, including its active actions.
  • FOLLOW_SPAWNER_QUIT : (Default) Remove the fake player when the spawner quits.

This setting is an individual fake player setting and is not included in the fakeplayer.basic permission by default. If allowed players to modify this setting, grant them the fakeplayer.settings.keepingMode permission.

Features

• Add automatic registration and login support for AuthMe (822d79f)
  (Closes #53 )
• Add keepInventory setting permission to fakeplayer.basic permission (bb58957)
• Add override-settings config to enforce server-wide fakeplayer settings (854db4c)
• Persist fake player action states, consolidate followQuitting into keepingMode (fc475a6)
  (Closes #59 )

v2.0.0

Supported Versions

• Paper: 26.3, 26.2, 26.1.2, 26.1.1, 1.21.11
• Folia: 26.2, 26.1.2, 1.21.11

---

2.0.0 (2026-09-25)

⚠ BREAKING CHANGES

The version split the previous behavior configuration in config.yml into the misc section and individual fakePlayer settings. Existing server owners need to manually migrate behavior configuration to the new configuration structure.

Features

• Add support for Minecraft 26.3

• Add advanced inventory viewer with:

  • Hotbar switching(Click the white glass pane in the second-to-last row to switch the main hand to the corresponding hotbar slot.)
  • Equipment slot support
  • Off-hand item modification (Closes #43)
  • 

• Add client language detection

  • Language bundles are now selected based on the player's client language.
  • remove the messages configuration in config.yml

• Add new FakePlayer Settings

  • Simulation distance (Closes #45)
  • XP pickup no cooldown
  • Auto equip tool
  • Infinite food level
  • Interacted action (Closes #44 )
  • Shift Interacted action

• Move the following settings from config.yml to individual FakePlayer Settings:

  • deathAction
  • keepInventory (this setting will override the gamerule)
  • followQuiting
  • followQuitingDelay

• Add Commands:

  • /fp swap to swap main and off-hand items. (Closes #43)

• Add FakePlayer Actions:

  • Look At Nearest Entity (Closes #56)

• Highlight active actions in green in the action dialog (Closes #57)

  • 

• Add granular permissions for settings

• The following settings are not included in fakeplayer.basic and require the corresponding fakeplayer.settings.<name> permission (e.g.fakeplayer.settings.interactedAction) to be granted separately:

  • interactedAction
  • shiftInteractedAction
  • deathAction
  • keepInventory
  • followQuiting
  • followQuitingDelay
  • 

Refactoring

• Migrate from plugin.yml to paper-plugin.yml
• Refactor sub-components into a generic PluginComponent system to provide a more consistent and extensible component architecture.
• Expose component registration through the API package
• Refactor the settings-related code to improve readability and extensibility.
• Further separate persistence logic by splitting the original repository implementation into: Table / PO / toEntity() / fromEntity()
• Refactor and reorganize the action system to make actions easier to extend and maintain.
  • Reorganize action-related classes and APIs
  • Improve action and settings dialog usability

Fixes

• Correct settings display when the player lacks the required permission
• Fix newly added settings not using values from the configuration
• Handle skin request timeouts correctly

v1.10.1

Supported Versions

• Paper: 26.2, 26.1.2, 26.1.1, 1.21.11
• Folia: 26.2, 26.1.2, 1.21.11

---

1.10.1 (2026-09-02)

Bug Fixes

• add ground check before jumping in JumpProcessor (4bab090), closes #47
• prevent fake player model from twitching after respawn (ffbf9f8), closes #46
• prevent race condition causing already retired error (7a988fe), closes #49
• resolve fakeplayer logic bugs and thread safety issues (94e480e)

v1.10.0

Supported Versions

• Paper: 26.2, 26.1.2, 26.1.1, 1.21.11
• Folia: 26.2, 26.1.2, 1.21.11

---

1.10.0 (2026-08-25)

Features

• add /fp rename command to rename fake players and update language files (c7c4f8b)

v1.9.1

Supported Versions

• Paper: 26.2, 26.1.2, 26.1.1, 1.21.11
• Folia: 26.2, 26.1.2, 1.21.11

---

1.9.1 (2026-08-24)

Bug Fixes

• i18n: fix traditional chinese strings in messages_zh_TW (b0bcbb7)

v1.9.0

Supported Versions

• Paper: 26.2, 26.1.2, 26.1.1, 1.21.11
• Folia: 26.2, 26.1.2, 1.21.11

---

1.9.0 (2026-08-23)

Features

• add help command and zh_TW language support (2333244)

v1.8.0

Supported Versions

• Paper: 26.2, 26.1.2, 26.1.1, 1.21.11
• Folia: 26.2, 26.1.2, 1.21.11

---

1.8.0 (2026-08-23)

Features

• add sequence name prefix config for fakeplayer (4b8568a), closes #33

Bug Fixes

• make useItem support entity interactions (2a71155)
• prevent loadData from overriding the fakeplayer's spawn position (692a239), closes #34
• replenish bone meal after fertilizing (b4b0d67)
• teleport to last death location without entity dispatcher (eee12ee)

v1.7.1

Supported Versions

• Paper: 26.2, 26.1.2, 26.1.1, 1.21.11
• Folia: 26.2, 26.1.2, 1.21.11

---

1.7.1 (2026-07-23)

Bug Fixes

• correct action permission check logic (319970a)

v1.7.0

Supported Versions

• Paper: 26.2, 26.1.2, 26.1.1, 1.21.11
• Folia: 26.1.2, 1.21.11

---

1.7.0 (2026-07-23)

Features

• add DropItemAction and processor, implement item drop functionality (c10f44a)
• allow executing actions directly without gui (d88008e)
• static-fakeplayers (1da3573)

Bug Fixes

• use ceil for block reach distance in useItem ray tracing (e89eb32)

Notable Changes

• The /fp action <action> command has been changed to /fp action start <action>.
• Can use /fp action execute <action> to execute actions directly now, bypassing the GUI.