This has been a long time coming really. In the past database scripts that render Link invisible or invincible have had common bugs where the effect doesn't go away under certain circumstances the scripter didn't anticipate. This header sets out to solve this problem in future scripts by tying Link's invisibility, collision detection, and draw/hit offsets to timers that clean up after themselves. I've also thrown in the ability to redraw Link's tiles as well, since that's a very common use for invisibility.

Update 4/22/20: Whaddya know, I forgot Link->Z again.
Update 5/4/20: Added Big Link compatibility
Update 6/24/20: Added post waitdraw direction overriding
Update 9/18/22: Added a 2.55 version of the header that writes to ScriptTile instead of the janky redrawing method. Some features of the 2.53 one are missing (CSet, layer) but the essentials are here.
Update 2/17/25: Updated the 2.55 version to not require a global Active script. Also added TempLinkState_SetNoColl() and TempLinkState_SetInvincible() which just call TempLinkState_UnsetCollDetection(). That function being named differently was bothering me.
Update 2/22/26: Updated the 2.55 version to add some speed changing functions.
Update 3/8/26: Updated the 2.55 version to be able to change player shield flags.
Update 5/22/26: 3.0 has mostly obsoleted the purpose of this header but I've made a 3.0 version anyways for script compatibility and to prevent deprecation warnings.

Combine the TempLinkState_Example global script with your own and set the following constants as needed:

• TEMPLINKSTATE_PRIORITIZE_LENGTH: If 1, longer timers will take priority when a shorter one is set. Something that sets Link invisible for 60 frames won't overwrite something that sets it for 30 if they overlap.
• TEMPLINKSTATE_TILE_OVERRIDE_USES_SPRITE: If 1, Link's redrawn tiles use sprites instead of script draws. Might have advantages with certain layer order stuff.
• TEMPLINKSTATE_TILE_OVERRIDE_FLICKERS: If 1, Link's redrawn tiles will flicker when hit instead of flashing csets 9-6. Use this if you have the "Invincible Link flickers" rule enabled.
• TEMPLINKSTATE_TILE_OVERRIDE_UNHIDE_ON_DEATH: If 1, Link will be made visible again on the frame he died if he's being redrawn. Generally preferable, but there could be reasons you want to handle this yourself.
• TEMPLINKSTATE_TILE_OVERRIDE_DRAW_DURING_SCROLL: If 1, Link will be drawn while the screen is scrolling. Not compatible with sprite based draws.
• TEMPLINKSTATE_BIG_LINK: 0 for normal, 1 for 1x2 Link, 2 for 2x2 Link

For scripters here's the functions you can use.

For turning off Link's collision detection:

• TempLinkState_UnsetCollDetection(int frames=1)

For making Link invisible:

• TempLinkState_SetInvisible(int frames=1)

For setting Link's draw offsets:

• TempLinkState_SetDrawXOffset(int offset, int frames=1)
• TempLinkState_SetDrawYOffset(int offset, int frames=1)

For setting Link's hit offsets:

• TempLinkState_SetHitXOffset(int offset, int frames=1)
• TempLinkState_SetHitYOffset(int offset, int frames=1)

For overriding Link's tile, base cset, and drawn layer:

• TempLinkState_SetLinkTileOverride(int tile, int frames=1)
• TempLinkState_SetLinkTileCSetOverride(int tile, int cset, int frames=1) - Removed in 2.55 version.
• TempLinkState_SetLinkTileCSetLayerOverride(int tile, int cset, int layer, int frames=1) - Does not work if TEMPLINKSTATE_TILE_OVERRIDE_USES_SPRITE is set. Removed in 2.55 version.

For overriding Link's facing direction:

• TempLinkState_SetDirOverride(int dir, int frames=1)

For changing Link's step speed:

• TempLinkState_MultiplyStepSpeed(int mult)
• TempLinkState_AddStepSpeedBoost(int amount)

For changing Link's shield flags:

• TempLinkState_SetShieldFlagOverride(int flags, int frames=1) - Uses the TLS_SF_ flag constants.

Requires std.zh and (for the old version) scrollingDraws.zh.