EngineHub / EngineHub/CommandHelper
Improve handling of offline players during events
- 主要言語
- Java
- スター
- 128
- フォーク
- 70
- PR マージ指標
- 30日以内にマージされた PR はありません
説明
Some events pass a player object for players that are missing from the player list during the event. This causes a CREPlayerOfflineException when getting these players from Static.GetPlayer() or Static.GetCommandSender(), as well as made it tricky to pass the player to the bind environment. This was originally solved by hijacking the player injection system used for capture_runas(), but it wasn't designed for this.
Now, after some changes, the player is added to the environment from MCPlayerEvent instead, but injection is still used for getting players by name (and as a fallback for environment adding). But this happens in AbstractEvent, and this is undesirable as it mixes MC and MethodScript stuff. This will need to be changed some day in the future, but extensions would need to be considered.
Two events use injection still: player_login, where the player is not yet added to the player list at all; and player_spawn where the player is missing from the byName player map but not the byUUID player map (byUUID determines whether the player is "online" or not), which means they're technically online but Static.GetPlayer() can't find them without injection. I consider the player_spawn situation a bug, so it might be better to move the workaround for this to the bukkit abstraction layer.
As for player_login, the player is technically offline, so I'm not sure what the expectation should be here. Due to this, currently you can run functions from player context but not by name, except functions that take a CommandSender instead. (e.g. `has_permission(, )`) We could change Static.GetPlayer() to take an environment object for situations like this (is player_login the only one?), but that'll affect a lot of functions and some will malfunction in unknown ways for truly offline players. I haven't done a comprehensive test.
コントリビューションガイド
調査の方向性
Start by reading AbstractEvent, MCPlayerEvent, Static.GetPlayer(), and Static.GetCommandSender(), then compare player_login and player_spawn handling. Clarify expected behavior for offline and missing-byName players, account for extensions, and add comprehensive coverage; done means event-context lookups and bind-environment behavior are explicitly defined and verified.
索引モデルが issue の本文から書いたものです。
評価
- 技術スタック
- java
- 領域
- game-dev
- issue の種類
- バグ
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 活発さ
- 停滞
- 明瞭さ
- 説明が足りない
- 初心者へのやさしさ
- 25/100