1
0
mirror of https://github.com/zeldaret/oot.git synced 2024-09-21 04:24:43 +00:00

Document a bug in Actor_ChangeCategory where actors may not be updated correctly (#1587)

* Document Actor_ChangeCategory bug

* Reword

* actor update function -> actor update
This commit is contained in:
cadmic 2023-11-30 17:18:00 -08:00 committed by GitHub
parent 5ce4670fd1
commit 2ab90bc517
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -3397,6 +3397,12 @@ Actor* func_80033684(PlayState* play, Actor* explosiveActor) {
* This is done by moving it to the corresponding category list and setting its category variable accordingly.
*/
void Actor_ChangeCategory(PlayState* play, ActorContext* actorCtx, Actor* actor, u8 actorCategory) {
//! @bug Calling this function immediately moves an actor from one category list to the other.
//! So, if Actor_ChangeCategory is called during an actor update, the inner loop in
//! Actor_UpdateAll will continue from the next actor in the new category, rather than the next
//! actor in the old category. This will cause any actors after this one in the old category to
//! be skipped over and not updated, and any actors in the new category to be updated more than
//! once.
Actor_RemoveFromCategory(play, actorCtx, actor);
Actor_AddToCategory(actorCtx, actor, actorCategory);
}